{"guide_contract":"bluecap.storefront.capability-guide.v1","capability_id":"evidence.verify","version":"1.0.0","deterministic":true,"description":"Verify a structured assurance record and its referenced evidence against the frozen Blue Cap verification contract. Returns a deterministic machine-readable verification result with provenance and assurance information for automated governance and audit workflows.","use_cases":[{"id":"AGENT_OUTPUT_VERIFICATION","description":"Verify a supplied assurance record and referenced evidence before accepting another machine's claimed result."},{"id":"MACHINE_COMMERCE_DELIVERY_VERIFICATION","description":"Verify structured evidence supplied with a machine-delivered service before relying on downstream output."},{"id":"GOVERNANCE_EVIDENCE_CHECK","description":"Validate supplied assurance and evidence integrity before accepting an operational claim."},{"id":"AUDIT_PIPELINE","description":"Verify structured assurance records before adding them to an audit evidence bundle."},{"id":"AGENT_TO_AGENT_TRUST","description":"Use deterministic evidence verification as an independent step between cooperating agents."}],"requirements":{"input":"A schema-valid evidence.verify request containing a compatible assurance record and every referenced evidence artifact.","payment":"An x402 v2 exact-compatible wallet on Base mainnet holding native USDC.","payload_limit_bytes":1000000},"schemas":{"input":"https://machine.soundiq.io/storefront/v1/schemas/evidence.verify-input-1.0.0.json","output":"https://machine.soundiq.io/storefront/v1/schemas/evidence.verify-output-1.0.0.json"},"examples":{"minimal_valid_request":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/examples/request","success_response":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/examples/success","failure_response":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/examples/failure"},"expected_result":"A deterministic verification status plus provenance, assurance and a commercial receipt after successful paid invocation.","commercial_terms":{"payment_protocol":"x402","payment_version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price_atomic":"1000","price_display":"0.001 USDC","invoke_endpoint":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/invoke","licence":{"authorised_invocations":1,"single_use":true,"replay_prevented":true}},"purchase_flow":["POST a valid request.","Read the HTTP 402 PAYMENT-REQUIRED header.","Select the Base native-USDC exact payment requirement.","Create an x402 authorization with a compatible wallet/client.","Resubmit the same request with PAYMENT-SIGNATURE and the same Idempotency-Key.","Receive the capability result, commercial receipt and bounded consumed authority."],"receipt_semantics":{"type":"commercial_receipt","one_per_execution":true,"verification_endpoint":"/storefront/v1/receipts/{receipt_id}/verify","verification_result":"VERIFIED means the receipt digest matches the stored canonical receipt."},"failure_modes":[{"code":"INVALID_SCHEMA","retry":"Correct the request before retrying."},{"code":"PAYMENT_REQUIRED","retry":"Authorize the exact advertised requirement, then resubmit."},{"code":"UNDERPAYMENT","retry":"Do not reuse the invalid authorization; create an exact authorization."},{"code":"PAYMENT_REPLAY","retry":"Do not replay; inspect the prior idempotent result or use new authority."},{"code":"RECONCILIATION_MISMATCH","retry":"Do not pay again; await operator reconciliation."},{"code":"CAPABILITY_DISABLED","retry":"Do not pay; retry only after service health is restored."}],"retry_semantics":{"idempotency_key_required":true,"same_key_same_request":"returns the stored response after completion","same_payment_new_key":"rejected as replay","ambiguous_payment":"do not retry payment"},"buy_if":["You possess a compatible x402 Base payment mechanism.","Your payload matches the input schema and contains compatible assurance/evidence data.","You need deterministic verification of supplied evidence under this contract."],"do_not_buy_if":["Your payload cannot satisfy the schema.","You require another network or asset.","You expect Blue Cap to establish truth beyond the supplied evidence and verification contract."],"support":{"questions":"https://machine.soundiq.io/storefront/v1/support","faq":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/faq","proof":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/proof","catalog":"https://machine.soundiq.io/storefront/v1/capabilities","openapi":"https://machine.soundiq.io/openapi.json","mcp":"https://machine.soundiq.io/mcp","health":"https://machine.soundiq.io/storefront/v1/health"},"limitations":"Verification establishes contract and evidence consistency; it does not independently establish real-world truth beyond supplied evidence.","buyer_transaction":{"transaction_contract":"bluecap.storefront.buyer-transaction.v1","next_actions":{"inspect_contract":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0","inspect_input_schema":"https://machine.soundiq.io/storefront/v1/schemas/evidence.verify-input-1.0.0.json","inspect_output_schema":"https://machine.soundiq.io/storefront/v1/schemas/evidence.verify-output-1.0.0.json","inspect_guide":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/guide","inspect_proof":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/proof","inspect_limitations":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/guide","inspect_faq":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/faq","inspect_example":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/examples/request","invoke":"https://machine.soundiq.io/storefront/v1/capabilities/evidence.verify/1.0.0/invoke","support":"https://machine.soundiq.io/storefront/v1/support"},"payment_protocol":{"name":"x402","version":2,"scheme":"exact","challenge_status":402,"challenge_header":"PAYMENT-REQUIRED","authorization_header":"PAYMENT-SIGNATURE"},"expected_payment_requirement":{"capability_id":"evidence.verify","capability_version":"1.0.0","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000","pay_to":"0x1944822de670f45899ddbddd8fdad8d4cc1a421d","x402_version":2,"scheme":"exact"},"payment_requirement_verification":{"instruction":"Before authorization, compare every listed field in the received HTTP 402 payment requirement with expected_payment_requirement.","required_matches":["capability_id","capability_version","network","asset","amount","pay_to","x402_version","scheme"],"on_mismatch":"DO_NOT_PAY","prohibitions":["Do not blindly sign or pay changed terms.","Do not grant unbounded or recurring spending authority.","Do not disclose wallet recovery or signing material.","Do not authorize unrelated token allowances."]},"invocation_flow":[{"step":1,"action":"Inspect this product contract, schemas, proof, limitations, example and health."},{"step":2,"action":"Prepare an input that validates against this product's input schema and choose one stable Idempotency-Key."},{"step":3,"action":"POST the input to next_actions.invoke without a payment signature to obtain the current HTTP 402 requirement."},{"step":4,"action":"Decode PAYMENT-REQUIRED and compare all payment_requirement_verification.required_matches. Stop without payment on any mismatch."},{"step":5,"action":"Using an x402 v2 exact-compatible Base wallet/client, authorize only the matching fixed requirement."},{"step":6,"action":"Resubmit the identical input and Idempotency-Key with the resulting PAYMENT-SIGNATURE."},{"step":7,"action":"Validate the response as instructed by result_validation and preserve the commercial_receipt and settlement identifiers."}],"result_validation":{"instruction":"Validate the response against the output schema and inspect capability_result.verification_result.status. VERIFIED establishes only the bounded result stated in this product guide.","result_field":"capability_result.verification_result.status"},"receipt_information":{"response_field":"commercial_receipt","preserve":["receipt_id","receipt_digest","transaction_id","licence_id","invocation_id"],"verification_endpoint":"https://machine.soundiq.io/storefront/v1/receipts/{receipt_id}/verify","instruction":"Preserve the returned commercial receipt. The verification endpoint checks its stored canonical digest; it does not broaden the product result."},"failure_safety":{"ambiguous_payment":"Do not authorize or submit another payment. Resolve status from the idempotent response, settlement evidence, or product support.","payment_replay":"Do not reuse payment authority.","invalid_input":"Correct the input before requesting payment again.","support":"https://machine.soundiq.io/storefront/v1/support"}}}