near-intents

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

NEAR Intents Integration

NEAR Intents 集成

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.

通过1Click REST API实现跨链代币兑换。获取报价后，API会提供存款地址，您只需构建存款交易，即可自动收到兑换后的代币。

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`

使用场景	开始文档
React应用	`react-swap-widget.md` - 展示实现模式的示例
Node.js / 脚本	`server-example.md` - 展示实现模式的示例
API参考	`api-quote.md` → `api-tokens.md` → `api-status.md`
链特定存款指南	`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

GET /v0/tokens → POST /v0/quote (dry) → POST /v0/quote (wet) → Deposit TX → POST /v0/deposit/submit → GET /v0/status

Rule Categories

规则分类


react-swap-widget.md
api-quote.md
deposit-evm.md
react-hooks.md
intents-balance.md

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`


react-swap-widget.md
api-quote.md
deposit-evm.md
react-hooks.md
intents-balance.md

优先级	分类	文件
1	示例	`react-swap-widget.md` , `server-example.md`
2	API文档	`api-quote.md` , `api-tokens.md` , `api-status.md` , `api-deposit-submit.md`
3	存款指南	`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	进阶内容	`intents-balance.md` , `passive-deposit.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
```
Chain-to-chain is default -
```
depositType
```
and
```
recipientType
```
default to chain endpoints

使用/v0/tokens接口返回的
assetId
- 切勿手动构造
dry: true
= 仅预览，dry: false
= 获取存款地址（有效期约10分钟）
轮询状态 直到进入终态：
```
SUCCESS
```
,
```
FAILED
```
,
```
REFUNDED
```
,
```
INCOMPLETE_DEPOSIT
```
默认跨链模式 -
```
depositType
```
和
```
recipientType
```
默认使用链端点

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

示例（高优先级）
- react-swap-widget - 基于wagmi的最简React兑换实现示例
- server-example - 用于服务端兑换的Node.js脚本示例
API参考（核心）
- api-tokens - 获取支持的代币列表，建议缓存结果
- api-quote - 获取兑换报价，dry=true用于预览，dry=false用于获取存款地址
- api-deposit-submit - 存款完成后通知API以加速处理
- api-status - 轮询直到进入终态（SUCCESS、FAILED、REFUNDED）
- api-any-input-withdrawals - 查询ANY_INPUT类型报价的提现记录
链存款指南（高优先级）
- deposit-evm - Ethereum、Base、Arbitrum、Polygon、BSC转账指南
- deposit-solana - 原生SOL和SPL代币转账指南
- deposit-near - 通过钱包选择器进行NEP-141代币转账
- deposit-ton - 通过TonConnect进行原生TON转账
- deposit-tron - 原生TRX和TRC-20代币转账指南
- deposit-stellar - Stellar转账指南（必须填写MEMO）
React Hooks（中优先级）
- react-hooks - 可复用的代币、报价、状态轮询Hooks
进阶内容（低优先级）
- intents-balance - 在intents.near中持有余额以加速兑换
- passive-deposit - 用于手动转账的二维码流程
参考资料
- concepts - 兑换生命周期、状态说明、CEX警告、认证机制

Resources

资源

文档：https://docs.near-intents.org/near-intents/integration/distribution-channels/1click-api
API密钥：https://partners.near-intents.org/
OpenAPI：https://1click.chaindefuser.com/docs/v0/openapi.yaml