@ixo/topic-protocol 0.8.0 → 1.0.0-rc.1

package/README.md

@@ -9,7 +9,10 @@ identity of a discussion.
 
 ## Status
 
-**Version:** 0.8.0
+**Version:** 1.0.0-rc.1
+
+The normative Topic Shape progression and Portal Now projection are defined in
+[Topic Shape Framework v1](docs/topic-shape-framework.md).
 
 **Maturity:** Draft implementation candidate  
 **Execution source of truth:** [Linear Topic Protocol project](https://linear.app/ixo-world/project/topic-protocol-4ea58bc7910d)
@@ -25,6 +28,7 @@ and external action execution require their dedicated conformance evidence.
 - [Why Topics matter](docs/topics-feature-guide.md) — a non-technical feature guide
 - [Extending Topic Kinds](docs/extending-topic-kinds.md) — third-party custom Kind and Kind Profile guide
 - [Decision-to-Pay templates](templates/decision-to-pay/README.md) — governed payment decision contract pack
+- [Topic Outcome Achievement evaluation kit](evaluation-kits/topic-outcome-achievement/README.md) — ledger-ready deterministic outcome evaluation release
 - [Protocol chapters](docs/protocol/README.md)
 - [Machine-readable contracts](contracts/README.md)
 - [Reference implementation](docs/reference-implementation.md)
@@ -149,6 +153,7 @@ api/                  OpenAPI and MCP contract surfaces
 scripts/              Dependency-free validation and integrity tooling
 checksums/            Reproducible SHA-256 manifest
 templates/            Machine-readable Topic Template packs
+evaluation-kits/      Ledger-ready governed evaluation releases
 src/                  TypeScript contract and projection reference library
 test/                 TDD contract, behavior, and edge-case tests
 ```

package/dist/schemas/decision-to-pay-template-v2.schema.json

@@ -0,0 +1,301 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/decision-to-pay-template-v2.schema.json",
+    "title": "IXO Decision-to-Pay Topic Template manifest v2",
+    "description": "A Claims-native Decision-to-Pay template. The Topic binds and projects the work case; the Deed and IXO Claims module remain authoritative.",
+    "type": "object",
+    "required": [
+        "$schema",
+        "version",
+        "id",
+        "templateVersion",
+        "label",
+        "description",
+        "maturity",
+        "compatibility",
+        "topic",
+        "authorities",
+        "actors",
+        "resources",
+        "lifecycle",
+        "capabilityPolicy",
+        "pilotPolicy",
+        "settlement",
+        "privacy",
+        "acceptanceCriteria"
+    ],
+    "properties": {
+        "$schema": { "type": "string", "minLength": 1 },
+        "version": { "const": 2 },
+        "id": { "type": "string", "pattern": "^urn:ixo:decision-to-pay:template:[a-z0-9-]+$" },
+        "templateVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+        "label": { "type": "string", "minLength": 1, "maxLength": 120 },
+        "description": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "maturity": { "enum": ["draft", "incubating", "candidate", "stable"] },
+        "compatibility": { "$ref": "#/$defs/compatibility" },
+        "topic": { "$ref": "#/$defs/topic" },
+        "authorities": { "$ref": "#/$defs/authorities" },
+        "actors": {
+            "type": "array",
+            "minItems": 4,
+            "items": { "$ref": "#/$defs/actor" }
+        },
+        "resources": {
+            "type": "array",
+            "minItems": 7,
+            "items": { "$ref": "#/$defs/resource" }
+        },
+        "lifecycle": {
+            "type": "array",
+            "minItems": 10,
+            "items": { "$ref": "#/$defs/lifecycleStep" }
+        },
+        "capabilityPolicy": { "$ref": "#/$defs/capabilityPolicy" },
+        "pilotPolicy": { "$ref": "#/$defs/pilotPolicy" },
+        "settlement": { "$ref": "#/$defs/settlement" },
+        "privacy": { "$ref": "#/$defs/privacy" },
+        "acceptanceCriteria": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/acceptanceCriterion" }
+        }
+    },
+    "additionalProperties": false,
+    "$defs": {
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "jsonPointer": { "type": "string", "pattern": "^/" },
+        "compatibility": {
+            "type": "object",
+            "required": ["protocolPackage", "protocolVersion", "sourceCommit", "claimsModule", "sdkVersion", "implementationStatus", "requiredExtensions"],
+            "properties": {
+                "protocolPackage": { "const": "@ixo/topic-protocol" },
+                "protocolVersion": { "const": "0.8.0" },
+                "sourceCommit": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+                "claimsModule": { "enum": ["v7", "v8"] },
+                "sdkVersion": { "const": "3.0.0" },
+                "implementationStatus": { "enum": ["design_ready", "candidate_contract", "implemented"] },
+                "requiredExtensions": {
+                    "type": "array",
+                    "minItems": 2,
+                    "uniqueItems": true,
+                    "items": { "type": "string", "minLength": 1 }
+                },
+                "constraints": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+            },
+            "additionalProperties": false
+        },
+        "topic": {
+            "type": "object",
+            "required": ["kind", "profile", "domain", "role", "bindingPaths", "lifecyclePolicy"],
+            "properties": {
+                "kind": { "const": "org.ixo.job-card" },
+                "profile": { "const": "https://topic-protocol.ixo.world/profiles/job-card" },
+                "domain": { "const": "deed" },
+                "role": { "const": "contract_binder_and_message_thread" },
+                "bindingPaths": {
+                    "type": "object",
+                    "required": ["deed", "claimCollection", "manifest", "claimSchema", "rubric"],
+                    "properties": {
+                        "deed": { "const": "/bindings/deed" },
+                        "claimCollection": { "const": "/bindings/claimCollection" },
+                        "manifest": { "const": "/bindings/verifiedWorkPaymentManifest" },
+                        "claimSchema": { "const": "/bindings/claimSchema" },
+                        "rubric": { "const": "/bindings/rubric" }
+                    },
+                    "additionalProperties": false
+                },
+                "lifecyclePolicy": {
+                    "type": "object",
+                    "required": ["topicIsProjection", "chainStateIsAuthoritative", "resolveRule"],
+                    "properties": {
+                        "topicIsProjection": { "const": true },
+                        "chainStateIsAuthoritative": { "const": true },
+                        "resolveRule": { "type": "string", "minLength": 1 }
+                    },
+                    "additionalProperties": false
+                }
+            },
+            "additionalProperties": false
+        },
+        "authorities": {
+            "type": "object",
+            "required": ["workPackage", "conversation", "claims", "evaluation", "orchestration"],
+            "properties": {
+                "workPackage": { "const": "deed" },
+                "conversation": { "const": "job_topic" },
+                "claims": { "const": "ixo.claims.v1beta1" },
+                "evaluation": { "const": "ixo_evaluation_engine" },
+                "orchestration": { "const": "ixo_portal" }
+            },
+            "additionalProperties": false
+        },
+        "actor": {
+            "type": "object",
+            "required": ["role", "identity", "capabilities"],
+            "properties": {
+                "role": { "enum": ["deed_owner", "payer", "service_agent", "evaluation_engine", "human_evaluator", "adjudicator"] },
+                "identity": { "const": "did" },
+                "required": { "type": "boolean" },
+                "capabilities": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": { "type": "string", "minLength": 1 }
+                },
+                "constraints": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+            },
+            "additionalProperties": false
+        },
+        "resource": {
+            "type": "object",
+            "required": ["role", "type", "required", "authority", "binding", "confidentiality"],
+            "properties": {
+                "role": { "enum": ["deed", "payment_terms", "payable_obligation", "bid_schema", "claim_schema", "claim_collection", "rubric", "evaluation_receipt", "evidence"] },
+                "type": { "type": "string", "minLength": 1 },
+                "required": { "type": "boolean" },
+                "authority": { "enum": ["deed", "bound_resource", "ixo_claims_module", "evaluation_engine"] },
+                "binding": { "enum": ["topic_binding", "deed_linked_resource", "claims_record", "content_addressed_receipt", "vfs_attachment"] },
+                "schemaRef": { "type": "string", "format": "uri-reference" },
+                "confidentiality": { "enum": ["public", "room_encrypted", "vfs_ucan", "claims_module"] },
+                "notes": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false
+        },
+        "lifecycleStep": {
+            "type": "object",
+            "required": ["sequence", "id", "authority", "result"],
+            "properties": {
+                "sequence": { "type": "integer", "minimum": 1, "maximum": 20 },
+                "id": { "enum": ["validate-deed", "create-job-topic", "submit-bid", "accept-bid-and-grant", "claim-intent", "submit-claim", "evaluate-evidence", "record-evaluation", "project-payment", "dispute-and-adjudicate"] },
+                "authority": { "enum": ["deed", "job_topic", "bids_service", "cosmos_authz", "ixo_claims_module", "evaluation_engine", "ixo_portal"] },
+                "messageType": {
+                    "enum": [
+                        "/ixo.claims.v1beta1.MsgClaimIntent",
+                        "/ixo.claims.v1beta1.MsgSubmitClaim",
+                        "/ixo.claims.v1beta1.MsgEvaluateClaim",
+                        "/ixo.claims.v1beta1.MsgDisputeClaim",
+                        "/ixo.claims.v1beta1.MsgAdjudicateDispute",
+                        "/cosmos.authz.v1beta1.MsgGrant"
+                    ]
+                },
+                "preconditions": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+                "result": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false
+        },
+        "capabilityPolicy": {
+            "type": "object",
+            "required": ["submitClaimAuthorization", "evaluateClaimAuthorization", "engineUcan", "revocationTriggers"],
+            "properties": {
+                "submitClaimAuthorization": {
+                    "type": "object",
+                    "required": ["typeUrl", "requiredConstraints", "deriveFromAcceptedBid", "expiryBound"],
+                    "properties": {
+                        "typeUrl": { "const": "/ixo.claims.v1beta1.SubmitClaimAuthorization" },
+                        "requiredConstraints": {
+                            "type": "array",
+                            "minItems": 5,
+                            "uniqueItems": true,
+                            "items": { "enum": ["collectionId", "agentQuota", "maxAmount", "intentDurationNs", "memberAddress"] }
+                        },
+                        "deriveFromAcceptedBid": { "const": true },
+                        "expiryBound": { "const": "min(job_end,collection_end)" }
+                    },
+                    "additionalProperties": false
+                },
+                "evaluateClaimAuthorization": {
+                    "type": "object",
+                    "required": ["typeUrl", "requiredConstraints", "expiryBound"],
+                    "properties": {
+                        "typeUrl": { "const": "/ixo.claims.v1beta1.EvaluateClaimAuthorization" },
+                        "requiredConstraints": {
+                            "type": "array",
+                            "minItems": 4,
+                            "uniqueItems": true,
+                            "items": { "enum": ["collectionId", "claimIds", "agentQuota", "beforeDate", "maxCustomAmount"] }
+                        },
+                        "expiryBound": { "const": "collection_end" }
+                    },
+                    "additionalProperties": false
+                },
+                "engineUcan": {
+                    "type": "object",
+                    "required": ["abilities", "audienceBound", "resourceBound", "timeBound", "revocable", "environmentBound"],
+                    "properties": {
+                        "abilities": {
+                            "type": "array",
+                            "minItems": 1,
+                            "uniqueItems": true,
+                            "items": { "enum": ["ixo:matrix-claims-bot", "subscriptions/read"] }
+                        },
+                        "audienceBound": { "const": true },
+                        "resourceBound": { "const": true },
+                        "timeBound": { "const": true },
+                        "revocable": { "const": true },
+                        "environmentBound": { "const": true }
+                    },
+                    "additionalProperties": false
+                },
+                "revocationTriggers": {
+                    "type": "array",
+                    "minItems": 4,
+                    "uniqueItems": true,
+                    "items": { "enum": ["job_cancelled", "job_completed", "job_expired", "bidder_removed", "security_incident"] }
+                }
+            },
+            "additionalProperties": false
+        },
+        "pilotPolicy": {
+            "type": "object",
+            "required": ["intentPolicy", "assetType", "payoutTimeoutNs", "mainnetEvaluationMode", "testnetAutomation", "deferredFeatures"],
+            "properties": {
+                "intentPolicy": { "const": "REQUIRED" },
+                "assetType": { "const": "native" },
+                "payoutTimeoutNs": { "const": "0" },
+                "mainnetEvaluationMode": { "const": "HUMAN_SIGNED" },
+                "testnetAutomation": { "const": "CAPPED" },
+                "deferredFeatures": {
+                    "type": "array",
+                    "minItems": 4,
+                    "uniqueItems": true,
+                    "items": { "enum": ["cw20", "cw1155", "team_budgets", "delayed_withdrawal", "mainnet_automation", "other_decision_to_pay_templates"] }
+                }
+            },
+            "additionalProperties": false
+        },
+        "settlement": {
+            "type": "object",
+            "required": ["templateMovesFunds", "claimsModuleMovesFunds", "authority", "adapter", "approvalTrigger", "disputeRecourse"],
+            "properties": {
+                "templateMovesFunds": { "const": false },
+                "claimsModuleMovesFunds": { "const": true },
+                "authority": { "const": "ixo.claims.v1beta1" },
+                "adapter": { "const": "canonical_impactxclient_sdk" },
+                "approvalTrigger": { "const": "MsgEvaluateClaim(APPROVED)" },
+                "disputeRecourse": { "const": "deposit_slashing_and_adjudication_not_payment_reversal" }
+            },
+            "additionalProperties": false
+        },
+        "privacy": {
+            "type": "object",
+            "required": ["topicIsConfidentialityBoundary", "topicCapabilityGrantsVfsAccess", "sensitiveResourceStorage", "receiptExcludesPii"],
+            "properties": {
+                "topicIsConfidentialityBoundary": { "const": false },
+                "topicCapabilityGrantsVfsAccess": { "const": false },
+                "sensitiveResourceStorage": { "const": "encrypted_room_or_ucan_vfs" },
+                "receiptExcludesPii": { "const": true }
+            },
+            "additionalProperties": false
+        },
+        "acceptanceCriterion": {
+            "type": "object",
+            "required": ["id", "statement", "verification"],
+            "properties": {
+                "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+                "statement": { "type": "string", "minLength": 1 },
+                "verification": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false
+        }
+    }
+}

package/dist/schemas/payable-obligation-v2.schema.json

@@ -0,0 +1,319 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/payable-obligation-v2.schema.json",
+    "title": "IXO Claims-native Payable Obligation projection v2",
+    "description": "A read-only projection of authoritative Deed, AuthZ and IXO Claims module state. It cannot approve, evaluate, settle or reverse payment.",
+    "type": "object",
+    "required": [
+        "$schema",
+        "version",
+        "type",
+        "id",
+        "projectionAuthority",
+        "observedAt",
+        "observedHeight",
+        "deedDid",
+        "topicId",
+        "state",
+        "paymentTerms",
+        "collection",
+        "acceptedBid",
+        "submitAuthorization",
+        "intent",
+        "claim",
+        "evaluation",
+        "payment",
+        "disputes",
+        "sourceRefs"
+    ],
+    "properties": {
+        "$schema": { "type": "string", "minLength": 1 },
+        "version": { "const": 2 },
+        "type": { "const": "org.ixo.payable-obligation" },
+        "id": { "type": "string", "pattern": "^urn:ixo:payable-obligation:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "projectionAuthority": { "const": "ixo_claims_module" },
+        "observedAt": { "type": "string", "format": "date-time" },
+        "observedHeight": { "$ref": "#/$defs/positiveUint" },
+        "deedDid": { "$ref": "#/$defs/did" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "state": {
+            "enum": [
+                "awaiting_authorization",
+                "awaiting_intent",
+                "intent_active",
+                "claim_submitted",
+                "awaiting_evaluation",
+                "flagged",
+                "approved",
+                "rejected",
+                "invalidated",
+                "paid",
+                "payment_failed",
+                "disputed"
+            ]
+        },
+        "paymentTerms": { "$ref": "#/$defs/resourceRef" },
+        "collection": { "$ref": "#/$defs/collectionProjection" },
+        "acceptedBid": { "$ref": "#/$defs/bidProjection" },
+        "submitAuthorization": { "$ref": "#/$defs/authorizationProjection" },
+        "intent": { "$ref": "#/$defs/intentProjection" },
+        "claim": { "$ref": "#/$defs/claimProjection" },
+        "evaluation": { "$ref": "#/$defs/evaluationProjection" },
+        "payment": { "$ref": "#/$defs/paymentProjection" },
+        "disputes": { "type": "array", "items": { "$ref": "#/$defs/disputeProjection" } },
+        "sourceRefs": {
+            "type": "array",
+            "minItems": 3,
+            "items": { "$ref": "#/$defs/resourceRef" }
+        }
+    },
+    "additionalProperties": false,
+    "allOf": [
+        {
+            "if": {
+                "type": "object",
+                "properties": {
+                    "evaluation": {
+                        "type": "object",
+                        "properties": { "status": { "enum": ["APPROVED", "REJECTED", "FLAGGED", "INVALIDATED"] } },
+                        "required": ["status"]
+                    }
+                },
+                "required": ["evaluation"]
+            },
+            "then": {
+                "type": "object",
+                "properties": {
+                    "evaluation": {
+                        "type": "object",
+                        "properties": {
+                            "chain": { "$ref": "#/$defs/chainRef" },
+                            "receipt": { "$ref": "#/$defs/receiptProjection" }
+                        },
+                        "required": ["chain", "receipt"]
+                    }
+                }
+            }
+        },
+        {
+            "if": {
+                "type": "object",
+                "properties": {
+                    "evaluation": {
+                        "type": "object",
+                        "properties": { "status": { "const": "FLAGGED" } },
+                        "required": ["status"]
+                    }
+                }
+            },
+            "then": {
+                "type": "object",
+                "properties": {
+                    "state": { "const": "flagged" },
+                    "payment": {
+                        "type": "object",
+                        "properties": { "status": { "enum": ["NO_PAYMENT", "PROMISED", "GUARANTEED"] } }
+                    }
+                }
+            }
+        },
+        {
+            "if": {
+                "type": "object",
+                "properties": {
+                    "payment": {
+                        "type": "object",
+                        "properties": { "status": { "const": "PAID" } },
+                        "required": ["status"]
+                    }
+                }
+            },
+            "then": {
+                "type": "object",
+                "properties": {
+                    "state": { "const": "paid" },
+                    "evaluation": {
+                        "type": "object",
+                        "properties": { "status": { "const": "APPROVED" } },
+                        "required": ["status"]
+                    },
+                    "payment": {
+                        "type": "object",
+                        "properties": { "chain": { "$ref": "#/$defs/chainRef" } },
+                        "required": ["chain"]
+                    }
+                }
+            }
+        },
+        {
+            "if": {
+                "type": "object",
+                "properties": { "state": { "const": "disputed" } },
+                "required": ["state"]
+            },
+            "then": {
+                "type": "object",
+                "properties": { "disputes": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/disputeProjection" } } }
+            }
+        }
+    ],
+    "$defs": {
+        "did": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "positiveUint": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+        "uint": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" },
+        "address": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "chainRef": {
+            "type": "object",
+            "required": ["txHash", "height"],
+            "properties": {
+                "txHash": { "type": "string", "pattern": "^[0-9A-Fa-f]{64}$" },
+                "height": { "$ref": "#/$defs/positiveUint" }
+            },
+            "additionalProperties": false
+        },
+        "resourceRef": {
+            "type": "object",
+            "required": ["type", "ref", "digest"],
+            "properties": {
+                "type": { "type": "string", "minLength": 1 },
+                "ref": { "type": "string", "format": "uri-reference" },
+                "digest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "nativeAmount": {
+            "type": "object",
+            "required": ["denom", "amount"],
+            "properties": {
+                "denom": { "type": "string", "minLength": 1 },
+                "amount": { "$ref": "#/$defs/positiveUint" }
+            },
+            "additionalProperties": false
+        },
+        "collectionProjection": {
+            "type": "object",
+            "required": ["collectionId", "entityDid", "protocolDid", "state", "intentPolicy", "configurationDigest", "created"],
+            "properties": {
+                "collectionId": { "$ref": "#/$defs/positiveUint" },
+                "entityDid": { "$ref": "#/$defs/did" },
+                "protocolDid": { "$ref": "#/$defs/did" },
+                "state": { "enum": ["OPEN", "PAUSED", "CLOSED"] },
+                "intentPolicy": { "enum": ["ALLOW", "DENY", "REQUIRED"] },
+                "configurationDigest": { "$ref": "#/$defs/digest" },
+                "created": { "$ref": "#/$defs/chainRef" }
+            },
+            "additionalProperties": false
+        },
+        "bidProjection": {
+            "type": "object",
+            "required": ["bidId", "serviceAgentDid", "serviceAgentAddress", "acceptedAt", "termsDigest"],
+            "properties": {
+                "bidId": { "type": "string", "minLength": 1 },
+                "serviceAgentDid": { "$ref": "#/$defs/did" },
+                "serviceAgentAddress": { "$ref": "#/$defs/address" },
+                "acceptedAt": { "type": "string", "format": "date-time" },
+                "termsDigest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "authorizationProjection": {
+            "type": "object",
+            "required": ["typeUrl", "granter", "grantee", "collectionId", "agentQuota", "maxNativeAmount", "intentDurationNs", "expiresAt", "grant"],
+            "properties": {
+                "typeUrl": { "const": "/ixo.claims.v1beta1.SubmitClaimAuthorization" },
+                "granter": { "$ref": "#/$defs/address" },
+                "grantee": { "$ref": "#/$defs/address" },
+                "collectionId": { "$ref": "#/$defs/positiveUint" },
+                "agentQuota": { "$ref": "#/$defs/positiveUint" },
+                "maxNativeAmount": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/nativeAmount" } },
+                "intentDurationNs": { "$ref": "#/$defs/uint" },
+                "memberAddress": { "$ref": "#/$defs/address" },
+                "expiresAt": { "type": "string", "format": "date-time" },
+                "grant": { "$ref": "#/$defs/chainRef" },
+                "revoked": { "$ref": "#/$defs/chainRef" }
+            },
+            "additionalProperties": false
+        },
+        "intentProjection": {
+            "type": "object",
+            "required": ["required", "status"],
+            "properties": {
+                "required": { "type": "boolean" },
+                "intentId": { "$ref": "#/$defs/positiveUint" },
+                "status": { "enum": ["NOT_CREATED", "ACTIVE", "FULFILLED", "EXPIRED"] },
+                "amount": { "type": "array", "items": { "$ref": "#/$defs/nativeAmount" } },
+                "expiresAt": { "type": "string", "format": "date-time" },
+                "chain": { "$ref": "#/$defs/chainRef" }
+            },
+            "additionalProperties": false
+        },
+        "claimProjection": {
+            "type": "object",
+            "required": ["claimId", "collectionId", "agentDid", "agentAddress", "useIntent", "evidenceDigest", "chain"],
+            "properties": {
+                "claimId": { "type": "string", "minLength": 1 },
+                "collectionId": { "$ref": "#/$defs/positiveUint" },
+                "agentDid": { "$ref": "#/$defs/did" },
+                "agentAddress": { "$ref": "#/$defs/address" },
+                "useIntent": { "type": "boolean" },
+                "evidenceDigest": { "$ref": "#/$defs/digest" },
+                "chain": { "$ref": "#/$defs/chainRef" }
+            },
+            "additionalProperties": false
+        },
+        "receiptProjection": {
+            "type": "object",
+            "required": ["udid", "cid", "digest", "issuerDid", "signatureVerified", "claimDigest", "rubricDigest"],
+            "properties": {
+                "udid": { "type": "string", "minLength": 1 },
+                "cid": { "type": "string", "minLength": 1 },
+                "digest": { "$ref": "#/$defs/digest" },
+                "issuerDid": { "$ref": "#/$defs/did" },
+                "signatureVerified": { "const": true },
+                "claimDigest": { "$ref": "#/$defs/digest" },
+                "rubricDigest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "evaluationProjection": {
+            "type": "object",
+            "required": ["status"],
+            "properties": {
+                "status": { "enum": ["PENDING", "APPROVED", "REJECTED", "FLAGGED", "INVALIDATED"] },
+                "evaluatorDid": { "$ref": "#/$defs/did" },
+                "oracleDid": { "$ref": "#/$defs/did" },
+                "reason": { "type": "integer", "minimum": 0 },
+                "receipt": { "$ref": "#/$defs/receiptProjection" },
+                "chain": { "$ref": "#/$defs/chainRef" },
+                "history": { "type": "array", "items": { "$ref": "#/$defs/chainRef" } }
+            },
+            "additionalProperties": false
+        },
+        "paymentProjection": {
+            "type": "object",
+            "required": ["status", "amount"],
+            "properties": {
+                "status": { "enum": ["NO_PAYMENT", "PROMISED", "AUTHORIZED", "GUARANTEED", "PAID", "FAILED", "DISPUTED_PAYMENT"] },
+                "amount": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/nativeAmount" } },
+                "chain": { "$ref": "#/$defs/chainRef" }
+            },
+            "additionalProperties": false
+        },
+        "disputeProjection": {
+            "type": "object",
+            "required": ["proof", "targetRole", "status", "deposit", "opened"],
+            "properties": {
+                "proof": { "type": "string", "minLength": 1 },
+                "targetRole": { "enum": ["SUBMITTER", "EVALUATOR"] },
+                "status": { "enum": ["OPEN", "AWARDED", "DISMISSED"] },
+                "deposit": { "$ref": "#/$defs/nativeAmount" },
+                "opened": { "$ref": "#/$defs/chainRef" },
+                "resolved": { "$ref": "#/$defs/chainRef" },
+                "adjudicatorDid": { "$ref": "#/$defs/did" }
+            },
+            "additionalProperties": false
+        }
+    }
+}