Skip to content

internet-court/internet-court-skill / vendored/near/near-intents

near-intents

Verified

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.

FileKindSize
LICENSEother329 B
SKILL.mdskill md3.7 KB
references/concepts.mdmarkdown2.1 KB
rules/api-any-input-withdrawals.mdmarkdown2.1 KB
rules/api-deposit-submit.mdmarkdown1.4 KB
rules/api-quote.mdmarkdown8.3 KB
rules/api-status.mdmarkdown2.0 KB
rules/api-tokens.mdmarkdown1.2 KB
rules/deposit-evm.mdmarkdown847 B
rules/deposit-near.mdmarkdown1.6 KB
rules/deposit-solana.mdmarkdown1.7 KB
rules/deposit-stellar.mdmarkdown1.6 KB
rules/deposit-ton.mdmarkdown1.5 KB
rules/deposit-tron.mdmarkdown1.0 KB
rules/intents-balance.mdmarkdown1.9 KB
rules/passive-deposit.mdmarkdown1.5 KB
rules/react-hooks.mdmarkdown3.8 KB
rules/react-swap-widget.mdmarkdown14.2 KB
rules/server-example.mdmarkdown9.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...
}
```
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 implementationStars: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 323kUpdated Claude CodeCodexVerifiedInstall