near/agent-skills

near-intents

Cross-chain token swap integration using NEAR Intents 1Click API.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/near/agent-skills --skill near-intents

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

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 CaseStart Here
React Appreact-swap-widget.md - Example showing the pattern
Node.js / Scriptserver-example.md - Example showing the pattern
API Referenceapi-quote.md → api-tokens.md → api-status.md
Chain-specific Depositsdeposit-{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

PriorityCategoryFiles
1Examplesreact-swap-widget.md, server-example.md
2APIapi-quote.md, api-tokens.md, api-status.md, api-deposit-submit.md
3Depositsdeposit-evm.md, deposit-solana.md, deposit-near.md, deposit-ton.md, deposit-tron.md, deposit-stellar.md
4React Hooksreact-hooks.md
5SDKsdk.md - official TypeScript/Go/Rust client libraries
6Advancedintents-balance.md, passive-deposit.md, api-confidential-swaps.md, api-orders.md, api-user-auth.md, api-hyperliquid.md

Critical Knowledge

  1. Use `assetId` from /v0/tokens - never construct manually
  2. `dry: true` = preview only, `dry: false` = get deposit address (valid ~10 min)
  3. Poll status until terminal: SUCCESS, FAILED, REFUNDED, INCOMPLETE_DEPOSIT (in-progress: PENDING_DEPOSIT, KNOWN_DEPOSIT_TX, PROCESSING)
  4. Chain-to-chain is default - depositType and recipientType default to chain endpoints
  5. Auth quote or pay 0.25% - without an API key, an extra 25 bps fee applies to every non-ANY_INPUT quote

Index

  1. Examples (HIGH)
  1. API Reference (CRITICAL)
  1. Chain Deposits (HIGH)
  1. React Hooks (MEDIUM)
  • react-hooks - Reusable hooks for tokens, quotes, status polling
  1. SDK (MEDIUM)
  • sdk - Official TypeScript / Go / Rust client libraries for 1Click
  1. Advanced (LOW)
  1. 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):

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