object — Additional properties rejected
| Field | Required at this level | Type | Description and constraints |
|---|---|---|---|
schemaVersion |
Yes | Constant treasury-ledger-custody-reconciliation-candidate-v1 |
— |
organizationId |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
sourceCutoff |
Yes | string |
Format: date-time; Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ |
status |
Yes | Constant REVIEW_CANDIDATE |
— |
mappings |
Yes | Array of object |
Min items: 1; Max items: 256 |
mappings[].ledger |
Yes | object |
Additional properties rejected |
mappings[].ledger.recordId |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
mappings[].ledger.resourceVersion |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
mappings[].ledger.artifactHash |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
mappings[].custody |
Yes | object |
Additional properties rejected |
mappings[].custody.evidenceId |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
mappings[].custody.resourceVersion |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
mappings[].capitalContainerId |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
mappings[].declaredCustodyLocationId |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
mappings[].declaredSource |
Yes | object |
Additional properties rejected |
mappings[].declaredSource.kind |
Yes | string |
Allowed: SAFE, VAULT, EXTERNAL_MANAGER |
mappings[].declaredSource.id |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
mappings[].unit |
Yes | object |
Additional properties rejected |
mappings[].unit.chainId |
Yes | integer |
Maximum: 9007199254740991; Exclusive minimum: 0 |
mappings[].unit.genesisHash |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
mappings[].unit.asset |
Yes | string |
Pattern: ^0x[0-9a-f]{40}$ |
mappings[].unit.decimals |
Yes | integer |
Minimum: 0; Maximum: 36 |
mappings[].custodyAccount |
Yes | string |
Pattern: ^0x[0-9a-f]{40}$ |
mappings[].relationship |
Yes | object |
Additional properties rejected |
mappings[].relationship.id |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
mappings[].relationship.resourceVersion |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
mappings[].relationship.evidenceHash |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
mappings[].projectId |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
mappings[].block |
Yes | object |
Additional properties rejected |
mappings[].block.number |
Yes | string |
Pattern: ^(0|[1-9][0-9]{0,77})$ |
mappings[].block.hash |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
mappings[].block.timestamp |
Yes | string |
Format: date-time; Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ |
mappings[].ledgerAmountAtomic |
Yes | string |
Pattern: ^(0|[1-9][0-9]{0,77})$ |
mappings[].observedCustodyAmountAtomic |
Yes | string |
Pattern: ^(0|[1-9][0-9]{0,77})$ |
mappings[].unallocatedCustodySurplusAtomic |
Yes | string |
Pattern: ^(0|[1-9][0-9]{0,77})$ |
mappings[].ledgerState |
Yes | string |
Allowed: AVAILABLE, DEPLOYED, LOCKED, AT_RISK, FEE_GENERATING |
mappings[].committedQuoteValuation |
Yes | string |
Pattern: ^(0|[1-9][0-9]{0,77})$ |
mappings[].obligationIds |
Yes | Array of string |
Max items: 256 |
mappings[].disposition |
Yes | Constant PROPOSED_MAPPING_REQUIRES_ADMISSION |
— |
sourceBindings |
Yes | object |
Additional properties rejected |
sourceBindings.ledger |
Yes | Array of object |
Min items: 1; Max items: 256 |
sourceBindings.ledger[].recordId |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
sourceBindings.ledger[].resourceVersion |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
sourceBindings.ledger[].artifactHash |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
sourceBindings.custody |
Yes | Array of object |
Min items: 1; Max items: 256 |
sourceBindings.custody[].evidenceId |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
sourceBindings.custody[].resourceVersion |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
sourceHash |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
candidateHash |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
ledgerConservation |
Yes | object |
Additional properties rejected |
ledgerConservation.scope |
Yes | Constant SUPPLIED_IMMUTABLE_ENTRIES_ONLY |
— |
ledgerConservation.ledgerVersion |
Yes | string |
Allowed: treasury-ledger-v1, treasury-ledger-v2 |
ledgerConservation.conserved |
Yes | Constant true |
— |
ledgerConservation.commitment |
Yes | string |
Pattern: ^0x[0-9a-f]{64}$ |
omittedLedgerEntryIds |
Yes | Array of string |
Max items: 256 |
omittedCustodyEvidenceIds |
Yes | Array of string |
Max items: 256 |
limitations |
Yes | Array of Not specified | — |
spendability |
Yes | Constant NOT_ESTABLISHED |
— |
expenseCoverage |
Yes | Constant UNKNOWN |
— |
financialAuthority |
Yes | Constant false |
— |
Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.
Exact definition: #/components/schemas/TreasuryLedgerReconciliation in the OpenAPI contract.