internet-court/internet-court-skill / vendored/jupiter/jupiter-vrfd
jupiter-vrfd
VerifiedUse when a user mentions Jupiter token verification, VRFD eligibility, paying 1000 JUP to verify a token, submitting a verification request, or updating metadata via the Jupiter express verification flow.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.0 KB |
| README.md | markdown | 1.3 KB |
| SKILL.md | skill md | 4.2 KB |
| examples/verify.md | markdown | 4.0 KB |
| references/api-reference.md | markdown | 12.6 KB |
references/api-reference.md
View on GitHub# API Reference — Jupiter Token Verification
> **Base URL**: `https://api.jup.ag`
> **Auth**: `x-api-key` header from [developers.jup.ag](https://developers.jup.ag/) (required for all requests)
This reference intentionally documents only the 3 public routes used by the skill.
For this skill, this file is the source of truth for:
- exact request and response shapes
- submission-mode field requirements
- accepted input formats and normalization rules
- available `tokenMetadata` fields
---
## GET /tokens/v2/verify/express/check-eligibility
Checks whether a token can enter the public verification flow and whether the execute route could also accept `tokenMetadata`.
```http
GET https://api.jup.ag/tokens/v2/verify/express/check-eligibility?tokenId={tokenId}
x-api-key: {API_KEY}
```
| Param | Type | Required | Notes |
| --- | --- | --- | --- |
| `tokenId` | string | Yes | Solana token mint address |
**Response**
```json
{
"canVerify": true,
"canMetadata": true,
"verificationError": null,
"metadataError": null
}
```
Notes:
- `canVerify: true` means the token can use the verification flow
- `canVerify: false` and `canMetadata: false` means the caller should stop and inspect `verificationError` and `metadataError`
- `canVerify: false` and `canMetadata: true` means verification is blocked, but a metadata-only execute request may still be possible
- `canMetadata: true` means `POST /tokens/v2/verify/express/execute` may accept a `tokenMetadata` payload
- this skill does not document private helpers for fetching or merging metadata
**Error response** (HTTP 400/403):
```json
{
"error": "Invalid token mint address",
"code": "INVALID_TOKEN_ID"
}
```
Common error codes: `INVALID_TOKEN_ID`, `UNAUTHORIZED` (missing or invalid API key).
---
## GET /tokens/v2/verify/express/craft-txn
Creates the unsigned 1000 JUP payment transaction used by the submission flow.
```http
GET https://api.jup.ag/tokens/v2/verify/express/craft-txn?senderAddress={walletAddress}
x-api-key: {API_KEY}
```
| Param | Type | Required | Notes |
| --- | --- | --- | --- |
| `senderAddress` | string | Yes | Wallet that will pay 1000 JUP |
**Response**
```json
{
"receiverAddress": "VRFD...",
"mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
"amount": "1000000000",
"tokenDecimals": 6,
"feeLamports": 5000,
"feeMint": "So11111111111111111111111111111111111111112",
"feeTokenDecimals": 9,
"feeAmount": 5000,
"transaction": "<base64-encoded-unsigned-transaction>",
"requestId": "req_abc123",
"totalTime": "150ms",
"expireAt": "2025-06-01T12:05:00Z",
"code": 0,
"gasless": false
}
```
The `transaction` value is unsigned. Verify it locally before signing.
**Response fields:**
| Field | Type | Description |
| --- | --- | --- |
| `receiverAddress` | string | Destination wallet (must be Jupiter burn multisig) |
| `mint` | string | Token mint being transferred |
| `amount` | string | Transfer amount in base units |
| `tokenDecimals` | number | Decimal places for `mint` |
| `tokenUsdRate` | number? | USD price of `mint` at craft time (may be absent) |
| `feeLamports` | number | **Deprecated** — use `feeAmount` instead |
| `feeUsdAmount` | number? | Fee expressed in USD (may be absent if prices unavailable) |
| `feeMint` | string | Mint used for fees — SOL when `gasless: false`, the transferred token when `gasless: true` |
| `feeTokenDecimals` | number | Decimal places for `feeMint` |
| `feeAmount` | number | Amount of `feeMint` the sender will pay as fees |
| `transaction` | string? | Base64-encoded unsigned transaction. **Only present when `code` is `0`** |
| `lastValidBlockHeight` | string? | Block height after which the transaction expires. Only present when `transaction` is present |
| `requestId` | string | Unique identifier — pass to `/execute` |
| `totalTime` | number | Server-side craft time in milliseconds |
| `expireAt` | string? | ISO 8601 timestamp after which the transaction is invalid |
| `code` | number | `0` = success, non-zero = error (see error codes below) |
| `error` | string? | Human-readable error message. Only present when `code` is non-zero |
| `gasless` | boolean | `true` if Jupiter covers SOL gas fees and collects fees in the transferred token instead |
**Transaction verification before signing:**
- `receiverAddress` must be `8gMBNeKwXaoNi9bhbVUWFt4Uc5aobL9PeYMXfYDMePE2` (Jupiter burn multisig)
- `mint` must be `JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN`
- `amount` must be `1000000000` (1000 JUP at 6 decimals)
- `expireAt` must be in the future — if expired, re-call `craft-txn`
**Error responses:**
HTTP 400/500 returns `{ "error": "..." }` for input validation failures (invalid address, invalid mint, invalid amount).
When the response is HTTP 200 but `code` is non-zero, the craft succeeded at the API level but the transaction would fail on-chain. The `transaction` field will be absent.
### Craft-txn error codes
| Code | Source | Meaning | Action |
| --- | --- | --- | --- |
| `0` | — | Success | Sign and submit via `/execute` |
| `1` | Taker state | Insufficient token balance | Prompt user to acquire more JUP |
| `2` | Taker state | Insufficient SOL for gas (< 0.01 SOL) | Prompt user to top up SOL |
| `3` | Taker state | Transfer amount too small for gasless (must be ≥ 10x fee) | Increase amount or add SOL for gas |
| `1001` | System program | Account does not have enough SOL | Top up SOL |
| `2001` | Token program | Insufficient funds | Check token balance |
| `2002` | Token program | Invalid mint | Verify mint address |
| `2004` | Token program | Owner does not match | Check token account ownership |
| `2009` | Token program | Token account uninitialized | Ensure token account exists |
| `2017` | Token program | Account is frozen | Contact token issuer |
| `3000` | Associated token | ATA owner mismatch | Check receiver address derivation |
---
## POST /tokens/v2/verify/express/execute
Submits the signed transaction and creates the verification request, metadata update, or both.
```http
POST https://api.jup.ag/tokens/v2/verify/express/execute
Content-Type: application/json
x-api-key: {API_KEY}
```
**Request body**
```json
{
"transaction": "<base64-signed-transaction>",
"requestId": "req_abc123",
"senderAddress": "8xDr...",
"tokenId": "So11111111111111111111111111111111111111112",
"twitterHandle": "https://x.com/jupiterexchange",
"senderTwitterHandle": "https://x.com/requester_handle",
"description": "Official wrapped SOL token"
}
```
| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `transaction` | string | Yes | Base64 signed transaction from `craft-txn` |
| `requestId` | string | Yes | Value returned by `craft-txn` |
| `senderAddress` | string | Yes | Wallet that signed the transaction |
| `tokenId` | string | Yes | Token mint being verified |
| `twitterHandle` | string | Yes for verification flow | The skill accepts `@handle`, bare `handle`, or `https://x.com/handle` from the user, then normalizes to `https://x.com/{handle}` before execute. For metadata-only execute, send `""` if the user did not provide one. |
| `senderTwitterHandle` | string | No | The skill accepts `@handle`, bare `handle`, or `https://x.com/handle`, then normalizes to `https://x.com/{handle}` before execute. |
| `description` | string | Yes for verification flow | Token description. For metadata-only execute, send `""` if the user did not provide one. |
| `tokenMetadata` | object | No | Optional metadata payload forwarded to the execute route |
**Response**
```json
{
"status": "Success",
"signature": "5tG8...",
"verificationCreated": true,
"metadataCreated": false,
"totalTime": 2500
}
```
**Error response** (HTTP 400/409/500):
```json
{
"error": "Transaction expired",
"code": "TRANSACTION_EXPIRED"
}
```
Common error codes:
| Code | HTTP | Retryable | Meaning |
| --- | --- | --- | --- |
| `TRANSACTION_EXPIRED` | 400 | Yes (re-craft) | Transaction `expireAt` has passed; call `craft-txn` again |
| `ELIGIBILITY_CONFLICT` | 409 | No | Token eligibility changed between check and execute |
| `EXECUTION_FAILED` | 500 | Maybe | On-chain execution failed; check signature on-chain before retrying |
| `UNAUTHORIZED` | 403 | No | Missing or invalid API key |
| `INVALID_PAYLOAD` | 400 | No | Missing required fields or malformed request body |
Notes:
- the route can create verification, metadata, or both depending on eligibility
- for metadata-only execute calls, the current schema still expects string values for `twitterHandle` and `description`; send `""` if the user did not provide them
- normalize `twitterHandle` and `senderTwitterHandle` to full `https://x.com/{handle}` URLs before execute
- if `tokenMetadata` is included, pass the object the user already has; this skill does not cover private metadata fetch or merge routes
- on `TRANSACTION_EXPIRED`, re-call `craft-txn` and restart the signing flow
- on `EXECUTION_FAILED`, check the transaction signature on-chain before deciding whether to retry
---
## Canonical Execute Contract
Use this section as the single source of truth for building the execute request.
### Submission Modes
| Mode | Meaning |
| --- | --- |
| `verification` | Create a verification request only |
| `verification+metadata` | Create a verification request and update token metadata in the same paid request |
| `metadata-only` | Update token metadata without creating a verification request |
### Required Fields By Submission Mode
| Field | `verification` | `verification+metadata` | `metadata-only` | Notes |
| --- | --- | --- | --- | --- |
| `tokenId` | Yes | Yes | Yes | Solana token mint |
| `senderAddress` | Yes | Yes | Yes | Wallet that signed the transaction (the paying wallet) |
| `twitterHandle` | Yes | Yes | Send `""` | Normalize to full `https://x.com/{handle}` URL when present |
| `senderTwitterHandle` | Optional | Optional | Optional | Normalize to full `https://x.com/{handle}` URL when present |
| `description` | Yes | Yes | Send `""` | Short token description when verification is created |
| `tokenMetadata` | Omit | Optional | Yes | Include only the fields the user wants to update, plus `tokenId` |
### Accepted Input Formats And Normalization
| Field | User may provide | Normalize to |
| --- | --- | --- |
| `twitterHandle` | `@handle`, bare `handle`, or `https://x.com/handle` | `https://x.com/{handle}` |
| `senderTwitterHandle` | `@handle`, bare `handle`, or `https://x.com/handle` | `https://x.com/{handle}` |
| `tokenId` | mint with surrounding spaces | Trimmed string before validation |
Confirm handle normalization with the user before execute when the user did not already provide the normalized URL.
---
## Optional tokenMetadata Payload
`POST /tokens/v2/verify/express/execute` accepts an optional `tokenMetadata` object with this shape:
```json
{
"tokenId": "So11111111111111111111111111111111111111112",
"icon": "https://example.com/icon.png",
"name": "Token Name",
"symbol": "TKN",
"website": "https://example.com",
"telegram": "https://t.me/example",
"twitter": "https://x.com/example",
"twitterCommunity": "https://x.com/i/communities/123",
"discord": "https://discord.gg/example",
"instagram": "https://instagram.com/example",
"tiktok": "https://tiktok.com/@example",
"circulatingSupply": "1000000",
"useCirculatingSupply": true,
"tokenDescription": "Token description",
"coingeckoCoinId": "example-token",
"useCoingeckoCoinId": true,
"circulatingSupplyUrl": "https://example.com/supply",
"useCirculatingSupplyUrl": true,
"otherUrl": "https://example.com"
}
```
All fields other than `tokenId` are optional and may be `string`, `boolean`, or `null` according to the server schema.
### tokenMetadata Fields
| Field | Type | Description |
| --- | --- | --- |
| `tokenId` | string | Token mint being updated |
| `icon` | string | Token icon URL |
| `name` | string | Token name |
| `symbol` | string | Token symbol |
| `website` | string | Project website URL |
| `telegram` | string | Telegram link |
| `twitter` | string | Twitter / X URL |
| `twitterCommunity` | string | Twitter community URL |
| `discord` | string | Discord invite link |
| `instagram` | string | Instagram URL |
| `tiktok` | string | TikTok URL |
| `circulatingSupply` | string | Circulating supply value |
| `useCirculatingSupply` | boolean | Enable circulating supply display |
| `tokenDescription` | string | Token description |
| `coingeckoCoinId` | string | CoinGecko coin ID |
| `useCoingeckoCoinId` | boolean | Enable CoinGecko integration |
| `circulatingSupplyUrl` | string | URL that returns circulating supply |
| `useCirculatingSupplyUrl` | boolean | Enable supply URL |
| `otherUrl` | string | Any other relevant URL |
## Validation Notes
- Solana addresses must be valid public keys
- The submission cost is 1000 JUP, represented as `1000000000` base units with 6 decimals
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |