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 |
rules/react-hooks.md
View on GitHub---
title: React Hooks
impact: HIGH
tags: react, hooks, tanstack-query
---
Core hooks for 1Click API. See `react-swap-widget.md` for how these fit together.
## Dependencies
```bash
npm install @tanstack/react-query
```
## Hooks
```typescript
import { useQuery, useMutation } from '@tanstack/react-query';
const API = 'https://1click.chaindefuser.com';
// Fetch all supported tokens (cache 5 min)
export function useTokens() {
return useQuery({
queryKey: ['1click-tokens'],
queryFn: () => fetch(`${API}/v0/tokens`).then((r) => r.json()),
staleTime: 5 * 60 * 1000,
});
}
// Get dry quote (preview only, no deposit address)
export function useQuote(
params: {
originAsset: string;
destinationAsset: string;
amount: string;
recipient: string;
refundTo: string;
} | null,
apiKey?: string
) {
return useQuery({
queryKey: ['1click-quote', params],
queryFn: () =>
fetch(`${API}/v0/quote`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
...(apiKey && { Authorization: `Bearer ${apiKey}` }),
},
body: JSON.stringify({
dry: true,
swapType: 'EXACT_INPUT',
slippageTolerance: 100,
...params,
}),
}).then((r) => r.json()),
enabled: !!params?.amount && params.amount !== '0',
refetchInterval: 10_000,
});
}
// Poll swap status until terminal
export function useSwapStatus(depositAddress: string | null, apiKey?: string) {
return useQuery({
queryKey: ['1click-status', depositAddress],
queryFn: () =>
fetch(`${API}/v0/status?depositAddress=${depositAddress}`, {
headers: apiKey ? { Authorization: `Bearer ${apiKey}` } : {},
}).then((r) => r.json()),
enabled: !!depositAddress,
refetchInterval: (q) =>
['SUCCESS', 'FAILED', 'REFUNDED', 'INCOMPLETE_DEPOSIT'].includes(q.state.data?.status)
? false
: 2000,
});
}
// Execute swap: get wet quote → send tx → submit hash
export function useExecuteSwap(apiKey?: string) {
return useMutation({
mutationFn: async ({
params,
sendTransaction,
}: {
params: { originAsset: string; destinationAsset: string; amount: string; recipient: string; refundTo: string };
sendTransaction: (depositAddress: string, amount: string) => Promise<string>;
}) => {
// 1. Get wet quote
const quote = await fetch(`${API}/v0/quote`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
...(apiKey && { Authorization: `Bearer ${apiKey}` }),
},
body: JSON.stringify({ dry: false, swapType: 'EXACT_INPUT', slippageTolerance: 100, ...params }),
}).then((r) => r.json());
// 2. Send deposit
const txHash = await sendTransaction(quote.quote.depositAddress, quote.quote.amountIn);
// 3. Notify API
fetch(`${API}/v0/deposit/submit`, {
method: 'POST',
headers: { 'Content-Type': 'application/json', ...(apiKey && { Authorization: `Bearer ${apiKey}` }) },
body: JSON.stringify({ txHash, depositAddress: quote.quote.depositAddress }),
}).catch(() => {});
return { depositAddress: quote.quote.depositAddress, txHash };
},
});
}
```
## Usage Pattern
```tsx
function MySwapComponent() {
const [depositAddr, setDepositAddr] = useState<string | null>(null);
const { data: tokens } = useTokens();
const { data: quote } = useQuote(params);
const { data: status } = useSwapStatus(depositAddr);
const swap = useExecuteSwap();
const handleSwap = async () => {
const result = await swap.mutateAsync({
params: { ... },
sendTransaction: async (addr, amt) => {
// Your wallet logic here (wagmi, ethers, etc.)
return txHash;
},
});
setDepositAddr(result.depositAddress);
};
// Build your custom UI...
}
```
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 |