near-intents

NEAR Intents の統合

1Click REST API を使ったクロスチェーンのトークンスワップです。見積もりを取得すると、API が入金先アドレスを提供します。入金トランザクションを作成すると、結果のトークンを自動的に受け取れます。

クイックスタート - パスを選択

ユースケース	まずはこちら
React アプリ	react-swap-widget.md - パターンを示すサンプル
Node.js / スクリプト	server-example.md - パターンを示すサンプル
API リファレンス	api-quote.md → api-tokens.md → api-status.md
チェーン固有の入金	deposit-{chain}.md

統合フロー

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

ルールのカテゴリ

優先度	カテゴリ	ファイル
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 フック	react-hooks.md
5	SDK	sdk.md - 公式 TypeScript/Go/Rust クライアントライブラリ
6	高度な機能	intents-balance.md、passive-deposit.md、api-confidential-swaps.md、api-orders.md、api-user-auth.md、api-hyperliquid.md

重要な知識

1. /v0/tokens の assetId を使用してください - 手動で作成しないでください
2. dry: true = プレビューのみ、dry: false = 入金先アドレスを取得（有効期間は約 10 分）
3. 終端状態になるまでステータスをポーリングします：SUCCESS、FAILED、REFUNDED、INCOMPLETE_DEPOSIT（処理中：PENDING_DEPOSIT、KNOWN_DEPOSIT_TX、PROCESSING）
4. デフォルトはチェーン間のスワップです - depositType と recipientType は、デフォルトでチェーンのエンドポイントになります
5. 見積もりを認証するか、0.25% を支払います - API キーがない場合、ANY_INPUT 以外の見積もりごとに追加で 25 bps の手数料がかかります

インデックス

1. サンプル（高）

   • react-swap-widget - wagmi を使った、React の最小構成のスワップ実装
   • server-example - サーバーサイドスワップ用の Node.js スクリプト

2. API リファレンス（最重要）

   • api-tokens - 対応トークンを取得し、結果をキャッシュします
   • api-quote - スワップの見積もりを取得します。プレビューには dry=true、入金先アドレスの取得には dry=false を指定します
   • api-deposit-submit - 処理を高速化するため、入金後に API に通知します
   • api-status - 終端状態になるまでポーリングします（SUCCESS、FAILED、REFUNDED）
   • api-any-input-withdrawals - ANY_INPUT の見積もりに対する出金を照会します

3. チェーン別の入金（高）

   • 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 が必須）

4. React フック（中）

   • react-hooks - トークン、見積もり、ステータスポーリング用の再利用可能なフック

5. SDK（中）

   • sdk - 1Click 用の公式 TypeScript / Go / Rust クライアントライブラリ

6. 高度な機能（低）

   • intents-balance - intents.near に残高を保有して、スワップを高速化します
   • passive-deposit - 手動送金用の QR コードフロー
   • api-confidential-swaps - プライベートスワップ（confidentiality パラメーター、CONFIDENTIAL_INTENTS）
   • api-orders - /v0/orders での指値注文
   • api-user-auth - ユーザー認証とプライベート残高／履歴
   • api-hyperliquid - Hyperliquid との USDC の入出金

7. 参考資料

   • concepts - スワップのライフサイクル、ステータス、CEX に関する警告、認証

上流ドキュメント（最新の値を優先）

詳細が必要な場合や常に最新の情報を確認する場合は、上流のドキュメントを直接参照してください（Markdown 版は .md を追加します）。

• Earn - 1Click によるマルチチェーンの利回り
• 手数料の設定 - appFees + 収益分配
• エクスプローラー API - 過去のトランザクションのクエリ
• スワップの種類 - EXACT_INPUT / EXACT_OUTPUT / FLEX_INPUT / ANY_INPUT
• 手数料 - 手数料の全一覧
• 変更履歴

リソース

• ドキュメント：https://docs.near-intents.org/integration/distribution-channels/1click-api
• API キー：https://partners.near-intents.org/
• OpenAPI：https://1click.chaindefuser.com/docs/v0/openapi.yaml