near-intents
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/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)
- 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
-
Advanced (LOW)
- intents-balance - Hold balances in intents.near for faster swaps
- passive-deposit - QR code flow for manual transfers
-
References
- concepts - Swap lifecycle, statuses, CEX warning, authentication
Resources
More from near/agent-skills
near-api-js
>-
48near-smart-contracts
NEAR Protocol smart contract development in Rust. Use when writing, reviewing, or deploying NEAR smart contracts. Covers contract structure, state management, cross-contract calls, testing, security, and optimization patterns. Based on near-sdk v5.x with modern macro syntax.
42near-kit
TypeScript library for NEAR Protocol blockchain interaction. Use this skill when writing code that interacts with NEAR Protocol, including viewing contract data, calling contract methods, sending NEAR tokens, building transactions, creating type-safe contract wrappers, integrating wallets (Wallet Selector, HOT Connect), React hooks and providers (@near-kit/react), managing keys, testing with sandbox, meta-transactions (NEP-366), and message signing (NEP-413).
35near-ai-cloud
NEAR AI Cloud private inference and verification. Use when integrating NEAR AI Cloud API for verifiable private AI inference, verifying model or gateway TEE attestation (NVIDIA NRAS, Intel TDX), verifying chat message signatures, implementing end-to-end encrypted chat, or using the OpenAI-compatible API with NEAR AI Cloud.
26near-contract-audit
Comprehensive security audit skill for NEAR Protocol smart contracts written in Rust. Use when auditing NEAR contracts, reviewing security vulnerabilities, or analyzing contract code for issues like reentrancy, unhandled promises, unsafe math, access control flaws, and callback security.
24near-dapp
>
22