Create one receipt-driven workflow. Example: pass caller_approved=true, a session approval_v3, its idempotency_key, a caller-local session token, and the quote-bound verification_context. Economic guidance is advisory and adds no request field. The adapter validates approval and context before the upstream request. Every returned action is deeply verified and receives a caller-wallet handoff. AssetFare never signs or submits.
View input schema
{
"type": "object",
"properties": {
"caller_approved": {
"type": "boolean",
"const": true,
"description": "Legacy caller assertion that MUST be supplied explicitly. It is not human-proof and is never auto-inserted; approval_v3 adds server-enforced quote binding."
},
"from_chain": {
"type": "string",
"enum": [
"solana",
"base",
"arbitrum",
"robinhood",
"polygon",
"optimism",
"ethereum",
"hyperevm",
"xlayer",
"sei",
"sonic",
"monad",
"avalanche",
"cronos",
"injective",
"linea",
"aptos",
"unichain",
"ink"
],
"description": "Source chain for the v2 route. Polygon, Optimism, Ethereum, HyperEVM, X Layer, Sei, Sonic, Monad, Avalanche, Cronos, Injective, Linea, Aptos, Unichain, and Ink are source-only and cannot be used as to_chain."
},
"from_token": {
"type": "string",
"enum": [
"SOL",
"ETH",
"USDC",
"USDG"
],
"description": "Input token symbol on from_chain. The chain-token pair must appear in current v2 capabilities."
},
"to_chain": {
"type": "string",
"enum": [
"solana",
"base",
"arbitrum",
"robinhood"
],
"description": "Destination chain for the v2 route: Solana, Base, Arbitrum, or Robinhood Chain. Source-only chains are not destinations."
},
"to_token": {
"type": "string",
"enum": [
"SOL",
"ETH",
"USDC",
"USDG"
],
"description": "Output token symbol on to_chain. The chain-token pair must appear in current v2 capabilities."
},
"amount_usd": {
"type": "number",
"minimum": 1,
"description": "Requested input value in USD, minimum 1. USD 1 is reachability/schema smoke only. A USD 50 competitive bucket was observed only for dated 2026-09-23 Solana USDC to Base USDC evidence and must not be generalized to another corridor. USD 1,000 is the primary representative amount. SOL input includes a swap. Always quote the actual intended amount."
},
"wallets": {
"type": "object",
"additionalProperties": {
"type": "string",
"description": "Caller-owned public wallet address: 0x plus 40 hex characters for EVM, 0x plus 64 hex characters for Aptos, or 32-44 base58 characters for Solana. Never provide secret key material."
},
"propertyNames": {
"enum": [
"solana",
"base",
"arbitrum",
"robinhood",
"polygon",
"optimism",
"ethereum",
"hyperevm",
"xlayer",
"sei",
"sonic",
"monad",
"avalanche",
"cronos",
"injective",
"linea",
"aptos",
"unichain",
"ink"
]
},
"description": "Map each chain needed by this route to the caller's public wallet address. Include public addresses only; never private keys or seed phrases."
},
"event_signer_public": {
"$ref": "#/properties/wallets/additionalProperties",
"description": "Solana CCTP only: caller-generated ephemeral public key. Keep the matching private key client-side and use it to co-sign the returned unsigned event-account transaction; never send the private key."
},
"approval_v3": {
"type": "object",
"properties": {
"version": {
"type": "string",
"const": "assetfare-quote-bound-approval-v3"
},
"quote_id": {
"type": "string",
"format": "uuid"
},
"quote_fingerprint": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"selection_status": {
"type": "string",
"const": "selected"
},
"selected_mode": {
"type": "string",
"const": "session"
},
"maximum_input_base": {
"type": "string",
"pattern": "^[1-9][0-9]*$"
},
"minimum_output_base": {
"$ref": "#/properties/approval_v3/properties/maximum_input_base"
},
"direct_route_summary_sha256": {
"$ref": "#/properties/approval_v3/properties/quote_fingerprint"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$"
}
},
"required": [
"version",
"quote_id",
"quote_fingerprint",
"selection_status",
"selected_mode",
"maximum_input_base",
"minimum_output_base",
"direct_route_summary_sha256",
"idempotency_key"
],
"additionalProperties": false,
"description": "Strict Core 2.4.1 session quote-bound selection from the exact unexpired quote. Required for every remote session flow."
},
"session_token": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43,128}$",
"description": "Sensitive caller-generated v2 session capability: at least 32 CSPRNG bytes encoded as 43-128 URL-safe base64 characters. Generate it locally; never log it or substitute a private key or legacy access token."
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"description": "Caller-generated retry key, 8-128 characters. Reuse it only when retrying the same logical mutation; choose a new key for a new operation. Strict approval_v3 requests additionally enforce its ASCII key pattern."
},
"verification_context": {
"type": "object",
"properties": {
"version": {
"type": "string",
"const": "assetfare-session-verification-context-v1"
},
"intent": {
"type": "object",
"properties": {
"from_chain": {
"$ref": "#/properties/from_chain"
},
"from_token": {
"$ref": "#/properties/from_token"
},
"to_chain": {
"$ref": "#/properties/to_chain"
},
"to_token": {
"$ref": "#/properties/to_token"
},
"amount_usd": {
"$ref": "#/properties/amount_usd"
}
},
"required": [
"from_chain",
"from_token",
"to_chain",
"to_token",
"amount_usd"
],
"additionalProperties": false
},
"wallets": {
"$ref": "#/properties/wallets"
},
"event_signer_public": {
"anyOf": [
{
"$ref": "#/properties/event_signer_public"
},
{
"type": "null"
}
],
"description": "Solana CCTP only: caller-generated ephemeral public key. Keep the matching private key client-side and use it to co-sign the returned unsigned event-account transaction; never send the private key."
},
"approval_v3": {
"type": "object",
"properties": {
"version": {
"$ref": "#/properties/approval_v3/properties/version"
},
"quote_id": {
"$ref": "#/properties/approval_v3/properties/quote_id"
},
"quote_fingerprint": {
"$ref": "#/properties/approval_v3/properties/quote_fingerprint"
},
"selection_status": {
"$ref": "#/properties/approval_v3/properties/selection_status"
},
"selected_mode": {
"$ref": "#/properties/approval_v3/properties/selected_mode"
},
"maximum_input_base": {
"$ref": "#/properties/approval_v3/properties/maximum_input_base"
},
"minimum_output_base": {
"$ref": "#/properties/approval_v3/properties/maximum_input_base"
},
"direct_route_summary_sha256": {
"$ref": "#/properties/approval_v3/properties/quote_fingerprint"
},
"idempotency_key": {
"$ref": "#/properties/approval_v3/properties/idempotency_key"
}
},
"required": [
"version",
"quote_id",
"quote_fingerprint",
"selection_status",
"selected_mode",
"maximum_input_base",
"minimum_output_base",
"direct_route_summary_sha256",
"idempotency_key"
],
"additionalProperties": false
},
"direct_route_summary": {
"type": "object",
"properties": {
"version": {
"type": "string",
"const": "assetfare-direct-route-summary-v1"
},
"route": {
"type": "string",
"enum": [
"solana:SOL->solana:USDC",
"solana:SOL->solana:USDG",
"solana:SOL->base:ETH",
"solana:SOL->base:USDC",
"solana:SOL->arbitrum:ETH",
"solana:SOL->arbitrum:USDC",
"solana:SOL->robinhood:ETH",
"solana:SOL->robinhood:USDG",
"solana:USDC->solana:SOL",
"solana:USDC->solana:USDG",
"solana:USDC->base:ETH",
"solana:USDC->base:USDC",
"solana:USDC->arbitrum:ETH",
"solana:USDC->arbitrum:USDC",
"solana:USDC->robinhood:ETH",
"solana:USDC->robinhood:USDG",
"solana:USDG->solana:SOL",
"solana:USDG->solana:USDC",
"solana:USDG->base:ETH",
"solana:USDG->base:USDC",
"solana:USDG->arbitrum:ETH",
"solana:USDG->arbitrum:USDC",
"solana:USDG->robinhood:ETH",
"solana:USDG->robinhood:USDG",
"base:ETH->solana:SOL",
"base:ETH->solana:USDC",
"base:ETH->solana:USDG",
"base:ETH->base:USDC",
"base:ETH->arbitrum:ETH",
"base:ETH->arbitrum:USDC",
"base:ETH->robinhood:ETH",
"base:ETH->robinhood:USDG",
"base:USDC->solana:SOL",
"base:USDC->solana:USDC",
"base:USDC->solana:USDG",
"base:USDC->base:ETH",
"base:USDC->arbitrum:ETH",
"base:USDC->arbitrum:USDC",
"base:USDC->robinhood:ETH",
"base:USDC->robinhood:USDG",
"arbitrum:ETH->solana:SOL",
"arbitrum:ETH->solana:USDC",
"arbitrum:ETH->solana:USDG",
"arbitrum:ETH->base:ETH",
"arbitrum:ETH->base:USDC",
"arbitrum:ETH->arbitrum:USDC",
"arbitrum:ETH->robinhood:ETH",
"arbitrum:ETH->robinhood:USDG",
"arbitrum:USDC->solana:SOL",
"arbitrum:USDC->solana:USDC",
"arbitrum:USDC->solana:USDG",
"arbitrum:USDC->base:ETH",
"arbitrum:USDC->base:USDC",
"arbitrum:USDC->arbitrum:ETH",
"arbitrum:USDC->robinhood:ETH",
"arbitrum:USDC->robinhood:USDG",
"robinhood:ETH->solana:SOL",
"robinhood:ETH->solana:USDC",
"robinhood:ETH->solana:USDG",
"robinhood:ETH->base:ETH",
"robinhood:ETH->base:USDC",
"robinhood:ETH->arbitrum:ETH",
"robinhood:ETH->arbitrum:USDC",
"robinhood:ETH->robinhood:USDG",
"robinhood:USDG->solana:SOL",
"robinhood:USDG->solana:USDC",
"robinhood:USDG->solana:USDG",
"robinhood:USDG->base:ETH",
"robinhood:USDG->base:USDC",
"robinhood:USDG->arbitrum:ETH",
"robinhood:USDG->arbitrum:USDC",
"robinhood:USDG->robinhood:ETH",
"polygon:USDC->base:USDC",
"polygon:USDC->arbitrum:USDC",
"optimism:USDC->base:USDC",
"optimism:USDC->arbitrum:USDC",
"ethereum:USDC->solana:USDC",
"ethereum:USDC->base:USDC",
"hyperevm:USDC->solana:USDC",
"hyperevm:USDC->base:USDC",
"xlayer:USDC->solana:USDC",
"xlayer:USDC->base:USDC",
"sei:USDC->solana:USDC",
"sei:USDC->base:USDC",
"sonic:USDC->solana:USDC",
"sonic:USDC->base:USDC",
"monad:USDC->solana:USDC",
"monad:USDC->base:USDC",
"avalanche:USDC->solana:USDC",
"avalanche:USDC->base:USDC",
"cronos:USDC->solana:USDC",
"cronos:USDC->base:USDC",
"injective:USDC->solana:USDC",
"injective:USDC->base:USDC",
"linea:USDC->solana:USDC",
"linea:USDC->base:USDC",
"aptos:USDC->solana:USDC",
"aptos:USDC->base:USDC",
"unichain:USDC->solana:USDC",
"ink:USDC->solana:USDC"
]
},
"from": {
"type": "string",
"enum": [
"solana:SOL",
"solana:USDC",
"solana:USDG",
"base:ETH",
"base:USDC",
"arbitrum:ETH",
"arbitrum:USDC",
"robinhood:ETH",
"robinhood:USDG",
"polygon:USDC",
"optimism:USDC",
"ethereum:USDC",
"hyperevm:USDC",
"xlayer:USDC",
"sei:USDC",
"sonic:USDC",
"monad:USDC",
"avalanche:USDC",
"cronos:USDC",
"injective:USDC",
"linea:USDC",
"aptos:USDC",
"unichain:USDC",
"ink:USDC"
]
},
"to": {
"type": "string",
"enum": [
"solana:SOL",
"solana:USDC",
"solana:USDG",
"base:ETH",
"base:USDC",
"arbitrum:ETH",
"arbitrum:USDC",
"robinhood:ETH",
"robinhood:USDG"
]
},
"classification": {
"type": "string",
"enum": [
"direct_protocol_only",
"external_intent"
]
},
"mode": {
"type": "string",
"enum": [
"aptos_move_cctp_direct",
"cctp_direct_composition",
"optimism_source_cctp",
"polygon_source_cctp",
"robinhood_across_ingress_composition",
"robinhood_paxos_egress_composition",
"robinhood_paxos_ingress_composition",
"same_chain_direct",
"same_chain_direct_composition"
]
},
"product_classification": {
"type": "string",
"enum": [
"primary_direct",
"external_coverage_only"
]
},
"economic_eligibility": {
"type": "string",
"enum": [
"not_asserted_by_capability",
"coverage_only_not_primary"
]
},
"public_execution_eligible": {
"type": "boolean"
},
"primary_selection_eligible": {
"type": "boolean"
},
"route_minimum_guard_bps": {
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 500
},
{
"type": "null"
}
]
},
"route_aggregator_used": {
"type": "boolean",
"const": false
},
"external_intent_protocol_used": {
"type": "boolean"
},
"provider_internal_dex_aggregation_possible": {
"type": "boolean"
},
"assetfare_fee_bps": {
"type": "number",
"const": 1
},
"fee_collection_step_index": {
"type": "integer",
"minimum": 0,
"maximum": 7
},
"server_signing": {
"type": "boolean",
"const": false
},
"server_submission": {
"type": "boolean",
"const": false
},
"step_count": {
"type": "integer",
"minimum": 1,
"maximum": 8
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"index": {
"type": "integer",
"minimum": 0,
"maximum": 7
},
"action": {
"type": "string",
"enum": [
"swap",
"bridge",
"receive"
]
},
"provider": {
"type": "string",
"enum": [
"raydium_clmm",
"orca_whirlpool",
"uniswap_v3",
"circle_cctp",
"circle_cctp_receive",
"paxos_usdg_layerzero_oft",
"across_intent_bridge"
]
},
"from": {
"type": "string",
"enum": [
"solana:SOL",
"solana:USDC",
"solana:USDG",
"base:ETH",
"base:USDC",
"arbitrum:ETH",
"arbitrum:USDC",
"robinhood:ETH",
"robinhood:USDG",
"polygon:USDC",
"optimism:USDC",
"ethereum:USDC",
"hyperevm:USDC",
"xlayer:USDC",
"sei:USDC",
"sonic:USDC",
"monad:USDC",
"avalanche:USDC",
"cronos:USDC",
"injective:USDC",
"linea:USDC",
"aptos:USDC",
"unichain:USDC",
"ink:USDC"
]
},
"to": {
"type": "string",
"enum": [
"solana:SOL",
"solana:USDC",
"solana:USDG",
"base:ETH",
"base:USDC",
"arbitrum:ETH",
"arbitrum:USDC",
"robinhood:ETH",
"robinhood:USDG"
]
},
"expected_input_base": {
"type": "string",
"pattern": "^[1-9][0-9]*$"
},
"minimum_input_base": {
"type": "string",
"pattern": "^[1-9][0-9]*$"
},
"expected_output_base": {
"type": "string",
"pattern": "^[1-9][0-9]*$"
},
"minimum_output_base": {
"type": "string",
"pattern": "^[1-9][0-9]*$"
},
"assetfare_fee_bps": {
"type": "number",
"enum": [
0,
1
]
},
"minimum_guard_bps": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"direct_protocol": {
"type": "boolean"
},
"external_intent_protocol": {
"type": "boolean"
},
"aggregator_api_used": {
"type": "boolean",
"const": false
}
},
"required": [
"index",
"action",
"provider",
"from",
"to",
"expected_input_base",
"minimum_input_base",
"expected_output_base",
"minimum_output_base",
"assetfare_fee_bps",
"direct_protocol",
"external_intent_protocol",
"aggregator_api_used"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 8
}
},
"required": [
"version",
"route",
"from",
"to",
"classification",
"mode",
"route_aggregator_used",
"external_intent_protocol_used",
"provider_internal_dex_aggregation_possible",
"assetfare_fee_bps",
"fee_collection_step_index",
"server_signing",
"server_submission",
"step_count",
"steps"
],
"additionalProperties": false
},
"verification_context_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
}
},
"required": [
"version",
"intent",
"wallets",
"event_signer_public",
"approval_v3",
"direct_route_summary",
"verification_context_sha256"
],
"additionalProperties": false,
"description": "Strict caller-held context copied from the selected quote and approval. It contains public intent/wallet data only, never the raw session token or a private key, and is required whenever a remote MCP session call can return current_action."
}
},
"required": [
"caller_approved",
"from_chain",
"from_token",
"to_chain",
"to_token",
"amount_usd",
"wallets",
"approval_v3",
"session_token",
"idempotency_key",
"verification_context"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}