near-intents
9
总安装量
9
周安装量
#33250
全站排名
安装命令
npx skills add https://github.com/surgecode/near-intents-skill --skill near-intents
Agent 安装分布
claude-code
9
cursor
8
gemini-cli
7
codex
7
opencode
6
antigravity
6
Skill 文档
NEAR Intents Integration
Cross-chain token swaps via 1 Click REST API. Get a quote, API provides deposit addresses you build the deposit transaction and receive the resulting token automatically.
Quick Start – Pick Your Path
| Use Case | Start Here |
|---|---|
| React App | react-swap-widget.md – Example showing the pattern |
| Node.js / Script | server-example.md – Example showing the pattern |
| API Reference | api-quote.md â api-tokens.md â api-status.md |
| Chain-specific Deposits | deposit-{chain}.md |
Integration Flow
GET /v0/tokens â POST /v0/quote (dry) â POST /v0/quote (wet) â Deposit TX â POST /v0/deposit/submit â GET /v0/status
Rule Categories
| Priority | Category | Files |
|---|---|---|
| 1 | Examples | react-swap-widget.md, server-example.md |
| 2 | API | api-quote.md, api-tokens.md, api-status.md, api-deposit-submit.md |
| 3 | Deposits | deposit-evm.md, deposit-solana.md, deposit-near.md, deposit-ton.md, deposit-tron.md, deposit-stellar.md |
| 4 | React Hooks | react-hooks.md |
| 5 | Advanced | intents-balance.md, passive-deposit.md |
Critical Knowledge
- Use
assetIdfrom /v0/tokens – never construct manually dry: true= preview only,dry: false= get deposit address (valid ~10 min)- Poll status until terminal:
SUCCESS,FAILED,REFUNDED,INCOMPLETE_DEPOSIT - Chain-to-chain is default –
depositTypeandrecipientTypedefault to chain endpoints
Index
-
Examples (HIGH)
- react-swap-widget – Minimum viable React swap implementation with wagmi
- server-example – Node.js script for server-side swaps
-
API Reference (CRITICAL)
- api-tokens – Fetch supported tokens, cache result
- api-quote – Get swap quote, dry=true for preview, dry=false for deposit address
- api-deposit-submit – Notify API after deposit to speed up processing
- api-status – Poll until terminal state (SUCCESS, FAILED, REFUNDED)
-
Chain Deposits (HIGH)
- deposit-evm – Ethereum, Base, Arbitrum, Polygon, BSC transfers
- deposit-solana – Native SOL and SPL token transfers
- deposit-near – NEP-141 token transfers via wallet selector
- deposit-ton – Native TON transfers via TonConnect
- deposit-tron – Native TRX and TRC-20 transfers
- deposit-stellar – Stellar transfers (MEMO REQUIRED)
-
React Hooks (MEDIUM)
- react-hooks – Reusable hooks for tokens, quotes, status polling
-
Advanced (LOW)
- intents-balance – Hold balances in intents.near for faster swaps
- passive-deposit – QR code flow for manual transfers
Resources
- Docs: https://docs.near-intents.org/near-intents/integration/distribution-channels/1click-api
- API Keys: https://partners.near-intents.org/
- OpenAPI: https://1click.chaindefuser.com/docs/v0/openapi.yaml
Full Document
Complete compiled rules: AGENTS.md