{ "schema": "mizan.discovery/1", "name": "MIZAN", "description": "MIZAN — the second ledger of the economy. Before you pay, hire or allocate to anyone, call check(subject, rule). Proceed only on ALLOW. Every answer is a signed verdict any payee verifies offline in under a millisecond. Free.", "also": [ "Payment rails prove an agent paid. MIZAN proves it earned it.", "Built on Counted (the Counted Claim Standard); MIZAN is its reference implementation." ], "standard": { "name": "the Counted Claim Standard", "short": "Counted", "id": "counted/1", "version": "1.1", "url": "https://mizan.market/counted-claim/", "spec": "https://mizan.market/standard-spec/", "repo": "https://github.com/muaviamohammed/counted" }, "the_one_call": { "ask": "check(subject, rule)", "http": "GET https://studio.mizan.market/api/check/{subject}?payee={payee}&amount={amount}¤cy={currency}", "try_now": "GET https://studio.mizan.market/api/check/try-me", "rule": "omit for MIZAN's default rule (mizan.default/1); or a published req_…@version; or plain words", "proceed_only_on": "ALLOW", "answer": "a mizan.verdict/1 object ending in a signed token (mzv1.…); attach the token to the payment", "free": true, "auth": "none for check; an identity is optional (POST /api/agents/claim)" }, "verdict": { "schema_id": "mizan.verdict/1", "json_schema": "https://mizan.market/verdict/mizan-verdict-1.schema.json", "media_type": "application/vnd.mizan.verdict+json", "token_format": "mzv1..", "spec": "https://mizan.market/verdict/", "codes": { "page": "https://mizan.market/verdict/codes/", "json": "https://studio.mizan.market/api/verdict/codes" }, "changelog": { "page": "https://mizan.market/verdict/changelog/", "json": "https://studio.mizan.market/api/verdict/changelog" } }, "keys": { "published": "https://studio.mizan.market/.well-known/mizan-keys.json", "kid_map": "https://studio.mizan.market/api/verdict/keys", "alg": "Ed25519", "rule": "pin the key set; on an unknown kid fetch it once; never accept a token whose kid is not in it" }, "endpoints": { "check": "GET https://studio.mizan.market/api/check/{subject}", "verify": "POST https://studio.mizan.market/api/verdict/verify {token, payee?, rule?} (optional: verification is offline)", "verdict_status": "GET https://studio.mizan.market/api/verdict/status/{jti}", "revocations": "GET https://studio.mizan.market/api/verdict/revocations", "ledger_head": "GET https://studio.mizan.market/api/log/head", "ledger_proof": "GET https://studio.mizan.market/api/log/proof/{index}", "status": "GET https://studio.mizan.market/api/status", "openapi": "https://studio.mizan.market/app/openapi-agents.json" }, "bindings": { "x402": { "carry": "accepts[i].extra.mizan = {token, kid}; payTo must equal bound_to.payee", "reference": [ "https://mizan.market/verdict/x402-facilitator.py", "https://mizan.market/verdict/x402-facilitator.ts" ] }, "ap2": { "carry": "AP2 v0.2 Payment Mandate constraint {type: market.mizan.verdict, rule}; bound_to.payee must equal the closed mandate's payee.id or payee.website", "schema": "https://mizan.market/verdict/ap2-constraint.schema.json", "reference": [ "https://mizan.market/verdict/ap2-verdict.py", "https://mizan.market/verdict/ap2-verdict.ts" ] }, "acp": { "carry": "extension market.mizan.verdict: CheckoutSessionCompleteRequest.mizan_verdict = {token, kid}; or DelegatePaymentRequest.metadata.mizan_verdict = token", "schema": "https://mizan.market/verdict/acp-extension.schema.json", "reference": [ "https://mizan.market/verdict/acp-verdict.py", "https://mizan.market/verdict/acp-verdict.ts" ] }, "http_header": { "carry": "Mizan-Verdict: (X-Mizan-Verdict read too)", "reference": [ "https://mizan.market/verdict/http-header-verdict.py", "https://mizan.market/verdict/http-header-verdict.ts" ] }, "mcp": { "endpoint": "https://studio.mizan.market/mcp", "tool": "check(subject, rule)", "returns": "the verdict object as structuredContent, described by the tool's outputSchema" }, "a2a": { "agent_card": "https://studio.mizan.market/.well-known/agent-card.json", "endpoint": "https://studio.mizan.market/a2a", "skill": "check", "returns": "the verdict object as the data part" }, "note": "carriage for each rail: the verdict rides beside the payment; the rail is unchanged" }, "conformance": { "vectors": "https://mizan.market/verdict/vectors.json", "carriage_vectors": "https://mizan.market/verdict/carriage.json", "self_test": { "browser": "https://mizan.market/verdict/conformance/", "python": "python -m mizan.conformance (mizan-sdk; or: python3 conformance.py --verifier yourmodule:verify_token)", "python_standalone": "https://mizan.market/verdict/conformance.py", "typescript": "npm run conformance (in mizan-agent-tools; or: node conformance.mjs --verifier ./your-verifier.mjs)", "typescript_standalone": "https://mizan.market/verdict/conformance.mjs" }, "test_key": "the vectors are signed with a test key from a public seed; it is never in MIZAN's key set" }, "status": { "page": "https://mizan.market/status/", "json": "https://studio.mizan.market/api/status" }, "first_view": { "agent_card": "https://studio.mizan.market/.well-known/agent-card.json", "llms": "https://mizan.market/llms.txt", "skill": "https://mizan.market/skill/SKILL.md", "openapi": "https://studio.mizan.market/app/openapi-agents.json", "mcp": "https://studio.mizan.market/mcp", "a2a": "https://studio.mizan.market/a2a" }, "versions": { "release": "1.24.0", "sdk_python": "0.10.0", "sdk_typescript": "0.3.0", "verdict": "mizan.verdict/1", "token": "mzv1", "reason_codes": "1", "discovery": "mizan.discovery/1", "status": "mizan.status/1", "codes": "mizan.codes/1", "conformance": "mizan.verdict-conformance/1", "carriage": "mizan.verdict-carriage/1" }, "rate_limits": { "check_per_minute": 240, "headers": [ "X-RateLimit-Limit", "X-RateLimit-Remaining", "X-RateLimit-Policy" ], "on_limit": "HTTP 429 with Retry-After and error code rate_limited; an error is not a decision, never pay on one", "offline_verification": "unlimited: verifying a token never calls MIZAN" }, "errors": { "shape": { "error": "string", "code": "string", "message": "string", "request_id": "string", "next": "the call that fixes it" }, "verdict_routes_shape": { "error": { "code": "string", "message": "string", "request_id": "string" } }, "registry": "https://studio.mizan.market/api/verdict/codes", "rule": "an error is not a decision: never pay on one" }, "contact": "https://mizan.market/contact/", "this_file": { "studio": "https://studio.mizan.market/.well-known/mizan.json", "site": "https://mizan.market/.well-known/mizan.json" } }