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

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
+        }
+    }
+}

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

@@ -0,0 +1,312 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/payable-obligation.schema.json",
+    "title": "IXO Payable Obligation envelope v1",
+    "description": "A non-authoritative envelope whose lifecycle axes are derived from referenced Topic Protocol records.",
+    "type": "object",
+    "required": [
+        "version",
+        "type",
+        "id",
+        "revision",
+        "status",
+        "topicId",
+        "basis",
+        "paymentTerms",
+        "payerDid",
+        "claimantDid",
+        "requested",
+        "sourceResources",
+        "evidence",
+        "axisProjection",
+        "recordRefs",
+        "replayKey",
+        "projectionAuthority"
+    ],
+    "properties": {
+        "$schema": { "type": "string", "minLength": 1 },
+        "version": { "const": 1 },
+        "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}$" },
+        "revision": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "supersedes": { "$ref": "#/$defs/resourceDigestRef" },
+        "status": { "enum": ["draft", "submitted", "withdrawn", "superseded"] },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "basis": { "enum": ["work_delivery", "physical_delivery", "milestone", "outcome", "invoice", "reimbursement", "eligibility", "usage", "custom"] },
+        "paymentTerms": {
+            "type": "object",
+            "required": ["id", "revision", "ref", "digest"],
+            "properties": {
+                "id": { "type": "string", "pattern": "^urn:ixo:payment-terms:" },
+                "revision": { "type": "string", "minLength": 1 },
+                "ref": { "type": "string", "format": "uri-reference" },
+                "digest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "payerDid": { "$ref": "#/$defs/did" },
+        "claimantDid": { "$ref": "#/$defs/did" },
+        "requested": { "$ref": "#/$defs/requested" },
+        "sourceResources": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/resourceDigestRef" }
+        },
+        "evidence": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/evidence" }
+        },
+        "axisProjection": { "$ref": "#/$defs/axisProjection" },
+        "recordRefs": { "$ref": "#/$defs/recordRefs" },
+        "reasons": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1, "maxLength": 2000 }
+        },
+        "replayKey": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "submittedBy": { "$ref": "#/$defs/did" },
+        "submittedAt": { "type": "string", "format": "date-time" },
+        "projectionAuthority": { "const": "referenced_topic_protocol_records" },
+        "extensions": { "type": "object" }
+    },
+    "additionalProperties": false,
+    "allOf": [
+        {
+            "if": { "properties": { "status": { "const": "submitted" } }, "required": ["status"] },
+            "then": {
+                "properties": {
+                    "submittedBy": { "$ref": "#/$defs/did" },
+                    "submittedAt": { "type": "string", "format": "date-time" }
+                },
+                "required": ["submittedBy", "submittedAt"]
+            }
+        },
+        {
+            "if": {
+                "properties": {
+                    "axisProjection": {
+                        "type": "object",
+                        "properties": { "delivery": { "enum": ["submitted", "accepted", "returned", "rejected"] } },
+                        "required": ["delivery"]
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "recordRefs": {
+                        "type": "object",
+                        "required": ["deliveryPacket"],
+                        "properties": { "deliveryPacket": { "$ref": "#/$defs/protocolRecordRef" } }
+                    }
+                }
+            }
+        },
+        {
+            "if": {
+                "properties": {
+                    "axisProjection": {
+                        "type": "object",
+                        "properties": { "delivery": { "enum": ["accepted", "returned", "rejected"] } },
+                        "required": ["delivery"]
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "recordRefs": {
+                        "type": "object",
+                        "required": ["deliveryDecision"],
+                        "properties": { "deliveryDecision": { "$ref": "#/$defs/protocolRecordRef" } }
+                    }
+                }
+            }
+        },
+        {
+            "if": {
+                "properties": {
+                    "axisProjection": {
+                        "type": "object",
+                        "properties": { "evaluation": { "enum": ["supported", "refuted", "insufficient_evidence", "human_review", "disputed", "superseded"] } },
+                        "required": ["evaluation"]
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "recordRefs": {
+                        "type": "object",
+                        "required": ["evaluations"],
+                        "properties": { "evaluations": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/protocolRecordRef" } } }
+                    }
+                }
+            }
+        },
+        {
+            "if": {
+                "properties": {
+                    "axisProjection": {
+                        "type": "object",
+                        "properties": { "approval": { "enum": ["approved", "rejected", "changes_requested", "superseded"] } },
+                        "required": ["approval"]
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "recordRefs": {
+                        "type": "object",
+                        "required": ["approval"],
+                        "properties": { "approval": { "$ref": "#/$defs/protocolRecordRef" } }
+                    }
+                }
+            }
+        },
+        {
+            "if": {
+                "properties": {
+                    "axisProjection": {
+                        "type": "object",
+                        "properties": { "claim": { "enum": ["pending", "approved", "rejected", "disputed", "invalidated", "flagged"] } },
+                        "required": ["claim"]
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "recordRefs": {
+                        "type": "object",
+                        "required": ["claim"],
+                        "properties": { "claim": { "$ref": "#/$defs/protocolRecordRef" } }
+                    }
+                }
+            }
+        },
+        {
+            "if": {
+                "properties": {
+                    "axisProjection": {
+                        "type": "object",
+                        "properties": { "settlement": { "enum": ["authorised", "submitted", "confirmed", "failed", "refunded"] } },
+                        "required": ["settlement"]
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "recordRefs": {
+                        "type": "object",
+                        "required": ["settlements"],
+                        "properties": { "settlements": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/protocolRecordRef" } } }
+                    }
+                }
+            }
+        },
+        {
+            "if": {
+                "properties": {
+                    "axisProjection": {
+                        "type": "object",
+                        "properties": { "settlement": { "enum": ["authorised", "submitted", "confirmed"] } },
+                        "required": ["settlement"]
+                    }
+                }
+            },
+            "then": {
+                "properties": {
+                    "axisProjection": {
+                        "type": "object",
+                        "properties": {
+                            "delivery": { "const": "accepted" },
+                            "evaluation": { "const": "supported" },
+                            "approval": { "const": "approved" },
+                            "claim": { "const": "approved" }
+                        }
+                    },
+                    "recordRefs": {
+                        "type": "object",
+                        "properties": {
+                            "deliveryPacket": { "$ref": "#/$defs/protocolRecordRef" },
+                            "deliveryDecision": { "$ref": "#/$defs/protocolRecordRef" },
+                            "evaluations": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/protocolRecordRef" } },
+                            "approval": { "$ref": "#/$defs/protocolRecordRef" },
+                            "claim": { "$ref": "#/$defs/protocolRecordRef" },
+                            "settlements": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/protocolRecordRef" } }
+                        },
+                        "required": ["deliveryPacket", "deliveryDecision", "evaluations", "approval", "claim", "settlements"]
+                    }
+                }
+            }
+        }
+    ],
+    "$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}$" },
+        "decimal": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" },
+        "requested": {
+            "type": "object",
+            "required": ["amount", "asset", "recipient"],
+            "properties": {
+                "amount": { "$ref": "#/$defs/decimal" },
+                "asset": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "recipient": { "type": "string", "minLength": 1, "maxLength": 256 }
+            },
+            "additionalProperties": false
+        },
+        "resourceDigestRef": {
+            "type": "object",
+            "required": ["type", "ref", "digest"],
+            "properties": {
+                "type": { "type": "string", "minLength": 1 },
+                "ref": { "type": "string", "format": "uri-reference" },
+                "digest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "evidence": {
+            "type": "object",
+            "required": ["type", "uri", "digest", "provenanceClass"],
+            "properties": {
+                "type": { "type": "string", "minLength": 1 },
+                "uri": { "type": "string", "format": "uri-reference" },
+                "digest": { "$ref": "#/$defs/digest" },
+                "provenanceClass": { "enum": ["claimant_provided", "client_assisted", "server_verified", "third_party_attested"] },
+                "label": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false
+        },
+        "axisProjection": {
+            "type": "object",
+            "required": ["delivery", "evaluation", "approval", "claim", "settlement"],
+            "properties": {
+                "delivery": { "enum": ["not_created", "not_required", "pending", "submitted", "accepted", "returned", "rejected"] },
+                "evaluation": { "enum": ["not_created", "not_required", "pending", "supported", "refuted", "insufficient_evidence", "human_review", "disputed", "superseded"] },
+                "approval": { "enum": ["not_created", "pending", "approved", "rejected", "changes_requested", "superseded"] },
+                "claim": { "enum": ["not_created", "pending", "approved", "rejected", "disputed", "invalidated", "flagged"] },
+                "settlement": { "enum": ["not_created", "unfunded", "funded", "held", "authorised", "submitted", "confirmed", "failed", "refunded"] }
+            },
+            "additionalProperties": false
+        },
+        "protocolRecordRef": {
+            "type": "object",
+            "required": ["id", "digest"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1, "maxLength": 512 },
+                "digest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "recordRefs": {
+            "type": "object",
+            "properties": {
+                "deliveryPacket": { "$ref": "#/$defs/protocolRecordRef" },
+                "deliveryDecision": { "$ref": "#/$defs/protocolRecordRef" },
+                "evaluations": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/protocolRecordRef" } },
+                "approval": { "$ref": "#/$defs/protocolRecordRef" },
+                "claim": { "$ref": "#/$defs/protocolRecordRef" },
+                "settlements": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/protocolRecordRef" } }
+            },
+            "additionalProperties": false
+        }
+    }
+}