← Back to Skills Marketplace
cuongdcdev

NEAR Intents 1click Api

by Cuong DC · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
573
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install near-intents
Description
Universal cross-chain swap & bridge skill for OpenClaw using the NEAR Intents 1Click SDK. Supports 14+ blockchains including NEAR, Base, Ethereum, Solana, an...
Usage Guidance
This skill appears to implement a real 1Click/NEAR swap client, but there are important inconsistencies and high-impact behaviors to consider before installing: - Metadata mismatch: The skill manifest says there are no required environment variables, but the documentation and code expect sensitive variables (NEAR_ACCOUNT_ID / NEAR_PRIVATE_KEY, SENDER_* keys, optional ONE_CLICK_JWT). Treat that as a red flag: the registry will not prompt you for secrets but the skill needs them to run auto-mode. - Sensitive secret risk: If you provide NEAR_PRIVATE_KEY or SENDER_PRIVATE_KEY to this skill (e.g., via .env), the agent (or any code run from the skill) can perform on-chain transfers and potentially drain funds. Only provide private keys in a controlled, isolated environment you trust, and prefer manual mode when possible. - Prefer manual mode & small tests: Use 'manual' mode or test/dry-run options first, and experiment with tiny amounts on testnet or in test mode to validate behavior before any real funds. - Audit & verify endpoints: The code targets https://1click.chaindefuser.com and explorer.near-intents.org — verify these endpoints independently and confirm they match the official 1Click/NEAR Intents documentation and your threat model. - Install & dependency caution: There is no registry-install spec — the repo expects you to run npm install. Audit package.json / package-lock.json (and dependencies) before running npm install in privileged environments. - Fix metadata before trusting: Ask the skill author/maintainer to update the skill manifest to declare required env vars and describe auto-mode behavior, or avoid granting credentials until the manifest accurately reflects runtime needs. - Operational recommendations: Keep keys out of global/shared environments, run the skill in an isolated container/VM, consider using ephemeral keys with limited funds, and always require explicit user consent (and confirm refundAddress) before executing any swap. If you need, I can: list exactly where each env var is referenced in the code, extract all env variable names used, or suggest a minimal safe workflow (manual-only) to reduce risk.
Capability Analysis
Package: NEAR Intents (xpi) Version: 2.0.0 Description: Universal cross-chain swap & bridge powered by NEAR Intents 1Click SDK. Supports 14+ blockchains including NEAR, Base, Ethereum, Arbitrum, Solana, and Bitcoin. Production-ready with mandatory refund address protection. The NEAR Intents package (v2.0.0) provides a universal cross-chain swap and bridge functionality, primarily through the `executeIntent()` function in `index.ts`. This function integrates with the official `@defuse-protocol/one-click-sdk-typescript` and NEAR-JS libraries. A critical safety feature is implemented: mandatory `refundAddress` validation for cross-chain swaps originating from non-NEAR chains. If this address is not provided, the function explicitly throws an error, preventing potential fund loss. Sensitive credentials (NEAR private keys, 1-Click JWT) are correctly sourced from environment variables, which is a standard secure practice for server-side applications. Minor concerns include `scripts/generate-account.ts` writing a newly generated private key to `.env.example`. While intended as a template, this practice carries a risk of accidental exposure if not handled with extreme care. Additionally, `scripts/logic.ts` appears to be an alternative or incomplete implementation of core swap logic, relying on undeclared local modules (`./near-intents-lib`). Its presence is suspicious due to potential confusion or unintended execution paths, but its direct impact on the skill's primary functionality is limited as `index.ts` is the declared entrypoint. The package relies on trusted third-party APIs (Defuse Protocol, CoinGecko) for its core operations. Overall, the package demonstrates a strong focus on security in its primary execution path and documentation, outweighing the minor issues in auxiliary scripts.
Capability Assessment
Purpose & Capability
The skill's name/description (NEAR Intents 1Click SDK cross-chain swaps) match the bundled code and SDK usage: it calls the 1Click API and NEAR RPC and includes implementation for getting quotes, sending deposits, submitting tx hashes, and polling swap status. However, the registry metadata incorrectly lists no required environment variables or credentials, while the documentation and code clearly expect/consume sensitive env vars (NEAR account/private key, SENDER_* keys, optional ONE_CLICK_JWT). That metadata omission is an incoherence between stated requirements and actual capabilities.
Instruction Scope
SKILL.md, AI-AGENT-GUIDE.md and the example scripts instruct agents to read .env and may perform irreversible operations (transfer NEAR funds, submit tx hashes, poll status). The instructions explicitly allow an 'auto' mode where the agent will send deposits using NEAR credentials found in environment variables. The SKILL.md references env variables and .env configuration not declared in the skill manifest. While sending funds is expected for this purpose, instructions that cause automatic on-chain transfers using private keys are high-impact and the missing metadata about required secrets increases the risk of accidental misuse.
Install Mechanism
The skill has no formal install spec in the registry, but the repository includes package.json/package-lock.json and Quickstart/INSTALL docs that instruct running npm install / npm scripts. There are no remote arbitrary download URLs; dependencies come from npm (registry). This is expected for a TypeScript SDK integration and is moderate-risk (it writes code to disk and installs many packages), but there are no extract-from-unknown-host install steps or URL shorteners.
Credentials
Registry metadata claims 'Required env vars: none' and 'Primary credential: none', but the docs and code require multiple sensitive env vars for full functionality: NEAR_ACCOUNT_ID / NEAR_PRIVATE_KEY / SENDER_NEAR_ACCOUNT / SENDER_PRIVATE_KEY / NEAR_RPC_URL / ONE_CLICK_JWT (optional). Requesting private keys is proportionate to an auto-send swap feature, but the omission from the declared requirements is misleading and dangerous. The skill will use dotenv and expects these secrets at runtime; this mismatch should be resolved before install.
Persistence & Privilege
The skill does not request 'always: true' and does not attempt to modify other skills or system-wide settings. Autonomous invocation is allowed (default), which combined with provided NEAR private keys allows the agent to execute on-chain transfers — this is expected for an auto-sending swap skill, but it is a high-impact capability and users should be cautious about granting keys. The skill itself does not request permanent system privileges beyond normal skill files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install near-intents
  3. After installation, invoke the skill by name or use /near-intents
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of universal cross-chain swap & bridge skill using NEAR Intents 1Click SDK. - Enables cross-chain swaps and bridging across 14+ blockchains, including NEAR, Base, Ethereum, Solana, and Bitcoin. - Provides a simple `executeIntent()` API supporting flexible asset, recipient, and mode parameters. - Supports both auto (from NEAR) and manual (from other chains) deposit modes. - Enforces explicit `refundAddress` for safety with non-NEAR origin swaps. - Integrates with 1Click API for seamless quotes, swaps, and bridging—no direct user interaction with NEAR contracts required. - Includes detailed usage documentation and asset naming conventions.
Metadata
Slug near-intents
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is NEAR Intents 1click Api?

Universal cross-chain swap & bridge skill for OpenClaw using the NEAR Intents 1Click SDK. Supports 14+ blockchains including NEAR, Base, Ethereum, Solana, an... It is an AI Agent Skill for Claude Code / OpenClaw, with 573 downloads so far.

How do I install NEAR Intents 1click Api?

Run "/install near-intents" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is NEAR Intents 1click Api free?

Yes, NEAR Intents 1click Api is completely free (open-source). You can download, install and use it at no cost.

Which platforms does NEAR Intents 1click Api support?

NEAR Intents 1click Api is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created NEAR Intents 1click Api?

It is built and maintained by Cuong DC (@cuongdcdev); the current version is v1.0.0.

💬 Comments