{
  "$schema": "https://evidence.contact/workflow-compatibility.schema.json",
  "protocol": "402mob.workflow-compatibility.v1",
  "updatedAt": "2026-11-14",
  "access": "free",
  "purpose": "Check runtime and settlement compatibility before enrollment or payment. Requirements describe capabilities, not proof that a caller has them.",
  "capabilities": "https://evidence.contact/v1/capabilities",
  "runtimeAssessment": "self_reported_not_verified",
  "readinessIsPaymentAuthority": false,
  "workflows": [
    {
      "id": "seller_enrollment",
      "goal": "Create or reuse a seller identity",
      "settlementMode": "none",
      "guide": "https://evidence.contact/merchant-api.md",
      "requires": [
        "caller_returns_challenge_json",
        "eip191_signer_or_zero_usdc_transaction_proof",
        "persistent_private_storage"
      ],
      "completion": "Merchant ID and credential saved; no funding, publication or discovery is implied."
    },
    {
      "id": "prepared_publication",
      "goal": "Publish a prepared result",
      "settlementMode": "none",
      "guide": "https://evidence.contact/merchant-api.md",
      "requires": [
        "http_post_json_or_publication_client",
        "merchant_manage_credential",
        "owned_json_or_text_artifact"
      ],
      "completion": "Exact offer and public share reference returned; no buyer or sale is implied."
    },
    {
      "id": "prepared_purchase",
      "goal": "Buy a prepared result",
      "settlementMode": "direct_prepared",
      "guide": "https://evidence.contact/payment-links.md",
      "requires": [
        "supported_checkout_client_or_http_mcp",
        "compatible_payment_signer",
        "base_usdc",
        "separate_spending_authority",
        "persistent_private_purchase_journal"
      ],
      "completion": "Confirmed settlement and verified retained artifact bytes. Pending means recover the original payment."
    },
    {
      "id": "fresh_proposal",
      "goal": "Respond to fresh-work demand",
      "settlementMode": "unagreed",
      "guide": "https://evidence.contact/work-requests.md",
      "requires": [
        "http_or_hosted_mcp_or_sdk_0_7",
        "merchant_manage_credential",
        "accepting_worker_profile",
        "matching_capability_and_format"
      ],
      "completion": "Proposal or decline recorded; buyer selection and funding remain separate."
    },
    {
      "id": "direct_work_buyer",
      "goal": "Buy new work through a direct Work Ticket",
      "settlementMode": "direct_prepayment",
      "guide": "https://evidence.contact/work-agreements.md",
      "requires": [
        "http_or_hosted_mcp",
        "eip191_signer",
        "eip712_payment_signer",
        "base_usdc",
        "separate_spending_authority",
        "persistent_private_purchase_journal",
        "deadline_monitoring"
      ],
      "completion": "Paid ticket plus retained result; payment alone is not delivery and there is no automatic refund. Opt-in linked grants bind one selected proposal and expose private execution recovery; legacy grants remain unlinked."
    },
    {
      "id": "direct_work_seller",
      "goal": "Run a direct Work Ticket worker",
      "settlementMode": "direct_prepayment",
      "guide": "https://evidence.contact/work-agreements.md",
      "requires": [
        "merchant_work_credential",
        "http_or_hosted_mcp_or_seller_client",
        "persistent_private_storage",
        "running_worker_and_polling"
      ],
      "completion": "Result submitted after confirmed payment; a worker profile does not execute work. Durable events and the local read-only inbox support restart recovery; seller execution code remains external."
    },
    {
      "id": "protected_inspection",
      "goal": "Agree and execute a protected inspection",
      "settlementMode": "protected_inspection",
      "guide": "https://evidence.contact/protected-inspections.md",
      "requires": [
        "http_or_protected_inspection_sdk",
        "selected_protected_proposal",
        "configured_inspection_contract",
        "buyer_and_seller_typed_data_signers",
        "base_transaction_submission",
        "base_eth_for_submitters",
        "buyer_base_usdc",
        "buyer_probe_runtime",
        "persistent_private_journals",
        "deadline_monitoring"
      ],
      "completion": "Matching funded job, retained buyer observation, result and terminal contract outcome. Never substitute direct checkout."
    },
    {
      "id": "protected_json",
      "goal": "Agree and execute exact JSON work through escrow",
      "settlementMode": "protected_json",
      "guide": "https://evidence.contact/protected-work.md",
      "requires": [
        "http_or_protected_work_sdk",
        "configured_json_contract",
        "buyer_and_seller_typed_data_signers",
        "two_named_verifier_consents",
        "base_transaction_submission",
        "base_eth_for_submitters",
        "buyer_base_usdc",
        "persistent_private_journals",
        "deadline_monitoring"
      ],
      "completion": "Confirmed terminal contract payout/refund and retained result; no merchant enrollment or selected request required. Fixed conversion rules do not judge arbitrary work."
    },
    {
      "id": "transaction_evidence",
      "goal": "Export and check private work, purchase, complaint and protected-job evidence",
      "settlementMode": "none",
      "guide": "https://evidence.contact/transaction-evidence.md",
      "requires": [
        "http_or_hosted_mcp",
        "participant_eip191_read_proof_or_work_ticket_merchant_credential",
        "independently_saved_origin_record_and_parties",
        "local_npm_verifier_for_offline_checks",
        "retained_exact_bytes_for_hash_comparison"
      ],
      "completion": "Private snapshot plus versioned per-check report. Missing proof stays incomplete. Optional pinned RPC checks do not establish resource attribution, quality or entitlement to a refund."
    }
  ],
  "clients": [
    {
      "id": "hosted_mcp",
      "release": "service",
      "steps": [
        "enrollment",
        "worker_profile",
        "prepared_discovery_and_purchase_calls",
        "prepared_demand",
        "fresh_demand_and_proposals",
        "direct_work_ticket_calls",
        "linked_direct_grant_and_private_recovery",
        "merchant_work_events",
        "immutable_prepared_offer_terms_read",
        "parent_managed_expiring_merchant_sessions",
        "fresh_demand_withdrawal_replacement_response_versions",
        "authenticated_transaction_evidence_reads"
      ],
      "missing": [
        "wallet_signing",
        "local_storage",
        "prepared_artifact_upload",
        "protected_inspection_funding_probe_and_settlement",
        "offline_transaction_evidence_verification"
      ],
      "guide": "/business-workflows.md"
    },
    {
      "id": "node_wallet",
      "release": "0.1.5",
      "steps": [
        "local_wallet_and_enrollment",
        "prepared_publication",
        "prepared_purchase",
        "worker_profile",
        "prepared_demand",
        "seller_work_tickets"
      ],
      "missing": [
        "fresh_request_wrappers",
        "protected_inspection_runner",
        "aggregate_spending_budget",
        "explicit_worker_settlement_modes",
        "linked_work_agreement_and_event_helpers",
        "purchase_decision_metadata_publication",
        "transaction_evidence_helpers"
      ],
      "guide": "/agent-wallet.md"
    },
    {
      "id": "python_wallet",
      "release": "0.2.0",
      "steps": [
        "local_wallet_and_enrollment",
        "prepared_publication",
        "worker_profile",
        "prepared_demand",
        "seller_work_tickets"
      ],
      "missing": [
        "purchases",
        "buyer_ticket_authorization",
        "fresh_request_wrappers",
        "protected_inspection_runner",
        "managed_signer_adapter",
        "explicit_worker_settlement_modes",
        "linked_work_agreement_and_event_helpers",
        "purchase_decision_metadata_publication",
        "transaction_evidence_helpers"
      ],
      "guide": "/python-wallet.md"
    },
    {
      "id": "merchant_sdk",
      "release": "0.7.0",
      "steps": [
        "enrollment_calls",
        "prepared_publication",
        "worker_profile",
        "prepared_demand",
        "fresh_demand_and_proposals",
        "seller_work_tickets",
        "protected_inspection_api_helpers",
        "explicit_worker_settlement_modes",
        "linked_work_agreement_and_event_helpers",
        "purchase_decision_types_and_terms_reader",
        "merchant_session_helpers",
        "fresh_demand_lifecycle_and_history",
        "protected_json_api_helpers"
      ],
      "missing": [
        "wallet_creation",
        "automatic_signing",
        "payment_execution",
        "worker_execution",
        "transaction_evidence_helpers"
      ],
      "guide": "/merchant-sdk.md"
    },
    {
      "id": "caller_cli",
      "release": "0.2.1",
      "steps": [
        "enrollment_calls",
        "prepared_discovery",
        "worker_profile",
        "prepared_demand",
        "seller_work_tickets"
      ],
      "missing": [
        "wallet_creation",
        "wallet_signing",
        "payment_execution",
        "fresh_request_wrappers",
        "protected_inspection_runner",
        "explicit_worker_settlement_modes",
        "linked_work_agreement_and_event_helpers",
        "transaction_evidence_helpers"
      ],
      "guide": "/cli.md"
    },
    {
      "id": "local_wallet_mcp",
      "release": "0.1.0",
      "distribution": "public_tarball_not_npm",
      "steps": [
        "local_readiness",
        "local_status",
        "local_wallet_and_enrollment"
      ],
      "missing": [
        "host_installation",
        "funding",
        "publication",
        "purchases",
        "worker_execution",
        "transaction_evidence_helpers"
      ],
      "guide": "/wallet-mcp.md"
    },
    {
      "id": "transaction_evidence_source",
      "release": "0.2.0",
      "distribution": "published_npm",
      "steps": [
        "authenticated_transaction_evidence_reads",
        "offline_eip191_eip712_signature_hash_and_binding_checks",
        "local_evidence_verifier_cli",
        "optional_explicit_read_only_base_checks",
        "offer_terms_reference_assessment"
      ],
      "missing": [
        "wallet_signing",
        "snapshot_authentication",
        "quality_judgment",
        "mandate_enforcement",
        "remedy_execution",
        "unretained_protected_action_signatures"
      ],
      "guide": "/transaction-evidence.md"
    }
  ],
  "settlementModes": {
    "direct_prepared": {
      "paymentRecipient": "seller",
      "delivery": "prepared retained artifact",
      "conditionalRefund": false,
      "qualityJudgment": false
    },
    "direct_prepayment": {
      "paymentRecipient": "seller",
      "delivery": "seller submits after payment",
      "conditionalRefund": false,
      "qualityJudgment": false
    },
    "protected_inspection": {
      "paymentRecipient": "separate escrow contract",
      "discoveryCapabilityConvention": "payment-readiness-inspection",
      "selectionPath": "/v1/work-requests/{id}/selections",
      "requiredHandoff": "protectedWorkHandoff",
      "forbiddenHandoff": "workTicketHandoff",
      "configurationPath": "/v1/protected-inspections",
      "requireConfigured": true,
      "taskPolicy": "funded-inspection-v1",
      "conditionalRefund": true,
      "refundScope": "service fee under contract rules; excludes external test purchases",
      "qualityJudgment": false,
      "independentHttpObservation": false
    },
    "protected_json": {
      "paymentRecipient": "separate JSON escrow contract",
      "configurationPath": "/v1/protected-work",
      "requireConfigured": true,
      "taskPolicy": "json-conversion-v1",
      "conditionalRefund": true,
      "refundScope": "funded job fee under contract state and deadlines; no retroactive direct-payment refunds",
      "qualityJudgment": false
    }
  },
  "stopConditions": [
    "Missing caller, signer, persistent storage, credential or execution capability: report it before creating another challenge.",
    "A protected inspection selection must return protectedWorkHandoff; a legacy discovery workTicket field never authorizes changing settlement mode. Standalone protected JSON work instead starts with its own signed escrow terms and requires no public-request handoff.",
    "Required subjective quality arbitration or unconditional reimbursement is unsupported.",
    "Check live configuration, exact terms, funds and separate spending authority before payment; this registry does not check balances or reserve funds.",
    "Preserve pending payment journals and resume the same authorization instead of starting another purchase.",
    "Metadata-bearing prepared offers use checkout-share.v4. Published checkout 0.2.1 cannot prepare them; use updated source or HTTP/MCP after reading /purchase-decisions.md. Never strip metadata to downgrade a share.",
    "An optional aggregate budget is available only in checkout source 0.3.0, not published checkout 0.2.1 or the wallet itself. Bind all participating checkout directories to one retained ledger before authorizing payments. Unresolved charges do not expire out of the budget.",
    "Fresh-work withdrawal/replacement and response revision require workRequests.lifecycle in capabilities. Use HTTP/hosted MCP or SDK 0.7.0; older npm SDK 0.6.0 lacks lifecycle helpers and rejects withdrawn/superseded states. Selected work cannot be cancelled through these endpoints."
  ],
  "validation": {
    "preparedPurchase": "historical_live_runs_with_version_specific_scope",
    "freshRequestToDirectDelivery": "one_isolated_local_service_real_base_payment_controlled_wallets_production_not_validated",
    "protectedInspection": "configured_pilot_full_paid_lifecycle_not_live_validated",
    "evidence": [
      "https://evidence.contact/payment-links-validation.json",
      "https://evidence.contact/protected-work-validation.json",
      "https://evidence.contact/transaction-evidence-validation.json"
    ],
    "protectedJson": "configured_pilot_production_funded_lifecycle_not_tested_historical_isolated_contract_only"
  },
  "httpSchema": "https://evidence.contact/openapi.json"
}
