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/api-status.md

View on GitHub
---
title: GET /v0/status
impact: CRITICAL
tags: api, status, polling
---

Check swap execution status. Poll until terminal state.

```typescript
const response = await fetch(
  `https://1click.chaindefuser.com/v0/status?depositAddress=${depositAddress}`,
  { headers: { Authorization: `Bearer ${apiKey}` } }
);
const status = await response.json();
```

For Stellar (MEMO mode), include memo:
```
?depositAddress=GABCD...&depositMemo=123456
```

## Status Values

| Status | Terminal | Description |
|--------|----------|-------------|
| `PENDING_DEPOSIT` | No | Waiting for deposit to arrive |
| `PROCESSING` | No | Deposit detected, swap executing |
| `SUCCESS` | Yes | Complete - tokens delivered |
| `INCOMPLETE_DEPOSIT` | Yes | Deposit below required amount |
| `REFUNDED` | Yes | Failed, funds returned to refundTo |
| `FAILED` | Yes | Error occurred |

## Response

```typescript
interface StatusResponse {
  correlationId: string;
  status: string;
  updatedAt: string;
  quoteResponse: QuoteResponse; // Original quote
  swapDetails: {
    amountIn: string;
    amountInFormatted: string;
    amountOut: string;
    amountOutFormatted: string;
    slippage: number;
    originChainTxHashes: Array<{ hash: string; explorerUrl: string }>;
    destinationChainTxHashes: Array<{ hash: string; explorerUrl: string }>;
    refundedAmount?: string;
    refundReason?: string;
    depositedAmount?: string;
  };
}
```

## Polling Pattern

```typescript
async function pollUntilComplete(depositAddress: string, apiKey?: string) {
  const headers = apiKey ? { Authorization: `Bearer ${apiKey}` } : {};

  for (let i = 0; i < 120; i++) { // Max ~4 minutes
    const res = await fetch(
      `https://1click.chaindefuser.com/v0/status?depositAddress=${depositAddress}`,
      { headers }
    );
    const status = await res.json();

    if (['SUCCESS', 'FAILED', 'REFUNDED', 'INCOMPLETE_DEPOSIT'].includes(status.status)) {
      return status;
    }

    await new Promise(r => setTimeout(r, 2000)); // Poll every 2s
  }

  throw new Error('Timeout waiting for swap completion');
}
```
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