internet-court/internet-court-skill / vendored/near/near-intents
near-intents
VerifiedCross-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.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 329 B |
| SKILL.md | skill md | 3.7 KB |
| references/concepts.md | markdown | 2.1 KB |
| rules/api-any-input-withdrawals.md | markdown | 2.1 KB |
| rules/api-deposit-submit.md | markdown | 1.4 KB |
| rules/api-quote.md | markdown | 8.3 KB |
| rules/api-status.md | markdown | 2.0 KB |
| rules/api-tokens.md | markdown | 1.2 KB |
| rules/deposit-evm.md | markdown | 847 B |
| rules/deposit-near.md | markdown | 1.6 KB |
| rules/deposit-solana.md | markdown | 1.7 KB |
| rules/deposit-stellar.md | markdown | 1.6 KB |
| rules/deposit-ton.md | markdown | 1.5 KB |
| rules/deposit-tron.md | markdown | 1.0 KB |
| rules/intents-balance.md | markdown | 1.9 KB |
| rules/passive-deposit.md | markdown | 1.5 KB |
| rules/react-hooks.md | markdown | 3.8 KB |
| rules/react-swap-widget.md | markdown | 14.2 KB |
| rules/server-example.md | markdown | 9.1 KB |
SKILL.md
View on GitHub---
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)**
- [react-swap-widget](rules/react-swap-widget.md) - Minimum viable React swap implementation with wagmi
- [server-example](rules/server-example.md) - Node.js script for server-side swaps
2. **API Reference (CRITICAL)**
- [api-tokens](rules/api-tokens.md) - Fetch supported tokens, cache result
- [api-quote](rules/api-quote.md) - Get swap quote, dry=true for preview, dry=false for deposit address
- [api-deposit-submit](rules/api-deposit-submit.md) - Notify API after deposit to speed up processing
- [api-status](rules/api-status.md) - Poll until terminal state (SUCCESS, FAILED, REFUNDED)
- [api-any-input-withdrawals](rules/api-any-input-withdrawals.md) - Query withdrawals for ANY_INPUT quotes
3. **Chain Deposits (HIGH)**
- [deposit-evm](rules/deposit-evm.md) - Ethereum, Base, Arbitrum, Polygon, BSC transfers
- [deposit-solana](rules/deposit-solana.md) - Native SOL and SPL token transfers
- [deposit-near](rules/deposit-near.md) - NEP-141 token transfers via wallet selector
- [deposit-ton](rules/deposit-ton.md) - Native TON transfers via TonConnect
- [deposit-tron](rules/deposit-tron.md) - Native TRX and TRC-20 transfers
- [deposit-stellar](rules/deposit-stellar.md) - Stellar transfers (MEMO REQUIRED)
4. **React Hooks (MEDIUM)**
- [react-hooks](rules/react-hooks.md) - Reusable hooks for tokens, quotes, status polling
5. **Advanced (LOW)**
- [intents-balance](rules/intents-balance.md) - Hold balances in intents.near for faster swaps
- [passive-deposit](rules/passive-deposit.md) - QR code flow for manual transfers
6. **References**
- [concepts](references/concepts.md) - 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
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |