{"openapi": "3.1.0", "info": {"title": "Solana Rent & Rug Shield | 11-Layer Anti-Rug & x402 Solana Gateway API", "version": "2.1.0", "summary": "Sub-120ms 11-Layer Solana SPL & Token-2022 Pre-Buy Anti-Rug Scanner, Inner-CPI Drain Simulator, Non-Custodial SOL Rent Reclaim Engine, and Streamable HTTP MCP with native Solana x402 micropayments.", "description": "Official OpenAPI & x402scan discovery specification for Solana Rent & Rug Shield. Supports 2 free pings per agent/client followed by instant Solana mainnet x402 settlement to treasury 89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1: Option B (0.0003 SOL / 300000 lamports single scan) or Option A (0.026 SOL / 26000000 lamports Unlimited Pro Pass issuing X-Pro-Pass-Token).", "contact": {"name": "Solana Rent & Rug Shield Engineering", "url": "https://rentandrugshield.com"}, "license": {"name": "Proprietary Commercial & x402 Pay-Per-Call API", "url": "https://rentandrugshield.com/terms"}}, "servers": [{"url": "https://api.rentandrugshield.com", "description": "Production Solana x402 & Streamable HTTP MCP API Gateway"}, {"url": "https://rentandrugshield.com", "description": "Canonical Web & Discovery Origin"}], "x-x402": {"protocol": "x402", "x402Version": 1, "supportedX402Versions": [1, 2], "scheme": "exact", "network": "solana:mainnet-beta", "caip2Network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "treasury": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "freePingsLimit": 2, "discoveryUrl": "https://api.rentandrugshield.com/.well-known/x402", "mcpEndpoint": "https://api.rentandrugshield.com/mcp", "options": {"option_a_pro_pass": {"sol": 0.026, "lamports": 26000000, "usd": 1.99, "label": "$1.99 Unlimited Pro Pass"}, "option_b_single_scan": {"sol": 0.0003, "lamports": 300000, "usd": 0.02, "label": "Instant Single Scan"}}}, "tags": [{"name": "x402-token-audit", "description": "11-Layer Solana SPL & Token-2022 Pre-Buy Anti-Rug Audits (x402 enabled)"}, {"name": "x402-tx-simulation", "description": "Layer-9 Inner-CPI Transaction Drainer & Authority Hijack Simulation (x402 enabled)"}, {"name": "x402-wallet-rent", "description": "Non-Custodial Empty ATA & Token-2022 Rent Scanner & 95/5 Reclaim Builder (x402 enabled)"}, {"name": "mcp-x402", "description": "Zero-Install Streamable HTTP MCP Server & x402 Discovery"}, {"name": "rpc-proxy", "description": "Hardened Backend Solana Mainnet JSON-RPC 2.0 Proxy"}], "paths": {"/api/v1/shield-check": {"get": {"operationId": "getShieldCheck11Layer", "tags": ["x402-token-audit"], "summary": "11-Layer Pre-Buy Solana Token Anti-Rug & Token-2022 Safety Audit (GET)", "description": "Audits any Solana SPL or Token-2022 mint across 10 on-chain + liquidity layers. Includes 2 free pings, then HTTP 402 Solana x402 micropayment.", "x-x402": {"x402Version": 1, "supportedVersions": [1, 2], "scheme": "exact", "network": "solana:mainnet-beta", "caip2Network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "treasury": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "freePingsLimit": 2, "accepts": [{"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "300000", "amountSol": "0.0003", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/shield-check", "description": "11-Layer Solana Token Safety Audit (Option B: 0.0003 SOL single scan)", "mimeType": "application/json"}, {"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "26000000", "amountSol": "0.026", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/shield-check", "description": "11-Layer Solana Token Safety Audit (Option A: 0.026 SOL / $1.99 Unlimited Pro Pass)", "mimeType": "application/json"}]}, "security": [{"X402Payment": []}, {"X402PaymentSignature": []}, {"SolanaTxSignature": []}, {"X402ProPassToken": []}, {"RentShieldApiKey": []}, {}], "parameters": [{"name": "mint", "in": "query", "required": true, "description": "Solana token mint address (base58) or canonical blue-chip ticker (SOL, USDC, USDT, BONK, JUP, RAY, PYTH).", "schema": {"type": "string", "examples": ["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"]}}, {"$ref": "#/components/parameters/XPaymentHeader"}, {"$ref": "#/components/parameters/PaymentSignatureHeader"}, {"$ref": "#/components/parameters/XSolanaTxSignatureHeader"}, {"$ref": "#/components/parameters/XProPassTokenHeader"}, {"$ref": "#/components/parameters/XAgentIdHeader"}], "responses": {"200": {"description": "11-Layer token audit result", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TokenAuditResponse"}}}}, "400": {"$ref": "#/components/responses/BadRequest400"}, "402": {"$ref": "#/components/responses/PaymentRequired402"}, "429": {"$ref": "#/components/responses/RateLimited429"}}}, "post": {"operationId": "postShieldCheck11Layer", "tags": ["x402-token-audit"], "summary": "11-Layer Pre-Buy Solana Token Anti-Rug & Token-2022 Safety Audit (POST)", "description": "POST variant of the 11-layer Solana token safety gate for sniper bots and AI agents with native x402 settlement.", "x-x402": {"x402Version": 1, "supportedVersions": [1, 2], "scheme": "exact", "network": "solana:mainnet-beta", "caip2Network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "treasury": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "freePingsLimit": 2, "accepts": [{"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "300000", "amountSol": "0.0003", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/shield-check", "description": "11-Layer Solana Token Safety Audit (Option B: 0.0003 SOL single scan)", "mimeType": "application/json"}, {"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "26000000", "amountSol": "0.026", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/shield-check", "description": "11-Layer Solana Token Safety Audit (Option A: 0.026 SOL / $1.99 Unlimited Pro Pass)", "mimeType": "application/json"}]}, "security": [{"X402Payment": []}, {"X402PaymentSignature": []}, {"SolanaTxSignature": []}, {"X402ProPassToken": []}, {"RentShieldApiKey": []}, {}], "parameters": [{"$ref": "#/components/parameters/XPaymentHeader"}, {"$ref": "#/components/parameters/PaymentSignatureHeader"}, {"$ref": "#/components/parameters/XSolanaTxSignatureHeader"}, {"$ref": "#/components/parameters/XProPassTokenHeader"}, {"$ref": "#/components/parameters/XAgentIdHeader"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TokenAuditRequest"}}}}, "responses": {"200": {"description": "11-Layer token audit result", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TokenAuditResponse"}}}}, "400": {"$ref": "#/components/responses/BadRequest400"}, "402": {"$ref": "#/components/responses/PaymentRequired402"}, "429": {"$ref": "#/components/responses/RateLimited429"}}}}, "/api/scan-token": {"post": {"operationId": "scanSolanaToken", "tags": ["x402-token-audit"], "summary": "Interactive & Agent 11-Layer Solana Mint Safety Radar", "x-x402": {"x402Version": 1, "supportedVersions": [1, 2], "scheme": "exact", "network": "solana:mainnet-beta", "caip2Network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "treasury": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "freePingsLimit": 2, "accepts": [{"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "300000", "amountSol": "0.0003", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/scan-token", "description": "11-Layer Solana Mint Safety Radar (Option B: 0.0003 SOL single scan)", "mimeType": "application/json"}, {"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "26000000", "amountSol": "0.026", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/scan-token", "description": "11-Layer Solana Mint Safety Radar (Option A: 0.026 SOL / $1.99 Unlimited Pro Pass)", "mimeType": "application/json"}]}, "security": [{"X402Payment": []}, {"X402ProPassToken": []}, {}], "parameters": [{"$ref": "#/components/parameters/XPaymentHeader"}, {"$ref": "#/components/parameters/PaymentSignatureHeader"}, {"$ref": "#/components/parameters/XSolanaTxSignatureHeader"}, {"$ref": "#/components/parameters/XProPassTokenHeader"}, {"$ref": "#/components/parameters/XAgentIdHeader"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TokenAuditRequest"}}}}, "responses": {"200": {"description": "11-Layer token audit result", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/TokenAuditResponse"}}}}, "400": {"$ref": "#/components/responses/BadRequest400"}, "402": {"$ref": "#/components/responses/PaymentRequired402"}}}}, "/api/v1/simulate-tx": {"post": {"operationId": "simulateSolanaTxDrain", "tags": ["x402-tx-simulation"], "summary": "Layer-9 Inner-CPI Solana Transaction Drain & SetAuthority Hijack Simulator", "description": "Simulates an unsigned or signed base64/base58 Solana transaction pre-signature to detect SystemProgram::Assign owner hijacks, SPL SetAuthority/Approve drains, and hidden -0.001514 SOL transfer-hook traps.", "x-x402": {"x402Version": 1, "supportedVersions": [1, 2], "scheme": "exact", "network": "solana:mainnet-beta", "caip2Network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "treasury": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "freePingsLimit": 2, "accepts": [{"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "300000", "amountSol": "0.0003", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/simulate-tx", "description": "Layer-9 Inner-CPI Transaction Drain Simulator (Option B: 0.0003 SOL single scan)", "mimeType": "application/json"}, {"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "26000000", "amountSol": "0.026", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/simulate-tx", "description": "Layer-9 Inner-CPI Transaction Drain Simulator (Option A: 0.026 SOL / $1.99 Unlimited Pro Pass)", "mimeType": "application/json"}]}, "security": [{"X402Payment": []}, {"X402PaymentSignature": []}, {"SolanaTxSignature": []}, {"X402ProPassToken": []}, {}], "parameters": [{"$ref": "#/components/parameters/XPaymentHeader"}, {"$ref": "#/components/parameters/PaymentSignatureHeader"}, {"$ref": "#/components/parameters/XSolanaTxSignatureHeader"}, {"$ref": "#/components/parameters/XProPassTokenHeader"}, {"$ref": "#/components/parameters/XAgentIdHeader"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SimulateTxRequest"}}}}, "responses": {"200": {"description": "Simulation safety verdict", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SimulateTxResponse"}}}}, "400": {"$ref": "#/components/responses/BadRequest400"}, "402": {"$ref": "#/components/responses/PaymentRequired402"}}}}, "/api/v1/scan-wallet": {"get": {"operationId": "getScanWalletUnclaimedSol", "tags": ["x402-wallet-rent"], "summary": "Scan Solana Wallet for Reclaimable Empty ATA & Token-2022 Rent (GET)", "x-x402": {"x402Version": 1, "supportedVersions": [1, 2], "scheme": "exact", "network": "solana:mainnet-beta", "caip2Network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "treasury": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "freePingsLimit": 2, "accepts": [{"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "300000", "amountSol": "0.0003", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/scan-wallet", "description": "Solana Wallet Unclaimed SOL Rent Scan (Option B: 0.0003 SOL single scan)", "mimeType": "application/json"}, {"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "26000000", "amountSol": "0.026", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/scan-wallet", "description": "Solana Wallet Unclaimed SOL Rent Scan (Option A: 0.026 SOL / $1.99 Unlimited Pro Pass)", "mimeType": "application/json"}]}, "security": [{"X402Payment": []}, {"X402ProPassToken": []}, {}], "parameters": [{"name": "wallet", "in": "query", "required": true, "description": "Solana wallet public key (base58).", "schema": {"type": "string"}}, {"name": "include_token_2022", "in": "query", "required": false, "schema": {"type": "boolean", "default": true}}, {"$ref": "#/components/parameters/XPaymentHeader"}, {"$ref": "#/components/parameters/PaymentSignatureHeader"}, {"$ref": "#/components/parameters/XSolanaTxSignatureHeader"}, {"$ref": "#/components/parameters/XProPassTokenHeader"}, {"$ref": "#/components/parameters/XAgentIdHeader"}], "responses": {"200": {"description": "Wallet rent scan summary", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/WalletScanResponse"}}}}, "400": {"$ref": "#/components/responses/BadRequest400"}, "402": {"$ref": "#/components/responses/PaymentRequired402"}}}, "post": {"operationId": "postScanWalletUnclaimedSol", "tags": ["x402-wallet-rent"], "summary": "Scan Solana Wallet for Reclaimable Empty ATA & Token-2022 Rent (POST)", "x-x402": {"x402Version": 1, "supportedVersions": [1, 2], "scheme": "exact", "network": "solana:mainnet-beta", "caip2Network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "treasury": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "freePingsLimit": 2, "accepts": [{"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "300000", "amountSol": "0.0003", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/scan-wallet", "description": "Solana Wallet Unclaimed SOL Rent Scan (Option B: 0.0003 SOL single scan)", "mimeType": "application/json"}, {"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "26000000", "amountSol": "0.026", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/api/v1/scan-wallet", "description": "Solana Wallet Unclaimed SOL Rent Scan (Option A: 0.026 SOL / $1.99 Unlimited Pro Pass)", "mimeType": "application/json"}]}, "security": [{"X402Payment": []}, {"X402ProPassToken": []}, {}], "parameters": [{"$ref": "#/components/parameters/XPaymentHeader"}, {"$ref": "#/components/parameters/PaymentSignatureHeader"}, {"$ref": "#/components/parameters/XSolanaTxSignatureHeader"}, {"$ref": "#/components/parameters/XProPassTokenHeader"}, {"$ref": "#/components/parameters/XAgentIdHeader"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/WalletScanRequest"}}}}, "responses": {"200": {"description": "Wallet rent scan summary", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/WalletScanResponse"}}}}, "400": {"$ref": "#/components/responses/BadRequest400"}, "402": {"$ref": "#/components/responses/PaymentRequired402"}}}}, "/api/build-reclaim-tx": {"post": {"operationId": "buildReclaimRentTx", "tags": ["x402-wallet-rent"], "summary": "Build Unsigned Non-Custodial 0x09 CloseAccount Rent Reclaim Transaction (98.5% Net SOL User / 1.5% Repeat Fee; 0.0% 1st Claim Free)", "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/BuildReclaimTxRequest"}}}}, "responses": {"200": {"description": "Unsigned serialized transaction batch", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"$ref": "#/components/responses/BadRequest400"}}}}, "/mcp": {"post": {"operationId": "mcpStreamableHttpRpc", "tags": ["mcp-x402"], "summary": "Zero-Install Streamable HTTP MCP JSON-RPC 2.0 Endpoint (tools/list free, tools/call x402 gated)", "x-x402": {"x402Version": 1, "supportedVersions": [1, 2], "scheme": "exact", "network": "solana:mainnet-beta", "caip2Network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "treasury": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "freePingsLimit": 2, "accepts": [{"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "300000", "amountSol": "0.0003", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/mcp", "description": "Streamable HTTP MCP Security Tools (Option B: 0.0003 SOL single scan)", "mimeType": "application/json"}, {"scheme": "exact", "network": "solana:mainnet-beta", "maxAmountRequired": "26000000", "amountSol": "0.026", "asset": "SOL", "payTo": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1", "resource": "https://api.rentandrugshield.com/mcp", "description": "Streamable HTTP MCP Security Tools (Option A: 0.026 SOL / $1.99 Unlimited Pro Pass)", "mimeType": "application/json"}]}, "parameters": [{"$ref": "#/components/parameters/XPaymentHeader"}, {"$ref": "#/components/parameters/PaymentSignatureHeader"}, {"$ref": "#/components/parameters/XSolanaTxSignatureHeader"}, {"$ref": "#/components/parameters/XProPassTokenHeader"}, {"$ref": "#/components/parameters/XAgentIdHeader"}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object"}}}}, "responses": {"200": {"description": "MCP JSON-RPC 2.0 response", "content": {"application/json": {"schema": {"type": "object"}}}}, "402": {"$ref": "#/components/responses/PaymentRequired402"}}}}, "/.well-known/x402": {"get": {"operationId": "getWellKnownX402", "tags": ["mcp-x402"], "summary": "Canonical Solana x402 Payment Protocol Discovery Manifest", "responses": {"200": {"description": "x402 discovery manifest", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/v1/x402-info": {"get": {"operationId": "getX402GatewayInfo", "tags": ["mcp-x402"], "summary": "Solana x402 Gateway Pricing, Treasury & Tool Alias Directory", "responses": {"200": {"description": "x402 gateway manifest", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/rpc": {"post": {"operationId": "proxySolanaJsonRpc", "tags": ["rpc-proxy"], "summary": "Backend Solana Mainnet JSON-RPC 2.0 Proxy (Method-Allowlisted, Keyless Client Safe)", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object"}}}}, "responses": {"200": {"description": "JSON-RPC 2.0 response", "content": {"application/json": {"schema": {"type": "object"}}}}, "403": {"description": "Disallowed RPC method or blocked scanner"}, "429": {"$ref": "#/components/responses/RateLimited429"}}}}, "/api/health": {"get": {"operationId": "getHealth", "tags": ["mcp-x402"], "summary": "Service Health Heartbeat", "responses": {"200": {"description": "Healthy status", "content": {"application/json": {"schema": {"type": "object"}}}}}}}}, "components": {"securitySchemes": {"X402Payment": {"type": "apiKey", "in": "header", "name": "X-Payment", "description": "Base64-encoded JSON x402 payment payload or confirmed Solana mainnet transfer signature to treasury 89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1."}, "X402PaymentSignature": {"type": "apiKey", "in": "header", "name": "PAYMENT-SIGNATURE", "description": "x402 v2 payment signature header carrying base64 payment payload or Solana tx signature."}, "SolanaTxSignature": {"type": "apiKey", "in": "header", "name": "X-Solana-Tx-Signature", "description": "Confirmed base58 Solana mainnet transaction signature paying 0.0003 SOL (Option B) or 0.026 SOL (Option A)."}, "X402ProPassToken": {"type": "apiKey", "in": "header", "name": "X-Pro-Pass-Token", "description": "HMAC-signed Unlimited Pro Pass bearer token (x402pp_v1...) issued upon 0.026 SOL Option A settlement."}, "RentShieldApiKey": {"type": "apiKey", "in": "header", "name": "X-API-Key", "description": "Developer API key (rsk_live_...) generated via POST /api/v1/generate-key."}}, "parameters": {"XPaymentHeader": {"name": "X-Payment", "in": "header", "required": false, "description": "x402 v1 payment proof (base64 JSON payload or base58 Solana tx signature).", "schema": {"type": "string"}}, "PaymentSignatureHeader": {"name": "PAYMENT-SIGNATURE", "in": "header", "required": false, "description": "x402 v2 payment signature header.", "schema": {"type": "string"}}, "XSolanaTxSignatureHeader": {"name": "X-Solana-Tx-Signature", "in": "header", "required": false, "description": "Raw base58 Solana mainnet transaction signature transferring SOL to treasury.", "schema": {"type": "string"}}, "XProPassTokenHeader": {"name": "X-Pro-Pass-Token", "in": "header", "required": false, "description": "Unlimited Pro Pass token (x402pp_v1...) returned after Option A payment.", "schema": {"type": "string"}}, "XAgentIdHeader": {"name": "X-Agent-Id", "in": "header", "required": false, "description": "Stable autonomous agent identifier for 2 free pings tracking.", "schema": {"type": "string"}}}, "responses": {"BadRequest400": {"description": "Invalid request parameters", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ErrorResponse"}}}}, "RateLimited429": {"description": "Rate limit or daily demo quota exceeded", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ErrorResponse"}}}}, "PaymentRequired402": {"description": "HTTP 402 Payment Required | Solana x402 payment challenge returned after free ping allowance is exhausted.", "headers": {"PAYMENT-REQUIRED": {"description": "Base64-encoded x402 payment requirements JSON.", "schema": {"type": "string"}}, "WWW-Authenticate": {"description": "x402 challenge header specifying network, treasury, option_a_sol, and option_b_sol.", "schema": {"type": "string"}}, "X-402-Treasury": {"description": "Recipient Solana treasury wallet address.", "schema": {"type": "string", "example": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1"}}, "X-Free-Pings-Limit": {"description": "Free pings included per client.", "schema": {"type": "integer", "example": 2}}, "X-Free-Pings-Remaining": {"description": "Remaining free pings before x402 payment is required.", "schema": {"type": "integer", "example": 0}}}, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/X402PaymentRequiredResponse"}}}}}, "schemas": {"TokenAuditRequest": {"type": "object", "required": ["mint"], "properties": {"mint": {"type": "string", "description": "Solana mint address (base58) or canonical ticker."}}}, "LayerCheck": {"type": "object", "properties": {"layer": {"type": "integer"}, "key": {"type": "string"}, "name": {"type": "string"}, "passed": {"type": "boolean"}, "status": {"type": "string"}, "detail": {"type": "string"}, "severity": {"type": "string"}, "penalty": {"type": "integer"}}}, "TokenAuditResponse": {"type": "object", "required": ["ok", "mint", "symbol", "score", "verdict"], "properties": {"ok": {"type": "boolean"}, "mint": {"type": "string"}, "symbol": {"type": "string"}, "name": {"type": "string"}, "token_program": {"type": "string"}, "score": {"type": "integer", "minimum": 0, "maximum": 100}, "safety_score": {"type": "integer", "minimum": 0, "maximum": 100}, "safe_to_buy": {"type": "boolean"}, "verdict": {"type": "string"}, "price_usd": {"type": "number"}, "liquidity_usd": {"type": "number"}, "market_cap_usd": {"type": "number"}, "layers_checked": {"type": "integer"}, "layers_passed": {"type": "integer"}, "checklist_summary": {"type": "string"}, "checks": {"type": "array", "items": {"$ref": "#/components/schemas/LayerCheck"}}, "risks": {"type": "array", "items": {"type": "object"}}}}, "SimulateTxRequest": {"type": "object", "required": ["transaction"], "properties": {"transaction": {"type": "string", "description": "Base64 or base58 serialized Solana transaction."}, "wallet": {"type": "string", "description": "Optional signer wallet pubkey for SOL delta attribution."}, "encoding": {"type": "string", "enum": ["base64", "base58"], "default": "base64"}}}, "SimulateTxResponse": {"type": "object", "required": ["ok", "safe_to_sign", "risk_score", "verdict"], "properties": {"ok": {"type": "boolean"}, "safe": {"type": "boolean"}, "safe_to_sign": {"type": "boolean"}, "drain_detected": {"type": "boolean"}, "inner_cpi_drain": {"type": "boolean"}, "hidden_pda_rent_trap": {"type": "boolean"}, "risk_level": {"type": "string"}, "safety_score": {"type": "integer"}, "risk_score": {"type": "integer"}, "verdict": {"type": "string"}, "estimated_lamports_delta": {"type": "integer"}, "warnings": {"type": "array", "items": {"type": "string"}}}}, "WalletScanRequest": {"type": "object", "required": ["wallet"], "properties": {"wallet": {"type": "string", "description": "Solana wallet public key (base58)."}, "include_token_2022": {"type": "boolean", "default": true}}}, "WalletScanResponse": {"type": "object", "required": ["ok", "wallet", "total_reclaimable_sol"], "properties": {"ok": {"type": "boolean"}, "wallet": {"type": "string"}, "empty_count": {"type": "integer"}, "dust_count": {"type": "integer"}, "active_count": {"type": "integer"}, "total_reclaimable_lamports": {"type": "integer"}, "total_reclaimable_sol": {"type": "number"}, "user_net_95_sol": {"type": "number"}, "service_fee_5_sol": {"type": "number"}}}, "BuildReclaimTxRequest": {"type": "object", "required": ["wallet"], "properties": {"wallet": {"type": "string"}, "include_dust_burn": {"type": "boolean", "default": true}, "mode": {"type": "string", "default": "all"}}}, "X402AcceptEntry": {"type": "object", "required": ["scheme", "network", "maxAmountRequired", "payTo", "asset"], "properties": {"scheme": {"type": "string", "example": "exact"}, "network": {"type": "string", "example": "solana:mainnet-beta"}, "maxAmountRequired": {"type": "string", "example": "300000"}, "payTo": {"type": "string", "example": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1"}, "asset": {"type": "string", "example": "SOL"}, "resource": {"type": "string"}, "description": {"type": "string"}, "mimeType": {"type": "string", "example": "application/json"}}}, "X402PaymentRequiredResponse": {"type": "object", "required": ["x402Version", "error", "accepts"], "properties": {"ok": {"type": "boolean", "example": false}, "x402Version": {"type": "integer", "example": 1}, "error": {"type": "string"}, "treasury": {"type": "string", "example": "89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1"}, "accepts": {"type": "array", "items": {"$ref": "#/components/schemas/X402AcceptEntry"}}}}, "ErrorResponse": {"type": "object", "properties": {"ok": {"type": "boolean", "example": false}, "error": {"type": "string"}}}}}}