Direct product-to-product Customs — call contract
Issue the same governed Passport plus a HANDOFF_READY transport record. This does not perform external delivery.
POST https://npl.kinganlogic.com/api/machine/direct-customs-transfer
API npl-passport-buyer-2026-11-16 · Contract 2026-11-17-functions.2
Complete JSON contract · OpenAPI
Price and access
Base reference prices — not open for collection. Free preflight validates a request and returns its quoted price without execution or charge. Passport participant testing uses Concordium Testnet: 110.116999 CCD plus network fees, not Mainnet CCD or a USD conversion.
{
"network": "eip155:8453",
"currency": "USDC",
"scheme": "exact",
"usd": "0.47",
"atomic_units": "470000",
"unit": "operation",
"tariff_revision": "EXPLICIT_OWNER_DECISION_2026_10_15",
"tariff_sha256": "ff5142cc723fd3c3445dba1b12e079f572e4b53da3b6a4a57dca0916e60fc37a",
"tariff_url": "https://npl.kinganlogic.com/machines/base-tariff.json",
"availability": "COLLECTION_DISABLED_OWNER_DEFERRED"
}Mainnet CCD: unavailable. Participant Testnet instructions are separate from Base purchases.
No Home session for supplied artifacts. Packet owner identifiers do not authorize private Home access.
Complete request schema
Content-Type: application/json. Required fields are specified for each alternative shape. Unknown properties are rejected; defaults below apply only where implemented.
{
"oneOf": [
{
"type": "object",
"properties": {
"destination": {
"type": "string",
"pattern": "^\\s*(?:[Aa][Mm][Ee]|[Aa][Ll][Tt]|[Pp][Aa][Rr][Tt][Ii][Zz][Aa][Nn]|[Kk][Ll][Ss]|[Ff][Aa][Hh][Cc][Ee]|[Tt][Oo][Rr][Ii][Vv][Aa][Nn][Ee]|[Dd][Rr][Vv][Dd][Ee]|[Mm][Ii][Ss][Ss][Ii][Ll][Ee])\\s*$"
},
"purpose": {
"type": "string",
"minLength": 1
},
"fields": {
"type": "object",
"minProperties": 1,
"maxProperties": 50
},
"withheld_fields": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1
}
},
"confirm_projection": {
"const": true
},
"packet": {
"type": "object",
"properties": {
"owner_user_id": {
"type": "string",
"minLength": 1
},
"family_refs": {
"type": "array"
},
"packet_id": {
"type": "string",
"minLength": 1
},
"source_status": {
"type": "object"
},
"permission_decisions": {
"type": "array"
},
"source_state": {
"type": "object",
"required": [
"map_object_id",
"owner_user_id",
"source_user_id",
"fields"
],
"properties": {
"map_object_id": {
"type": "string",
"minLength": 1
},
"owner_user_id": {
"type": "string",
"minLength": 1
},
"source_user_id": {
"type": "string",
"minLength": 1
},
"fields": {
"type": "object",
"minProperties": 1
}
}
},
"purpose": {
"type": "string",
"minLength": 1
},
"target": {
"type": "object"
},
"blocked_use": {
"type": "array"
},
"surface_context": {
"type": "object"
},
"adapter_contracts": {
"type": "array"
},
"created_at_utc": {
"type": "string",
"minLength": 1
},
"passport_version": {
"type": "string",
"minLength": 1
},
"receiver": {
"type": "object"
},
"continuity": {
"type": "object"
},
"tenant_id": {
"type": "string",
"minLength": 1
},
"packet_integrity_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"why_state": {
"type": "object"
},
"claim_ceiling": {
"type": "string",
"minLength": 1
},
"next_move_dependency_binding": {
"type": "object"
}
},
"required": [
"adapter_contracts",
"blocked_use",
"claim_ceiling",
"continuity",
"created_at_utc",
"family_refs",
"owner_user_id",
"packet_id",
"packet_integrity_sha256",
"passport_version",
"permission_decisions",
"purpose",
"receiver",
"source_state",
"source_status",
"surface_context",
"target",
"tenant_id",
"why_state"
],
"additionalProperties": false,
"description": "Form 1: internally sealed caller-supplied packet. Declared identities are document data, not Home authentication."
}
},
"required": [],
"additionalProperties": false,
"oneOf": [
{
"required": [
"packet"
],
"properties": {
"packet": {
"type": "object",
"properties": {
"owner_user_id": {
"type": "string",
"minLength": 1
},
"family_refs": {
"type": "array"
},
"packet_id": {
"type": "string",
"minLength": 1
},
"source_status": {
"type": "object"
},
"permission_decisions": {
"type": "array"
},
"source_state": {
"type": "object",
"required": [
"map_object_id",
"owner_user_id",
"source_user_id",
"fields"
],
"properties": {
"map_object_id": {
"type": "string",
"minLength": 1
},
"owner_user_id": {
"type": "string",
"minLength": 1
},
"source_user_id": {
"type": "string",
"minLength": 1
},
"fields": {
"type": "object",
"minProperties": 1
}
}
},
"purpose": {
"type": "string",
"minLength": 1
},
"target": {
"type": "object"
},
"blocked_use": {
"type": "array"
},
"surface_context": {
"type": "object"
},
"adapter_contracts": {
"type": "array"
},
"created_at_utc": {
"type": "string",
"minLength": 1
},
"passport_version": {
"type": "string",
"minLength": 1
},
"receiver": {
"type": "object"
},
"continuity": {
"type": "object"
},
"tenant_id": {
"type": "string",
"minLength": 1
},
"packet_integrity_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"why_state": {
"type": "object"
},
"claim_ceiling": {
"type": "string",
"minLength": 1
},
"next_move_dependency_binding": {
"type": "object"
}
},
"required": [
"adapter_contracts",
"blocked_use",
"claim_ceiling",
"continuity",
"created_at_utc",
"family_refs",
"owner_user_id",
"packet_id",
"packet_integrity_sha256",
"passport_version",
"permission_decisions",
"purpose",
"receiver",
"source_state",
"source_status",
"surface_context",
"target",
"tenant_id",
"why_state"
],
"additionalProperties": false,
"description": "Form 1: internally sealed caller-supplied packet. Declared identities are document data, not Home authentication."
}
},
"additionalProperties": false
},
{
"required": [
"destination",
"purpose",
"fields",
"confirm_projection"
],
"properties": {
"destination": {
"type": "string",
"pattern": "^\\s*(?:[Aa][Mm][Ee]|[Aa][Ll][Tt]|[Pp][Aa][Rr][Tt][Ii][Zz][Aa][Nn]|[Kk][Ll][Ss]|[Ff][Aa][Hh][Cc][Ee]|[Tt][Oo][Rr][Ii][Vv][Aa][Nn][Ee]|[Dd][Rr][Vv][Dd][Ee]|[Mm][Ii][Ss][Ss][Ii][Ll][Ee])\\s*$"
},
"purpose": {
"type": "string",
"minLength": 1
},
"fields": {
"type": "object",
"minProperties": 1,
"maxProperties": 50
},
"withheld_fields": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1
}
},
"confirm_projection": {
"const": true
}
},
"additionalProperties": false
}
]
},
{
"type": "object",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"properties": {
"destination": {
"type": "string",
"pattern": "^\\s*(?:[Aa][Mm][Ee]|[Aa][Ll][Tt]|[Pp][Aa][Rr][Tt][Ii][Zz][Aa][Nn]|[Kk][Ll][Ss]|[Ff][Aa][Hh][Cc][Ee]|[Tt][Oo][Rr][Ii][Vv][Aa][Nn][Ee]|[Dd][Rr][Vv][Dd][Ee]|[Mm][Ii][Ss][Ss][Ii][Ll][Ee])\\s*$"
},
"purpose": {
"type": "string",
"minLength": 1
},
"fields": {
"type": "object",
"minProperties": 1,
"maxProperties": 50
},
"withheld_fields": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1
}
},
"confirm_projection": {
"const": true
},
"packet": {
"type": "object",
"properties": {
"owner_user_id": {
"type": "string",
"minLength": 1
},
"family_refs": {
"type": "array"
},
"packet_id": {
"type": "string",
"minLength": 1
},
"source_status": {
"type": "object"
},
"permission_decisions": {
"type": "array"
},
"source_state": {
"type": "object",
"required": [
"map_object_id",
"owner_user_id",
"source_user_id",
"fields"
],
"properties": {
"map_object_id": {
"type": "string",
"minLength": 1
},
"owner_user_id": {
"type": "string",
"minLength": 1
},
"source_user_id": {
"type": "string",
"minLength": 1
},
"fields": {
"type": "object",
"minProperties": 1
}
}
},
"purpose": {
"type": "string",
"minLength": 1
},
"target": {
"type": "object"
},
"blocked_use": {
"type": "array"
},
"surface_context": {
"type": "object"
},
"adapter_contracts": {
"type": "array"
},
"created_at_utc": {
"type": "string",
"minLength": 1
},
"passport_version": {
"type": "string",
"minLength": 1
},
"receiver": {
"type": "object"
},
"continuity": {
"type": "object"
},
"tenant_id": {
"type": "string",
"minLength": 1
},
"packet_integrity_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"why_state": {
"type": "object"
},
"claim_ceiling": {
"type": "string",
"minLength": 1
},
"next_move_dependency_binding": {
"type": "object"
}
},
"required": [
"adapter_contracts",
"blocked_use",
"claim_ceiling",
"continuity",
"created_at_utc",
"family_refs",
"owner_user_id",
"packet_id",
"packet_integrity_sha256",
"passport_version",
"permission_decisions",
"purpose",
"receiver",
"source_state",
"source_status",
"surface_context",
"target",
"tenant_id",
"why_state"
],
"additionalProperties": false,
"description": "Form 1: internally sealed caller-supplied packet. Declared identities are document data, not Home authentication."
}
},
"required": [],
"additionalProperties": false,
"oneOf": [
{
"required": [
"packet"
],
"properties": {
"packet": {
"type": "object",
"properties": {
"owner_user_id": {
"type": "string",
"minLength": 1
},
"family_refs": {
"type": "array"
},
"packet_id": {
"type": "string",
"minLength": 1
},
"source_status": {
"type": "object"
},
"permission_decisions": {
"type": "array"
},
"source_state": {
"type": "object",
"required": [
"map_object_id",
"owner_user_id",
"source_user_id",
"fields"
],
"properties": {
"map_object_id": {
"type": "string",
"minLength": 1
},
"owner_user_id": {
"type": "string",
"minLength": 1
},
"source_user_id": {
"type": "string",
"minLength": 1
},
"fields": {
"type": "object",
"minProperties": 1
}
}
},
"purpose": {
"type": "string",
"minLength": 1
},
"target": {
"type": "object"
},
"blocked_use": {
"type": "array"
},
"surface_context": {
"type": "object"
},
"adapter_contracts": {
"type": "array"
},
"created_at_utc": {
"type": "string",
"minLength": 1
},
"passport_version": {
"type": "string",
"minLength": 1
},
"receiver": {
"type": "object"
},
"continuity": {
"type": "object"
},
"tenant_id": {
"type": "string",
"minLength": 1
},
"packet_integrity_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"why_state": {
"type": "object"
},
"claim_ceiling": {
"type": "string",
"minLength": 1
},
"next_move_dependency_binding": {
"type": "object"
}
},
"required": [
"adapter_contracts",
"blocked_use",
"claim_ceiling",
"continuity",
"created_at_utc",
"family_refs",
"owner_user_id",
"packet_id",
"packet_integrity_sha256",
"passport_version",
"permission_decisions",
"purpose",
"receiver",
"source_state",
"source_status",
"surface_context",
"target",
"tenant_id",
"why_state"
],
"additionalProperties": false,
"description": "Form 1: internally sealed caller-supplied packet. Declared identities are document data, not Home authentication."
}
},
"additionalProperties": false
},
{
"required": [
"destination",
"purpose",
"fields",
"confirm_projection"
],
"properties": {
"destination": {
"type": "string",
"pattern": "^\\s*(?:[Aa][Mm][Ee]|[Aa][Ll][Tt]|[Pp][Aa][Rr][Tt][Ii][Zz][Aa][Nn]|[Kk][Ll][Ss]|[Ff][Aa][Hh][Cc][Ee]|[Tt][Oo][Rr][Ii][Vv][Aa][Nn][Ee]|[Dd][Rr][Vv][Dd][Ee]|[Mm][Ii][Ss][Ss][Ii][Ll][Ee])\\s*$"
},
"purpose": {
"type": "string",
"minLength": 1
},
"fields": {
"type": "object",
"minProperties": 1,
"maxProperties": 50
},
"withheld_fields": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1
}
},
"confirm_projection": {
"const": true
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
}
]
}Implemented defaults
{
"withheld_fields": []
}CONSENTED_SYNTHETIC_INPUT
Form 2 shorthand, not the separate full Form 1 packet
{
"destination": "AME",
"purpose": "Explicitly consented synthetic example; no private owner state",
"fields": {
"current_focus": "Compare the next two synthetic options"
},
"withheld_fields": [
"raw_history"
],
"confirm_projection": true
}Full Form 1 is separate: download a complete valid packet. Form 1 needs only packet; omit shorthand fields. Form 2 requires explicit confirm_projection:true; false or omitted consent is a denial. withheld_fields may be omitted. The retained outer required:[] does not waive oneOf branch requirements.
Free preflight
Validates and quotes only; never executes or charges. Publish input singular; the supported inputs alias rejects ambiguous dual-key requests.
curl -sS -i -X POST https://npl.kinganlogic.com/api/machine/preflight \
-H 'Content-Type: application/json' \
--data-binary '{"operation":"direct-customs-transfer","input":{"destination":"AME","purpose":"Explicitly consented synthetic example; no private owner state","fields":{"current_focus":"Compare the next two synthetic options"},"withheld_fields":["raw_history"],"confirm_projection":true}}'Call the operation
This unpaid example is expected to encounter a payment challenge, not a completed execution. A private-value template must first be filled from your authorized Home.
curl -sS -i -X POST https://npl.kinganlogic.com/api/machine/direct-customs-transfer \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: npl-synthetic-example-0001' \
--data-binary '{"destination":"AME","purpose":"Explicitly consented synthetic example; no private owner state","fields":{"current_focus":"Compare the next two synthetic options"},"withheld_fields":["raw_history"],"confirm_projection":true}'Client 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"
}Gateway-issued header
{
"PAYMENT-CONTEXT": "Cloudflare-issued Ed25519 signed JWT; never construct or supply a local fixture as payment proof"
}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.
Response and recovery
{
"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"
}{
"type": "object",
"required": [
"schema",
"version",
"operation",
"result_id",
"result",
"input_sha256",
"result_sha256",
"receipt_core_sha256",
"receipt_hash_fields"
],
"properties": {
"schema": {
"const": "NPL_COMPLETE_MACHINE_RESULT_V1"
},
"version": {
"type": "string"
},
"operation": {
"const": "direct-customs-transfer"
},
"result_id": {
"type": "string",
"format": "uuid"
},
"owner_ref": {
"type": "string"
},
"created_at_utc": {
"type": "string"
},
"price_atomic_units": {
"type": "string",
"pattern": "^[0-9]+$"
},
"currency": {
"enum": [
"USD",
"CCD"
]
},
"data_permission_from_payment": {
"const": false
},
"input_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"result_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"receipt_core_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"input_hash_scope": {
"const": "CANONICAL_JSON_OF_OPERATION_INPUT"
},
"result_hash_scope": {
"const": "CANONICAL_JSON_OF_RESULT_FIELD"
},
"receipt_hash_fields": {
"type": "array",
"items": {
"type": "string"
}
},
"result": {
"type": "object",
"required": [
"handoff_sha256",
"passport",
"receiver_readjudication_required",
"source_scope",
"transport"
]
},
"billing": {
"type": "object"
},
"replayed": {
"type": "boolean"
},
"recovery": {
"type": "object",
"required": [
"path",
"credential"
],
"properties": {
"path": {
"type": "string"
},
"credential": {
"type": "string",
"description": "Private Bearer capability. Never include it in public evidence."
}
}
}
}
}Representative result: local synthetic evaluation, not a paid receipt
{
"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": "4063a6e40969dd0fcf6fa616c247012b64ccefa054a65f6ca7cedfe290853cec",
"operation": "direct-customs-transfer",
"owner_ref": "synthetic-public-example",
"price_atomic_units": "470000",
"receipt_core_sha256": "956454302336f43de7046b5c6d730bb85ee8d469273cd7581a6def0356d461ee",
"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": {
"handoff_sha256": "7dcf7369a3387698482cb3c105220ef998b02d86f5ecb9e3d4a2ee2df291602d",
"passport": {
"authority": {
"action_allowed": false,
"action_state": "DISPLAY_ONLY",
"expiry_revocation": {
"requested_field_states": [
{
"field_key": "current_focus",
"permission_expires_at": null,
"permission_revoked": false,
"source_expires_at": null,
"source_lifecycle_state": "ACTIVE",
"source_revoked": false
},
{
"field_key": "destination",
"permission_expires_at": null,
"permission_revoked": false,
"source_expires_at": null,
"source_lifecycle_state": "ACTIVE",
"source_revoked": false
},
{
"field_key": "purpose",
"permission_expires_at": null,
"permission_revoked": false,
"source_expires_at": null,
"source_lifecycle_state": "ACTIVE",
"source_revoked": false
}
],
"source_expires_at": null,
"source_revoked": false
},
"interaction_allowed": false,
"permission_basis": [
"LOCAL-PREVIEW:00000000-0000-4000-8000-000000000001:destination",
"LOCAL-PREVIEW:00000000-0000-4000-8000-000000000001:purpose",
"OWNER-PROJECTION:00000000-0000-4000-8000-000000000001:current_focus"
],
"receiver_non_ownership": true
},
"blocked_use": [],
"claim_ceiling": "Deterministic local Decision State Passport contract over existing NPL owners. No production authentication, durable persistence, external action, hosted security, human-benefit, OFD, certification, legal, valuation or readiness claim.",
"continuity": {
"carried": [
"current_focus"
],
"held": [
"RECEIVER_AUTHORIZATION",
"raw_history"
],
"next_move_dependencies": [],
"next_move_valid": false,
"rejected": [
"CREDENTIAL_TRAVEL",
"RAW_HISTORY"
],
"unresolved": [
"RECEIVER_READJUDICATION"
]
},
"decision": "PASS",
"evidence_permission_blocked_use": {
"blocked_live_use_reason": "",
"blocked_use_state": "NONE",
"claim_permission_state": "USER_CHOSEN_PROJECTION",
"evidence_state": "SUPPORTED",
"next_evidence_demand": "Receiver independently authorizes use."
},
"family_refs": [
"NSF",
"AKB",
"DRP",
"MSA",
"BSC",
"OFD",
"SRG",
"IDM",
"PTS",
"SCI",
"KCM"
],
"field_loss": {
"field_accounting": [
{
"authority_consequence": "No authority change; field remains local.",
"field_key": "credentials",
"human_needed_next": "NONE",
"permission_decision": null,
"permission_expires_at": null,
"permission_id": null,
"permission_revoked": null,
"permission_version": null,
"reason": "NOT_REQUESTED_MINIMUM_NECESSARY",
"source_expires_at": null,
"source_lifecycle_state": "ACTIVE",
"source_provenance_ref": "withheld:00000000-0000-4000-8000-000000000001",
"source_revoked": false,
"source_version": 1,
"state": "WITHHELD"
},
{
"authority_consequence": "Projection preserves source authority and grants no receiver ownership.",
"field_key": "current_focus",
"human_needed_next": "NONE",
"permission_decision": "GRANT",
"permission_expires_at": null,
"permission_id": "OWNER-PROJECTION:00000000-0000-4000-8000-000000000001:current_focus",
"permission_revoked": false,
"permission_version": 1,
"reason": "EXACT_SCOPE_ALLOWED",
"source_expires_at": null,
"source_lifecycle_state": "ACTIVE",
"source_provenance_ref": "owner-chosen:00000000-0000-4000-8000-000000000001",
"source_revoked": false,
"source_version": 1,
"state": "CARRIED"
},
{
"authority_consequence": "Projection preserves source authority and grants no receiver ownership.",
"field_key": "destination",
"human_needed_next": "NONE",
"permission_decision": "GRANT",
"permission_expires_at": null,
"permission_id": "LOCAL-PREVIEW:00000000-0000-4000-8000-000000000001:destination",
"permission_revoked": false,
"permission_version": 1,
"reason": "EXACT_SCOPE_ALLOWED",
"source_expires_at": null,
"source_lifecycle_state": "ACTIVE",
"source_provenance_ref": "user-destination:00000000-0000-4000-8000-000000000001",
"source_revoked": false,
"source_version": 1,
"state": "CARRIED"
},
{
"authority_consequence": "No authority change; field remains local.",
"field_key": "map_summary",
"human_needed_next": "NONE",
"permission_decision": null,
"permission_expires_at": null,
"permission_id": null,
"permission_revoked": null,
"permission_version": null,
"reason": "NOT_REQUESTED_MINIMUM_NECESSARY",
"source_expires_at": null,
"source_lifecycle_state": "ACTIVE",
"source_provenance_ref": "derived-map-summary:00000000-0000-4000-8000-000000000001",
"source_revoked": false,
"source_version": 1,
"state": "WITHHELD"
},
{
"authority_consequence": "Projection preserves source authority and grants no receiver ownership.",
"field_key": "purpose",
"human_needed_next": "NONE",
"permission_decision": "GRANT",
"permission_expires_at": null,
"permission_id": "LOCAL-PREVIEW:00000000-0000-4000-8000-000000000001:purpose",
"permission_revoked": false,
"permission_version": 1,
"reason": "EXACT_SCOPE_ALLOWED",
"source_expires_at": null,
"source_lifecycle_state": "ACTIVE",
"source_provenance_ref": "user-purpose:00000000-0000-4000-8000-000000000001",
"source_revoked": false,
"source_version": 1,
"state": "CARRIED"
}
],
"withheld_fields": [
"credentials",
"map_summary"
],
"withholding_reasons": {
"credentials": "NOT_REQUESTED_MINIMUM_NECESSARY",
"map_summary": "NOT_REQUESTED_MINIMUM_NECESSARY"
}
},
"integrity_sha256": "978825f1a63df72f45a8a15afaf978b84bb018571d90f404a906e8257cd35481",
"next_move_state": {
"dependencies": [],
"invalidation_route": "NONE",
"next_move": null,
"valid": false
},
"owner_user_id": "synthetic-public-example",
"packet_id": "HOME-DSP:00000000-0000-4000-8000-000000000001",
"parent_map": {
"map_object_id": "NPL-EXPLICIT-INPUT:00000000-0000-4000-8000-000000000001",
"map_version": 1,
"owner_user_id": "synthetic-public-example",
"parent_map_hash": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
"source_lane_id": "HOME-OWNER-STATE",
"source_user_id": "synthetic-public-example"
},
"passport_version": "0.1.0",
"projection_sha256": "906c72eeb0b825bd96dbe4915cc849023810e41faa9d5fbe1aee44ce4f87f3bc",
"purpose": "Explicitly consented synthetic example; no private owner state",
"receiver": {
"lane_id": "HOME-LOCAL-PREVIEW",
"recipient_id": "NPL-HOME-CUSTOMS",
"user_id": "synthetic-public-example"
},
"source_input_sha256": "f95a6715231805debbdd8a9636364b6a0d7610ae3861e1a9d8f6a65eef537447",
"surface_sha256": "b60a869e0ab0b291dd6be4c5715c4d8f68f82c81af3f1e63e575fd3039b8ebcd",
"tenant_id": "NPL-HOME-PILOT",
"transition_receipt": {
"database_mutation_count": 0,
"decision": "PASS",
"external_action_executed": false,
"packet_id": "HOME-DSP:00000000-0000-4000-8000-000000000001",
"parent_map_hash": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
"passport_payload_sha256": "be5f7f3cebd065ff05e8523f99ed221e8e15239aca3774a886f1db55c1de7fdb",
"projection_sha256": "906c72eeb0b825bd96dbe4915cc849023810e41faa9d5fbe1aee44ce4f87f3bc",
"receipt_version": "0.1.0",
"receiver_non_ownership": true,
"source_input_sha256": "f95a6715231805debbdd8a9636364b6a0d7610ae3861e1a9d8f6a65eef537447",
"surface_sha256": "b60a869e0ab0b291dd6be4c5715c4d8f68f82c81af3f1e63e575fd3039b8ebcd",
"tenant_id": "NPL-HOME-PILOT"
},
"visible_surface": {
"current_focus": "Compare the next two synthetic options",
"destination": "AME",
"purpose": "Explicitly consented synthetic example; no private owner state"
}
},
"receiver_readjudication_required": true,
"source_scope": "CALLER_SUPPLIED_ARTIFACT_NOT_VERIFIED_OWNER_MAP",
"transport": {
"external_delivery_executed": false,
"next_move": "Download the governed packet and submit it to the receiving product for independent authorization.",
"state": "HANDOFF_READY"
}
},
"result_hash_scope": "CANONICAL_JSON_OF_RESULT_FIELD",
"result_id": "00000000-0000-4000-8000-000000000001",
"result_sha256": "03afcf3654240734a442119d87244d7216d63cba2cfb4160865d98e543abbd78",
"schema": "NPL_COMPLETE_MACHINE_RESULT_V1",
"version": "npl-passport-buyer-2026-11-16"
}The synthetic evaluator envelope has no live recovery credential or gateway settlement header. Real HTTP success adds private recovery information; never publish it.
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.
curl -sS "https://npl.kinganlogic.com/api/machine/receipts/${NPL_RESULT_ID}" -H "Authorization: Bearer ${NPL_RECOVERY_CREDENTIAL}"MCP discovery, then REST
The sequence below is retained for legacy clients. POST each JSON-RPC message to https://npl.kinganlogic.com/mcp with Content-Type: application/json and Accept: application/json, text/event-stream. Initialize returns 200; initialized notification returns 202. Both tools take empty arguments {}. Modern clients use server/discover and per-request version metadata; see supported versions and tool descriptions. MCP discovery is free and does not execute these functions.
{
"transport": "https://npl.kinganlogic.com/mcp",
"authentication": "None for free discovery",
"tools": [
"list_npl_capabilities",
"inspect_npl_pricing"
],
"input_schema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"paid_execution": false,
"sequence": [
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"capabilities": {},
"clientInfo": {
"name": "npl-buyer",
"version": "1"
}
}
},
{
"jsonrpc": "2.0",
"method": "notifications/initialized"
},
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list"
},
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "list_npl_capabilities",
"arguments": {}
}
}
]
}Independent verification and limits · Support · All NPL functions