Anmelden
near

near-intents

by @near in AI & LLM
5
1
# Install this skill:
npx skills add near/agent-skills --skill "near-intents"

Install specific skill from multi-skill repository

# Description

Cross-chain token swap integration using NEAR Intents 1Click API. Use when building swap widgets, bridge interfaces, or multi-chain transfers across EVM, Solana, NEAR, TON, Stellar, and Tron.

# SKILL.md

name: near-intents
description: Cross-chain token swap integration using NEAR Intents 1Click API. Use when building swap widgets, bridge interfaces, or multi-chain transfers across EVM, Solana, NEAR, TON, Stellar, and Tron.

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

  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
  4. Chain-to-chain is default - depositType and recipientType default to chain endpoints

Index

  1. Examples (HIGH)
  2. react-swap-widget - Minimum viable React swap implementation with wagmi

  3. server-example - Node.js script for server-side swaps

  4. API Reference (CRITICAL)

  5. api-tokens - Fetch supported tokens, cache result
  6. api-quote - Get swap quote, dry=true for preview, dry=false for deposit address
  7. api-deposit-submit - Notify API after deposit to speed up processing
  8. api-status - Poll until terminal state (SUCCESS, FAILED, REFUNDED)

  9. api-any-input-withdrawals - Query withdrawals for ANY_INPUT quotes

  10. Chain Deposits (HIGH)

  11. deposit-evm - Ethereum, Base, Arbitrum, Polygon, BSC transfers
  12. deposit-solana - Native SOL and SPL token transfers
  13. deposit-near - NEP-141 token transfers via wallet selector
  14. deposit-ton - Native TON transfers via TonConnect
  15. deposit-tron - Native TRX and TRC-20 transfers

  16. deposit-stellar - Stellar transfers (MEMO REQUIRED)

  17. React Hooks (MEDIUM)

  18. react-hooks - Reusable hooks for tokens, quotes, status polling

  19. Advanced (LOW)

  20. intents-balance - Hold balances in intents.near for faster swaps

  21. passive-deposit - QR code flow for manual transfers

  22. References

  23. concepts - Swap lifecycle, statuses, CEX warning, authentication

Resources

  • Docs: https://docs.near-intents.org/near-intents/integration/distribution-channels/1click-api
  • API Keys: https://partners.near-intents.org/
  • OpenAPI: https://1click.chaindefuser.com/docs/v0/openapi.yaml

# Related Skills

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚑ Amp πŸš€ Antigravity πŸ€– Claude Code πŸ¦€ Clawdbot πŸ“ Codex ▢️ Cursor πŸ€– Droid πŸ’Ž Gemini CLI πŸ™ GitHub Copilot πŸͺΏ Goose πŸ“Š Kilo Code πŸ”§ Kiro CLI πŸ’» OpenCode 🦘 Roo Code 🌲 Trae πŸ„ Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.