Finalize delegation of spending authority from Solana wallets (Step 3 of 3)
solanaBearer {access_token}application/jsonus for US-specific routing.Example: ?region=usNote: Alternatively, you can use the x-us-env: true header instead of the region query parameter.^[1-9A-HJ-NP-Za-km-z]{32,44}$Example: DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKKThis address must match the one that signed the delegation transaction.solana for Solana blockchain.Allowed values:solana - Solana mainnetusdc - USD Coin (SPL)usdt - Tether USD (SPL)^\d+(\.\d+)?$Example: "5000" or "5000.50"^[1-9A-HJ-NP-Za-km-z]{87,88}$Example: 5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUWThe API verifies this transaction exists on-chain and is confirmed.sigMessage with the wallet’s private key. Must be a valid base58-encoded signature (87-88 characters).Pattern: ^[1-9A-HJ-NP-Za-km-z]{87,88}$Example: 2Uhj5WqpLvZmJqKGx3WKvSC5K1m4YCp1eK3jcGY7GgRqNnBQEXhP9XjWCv4M3nZKF7RqWpLvZmJqKGx3WKvSC5K1"Prove wallet ownership for delegation"Recommended format: Include purpose, timestamp, and nonce for securityGET /v1/delegation/token (Step 1). Must be a valid UUID.Format: UUID v4Example: 100a99cf-f4d3-4fa1-9be9-2e9828b20ebcNote: Token expires after ~10 minutes or after successful use.| Code | Description |
|---|---|
| 201 | Wallet delegation completed successfully |
| 400 | Bad request - invalid data format or verification failed |
| 401 | Authentication failed - invalid or expired access token |
| 422 | Validation error - invalid request parameters |
| 498 | Invalid client key |
| 499 | Missing client key |
| 500 | Internal server error |
GET /v1/wallet/external endpoint responsesigMessage should be a clear, descriptive message. Here’s a recommended format:
sigHash doesn’t match the wallet that signedsigMessage was modified after signingsigMessage after user signs itbs58.encode() for signature encodingpublicKey.toBase58() to get correct format| Token | Mint Address |
|---|---|
| USDC | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v |
| USDT | Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB |
Transaction Confirmation
Wallet Support
Error Handling
Security
User Experience