Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/near/agent-skills --skill near-intentsAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
NEAR Intents Integration
Cross-chain token swaps via 1Click 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/statusRule 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 | SDK | sdk.md - official TypeScript/Go/Rust client libraries |
| 6 | Advanced | intents-balance.md, passive-deposit.md, api-confidential-swaps.md, api-orders.md, api-user-auth.md, api-hyperliquid.md |
Critical Knowledge
- Use `assetId` from /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(in-progress:PENDING_DEPOSIT,KNOWN_DEPOSIT_TX,PROCESSING) - Chain-to-chain is default -
depositTypeandrecipientTypedefault to chain endpoints - Auth quote or pay 0.25% - without an API key, an extra 25 bps fee applies to every non-
ANY_INPUTquote
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)
- api-any-input-withdrawals - Query withdrawals for ANY_INPUT quotes
- 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
- SDK (MEDIUM)
- sdk - Official TypeScript / Go / Rust client libraries for 1Click
- Advanced (LOW)
- intents-balance - Hold balances in intents.near for faster swaps
- passive-deposit - QR code flow for manual transfers
- api-confidential-swaps - Private swaps (
confidentialityparam, CONFIDENTIAL_INTENTS) - api-orders - Limit orders on /v0/orders
- api-user-auth - User authentication + private balances/history
- api-hyperliquid - USDC to/from Hyperliquid
- References
- concepts - Swap lifecycle, statuses, CEX warning, authentication
Upstream Docs (prefer live values)
For smaller areas and always-current details, consult upstream directly (append .md for markdown):
- Earn - multichain yield through 1Click
- Fee configuration -
appFees+ revenue share - Explorer API - historical transaction queries
- Swap types - EXACTINPUT / EXACTOUTPUT / FLEXINPUT / ANYINPUT
- Fees - full fee schedule
- Changelog
Resources
- Docs: https://docs.near-intents.org/integration/distribution-channels/1click-api
- API Keys: https://partners.near-intents.org/
- OpenAPI: https://1click.chaindefuser.com/docs/v0/openapi.yaml