{"api_version":"npl-passport-buyer-2026-11-16","base":{"atomic_units":"470000","availability":"COLLECTION_DISABLED_OWNER_DEFERRED","currency":"USDC","network":"eip155:8453","scheme":"exact","tariff_revision":"EXPLICIT_OWNER_DECISION_2026_10_15","tariff_sha256":"ff5142cc723fd3c3445dba1b12e079f572e4b53da3b6a4a57dca0916e60fc37a","tariff_url":"https://npl.kinganlogic.com/machines/base-tariff.json","unit":"operation","usd":"0.47"},"call_page":"https://npl.kinganlogic.com/machines/srg-exact-span-grounding","content_type":"application/json","contract_revision":"2026-11-17-functions.2","contract_url":"https://npl.kinganlogic.com/machines/srg-exact-span-grounding.json","example":{"exact_span":"Map belongs to its user","source_ref":"supplied-document:1","source_text":"The Map belongs to its user."},"example_scope":"Supplied input","example_status":"CONSENTED_SYNTHETIC_INPUT","family":"SRG","gateway_only_headers":{"PAYMENT-CONTEXT":"Cloudflare-issued Ed25519 signed JWT; never construct or supply a local fixture as payment proof"},"headers":{"Content-Type":"application/json","Idempotency-Key":"8..128 ASCII letters, digits, underscore or hyphen; retain for retries","PAYMENT-SIGNATURE":"Buyer wallet x402 authorization, only after an active Base gateway challenge","X-NPL-Buyer-Key":"Optional private random base64url retry key, 43..128 characters; persist before authorization"},"home_requirement":"No Home session for supplied artifacts. Packet owner identifiers do not authorize private Home access.","implementation_path":"Buyer Worker dispatch to the existing deterministic evaluator","implemented_defaults":{"source_ref":"supplied-source"},"mainnet_ccd":{"availability":"UNAVAILABLE_NO_APPROVED_OPERATION_TARIFF"},"mcp":{"authentication":"None for free discovery","input_schema":{"additionalProperties":false,"properties":{},"type":"object"},"paid_execution":false,"sequence":[{"id":1,"jsonrpc":"2.0","method":"initialize","params":{"capabilities":{},"clientInfo":{"name":"npl-buyer","version":"1"},"protocolVersion":"2025-03-26"}},{"jsonrpc":"2.0","method":"notifications/initialized"},{"id":2,"jsonrpc":"2.0","method":"tools/list"},{"id":3,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"list_npl_capabilities"}}],"tools":["list_npl_capabilities","inspect_npl_pricing"],"transport":"https://npl.kinganlogic.com/mcp"},"method":"POST","name":"Exact-span grounding","openapi":{"operationId":"srg_exact_span_grounding","url":"https://npl.kinganlogic.com/openapi.json"},"operation":"srg-exact-span-grounding","paid_call":"After owner activation, an x402-capable client obtains a gateway challenge and resends the same body with PAYMENT-SIGNATURE. Keep response headers and private result. The unpaid curl below deliberately does not authorize a debit.","participant_testnet":{"available":false,"instructions":null,"network_fees":"Separate buyer-paid fees","price_microccd":null,"scope":"Passport only; other operations are not offered on this rail"},"preflight_curl":"curl -sS -i -X POST https://npl.kinganlogic.com/api/machine/preflight \\\n  -H 'Content-Type: application/json' \\\n  --data-binary '{\"operation\":\"srg-exact-span-grounding\",\"input\":{\"source_text\":\"The Map belongs to its user.\",\"exact_span\":\"Map belongs to its user\",\"source_ref\":\"supplied-document:1\"}}'","purpose":"Find an exact span in supplied text and report its offsets and hashes. This does not verify factual truth or source identity.","recovery":{"authentication":"Authorization: Bearer <recovery.credential from the private original response>","curl":"curl -sS \"https://npl.kinganlogic.com/api/machine/receipts/${NPL_RESULT_ID}\" -H \"Authorization: Bearer ${NPL_RECOVERY_CREDENTIAL}\"","instructions":"Retain exact request, complete response, result_id and private recovery credential. Set the two variables from that response. Recovery requests do not debit. Wrong credentials return 404. For an interrupted Testnet response, retry the original order and transaction; do not transfer again.","method":"GET","url_template":"https://npl.kinganlogic.com/api/machine/receipts/{result_id}"},"request_schema":{"oneOf":[{"additionalProperties":false,"properties":{"exact_span":{"minLength":1,"type":"string"},"source_ref":{"type":"string"},"source_sha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"source_text":{"type":"string"}},"required":["source_text","exact_span"],"type":"object"},{"additionalProperties":false,"properties":{"input":{"additionalProperties":false,"properties":{"exact_span":{"minLength":1,"type":"string"},"source_ref":{"type":"string"},"source_sha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"source_text":{"type":"string"}},"required":["source_text","exact_span"],"type":"object"}},"required":["input"],"type":"object"}]},"responses":{"200":"Complete evaluated result or same recovered result. HOLD is a deliverable.","400":"Invalid schema, malformed JSON or invalid inner payload","401":"Invalid payment context","402":"Payment required; an application 402 alone is not gateway purchase evidence","403":"Currentness capability missing, expired, revoked or outside scope","404":"Private state or receipt unavailable","409":"Conflicting idempotency or paid request","410":"Retained result deleted","503":"Required private storage/provider unavailable"},"schema":"NPL_OPERATION_CONTRACT_V1","success_example":{"created_at_utc":"2026-11-16T00:00:00Z","currency":"USD","data_permission_from_payment":false,"hash_scheme":"NPL_CANONICAL_JSON_SHA256_V1","input_hash_scope":"CANONICAL_JSON_OF_OPERATION_INPUT","input_sha256":"84625f40a925496e075f75f50b2878933f35e63e821f2297633e9c7d90347240","operation":"srg-exact-span-grounding","owner_ref":"synthetic-public-example","price_atomic_units":"470000","receipt_core_sha256":"23fc0c77118b9406c2d645e492f8b5fc1accf225d6ae4834116743ae32b00a9c","receipt_hash_fields":["created_at_utc","currency","data_permission_from_payment","hash_scheme","input_hash_scope","input_sha256","operation","owner_ref","price_atomic_units","result","result_hash_scope","result_id","result_sha256","schema","version"],"result":{"claim_truth_verified":false,"decision":"EXACT_SPAN_SUPPORT","end":27,"source_origin_verified":false,"source_ref":"supplied-document:1","source_sha256":"060ee2d2ac6acebc43ca9429ee63b0e812bd884baf696dc737de3f68183cf555","span_sha256":"495aa451e7f62e20fa46a5f22254ad4f643890aabf44aa62c32884c1ac3b5eca","start":4,"verification_scope":"EXACT_TEXT_MATCH_IN_SUPPLIED_BODY"},"result_hash_scope":"CANONICAL_JSON_OF_RESULT_FIELD","result_id":"00000000-0000-4000-8000-000000000001","result_sha256":"9cfe7e5d642f7afc923db9fc7fbc281ae6edae640d649d9f505b44a09bca2230","schema":"NPL_COMPLETE_MACHINE_RESULT_V1","version":"npl-passport-buyer-2026-11-16"},"success_example_status":"LOCAL_SYNTHETIC_EVALUATOR_OUTPUT_NOT_PAID_ACCEPTANCE","success_schema":{"properties":{"billing":{"type":"object"},"created_at_utc":{"type":"string"},"currency":{"enum":["USD","CCD"]},"data_permission_from_payment":{"const":false},"input_hash_scope":{"const":"CANONICAL_JSON_OF_OPERATION_INPUT"},"input_sha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"operation":{"const":"srg-exact-span-grounding"},"owner_ref":{"type":"string"},"price_atomic_units":{"pattern":"^[0-9]+$","type":"string"},"receipt_core_sha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"receipt_hash_fields":{"items":{"type":"string"},"type":"array"},"recovery":{"properties":{"credential":{"description":"Private Bearer capability. Never include it in public evidence.","type":"string"},"path":{"type":"string"}},"required":["path","credential"],"type":"object"},"replayed":{"type":"boolean"},"result":{"required":["claim_truth_verified","decision","end","source_origin_verified","source_ref","source_sha256","span_sha256","start","verification_scope"],"type":"object"},"result_hash_scope":{"const":"CANONICAL_JSON_OF_RESULT_FIELD"},"result_id":{"format":"uuid","type":"string"},"result_sha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"schema":{"const":"NPL_COMPLETE_MACHINE_RESULT_V1"},"version":{"type":"string"}},"required":["schema","version","operation","result_id","result","input_sha256","result_sha256","receipt_core_sha256","receipt_hash_fields"],"type":"object"},"unpaid_curl":"curl -sS -i -X POST https://npl.kinganlogic.com/api/machine/srg-exact-span-grounding \\\n  -H 'Content-Type: application/json' \\\n  -H 'Idempotency-Key: npl-synthetic-example-0001' \\\n  --data-binary '{\"source_text\":\"The Map belongs to its user.\",\"exact_span\":\"Map belongs to its user\",\"source_ref\":\"supplied-document:1\"}'","url":"https://npl.kinganlogic.com/api/machine/srg-exact-span-grounding","verification":{"guide":"https://npl.kinganlogic.com/verification","offline":"https://npl.kinganlogic.com/capabilities/passport-oci","scope":"Canonical hashes and supplied-packet predicates, not issuer signatures, hardware attestation or settlement"}}