{"uid":"cap_wRIzOVTluy54BuFbw2XL4","slug":"blockchain-money-map-x402-agent-commerce-digital-twin-51161535","name":"Blockchain Money Map x402 Agent Commerce Digital Twin","description":"Builds a sanitized go-live twin of an agent-commerce mission before a buyer allows payment, delegation, or live execution.","url":"https://api.blockchainmoneymap.com/api/x402/x402-agent-commerce-digital-twin?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["analyze","audit","check"]},"facts":{"type":"object","required":["mission_label","buyer_role","seller_role","agent_role","intended_outcome","allowed_task","amount_cap","currency","network","mcp_tool_name","x402_amount","x402_receiver_label","expected_output","receipt_requirement","rollback_contact"],"properties":{"expiry":{"type":"string","maxLength":500},"network":{"type":"string","maxLength":500},"currency":{"type":"string","maxLength":500},"agent_role":{"type":"string","maxLength":500},"amount_cap":{"type":"number"},"buyer_role":{"type":"string","maxLength":500},"known_gaps":{"type":"string","maxLength":500},"recurrence":{"type":"string","maxLength":500},"route_path":{"type":"string","maxLength":500},"max_retries":{"type":"number"},"seller_role":{"type":"string","maxLength":500},"x402_amount":{"type":"number"},"allowed_task":{"type":"string","maxLength":500},"retry_policy":{"type":"string","maxLength":500},"support_path":{"type":"string","maxLength":500},"mcp_tool_name":{"type":"string","maxLength":500},"mission_label":{"type":"string","maxLength":500},"allowed_payees":{"type":"array","maxItems":10},"provider_label":{"type":"string","maxLength":500},"agent_card_hash":{"type":"string","pattern":"^sha256:[a-fA-F0-9]{64}$"},"agent_skill_ids":{"type":"array","maxItems":10},"expected_output":{"type":"string","maxLength":500},"intended_outcome":{"type":"string","maxLength":500},"rollback_contact":{"type":"string","maxLength":500},"facilitator_label":{"type":"string","maxLength":500},"idempotency_policy":{"type":"string","maxLength":500},"human_presence_mode":{"type":"string","maxLength":500},"receipt_requirement":{"type":"string","maxLength":500},"x402_receiver_label":{"type":"string","maxLength":500},"agent_card_url_label":{"type":"string","maxLength":500},"declared_limitations":{"type":"array","maxItems":10},"human_return_triggers":{"type":"array","maxItems":10},"wallet_policy_summary":{"type":"string","maxLength":500}},"additionalProperties":false},"policy":{"type":"object","additionalProperties":true},"reference_facts":{"type":"object","required":["mission_label","buyer_role","seller_role","agent_role","intended_outcome","allowed_task","amount_cap","currency","network","mcp_tool_name","x402_amount","x402_receiver_label","expected_output","receipt_requirement","rollback_contact"],"properties":{"expiry":{"type":"string","maxLength":500},"network":{"type":"string","maxLength":500},"currency":{"type":"string","maxLength":500},"agent_role":{"type":"string","maxLength":500},"amount_cap":{"type":"number"},"buyer_role":{"type":"string","maxLength":500},"known_gaps":{"type":"string","maxLength":500},"recurrence":{"type":"string","maxLength":500},"route_path":{"type":"string","maxLength":500},"max_retries":{"type":"number"},"seller_role":{"type":"string","maxLength":500},"x402_amount":{"type":"number"},"allowed_task":{"type":"string","maxLength":500},"retry_policy":{"type":"string","maxLength":500},"support_path":{"type":"string","maxLength":500},"mcp_tool_name":{"type":"string","maxLength":500},"mission_label":{"type":"string","maxLength":500},"allowed_payees":{"type":"array","maxItems":10},"provider_label":{"type":"string","maxLength":500},"agent_card_hash":{"type":"string","pattern":"^sha256:[a-fA-F0-9]{64}$"},"agent_skill_ids":{"type":"array","maxItems":10},"expected_output":{"type":"string","maxLength":500},"intended_outcome":{"type":"string","maxLength":500},"rollback_contact":{"type":"string","maxLength":500},"facilitator_label":{"type":"string","maxLength":500},"idempotency_policy":{"type":"string","maxLength":500},"human_presence_mode":{"type":"string","maxLength":500},"receipt_requirement":{"type":"string","maxLength":500},"x402_receiver_label":{"type":"string","maxLength":500},"agent_card_url_label":{"type":"string","maxLength":500},"declared_limitations":{"type":"array","maxItems":10},"human_return_triggers":{"type":"array","maxItems":10},"wallet_policy_summary":{"type":"string","maxLength":500}},"additionalProperties":false}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm___asWpsewbiYVtXWn4UU9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes, audits, or checks an agent commerce transaction definition against a structured digital twin schema to validate mission parameters, roles, payment caps, and compliance rules for x402-paid agent interactions.","exampleAgentPrompt":"Audit my x402 agent commerce mission called 'Token Swap Execution' where the buyer is a treasury agent, the seller is a DEX aggregator agent, the agent role is executor, the intended outcome is a completed token swap, the allowed task is swap-only, amount cap is 50 USDC on Base network, the MCP tool is 'dex-swap', x402 amount is 0.01, receiver label is 'DEX-Aggregator', expected output is a swap receipt, receipt requirement is on-chain, and rollback contact is ops@myprotocol.com — run it in analyze mode.","exampleUseCases":[{"title":"Pre-flight audit for autonomous payment agent","prompt":"Before I let my payment agent run, analyze this mission spec called 'Invoice Settlement Bot': buyer is accounts-payable agent, seller is vendor-payment-api, agent role is payment-executor, intended outcome is settled invoice, allowed task is payment-only, amount cap 500 USDC on Ethereum, MCP tool name 'invoice-pay', x402 amount 0.01, receiver label 'Vendor-API', expected output is payment confirmation, receipt requirement is on-chain, rollback contact is finance@mycompany.com — run in analyze mode."},{"title":"Compliance check for multi-role DeFi agent mission","prompt":"Run a compliance check on my DeFi agent commerce definition called 'Yield Harvest Mission': buyer is vault-manager-agent, seller is yield-protocol-agent, agent role is harvester, intended outcome is yield collected, allowed task is harvest-only, amount cap 200 USDC on Base, MCP tool 'yield-harvest', x402 amount 0.01, receiver label 'Yield-Protocol', expected output is harvest receipt, receipt requirement is logged, rollback contact is admin@vaultprotocol.xyz — use check mode."},{"title":"Audit agent task permissions before deployment","prompt":"Before deploying my NFT-minting agent, audit the mission spec 'NFT Mint Agent': buyer is collector-agent, seller is mint-service-agent, agent role is minter, intended outcome is NFT minted to wallet, allowed task is mint-only, amount cap 10 USDC on Base, MCP tool 'nft-mint', x402 amount 0.01, receiver label 'Mint-Service', expected output is token ID and transaction hash, receipt requirement is on-chain, rollback contact is support@nftplatform.io — run audit mode."}],"resultDescription":"Returns a JSON report evaluating the submitted agent commerce digital twin specification, including validation status of all required fields, role consistency checks, payment cap compliance, x402 parameter correctness, identified gaps or misconfigurations, and any compliance flags related to receipt requirements, idempotency policy, or rollback provisions.","failureModes":["Missing required fields in the facts object returns a validation error listing absent properties","Invalid mode enum value (not analyze/audit/check) returns a 400 bad request","Malformed agent_card_hash not matching sha256 hex pattern returns schema validation failure","amount_cap or x402_amount type mismatch (non-numeric) causes a parse error","allowed_payees or agent_skill_ids exceeding 10 items triggers array limit error","Payment failure or x402 authentication error returns 402 with payment requirements","Network or currency values that are unrecognized may return an unknown-field warning in the audit"],"whenToPreferThis":"Choose this endpoint when you need to pre-validate or audit a structured agent commerce mission definition before execution, especially in x402-paid autonomous agent workflows involving defined buyer/seller/agent roles, MCP tool bindings, payment caps, and receipt requirements. It is distinct from generic wallet audit or transaction decode endpoints on the same platform — those inspect historical on-chain data, while this endpoint validates a prospective agent mission specification against a digital twin schema for compliance and completeness.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:43:51.231Z","isFirstParty":false,"canonicalSlug":"blockchain-money-map-x402-agent-commerce-digital-twin-51161535"}