Skip to content

vrfd.md

Latest commit

 

History

History
122 lines (95 loc) · 4.5 KB

vrfd.md

File metadata and controls

122 lines (95 loc) · 4.5 KB

Token Verification

Submit token verification requests on Jupiter. Costs 1000 JUP per verification.

Requires: an active key for the submit command. See setup.

Commands

Check eligibility

jup vrfd check --token <mint-address>
  • --token (required) — token mint address to check
// Example JSON response:
{
  "tokenExists": true, // whether the token mint exists on-chain
  "isVerified": false, // whether the token is already verified
  "canVerify": true, // whether verification can be submitted
  "canMetadata": true, // whether token metadata can be updated
  "verificationError": null, // string if canVerify is false
  "metadataError": null // string if canMetadata is false
}

Submit verification

jup vrfd submit --token <mint> --project-twitter @projecthandle --description "DeFi protocol on Solana"
jup vrfd submit --token <mint> --project-twitter @projecthandle --description "DEX aggregator" --key mykey
jup vrfd submit --token <mint> --project-twitter @projecthandle --description "Lending protocol" --sender-twitter @myhandle
jup vrfd submit --token <mint> --project-twitter @projecthandle --description "NFT marketplace" \
  --meta-name "Token Name" --meta-symbol "TKN" --meta-website "https://example.com"
jup vrfd submit --token <mint> --project-twitter @projecthandle --description "Payment token" --dry-run
  • --token (required) — token mint address to verify
  • --project-twitter (required) — project's Twitter/X handle or URL
  • --description (required) — reason for verification request
  • --sender-twitter sets the submitter's Twitter/X handle
  • --key overrides the active key for this transaction
  • --dry-run previews the payment transaction without signing. JSON response includes the unsigned base64 transaction.
  • Inline metadata options are listed under metadata options below
// Example JSON response:
{
  "sender": "ABC1...xyz", // sender wallet address
  "tokenId": "So11111111111111111111111111111111111111112", // token mint address
  "status": "Success", // "Success" or "Failed"
  "signature": "2Goj...diEc", // tx signature
  "paymentAmount": "1000", // JUP amount paid for verification
  "paymentMint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN", // payment token mint
  "feeUsd": 0.85, // USD value of fee
  "verificationCreated": true, // whether verification request was created
  "metadataCreated": false, // whether metadata was updated
  "metadata": null // token metadata object if --meta-* options were provided
}

Metadata options

Pass token metadata inline with --meta- prefixed options. All are optional.

String fields:

  • --meta-name <name>: Token name
  • --meta-symbol <symbol>: Token symbol/ticker
  • --meta-icon <url>: Token icon URL
  • --meta-description <text>: Token description
  • --meta-website <url>: Token website URL
  • --meta-twitter <url>: Token Twitter/X URL (distinct from --project-twitter, which is the project handle for the verification request)
  • --meta-twitter-community <url>: Twitter community URL
  • --meta-telegram <url>: Telegram group URL
  • --meta-discord <url>: Discord server URL
  • --meta-instagram <url>: Instagram URL
  • --meta-tiktok <url>: TikTok URL
  • --meta-circulating-supply <amount>: Circulating supply value
  • --meta-coingecko-coin-id <id>: CoinGecko coin identifier
  • --meta-circulating-supply-url <url>: Circulating supply API URL
  • --meta-other-url <url>: Additional URL

Boolean flags (no value needed):

  • --meta-use-circulating-supply: Enable circulating supply
  • --meta-use-coingecko-coin-id: Enable CoinGecko coin ID
  • --meta-use-circulating-supply-url: Enable circulating supply URL

Workflows

Submit for verification

jup vrfd submit --token <mint> --project-twitter @project --description "My token"

Submit with metadata update

jup vrfd submit --token <mint> --project-twitter @project --description "My token" \
  --meta-name "Token Name" --meta-symbol "TKN" \
  --meta-website "https://example.com" --meta-twitter "https://x.com/token"

Preview before submitting

jup vrfd submit --token <mint> --project-twitter @project --description "My token" --dry-run
# Review the details, then run without --dry-run
jup vrfd submit --token <mint> --project-twitter @project --description "My token"

Check eligibility (optional)

jup vrfd check --token <mint>

Use check to inspect eligibility details without submitting — submit already validates eligibility automatically.