mcpField
N
near-intents

near-intents

github.com/near开发16170 次安装4 周前更新
代码仓库

关于 near-intents

near-intents 是集成 NEAR Intents 1Click REST API 的开发参考，面向构建跨链代币兑换的开发者。内容涵盖 API 流程、链上存款、React 示例、SDK 及高级兑换功能。

主要功能

  1. 011Click API 兑换流程
  2. 02报价、存款地址与状态查询
  3. 03多链存款实现参考
  4. 04React Hooks 与应用示例
  5. 05TypeScript、Go、Rust SDK
  6. 06限价单与隐私兑换参考

适用场景

  1. 01在 React 应用中加入代币兑换
  2. 02通过 Node.js 脚本执行跨链兑换
  3. 03为指定区块链构建存款交易
  4. 04跟踪兑换状态直至完成

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/near/agent-skills --skill near-intents

安装后在 Claude Code 中输入/near-intents确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
concepts.md
rules/
api-any-input-withdrawals.md
api-confidential-swaps.md
api-deposit-submit.md
api-hyperliquid.md
api-orders.md
api-quote.md
api-status.md
api-tokens.md
api-user-auth.md
deposit-evm.md
deposit-near.md
deposit-solana.md
deposit-stellar.md
deposit-ton.md
deposit-tron.md
intents-balance.md
passive-deposit.md
react-hooks.md
react-swap-widget.md
sdk.md
server-example.md

详细介绍

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
2APIapi-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
4React Hooksreact-hooks.md
5SDKsdk.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 个基点的费用

索引

  1. 示例（高优先级）

  2. API 参考（关键）

  3. 链上存款（高优先级）

  4. React Hooks（中优先级）

    • react-hooks - 用于代币、报价和状态轮询的可复用 Hook

  5. SDK（中优先级）

    • sdk - 适用于 1Click 的官方 TypeScript / Go / Rust 客户端库

  6. 高级（低优先级）

  7. 参考

    • concepts - 兑换生命周期、状态、CEX 警告、身份验证

上游文档（优先采用实时数据）

对于较小范围的主题和始终保持最新的详情，请直接查阅上游文档（添加 .md 可访问 Markdown 版本）：

资源

评论

支持 Markdown