internet-court/internet-court-skill / vendored/jupiter/integrating-jupiter
integrating-jupiter
VerifiedComprehensive guidance for integrating Jupiter APIs (Swap, Lend, Perps, Trigger, Recurring, Tokens, Price, Portfolio, Prediction Markets, Send, Studio, Lock, Routing). Use for endpoint selection, integration flows, error handling, and production hardening.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.0 KB |
| README.md | markdown | 1.6 KB |
| SKILL.md | skill md | 29.6 KB |
| examples/lend.md | markdown | 1.8 KB |
| examples/price.md | markdown | 1.8 KB |
| examples/swap.md | markdown | 2.9 KB |
| examples/trigger.md | markdown | 7.1 KB |
examples/swap.md
View on GitHub# Swap: End-to-End Example
> **Prerequisites:** This example uses the `jupiterFetch` helper defined in the
> **Developer Quickstart** section of the main `SKILL.md`. That helper prepends
> `https://api.jup.ag` to every path and attaches the `x-api-key` header
> automatically, so you never need to build full URLs or pass the API key
> manually.
>
> Note: The Swap API does **not** require a `Connection` object. Jupiter's
> `/swap/v2/execute` endpoint handles transaction submission on your behalf.
>
> **Production use:** Wrap the execute call in `withRetry` (defined in SKILL.md)
> to handle all retryable error codes per the error table in SKILL.md.
```typescript
import { Keypair, VersionedTransaction } from '@solana/web3.js';
import bs58 from 'bs58';
// jupiterFetch<T>(path, init?) is defined in Developer Quickstart (SKILL.md).
// It prepends https://api.jup.ag and adds the x-api-key header.
const wallet = Keypair.fromSecretKey(bs58.decode(process.env.WALLET_PRIVATE_KEY!));
const SOL_MINT = 'So11111111111111111111111111111111111111112';
const USDC_MINT = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
async function swapSolToUsdc(amountLamports: number) {
// 1. Get order
const params = new URLSearchParams({
inputMint: SOL_MINT,
outputMint: USDC_MINT,
amount: amountLamports.toString(),
taker: wallet.publicKey.toBase58(),
});
const order = await jupiterFetch<{
transaction: string | null;
requestId: string;
router?: string;
mode?: string;
feeBps?: number;
feeMint?: string;
error?: string;
}>(`/swap/v2/order?${params}`);
if (order.error || !order.transaction) {
throw new Error(`Order error: ${order.error ?? 'no transaction returned (is taker set?)'}`);
}
// 2. Sign the transaction
const txBuf = Buffer.from(order.transaction, 'base64');
const tx = VersionedTransaction.deserialize(txBuf);
tx.sign([wallet]);
const signedTx = Buffer.from(tx.serialize()).toString('base64');
// 3. Execute — Jupiter submits the transaction; no Connection needed
const result = await jupiterFetch<{
status: string;
signature: string;
code: number;
inputAmountResult?: string;
outputAmountResult?: string;
error?: string;
}>('/swap/v2/execute', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
signedTransaction: signedTx,
requestId: order.requestId,
}),
});
// 4. Confirm
if (result.status === 'Success') {
return {
signature: result.signature,
inputAmount: result.inputAmountResult,
outputAmount: result.outputAmountResult,
explorerUrl: `https://solscan.io/tx/${result.signature}`,
};
}
// Throw with structured context so withRetry can identify retryable errors
const err: any = new Error(`Swap failed: ${result.error || 'unknown'}`);
err.code = result.code;
throw err;
}
// Usage: swapSolToUsdc(1_000_000_000) → swaps 1 SOL
```
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: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | 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: 322k | 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: 322k | Updated | Claude CodeCodex | Verified | Install |