@plasius/economy 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -439,7 +439,7 @@ declare const ECONOMY_AUTHORITY_MAX_BATCH_BYTES = 1572864;
439
439
  declare function assertEconomyAuthorityBatchLimits(operationCount: number, serializedBytes: number): void;
440
440
  type EconomyAuthorityStateV1 = "open" | "acquisition-closed" | "closed" | "rebuilding";
441
441
  type EconomyAuthorityCommitKindV1 = "genesis" | "first-party-command" | "provider-acceptance" | "provider-result" | "integrity-verification" | "state-transition" | "writer-fence-transition" | "reconstruction";
442
- type EconomyAuthorityRecordKindV1 = "command-envelope" | "provider-evidence-manifest" | "provider-evidence" | "operational-handle-binding" | "workflow-event" | "accepted-receipt" | "result-receipt" | "journal-transaction" | "source-lot" | "source-lot-movement" | "gameplay-allocation" | "balance-projection" | "lifetime-projection" | "idempotency-result" | "outbox-event" | "work-item" | "dead-letter" | "integrity-receipt" | "integrity-anchor";
442
+ type EconomyAuthorityRecordKindV1 = "command-envelope" | "provider-evidence-manifest" | "provider-evidence" | "operational-handle-binding" | "workflow-event" | "accepted-receipt" | "result-receipt" | "journal-transaction" | "source-lot" | "source-lot-movement" | "gameplay-allocation" | "wallet" | "balance-projection" | "lifetime-projection" | "idempotency-result" | "outbox-event" | "work-item" | "dead-letter" | "integrity-receipt" | "integrity-anchor";
443
443
  type EconomyAuthorityWriteKindV1 = "create" | "conditional-replace";
444
444
  /**
445
445
  * Canonical reference to one record created or conditionally replaced by an
@@ -904,6 +904,8 @@ interface EconomyIdPort {
904
904
  nextId(namespace: string): string;
905
905
  }
906
906
 
907
+ /** Additive authoritative command types; legacy V1/V2 command unions stay unchanged. */
908
+ type EconomyAuditedCommandTypeV1 = EconomyCommandType | "initialize-wallet";
907
909
  type EconomyCommandSourceV1 = "browser" | "shopify" | "ayet" | "bitlabs" | "operator" | "system";
908
910
  type EconomyCommandProcessingModeV1 = "initial" | "replay";
909
911
  type EconomyPrincipalTypeV1 = "account" | "delegated-child" | "service" | "operator";
@@ -950,7 +952,7 @@ interface EconomyAuthorizationEvidenceV1 {
950
952
  interface AuditedEconomyCommandEnvelopeV1 {
951
953
  readonly schemaVersion: EconomyContractVersion;
952
954
  readonly commandId: string;
953
- readonly commandType: EconomyCommandType;
955
+ readonly commandType: EconomyAuditedCommandTypeV1;
954
956
  readonly commandSource: EconomyCommandSourceV1;
955
957
  readonly idempotencyFingerprint: EconomyHmacFingerprintV1;
956
958
  readonly actorAccountId: AccountId;
@@ -1068,7 +1070,7 @@ interface EconomyCommandResultReceiptV1 {
1068
1070
  interface EconomyAuditedIdempotencyScopeV1 {
1069
1071
  readonly schemaVersion: EconomyContractVersion;
1070
1072
  readonly idempotencyFingerprint: EconomyHmacFingerprintV1;
1071
- readonly commandType: EconomyCommandType;
1073
+ readonly commandType: EconomyAuditedCommandTypeV1;
1072
1074
  readonly actorAccountId: AccountId;
1073
1075
  readonly subjectAccountId: AccountId;
1074
1076
  readonly principalType: EconomyPrincipalTypeV1;
@@ -1225,7 +1227,7 @@ declare function evaluateEarlyBacker(payerAccountId: AccountId, receivingHouseho
1225
1227
  declare function evaluateEarlyBackerBySettlementV2(payerAccountId: AccountId, receivingHouseholdId: HouseholdId, paidLots: readonly PaidLotRetentionV1[], window: EarlyBackerWindowV1, evaluatedAt: IsoTimestamp): EarlyBackerEvaluationV2;
1226
1228
 
1227
1229
  /** Stable machine-readable failures exposed by the economy domain. */
1228
- type EconomyErrorCode = "INVALID_AMOUNT" | "AMOUNT_OUT_OF_RANGE" | "AMOUNT_NOT_WHOLE_TOKEN" | "INVALID_CONTRACT" | "UNBALANCED_TRANSACTION" | "DUPLICATE_IDENTIFIER" | "DUPLICATE_TRANSACTION" | "INSUFFICIENT_BALANCE" | "INSUFFICIENT_ELIGIBLE_LOTS" | "SOURCE_LOT_RESTRICTED" | "REVERSAL_ALREADY_EXISTS" | "NEGATIVE_PROJECTION" | "INVALID_TIME_WINDOW";
1230
+ type EconomyErrorCode = "INVALID_AMOUNT" | "AMOUNT_OUT_OF_RANGE" | "AMOUNT_NOT_WHOLE_TOKEN" | "INVALID_CONTRACT" | "UNBALANCED_TRANSACTION" | "DUPLICATE_IDENTIFIER" | "DUPLICATE_TRANSACTION" | "INSUFFICIENT_BALANCE" | "INSUFFICIENT_ELIGIBLE_LOTS" | "SOURCE_LOT_RESTRICTED" | "REVERSAL_ALREADY_EXISTS" | "NEGATIVE_PROJECTION" | "INVALID_TIME_WINDOW" | "ADJUSTMENT_SELF_APPROVAL" | "ADJUSTMENT_EXPIRED" | "ADJUSTMENT_PREVIEW_MISMATCH" | "ADJUSTMENT_NOT_APPROVED";
1229
1231
  interface EconomyErrorEnvelopeV1 {
1230
1232
  readonly schemaVersion: "1";
1231
1233
  readonly error: {
@@ -1464,6 +1466,98 @@ interface AdjustmentRequestV1 {
1464
1466
  /** Proves that production adjustment approval was performed by another actor. */
1465
1467
  declare function assertDistinctAdjustmentApproval(request: AdjustmentRequestV1): void;
1466
1468
 
1469
+ type OperatorAdjustmentOperationV1 = "credit" | "reverse-credit";
1470
+ type OperatorAdjustmentTargetComponentV1 = "personal" | "household-treasury";
1471
+ type OperatorAdjustmentRefundPolicyV1 = "not-refundable";
1472
+ type OperatorAdjustmentDecisionKindV1 = "approve" | "reject";
1473
+ type OperatorAdjustmentProposalStatusV1 = "pending-approval";
1474
+ type OperatorAdjustmentFailureCodeV1 = "ADJUSTMENT_DISABLED" | "ADJUSTMENT_OWNER_REQUIRED" | "ADJUSTMENT_CAPABILITY_DENIED" | "ADJUSTMENT_STEP_UP_REQUIRED" | "ADJUSTMENT_TARGET_UNAVAILABLE" | "ADJUSTMENT_SELF_APPROVAL" | "ADJUSTMENT_EXPIRED" | "ADJUSTMENT_PREVIEW_MISMATCH" | "ADJUSTMENT_ALREADY_DECIDED" | "ADJUSTMENT_ALREADY_EXECUTED" | "ADJUSTMENT_NOT_APPROVED" | "ADJUSTMENT_REVERSAL_UNAVAILABLE";
1475
+ /**
1476
+ * Immutable server-prepared value plan shown to both adjustment operators.
1477
+ *
1478
+ * Callers may request an account and component, but only a trusted adapter may
1479
+ * resolve the wallet, ledger accounts and deterministic source lot recorded
1480
+ * here. Browser or MCP supplied wallet and ledger identifiers are never input
1481
+ * authority.
1482
+ */
1483
+ interface OperatorAdjustmentPreviewV1 {
1484
+ readonly schemaVersion: EconomyContractVersion;
1485
+ readonly previewId: string;
1486
+ readonly adjustmentId: string;
1487
+ readonly operation: OperatorAdjustmentOperationV1;
1488
+ readonly targetAccountId: AccountId;
1489
+ readonly targetComponent: OperatorAdjustmentTargetComponentV1;
1490
+ readonly targetWalletId: WalletId;
1491
+ readonly targetLedgerAccountId: AccountId;
1492
+ readonly offsetLedgerAccountId: AccountId;
1493
+ readonly sourceLotId: LotId;
1494
+ /** Positive magnitude. Reversals carry direction in `operation`. */
1495
+ readonly amount: TokenSubunitString;
1496
+ readonly reasonCode: string;
1497
+ /** SHA-256 of an adapter-owned, bounded ticket reference. */
1498
+ readonly ticketReferenceHash: string;
1499
+ readonly transferPolicy: LotTransferPolicy;
1500
+ readonly refundPolicy: OperatorAdjustmentRefundPolicyV1;
1501
+ readonly originalSourceLotId?: LotId;
1502
+ readonly originalTransactionId?: TransactionId;
1503
+ readonly preparedAt: IsoTimestamp;
1504
+ readonly expiresAt: IsoTimestamp;
1505
+ }
1506
+ /** Immutable first-operator proposal bound to the exact prepared preview. */
1507
+ interface OperatorAdjustmentProposalV1 {
1508
+ readonly schemaVersion: EconomyContractVersion;
1509
+ readonly proposalId: string;
1510
+ readonly adjustmentId: string;
1511
+ readonly previewHash: string;
1512
+ readonly status: OperatorAdjustmentProposalStatusV1;
1513
+ readonly proposedByAccountId: AccountId;
1514
+ readonly proposedAt: IsoTimestamp;
1515
+ readonly expiresAt: IsoTimestamp;
1516
+ }
1517
+ /** Immutable second-operator decision bound to the exact preview hash. */
1518
+ interface OperatorAdjustmentDecisionV1 {
1519
+ readonly schemaVersion: EconomyContractVersion;
1520
+ readonly decisionId: string;
1521
+ readonly adjustmentId: string;
1522
+ readonly proposalId: string;
1523
+ readonly proposalHash: string;
1524
+ readonly previewHash: string;
1525
+ readonly decision: OperatorAdjustmentDecisionKindV1;
1526
+ readonly proposedByAccountId: AccountId;
1527
+ readonly decidedByAccountId: AccountId;
1528
+ readonly proposedAt: IsoTimestamp;
1529
+ readonly decidedAt: IsoTimestamp;
1530
+ }
1531
+ /** Immutable result edge linking an approved plan to its ledger transaction. */
1532
+ interface OperatorAdjustmentExecutionV1 {
1533
+ readonly schemaVersion: EconomyContractVersion;
1534
+ readonly executionId: string;
1535
+ readonly adjustmentId: string;
1536
+ readonly previewHash: string;
1537
+ readonly proposalHash: string;
1538
+ readonly decisionHash: string;
1539
+ readonly sourceLotId: LotId;
1540
+ readonly transactionId: TransactionId;
1541
+ readonly resultReceiptId: string;
1542
+ readonly executedAt: IsoTimestamp;
1543
+ }
1544
+ /** Validates one exact, positive and privacy-minimized operator value plan. */
1545
+ declare function assertOperatorAdjustmentPreview(preview: OperatorAdjustmentPreviewV1): void;
1546
+ /** Canonical preview bytes for an approved SHA-256 adapter. */
1547
+ declare function canonicalOperatorAdjustmentPreviewPayload(preview: OperatorAdjustmentPreviewV1): string;
1548
+ /** Validates a pending proposal against the exact server-prepared preview. */
1549
+ declare function assertOperatorAdjustmentProposal(proposal: OperatorAdjustmentProposalV1, preview: OperatorAdjustmentPreviewV1, expectedPreviewHash: string): void;
1550
+ /** Canonical proposal bytes for the immutable pending-approval fact. */
1551
+ declare function canonicalOperatorAdjustmentProposalPayload(proposal: OperatorAdjustmentProposalV1): string;
1552
+ /** Validates a distinct-operator decision against its immutable preview. */
1553
+ declare function assertOperatorAdjustmentDecision(decision: OperatorAdjustmentDecisionV1, proposal: OperatorAdjustmentProposalV1, preview: OperatorAdjustmentPreviewV1, expectedPreviewHash: string, expectedProposalHash: string): void;
1554
+ /** Canonical decision bytes for approval evidence and execution binding. */
1555
+ declare function canonicalOperatorAdjustmentDecisionPayload(decision: OperatorAdjustmentDecisionV1): string;
1556
+ /** Validates the immutable ledger-result edge for one approved adjustment. */
1557
+ declare function assertOperatorAdjustmentExecution(execution: OperatorAdjustmentExecutionV1, preview: OperatorAdjustmentPreviewV1, proposal: OperatorAdjustmentProposalV1, decision: OperatorAdjustmentDecisionV1, expectedPreviewHash: string, expectedProposalHash: string, expectedDecisionHash: string): void;
1558
+ /** Canonical execution bytes for authority and audit-graph records. */
1559
+ declare function canonicalOperatorAdjustmentExecutionPayload(execution: OperatorAdjustmentExecutionV1): string;
1560
+
1467
1561
  type PaidLotLifecycleStatusV1 = "clear" | "partially-reversed" | "disputed" | "fully-reversed" | "chargeback-lost";
1468
1562
  type PaidLotLifecycleEventTypeV1 = "refund" | "dispute-hold" | "dispute-won" | "dispute-lost" | "chargeback" | "reversal";
1469
1563
  /** Paid-purchase facts not already carried by the source lot. */
@@ -2159,4 +2253,72 @@ interface SpendRequestV1 {
2159
2253
  /** Validates future child requests while creation remains policy-disabled. */
2160
2254
  declare function assertSpendRequest(request: SpendRequestV1): void;
2161
2255
 
2162
- export { type AccountId, type ActivityEntryV1, type ActivityStatus, type ActivityType, type AdjustmentRequestV1, type AdjustmentStatus, type AllocationId, type AllocationStatus, type AuditedChainedEconomicJournalTransactionV1, type AuditedEconomyCommandEnvelopeV1, BASELINE_GBP_CATALOG_VERSION, BASELINE_GBP_REFERENCE_RATE, BASELINE_GBP_TOKEN_PACKS, BASELINE_MONTHLY_SUBSCRIPTION_PLAN, BASELINE_PURCHASE_LIMIT_POLICY, type BalanceProjection, type BalanceProjectionSnapshotV1, type BitLabsConversionState, type BoostGameplayAllocationInputV1, type CanonicalPayloadHashFunctionV1, type ChainedEconomicJournalTransactionV1, type CloseModuleAllowanceInputV1, type CreateGameplayAllocationInputV1, type CreateModuleAllowanceInputV1, type CreateModulePurchaseReceiptInputV1, type CreateModuleSpendHoldInputV1, type CreateModuleSpendQuoteInputV1, EARLY_BACKER_SETTLEMENT_POLICY_V2, ECONOMY_AUTHORITY_COMMIT_OVERHEAD_OPERATIONS, ECONOMY_AUTHORITY_MAX_BATCH_BYTES, ECONOMY_AUTHORITY_MAX_BATCH_OPERATIONS, ECONOMY_AUTHORITY_MAX_RECORD_REFERENCES, ECONOMY_CONTRACT_VERSION, ECONOMY_RECOVERY_PROTOCOL_VERSION, type EarlyBackerEvaluationV1, type EarlyBackerEvaluationV2, type EarlyBackerWindowV1, type EconomicActivityStatusV1, type EconomicJournalStatus, type EconomicJournalTransactionV1, type EconomicWalletActivityEntryV1, type EconomyAcceptedCommandReceiptV1, type EconomyAcquisitionProviderV1, type EconomyAuditGraphV1, type EconomyAuditedIdempotencyResultV1, type EconomyAuditedIdempotencyScopeV1, type EconomyAuditedIdempotencyStateV1, type EconomyAuthorityCommitKindV1, type EconomyAuthorityCommitManifestV1, type EconomyAuthorityHeadV1, type EconomyAuthorityRecordKindV1, type EconomyAuthorityRecordReferenceV1, type EconomyAuthorityStateV1, type EconomyAuthorityWriteKindV1, type EconomyAuthorizationEvidenceV1, type EconomyCausationKindV1, type EconomyCausationReferenceV1, type EconomyClockPort, type EconomyCommandEnvelopeV1, type EconomyCommandProcessingDispositionV1, type EconomyCommandProcessingModeV1, type EconomyCommandResultOutcomeV1, type EconomyCommandResultReceiptV1, type EconomyCommandSourceV1, type EconomyCommandType, type EconomyCommandWorkflowEventV1, type EconomyCommandWorkflowStateV1, type EconomyContractVersion, type EconomyEncryptedOperationalHandleBindingV1, EconomyError, type EconomyErrorCode, type EconomyErrorEnvelopeV1, type EconomyEvidenceRecordReferenceV1, type EconomyEvidenceSignatureAlgorithmV1, type EconomyEvidenceSignatureMetadataV1, type EconomyEvidenceSignatureV1, type EconomyEvidenceSignatureVerificationInputV1, type EconomyEvidenceSignatureVerifierV1, type EconomyHmacFingerprintDomainV1, type EconomyHmacFingerprintV1, type EconomyHmacSha256DigestV1, type EconomyIdPort, type EconomyIdempotencyScopeV1, type EconomyIntegrityAnchorManifestV1, type EconomyIntegrityFailureCodeV1, type EconomyIntegrityVerificationReceiptV1, type EconomyIntegrityVerificationStatusV1, type EconomyMerkleInclusionProofV1, type EconomyMerkleProofStepV1, type EconomyOperationalHandlePurposeV1, type EconomyOutboxEventV1, type EconomyPersistencePort, type EconomyPersistencePortV2, type EconomyPersistencePortV3, type EconomyPortableCustomerReceiptBodyV1, type EconomyPortableCustomerReceiptV1, type EconomyPortableEvidenceReferenceV1, type EconomyPreparedEvidenceSignatureV1, type EconomyPrincipalTypeV1, type EconomyProviderEvidenceHashV1, type EconomyProviderEvidenceManifestV1, type EconomyQueryPortV1, type EconomyRecoveryAcceptanceBodyV1, type EconomyRecoveryAcceptanceEnvelopeV1, type EconomyRecoveryCommittedResultBodyV1, type EconomyRecoveryCommittedResultV1, type EconomyRecoveryDirectionV1, type EconomyRecoveryProtocolVersion, type EconomyRecoveryRecordKindV1, type EconomyRegionalEvidenceReceiptBodyV1, type EconomyRegionalEvidenceReceiptV1, type EconomySealedRecoveryPayloadV1, type EconomyUnitOfWork, type EconomyUnitOfWorkV2, type EconomyUnitOfWorkV3, type FundModuleAllowanceInputV1, type FxSnapshotV1, type GameplayAllocationV1, type GameplayLimitsV1, type GbpMinorUnitString, type HashedEconomyAuthorityCommitManifestV1, type HouseholdId, type IsoTimestamp, type JournalChainHeadV1, type JournalChainId, type JournalChainVerificationFailureCodeV1, type JournalChainVerificationResultV1, type LearningEntitlementId, type LearningModuleVersionId, type LedgerPostingV1, type LedgerTransactionV1, type LotId, type LotRefundState, type LotTransferPolicy, type LotUseContextV1, type LotUseOperation, MODULE_ALLOWANCE_PURPOSE, type ModuleAllowanceId, type ModuleAllowanceStatusV1, type ModuleAllowanceV1, type ModulePurchaseEntitlementStateV1, type ModulePurchaseFinancialStateV1, type ModulePurchaseReceiptV1, type ModulePurchaseReconciliationActionV1, type ModulePurchaseReconciliationObservationV1, type ModulePurchaseReconciliationResultV1, type ModuleSpendHoldId, type ModuleSpendHoldStatusV1, type ModuleSpendHoldV1, type ModuleSpendQuoteId, type ModuleSpendQuoteV1, type ModuleSpendTransitionResultV1, PRE_UTILITY_BACKER_COHORT, type PaidLotLifecycleArithmeticV1, type PaidLotLifecycleEventTypeV1, type PaidLotLifecycleEventV1, type PaidLotLifecycleMutationResultV1, type PaidLotLifecycleReceiptV1, type PaidLotLifecycleStatusV1, type PaidLotLifecycleV1, type PaidLotPurchaseProvenanceV1, type PaidLotRetentionV1, type PeriodicLimitWindow, type PersistedIdempotencyResultV1, type PostingId, type ProviderEventId, type PurchaseCapMutationResultV1, type PurchaseCapReservationStatusV1, type PurchaseCapReservationTransitionReceiptV1, type PurchaseCapReservationTransitionTypeV1, type PurchaseCapReservationTransitionV1, type PurchaseCapReservationV1, type PurchaseCapScopeTypeV1, type PurchaseCreditInstructionV1, type PurchaseIntentDisputeDispositionV1, type PurchaseIntentLifecycleV1, type PurchaseIntentReductionV1, type PurchaseIntentStatus, type PurchaseIntentTransitionReceiptV1, type PurchaseIntentTransitionResultV1, type PurchaseIntentTransitionTypeV1, type PurchaseIntentTransitionV1, type PurchaseIntentV1, type PurchaseLimitPolicyV1, type ReclaimGameplayAllocationInputV1, type ReclaimModuleAllowanceInputV1, type RecurrenceInterval, type ReleaseModuleSpendHoldInputV1, type ReservePurchaseCapsCommandV1, type ReversalInputV1, type RewardActivityTransitionV1, type RewardConversionStatus, type RewardConversionV1, type RewardRateV1, type RollingPurchaseCapStateV1, type ScopedPersistedIdempotencyResultV1, type SettleModuleSpendHoldInputV1, type SourceLotMovementType, type SourceLotMovementV1, type SourceLotSliceV1, type SourceLotV1, type SpendRequestPurpose, type SpendRequestStatus, type SpendRequestV1, TOKEN_SUBUNITS_MAX, TOKEN_SUBUNITS_MIN, TOKEN_SUBUNITS_PER_TOKEN, type TokenPackV1, type TokenReferenceRateV1, type TokenSource, type TokenSubscriptionPlanV1, type TokenSubunitString, type TransactionId, type VersionedSourceLotV1, type WalletActivityEntryV1, type WalletActivityFilterV1, type WalletActivityPageRequestV1, type WalletActivityPageV1, type WalletActivityStatusV1, type WalletBalanceDeltaV1, type WalletBalanceProjectionV1, type WalletBalanceSummaryV1, type WalletBalanceTotalsV1, type WalletId, type WalletKind, type WalletLifetimeBucket, type WalletLifetimeDeltaV1, type WalletLifetimeSnapshotV1, type WalletLifetimeTotalsV1, type WalletOwnerReferenceV1, type WalletOwnerType, type WalletPortfolioBalanceComponentV1, type WalletPortfolioComponentRole, type WalletPortfolioComponentScopeV1, type WalletPortfolioLifetimeComponentV1, type WalletPortfolioLifetimeV1, type WalletPortfolioReadScopeV1, type WalletPortfolioSummaryV1, type WalletPostingAccountBindingV1, type WalletProjectionBucket, type WalletStatus, type WalletV1, type WorkflowActivityStatusV1, type WorkflowWalletActivityEntryV1, advanceEconomyAuthorityHead, advanceJournalChainHead, applyPaidLotLifecycleEvent, applyPurchaseIntentTransition, applySourceLotMovement, applyTransactionToProjection, applyWalletBalanceDelta, applyWalletLifetimeDeltas, assertActivityEntry, assertAuditedEconomyCommandEnvelope, assertBalancedTransaction, assertDeterministicWalletBalanceSummary, assertDistinctAdjustmentApproval, assertEconomicJournalTransaction, assertEconomyAcceptedCommandReceipt, assertEconomyAuditGraph, assertEconomyAuditedIdempotencyResult, assertEconomyAuditedIdempotencyScope, assertEconomyAuthorityBatchLimits, assertEconomyAuthorityCommitManifest, assertEconomyAuthorityHead, assertEconomyAuthorityRecordReference, assertEconomyAuthorityRecoveryEvidence, assertEconomyAuthorizationEvidence, assertEconomyCommandEnvelope, assertEconomyCommandResultReceipt, assertEconomyCommandWorkflowEvent, assertEconomyEncryptedOperationalHandleBinding, assertEconomyEvidenceSignature, assertEconomyEvidenceSignatureMetadata, assertEconomyHmacFingerprint, assertEconomyIdempotencyScope, assertEconomyIdentifier, assertEconomyIntegrityAnchorManifest, assertEconomyIntegrityVerificationReceipt, assertEconomyMerkleInclusion, assertEconomyMerkleInclusionProof, assertEconomyPortableCustomerReceipt, assertEconomyPortableCustomerReceiptEvidence, assertEconomyPortableCustomerReceiptSignature, assertEconomyProviderEvidenceHash, assertEconomyProviderEvidenceManifest, assertEconomyRecoveryAcceptanceEnvelope, assertEconomyRecoveryCommittedResult, assertEconomyRecoveryResultLink, assertEconomyRegionalEvidenceChain, assertEconomyRegionalEvidenceEquality, assertEconomyRegionalEvidenceReceipt, assertEconomyRegionalEvidenceReceiptSignature, assertEconomySealedRecoveryPayload, assertExactAuditedEconomyCommandReplay, assertFlatTokenCatalog, assertFxSnapshot, assertGameplayAllocation, assertJournalChainHead, assertModuleAllowance, assertModulePurchaseReceipt, assertModulePurchaseReconciliationObservation, assertModuleSpendHold, assertModuleSpendQuote, assertNonNegativeAccounts, assertOpenPurchaseIntent, assertPaidLotLifecycle, assertPaidLotLifecycleEvent, assertPaidLotPurchaseProvenance, assertPurchaseCapReservation, assertPurchaseCapReservationTransition, assertPurchaseIntentBinding, assertPurchaseIntentLifecycle, assertPurchaseIntentTransition, assertPurchaseLimitPolicy, assertReversalAvailable, assertRewardConversion, assertRewardRate, assertRollingPurchaseCapState, assertScopedPersistedIdempotencyResult, assertSourceLot, assertSourceLotMovement, assertSpendRequest, assertTokenPack, assertTokenReferenceRate, assertTokenSubscriptionPlan, assertVersionedSourceLot, assertWallet, assertWalletActivityEntry, assertWalletActivityPage, assertWalletActivityPageForPortfolio, assertWalletActivityPageRequest, assertWalletBalanceDelta, assertWalletBalanceDeltaBatch, assertWalletBalanceProjection, assertWalletBalanceSummary, assertWalletLifetimeSnapshot, assertWalletLifetimeTotals, assertWalletOwnerReference, assertWalletPortfolioLifetime, assertWalletPortfolioReadScope, assertWalletPortfolioSummary, availableSourceLotAmount, boostGameplayAllocation, calculateRollingPurchaseCapUsage, canUseSourceLot, canonicalAuditedEconomyCommandEnvelopePayload, canonicalEconomyAcceptedCommandReceiptPayload, canonicalEconomyAuthorityCommitManifestPayload, canonicalEconomyAuthorityHeadPayload, canonicalEconomyCommandResultReceiptPayload, canonicalEconomyEncryptedOperationalHandleBindingPayload, canonicalEconomyIntegrityAnchorManifestPayload, canonicalEconomyIntegrityVerificationReceiptPayload, canonicalEconomyPortableCustomerReceiptBodyPayload, canonicalEconomyPortableCustomerReceiptPayload, canonicalEconomyPortableCustomerReceiptSigningPayload, canonicalEconomyProviderEvidenceHashPayload, canonicalEconomyProviderEvidenceManifestPayload, canonicalEconomyRecoveryAcceptanceBodyPayload, canonicalEconomyRecoveryAcceptanceEnvelopePayload, canonicalEconomyRecoveryCommittedResultBodyPayload, canonicalEconomyRecoveryCommittedResultPayload, canonicalEconomyRegionalEvidenceReceiptBodyPayload, canonicalEconomyRegionalEvidenceReceiptPayload, canonicalEconomyRegionalEvidenceReceiptSigningPayload, canonicalTransactionPayload, closeModuleAllowance, convertRewardPayout, createEarlyBackerRetentionFromPaidLot, createEconomyPortableCustomerReceipt, createEconomyRecoveryAcceptanceEnvelope, createEconomyRecoveryCommittedResult, createEconomyRegionalEvidenceReceipt, createGameplayAllocation, createInitialSourceLotSnapshot, createModuleAllowance, createModulePurchaseReceipt, createModuleSpendHold, createModuleSpendQuote, createPaidLotLifecycle, createProjectionSnapshot, createPurchaseIntentLifecycle, createReversalTransaction, createRollingPurchaseCapState, createWalletBalanceSummary, createWalletPortfolioLifetime, createWalletPortfolioSummary, deriveWalletBalanceDeltas, deriveWalletLifetimeDeltas, economyAssert, evaluateEarlyBacker, evaluateEarlyBackerBySettlementV2, fundModuleAllowance, isWholeTokenAmount, mapBitLabsConversionState, parseGbpMinorUnits, parseIsoTimestamp, parseTokenSubunits, prepareEconomyPortableCustomerReceiptSignature, prepareEconomyRegionalEvidenceReceiptSignature, rebuildBalanceProjection, reclaimGameplayAllocation, reclaimModuleAllowance, reconcileModulePurchase, reducePaidLotLifecycleEvents, reducePurchaseIntentTransitions, releaseModuleSpendHold, reserveRollingPurchaseCaps, selectSourceLots, serializeGbpMinorUnits, serializeTokenSubunits, settleModuleSpendHold, sortEconomyAuthorityRecordReferences, sortStringRecord, subunitsToWholeTokens, sumTokenSubunits, toEconomyErrorEnvelope, transitionRollingPurchaseCapReservation, verifyJournalChainSegment, wholeTokensToSubunits };
2256
+ type WalletInitializationNoOpCodeV1 = "WALLET_INITIALIZED" | "WALLET_ALREADY_INITIALIZED";
2257
+ /** Deterministic storage identities for one self-owned personal wallet. */
2258
+ interface PersonalWalletInitializationDocumentIdsV1 {
2259
+ readonly walletDescriptorId: string;
2260
+ readonly accessProjectionId: string;
2261
+ readonly balanceProjectionId: string;
2262
+ readonly lifetimeProjectionId: string;
2263
+ readonly outboxEventId: string;
2264
+ }
2265
+ /** Privacy-minimized semantic payload bound by the audited command hash. */
2266
+ interface PersonalWalletInitializationCommandV1 {
2267
+ readonly schemaVersion: EconomyContractVersion;
2268
+ readonly commandType: "initialize-wallet";
2269
+ readonly walletKind: "personal";
2270
+ readonly subjectAccountId: AccountId;
2271
+ readonly walletId: string;
2272
+ readonly portfolioId: string;
2273
+ readonly initializedAt: IsoTimestamp;
2274
+ }
2275
+ /** Non-economic integration intent emitted in the same authority batch. */
2276
+ interface PersonalWalletInitializationOutboxIntentV1 {
2277
+ readonly schemaVersion: EconomyContractVersion;
2278
+ readonly eventType: "wallet.initialized.v1";
2279
+ readonly eventId: string;
2280
+ readonly subjectAccountId: AccountId;
2281
+ readonly walletId: string;
2282
+ readonly portfolioId: string;
2283
+ readonly occurredAt: IsoTimestamp;
2284
+ }
2285
+ /** Complete rebuildable baseline for one new self-owned personal wallet. */
2286
+ interface PersonalWalletInitializationStateV1 {
2287
+ readonly schemaVersion: EconomyContractVersion;
2288
+ readonly documentIds: PersonalWalletInitializationDocumentIdsV1;
2289
+ readonly command: PersonalWalletInitializationCommandV1;
2290
+ readonly wallet: WalletV1;
2291
+ readonly scope: WalletPortfolioReadScopeV1;
2292
+ readonly balance: WalletBalanceSummaryV1;
2293
+ readonly lifetime: WalletLifetimeSnapshotV1;
2294
+ /** Initialization itself is not an economic activity. */
2295
+ readonly activityEntries: readonly WalletActivityEntryV1[];
2296
+ readonly outboxIntent: PersonalWalletInitializationOutboxIntentV1;
2297
+ }
2298
+ interface CreatePersonalWalletInitializationStateInputV1 {
2299
+ readonly subjectAccountId: AccountId;
2300
+ readonly initializedAt: IsoTimestamp;
2301
+ }
2302
+ /** Produces stable, non-guessable-by-sequence IDs without owning cryptography. */
2303
+ declare function createPersonalWalletInitializationDocumentIds(subjectAccountId: AccountId, hash: CanonicalPayloadHashFunctionV1): PersonalWalletInitializationDocumentIdsV1 & {
2304
+ readonly walletId: string;
2305
+ readonly portfolioId: string;
2306
+ };
2307
+ /** Validates the exact semantic initialization payload before hashing it. */
2308
+ declare function assertPersonalWalletInitializationCommand(command: PersonalWalletInitializationCommandV1): void;
2309
+ /** Returns the exact UTF-8 JSON bytes an approved SHA-256 adapter must hash. */
2310
+ declare function canonicalPersonalWalletInitializationCommandPayload(command: PersonalWalletInitializationCommandV1): string;
2311
+ /** Validates the privacy-minimized outbox intent. */
2312
+ declare function assertPersonalWalletInitializationOutboxIntent(intent: PersonalWalletInitializationOutboxIntentV1): void;
2313
+ /** Canonical bytes for the create-only initialization outbox fact. */
2314
+ declare function canonicalPersonalWalletInitializationOutboxPayload(intent: PersonalWalletInitializationOutboxIntentV1): string;
2315
+ /**
2316
+ * Builds the complete exact-zero personal-wallet baseline. The caller supplies
2317
+ * SHA-256 and persists these records with receipts, idempotency, the authority
2318
+ * manifest, and the conditional head advance in one ACID boundary.
2319
+ */
2320
+ declare function createPersonalWalletInitializationState(input: CreatePersonalWalletInitializationStateInputV1, hash: CanonicalPayloadHashFunctionV1): PersonalWalletInitializationStateV1;
2321
+ /** Proves the personal-wallet initialization state is complete and exact-zero. */
2322
+ declare function assertPersonalWalletInitializationState(state: PersonalWalletInitializationStateV1): void;
2323
+
2324
+ export { type AccountId, type ActivityEntryV1, type ActivityStatus, type ActivityType, type AdjustmentRequestV1, type AdjustmentStatus, type AllocationId, type AllocationStatus, type AuditedChainedEconomicJournalTransactionV1, type AuditedEconomyCommandEnvelopeV1, BASELINE_GBP_CATALOG_VERSION, BASELINE_GBP_REFERENCE_RATE, BASELINE_GBP_TOKEN_PACKS, BASELINE_MONTHLY_SUBSCRIPTION_PLAN, BASELINE_PURCHASE_LIMIT_POLICY, type BalanceProjection, type BalanceProjectionSnapshotV1, type BitLabsConversionState, type BoostGameplayAllocationInputV1, type CanonicalPayloadHashFunctionV1, type ChainedEconomicJournalTransactionV1, type CloseModuleAllowanceInputV1, type CreateGameplayAllocationInputV1, type CreateModuleAllowanceInputV1, type CreateModulePurchaseReceiptInputV1, type CreateModuleSpendHoldInputV1, type CreateModuleSpendQuoteInputV1, type CreatePersonalWalletInitializationStateInputV1, EARLY_BACKER_SETTLEMENT_POLICY_V2, ECONOMY_AUTHORITY_COMMIT_OVERHEAD_OPERATIONS, ECONOMY_AUTHORITY_MAX_BATCH_BYTES, ECONOMY_AUTHORITY_MAX_BATCH_OPERATIONS, ECONOMY_AUTHORITY_MAX_RECORD_REFERENCES, ECONOMY_CONTRACT_VERSION, ECONOMY_RECOVERY_PROTOCOL_VERSION, type EarlyBackerEvaluationV1, type EarlyBackerEvaluationV2, type EarlyBackerWindowV1, type EconomicActivityStatusV1, type EconomicJournalStatus, type EconomicJournalTransactionV1, type EconomicWalletActivityEntryV1, type EconomyAcceptedCommandReceiptV1, type EconomyAcquisitionProviderV1, type EconomyAuditGraphV1, type EconomyAuditedCommandTypeV1, type EconomyAuditedIdempotencyResultV1, type EconomyAuditedIdempotencyScopeV1, type EconomyAuditedIdempotencyStateV1, type EconomyAuthorityCommitKindV1, type EconomyAuthorityCommitManifestV1, type EconomyAuthorityHeadV1, type EconomyAuthorityRecordKindV1, type EconomyAuthorityRecordReferenceV1, type EconomyAuthorityStateV1, type EconomyAuthorityWriteKindV1, type EconomyAuthorizationEvidenceV1, type EconomyCausationKindV1, type EconomyCausationReferenceV1, type EconomyClockPort, type EconomyCommandEnvelopeV1, type EconomyCommandProcessingDispositionV1, type EconomyCommandProcessingModeV1, type EconomyCommandResultOutcomeV1, type EconomyCommandResultReceiptV1, type EconomyCommandSourceV1, type EconomyCommandType, type EconomyCommandWorkflowEventV1, type EconomyCommandWorkflowStateV1, type EconomyContractVersion, type EconomyEncryptedOperationalHandleBindingV1, EconomyError, type EconomyErrorCode, type EconomyErrorEnvelopeV1, type EconomyEvidenceRecordReferenceV1, type EconomyEvidenceSignatureAlgorithmV1, type EconomyEvidenceSignatureMetadataV1, type EconomyEvidenceSignatureV1, type EconomyEvidenceSignatureVerificationInputV1, type EconomyEvidenceSignatureVerifierV1, type EconomyHmacFingerprintDomainV1, type EconomyHmacFingerprintV1, type EconomyHmacSha256DigestV1, type EconomyIdPort, type EconomyIdempotencyScopeV1, type EconomyIntegrityAnchorManifestV1, type EconomyIntegrityFailureCodeV1, type EconomyIntegrityVerificationReceiptV1, type EconomyIntegrityVerificationStatusV1, type EconomyMerkleInclusionProofV1, type EconomyMerkleProofStepV1, type EconomyOperationalHandlePurposeV1, type EconomyOutboxEventV1, type EconomyPersistencePort, type EconomyPersistencePortV2, type EconomyPersistencePortV3, type EconomyPortableCustomerReceiptBodyV1, type EconomyPortableCustomerReceiptV1, type EconomyPortableEvidenceReferenceV1, type EconomyPreparedEvidenceSignatureV1, type EconomyPrincipalTypeV1, type EconomyProviderEvidenceHashV1, type EconomyProviderEvidenceManifestV1, type EconomyQueryPortV1, type EconomyRecoveryAcceptanceBodyV1, type EconomyRecoveryAcceptanceEnvelopeV1, type EconomyRecoveryCommittedResultBodyV1, type EconomyRecoveryCommittedResultV1, type EconomyRecoveryDirectionV1, type EconomyRecoveryProtocolVersion, type EconomyRecoveryRecordKindV1, type EconomyRegionalEvidenceReceiptBodyV1, type EconomyRegionalEvidenceReceiptV1, type EconomySealedRecoveryPayloadV1, type EconomyUnitOfWork, type EconomyUnitOfWorkV2, type EconomyUnitOfWorkV3, type FundModuleAllowanceInputV1, type FxSnapshotV1, type GameplayAllocationV1, type GameplayLimitsV1, type GbpMinorUnitString, type HashedEconomyAuthorityCommitManifestV1, type HouseholdId, type IsoTimestamp, type JournalChainHeadV1, type JournalChainId, type JournalChainVerificationFailureCodeV1, type JournalChainVerificationResultV1, type LearningEntitlementId, type LearningModuleVersionId, type LedgerPostingV1, type LedgerTransactionV1, type LotId, type LotRefundState, type LotTransferPolicy, type LotUseContextV1, type LotUseOperation, MODULE_ALLOWANCE_PURPOSE, type ModuleAllowanceId, type ModuleAllowanceStatusV1, type ModuleAllowanceV1, type ModulePurchaseEntitlementStateV1, type ModulePurchaseFinancialStateV1, type ModulePurchaseReceiptV1, type ModulePurchaseReconciliationActionV1, type ModulePurchaseReconciliationObservationV1, type ModulePurchaseReconciliationResultV1, type ModuleSpendHoldId, type ModuleSpendHoldStatusV1, type ModuleSpendHoldV1, type ModuleSpendQuoteId, type ModuleSpendQuoteV1, type ModuleSpendTransitionResultV1, type OperatorAdjustmentDecisionKindV1, type OperatorAdjustmentDecisionV1, type OperatorAdjustmentExecutionV1, type OperatorAdjustmentFailureCodeV1, type OperatorAdjustmentOperationV1, type OperatorAdjustmentPreviewV1, type OperatorAdjustmentProposalStatusV1, type OperatorAdjustmentProposalV1, type OperatorAdjustmentRefundPolicyV1, type OperatorAdjustmentTargetComponentV1, PRE_UTILITY_BACKER_COHORT, type PaidLotLifecycleArithmeticV1, type PaidLotLifecycleEventTypeV1, type PaidLotLifecycleEventV1, type PaidLotLifecycleMutationResultV1, type PaidLotLifecycleReceiptV1, type PaidLotLifecycleStatusV1, type PaidLotLifecycleV1, type PaidLotPurchaseProvenanceV1, type PaidLotRetentionV1, type PeriodicLimitWindow, type PersistedIdempotencyResultV1, type PersonalWalletInitializationCommandV1, type PersonalWalletInitializationDocumentIdsV1, type PersonalWalletInitializationOutboxIntentV1, type PersonalWalletInitializationStateV1, type PostingId, type ProviderEventId, type PurchaseCapMutationResultV1, type PurchaseCapReservationStatusV1, type PurchaseCapReservationTransitionReceiptV1, type PurchaseCapReservationTransitionTypeV1, type PurchaseCapReservationTransitionV1, type PurchaseCapReservationV1, type PurchaseCapScopeTypeV1, type PurchaseCreditInstructionV1, type PurchaseIntentDisputeDispositionV1, type PurchaseIntentLifecycleV1, type PurchaseIntentReductionV1, type PurchaseIntentStatus, type PurchaseIntentTransitionReceiptV1, type PurchaseIntentTransitionResultV1, type PurchaseIntentTransitionTypeV1, type PurchaseIntentTransitionV1, type PurchaseIntentV1, type PurchaseLimitPolicyV1, type ReclaimGameplayAllocationInputV1, type ReclaimModuleAllowanceInputV1, type RecurrenceInterval, type ReleaseModuleSpendHoldInputV1, type ReservePurchaseCapsCommandV1, type ReversalInputV1, type RewardActivityTransitionV1, type RewardConversionStatus, type RewardConversionV1, type RewardRateV1, type RollingPurchaseCapStateV1, type ScopedPersistedIdempotencyResultV1, type SettleModuleSpendHoldInputV1, type SourceLotMovementType, type SourceLotMovementV1, type SourceLotSliceV1, type SourceLotV1, type SpendRequestPurpose, type SpendRequestStatus, type SpendRequestV1, TOKEN_SUBUNITS_MAX, TOKEN_SUBUNITS_MIN, TOKEN_SUBUNITS_PER_TOKEN, type TokenPackV1, type TokenReferenceRateV1, type TokenSource, type TokenSubscriptionPlanV1, type TokenSubunitString, type TransactionId, type VersionedSourceLotV1, type WalletActivityEntryV1, type WalletActivityFilterV1, type WalletActivityPageRequestV1, type WalletActivityPageV1, type WalletActivityStatusV1, type WalletBalanceDeltaV1, type WalletBalanceProjectionV1, type WalletBalanceSummaryV1, type WalletBalanceTotalsV1, type WalletId, type WalletInitializationNoOpCodeV1, type WalletKind, type WalletLifetimeBucket, type WalletLifetimeDeltaV1, type WalletLifetimeSnapshotV1, type WalletLifetimeTotalsV1, type WalletOwnerReferenceV1, type WalletOwnerType, type WalletPortfolioBalanceComponentV1, type WalletPortfolioComponentRole, type WalletPortfolioComponentScopeV1, type WalletPortfolioLifetimeComponentV1, type WalletPortfolioLifetimeV1, type WalletPortfolioReadScopeV1, type WalletPortfolioSummaryV1, type WalletPostingAccountBindingV1, type WalletProjectionBucket, type WalletStatus, type WalletV1, type WorkflowActivityStatusV1, type WorkflowWalletActivityEntryV1, advanceEconomyAuthorityHead, advanceJournalChainHead, applyPaidLotLifecycleEvent, applyPurchaseIntentTransition, applySourceLotMovement, applyTransactionToProjection, applyWalletBalanceDelta, applyWalletLifetimeDeltas, assertActivityEntry, assertAuditedEconomyCommandEnvelope, assertBalancedTransaction, assertDeterministicWalletBalanceSummary, assertDistinctAdjustmentApproval, assertEconomicJournalTransaction, assertEconomyAcceptedCommandReceipt, assertEconomyAuditGraph, assertEconomyAuditedIdempotencyResult, assertEconomyAuditedIdempotencyScope, assertEconomyAuthorityBatchLimits, assertEconomyAuthorityCommitManifest, assertEconomyAuthorityHead, assertEconomyAuthorityRecordReference, assertEconomyAuthorityRecoveryEvidence, assertEconomyAuthorizationEvidence, assertEconomyCommandEnvelope, assertEconomyCommandResultReceipt, assertEconomyCommandWorkflowEvent, assertEconomyEncryptedOperationalHandleBinding, assertEconomyEvidenceSignature, assertEconomyEvidenceSignatureMetadata, assertEconomyHmacFingerprint, assertEconomyIdempotencyScope, assertEconomyIdentifier, assertEconomyIntegrityAnchorManifest, assertEconomyIntegrityVerificationReceipt, assertEconomyMerkleInclusion, assertEconomyMerkleInclusionProof, assertEconomyPortableCustomerReceipt, assertEconomyPortableCustomerReceiptEvidence, assertEconomyPortableCustomerReceiptSignature, assertEconomyProviderEvidenceHash, assertEconomyProviderEvidenceManifest, assertEconomyRecoveryAcceptanceEnvelope, assertEconomyRecoveryCommittedResult, assertEconomyRecoveryResultLink, assertEconomyRegionalEvidenceChain, assertEconomyRegionalEvidenceEquality, assertEconomyRegionalEvidenceReceipt, assertEconomyRegionalEvidenceReceiptSignature, assertEconomySealedRecoveryPayload, assertExactAuditedEconomyCommandReplay, assertFlatTokenCatalog, assertFxSnapshot, assertGameplayAllocation, assertJournalChainHead, assertModuleAllowance, assertModulePurchaseReceipt, assertModulePurchaseReconciliationObservation, assertModuleSpendHold, assertModuleSpendQuote, assertNonNegativeAccounts, assertOpenPurchaseIntent, assertOperatorAdjustmentDecision, assertOperatorAdjustmentExecution, assertOperatorAdjustmentPreview, assertOperatorAdjustmentProposal, assertPaidLotLifecycle, assertPaidLotLifecycleEvent, assertPaidLotPurchaseProvenance, assertPersonalWalletInitializationCommand, assertPersonalWalletInitializationOutboxIntent, assertPersonalWalletInitializationState, assertPurchaseCapReservation, assertPurchaseCapReservationTransition, assertPurchaseIntentBinding, assertPurchaseIntentLifecycle, assertPurchaseIntentTransition, assertPurchaseLimitPolicy, assertReversalAvailable, assertRewardConversion, assertRewardRate, assertRollingPurchaseCapState, assertScopedPersistedIdempotencyResult, assertSourceLot, assertSourceLotMovement, assertSpendRequest, assertTokenPack, assertTokenReferenceRate, assertTokenSubscriptionPlan, assertVersionedSourceLot, assertWallet, assertWalletActivityEntry, assertWalletActivityPage, assertWalletActivityPageForPortfolio, assertWalletActivityPageRequest, assertWalletBalanceDelta, assertWalletBalanceDeltaBatch, assertWalletBalanceProjection, assertWalletBalanceSummary, assertWalletLifetimeSnapshot, assertWalletLifetimeTotals, assertWalletOwnerReference, assertWalletPortfolioLifetime, assertWalletPortfolioReadScope, assertWalletPortfolioSummary, availableSourceLotAmount, boostGameplayAllocation, calculateRollingPurchaseCapUsage, canUseSourceLot, canonicalAuditedEconomyCommandEnvelopePayload, canonicalEconomyAcceptedCommandReceiptPayload, canonicalEconomyAuthorityCommitManifestPayload, canonicalEconomyAuthorityHeadPayload, canonicalEconomyCommandResultReceiptPayload, canonicalEconomyEncryptedOperationalHandleBindingPayload, canonicalEconomyIntegrityAnchorManifestPayload, canonicalEconomyIntegrityVerificationReceiptPayload, canonicalEconomyPortableCustomerReceiptBodyPayload, canonicalEconomyPortableCustomerReceiptPayload, canonicalEconomyPortableCustomerReceiptSigningPayload, canonicalEconomyProviderEvidenceHashPayload, canonicalEconomyProviderEvidenceManifestPayload, canonicalEconomyRecoveryAcceptanceBodyPayload, canonicalEconomyRecoveryAcceptanceEnvelopePayload, canonicalEconomyRecoveryCommittedResultBodyPayload, canonicalEconomyRecoveryCommittedResultPayload, canonicalEconomyRegionalEvidenceReceiptBodyPayload, canonicalEconomyRegionalEvidenceReceiptPayload, canonicalEconomyRegionalEvidenceReceiptSigningPayload, canonicalOperatorAdjustmentDecisionPayload, canonicalOperatorAdjustmentExecutionPayload, canonicalOperatorAdjustmentPreviewPayload, canonicalOperatorAdjustmentProposalPayload, canonicalPersonalWalletInitializationCommandPayload, canonicalPersonalWalletInitializationOutboxPayload, canonicalTransactionPayload, closeModuleAllowance, convertRewardPayout, createEarlyBackerRetentionFromPaidLot, createEconomyPortableCustomerReceipt, createEconomyRecoveryAcceptanceEnvelope, createEconomyRecoveryCommittedResult, createEconomyRegionalEvidenceReceipt, createGameplayAllocation, createInitialSourceLotSnapshot, createModuleAllowance, createModulePurchaseReceipt, createModuleSpendHold, createModuleSpendQuote, createPaidLotLifecycle, createPersonalWalletInitializationDocumentIds, createPersonalWalletInitializationState, createProjectionSnapshot, createPurchaseIntentLifecycle, createReversalTransaction, createRollingPurchaseCapState, createWalletBalanceSummary, createWalletPortfolioLifetime, createWalletPortfolioSummary, deriveWalletBalanceDeltas, deriveWalletLifetimeDeltas, economyAssert, evaluateEarlyBacker, evaluateEarlyBackerBySettlementV2, fundModuleAllowance, isWholeTokenAmount, mapBitLabsConversionState, parseGbpMinorUnits, parseIsoTimestamp, parseTokenSubunits, prepareEconomyPortableCustomerReceiptSignature, prepareEconomyRegionalEvidenceReceiptSignature, rebuildBalanceProjection, reclaimGameplayAllocation, reclaimModuleAllowance, reconcileModulePurchase, reducePaidLotLifecycleEvents, reducePurchaseIntentTransitions, releaseModuleSpendHold, reserveRollingPurchaseCaps, selectSourceLots, serializeGbpMinorUnits, serializeTokenSubunits, settleModuleSpendHold, sortEconomyAuthorityRecordReferences, sortStringRecord, subunitsToWholeTokens, sumTokenSubunits, toEconomyErrorEnvelope, transitionRollingPurchaseCapReservation, verifyJournalChainSegment, wholeTokensToSubunits };
package/dist/index.d.ts CHANGED
@@ -439,7 +439,7 @@ declare const ECONOMY_AUTHORITY_MAX_BATCH_BYTES = 1572864;
439
439
  declare function assertEconomyAuthorityBatchLimits(operationCount: number, serializedBytes: number): void;
440
440
  type EconomyAuthorityStateV1 = "open" | "acquisition-closed" | "closed" | "rebuilding";
441
441
  type EconomyAuthorityCommitKindV1 = "genesis" | "first-party-command" | "provider-acceptance" | "provider-result" | "integrity-verification" | "state-transition" | "writer-fence-transition" | "reconstruction";
442
- type EconomyAuthorityRecordKindV1 = "command-envelope" | "provider-evidence-manifest" | "provider-evidence" | "operational-handle-binding" | "workflow-event" | "accepted-receipt" | "result-receipt" | "journal-transaction" | "source-lot" | "source-lot-movement" | "gameplay-allocation" | "balance-projection" | "lifetime-projection" | "idempotency-result" | "outbox-event" | "work-item" | "dead-letter" | "integrity-receipt" | "integrity-anchor";
442
+ type EconomyAuthorityRecordKindV1 = "command-envelope" | "provider-evidence-manifest" | "provider-evidence" | "operational-handle-binding" | "workflow-event" | "accepted-receipt" | "result-receipt" | "journal-transaction" | "source-lot" | "source-lot-movement" | "gameplay-allocation" | "wallet" | "balance-projection" | "lifetime-projection" | "idempotency-result" | "outbox-event" | "work-item" | "dead-letter" | "integrity-receipt" | "integrity-anchor";
443
443
  type EconomyAuthorityWriteKindV1 = "create" | "conditional-replace";
444
444
  /**
445
445
  * Canonical reference to one record created or conditionally replaced by an
@@ -904,6 +904,8 @@ interface EconomyIdPort {
904
904
  nextId(namespace: string): string;
905
905
  }
906
906
 
907
+ /** Additive authoritative command types; legacy V1/V2 command unions stay unchanged. */
908
+ type EconomyAuditedCommandTypeV1 = EconomyCommandType | "initialize-wallet";
907
909
  type EconomyCommandSourceV1 = "browser" | "shopify" | "ayet" | "bitlabs" | "operator" | "system";
908
910
  type EconomyCommandProcessingModeV1 = "initial" | "replay";
909
911
  type EconomyPrincipalTypeV1 = "account" | "delegated-child" | "service" | "operator";
@@ -950,7 +952,7 @@ interface EconomyAuthorizationEvidenceV1 {
950
952
  interface AuditedEconomyCommandEnvelopeV1 {
951
953
  readonly schemaVersion: EconomyContractVersion;
952
954
  readonly commandId: string;
953
- readonly commandType: EconomyCommandType;
955
+ readonly commandType: EconomyAuditedCommandTypeV1;
954
956
  readonly commandSource: EconomyCommandSourceV1;
955
957
  readonly idempotencyFingerprint: EconomyHmacFingerprintV1;
956
958
  readonly actorAccountId: AccountId;
@@ -1068,7 +1070,7 @@ interface EconomyCommandResultReceiptV1 {
1068
1070
  interface EconomyAuditedIdempotencyScopeV1 {
1069
1071
  readonly schemaVersion: EconomyContractVersion;
1070
1072
  readonly idempotencyFingerprint: EconomyHmacFingerprintV1;
1071
- readonly commandType: EconomyCommandType;
1073
+ readonly commandType: EconomyAuditedCommandTypeV1;
1072
1074
  readonly actorAccountId: AccountId;
1073
1075
  readonly subjectAccountId: AccountId;
1074
1076
  readonly principalType: EconomyPrincipalTypeV1;
@@ -1225,7 +1227,7 @@ declare function evaluateEarlyBacker(payerAccountId: AccountId, receivingHouseho
1225
1227
  declare function evaluateEarlyBackerBySettlementV2(payerAccountId: AccountId, receivingHouseholdId: HouseholdId, paidLots: readonly PaidLotRetentionV1[], window: EarlyBackerWindowV1, evaluatedAt: IsoTimestamp): EarlyBackerEvaluationV2;
1226
1228
 
1227
1229
  /** Stable machine-readable failures exposed by the economy domain. */
1228
- type EconomyErrorCode = "INVALID_AMOUNT" | "AMOUNT_OUT_OF_RANGE" | "AMOUNT_NOT_WHOLE_TOKEN" | "INVALID_CONTRACT" | "UNBALANCED_TRANSACTION" | "DUPLICATE_IDENTIFIER" | "DUPLICATE_TRANSACTION" | "INSUFFICIENT_BALANCE" | "INSUFFICIENT_ELIGIBLE_LOTS" | "SOURCE_LOT_RESTRICTED" | "REVERSAL_ALREADY_EXISTS" | "NEGATIVE_PROJECTION" | "INVALID_TIME_WINDOW";
1230
+ type EconomyErrorCode = "INVALID_AMOUNT" | "AMOUNT_OUT_OF_RANGE" | "AMOUNT_NOT_WHOLE_TOKEN" | "INVALID_CONTRACT" | "UNBALANCED_TRANSACTION" | "DUPLICATE_IDENTIFIER" | "DUPLICATE_TRANSACTION" | "INSUFFICIENT_BALANCE" | "INSUFFICIENT_ELIGIBLE_LOTS" | "SOURCE_LOT_RESTRICTED" | "REVERSAL_ALREADY_EXISTS" | "NEGATIVE_PROJECTION" | "INVALID_TIME_WINDOW" | "ADJUSTMENT_SELF_APPROVAL" | "ADJUSTMENT_EXPIRED" | "ADJUSTMENT_PREVIEW_MISMATCH" | "ADJUSTMENT_NOT_APPROVED";
1229
1231
  interface EconomyErrorEnvelopeV1 {
1230
1232
  readonly schemaVersion: "1";
1231
1233
  readonly error: {
@@ -1464,6 +1466,98 @@ interface AdjustmentRequestV1 {
1464
1466
  /** Proves that production adjustment approval was performed by another actor. */
1465
1467
  declare function assertDistinctAdjustmentApproval(request: AdjustmentRequestV1): void;
1466
1468
 
1469
+ type OperatorAdjustmentOperationV1 = "credit" | "reverse-credit";
1470
+ type OperatorAdjustmentTargetComponentV1 = "personal" | "household-treasury";
1471
+ type OperatorAdjustmentRefundPolicyV1 = "not-refundable";
1472
+ type OperatorAdjustmentDecisionKindV1 = "approve" | "reject";
1473
+ type OperatorAdjustmentProposalStatusV1 = "pending-approval";
1474
+ type OperatorAdjustmentFailureCodeV1 = "ADJUSTMENT_DISABLED" | "ADJUSTMENT_OWNER_REQUIRED" | "ADJUSTMENT_CAPABILITY_DENIED" | "ADJUSTMENT_STEP_UP_REQUIRED" | "ADJUSTMENT_TARGET_UNAVAILABLE" | "ADJUSTMENT_SELF_APPROVAL" | "ADJUSTMENT_EXPIRED" | "ADJUSTMENT_PREVIEW_MISMATCH" | "ADJUSTMENT_ALREADY_DECIDED" | "ADJUSTMENT_ALREADY_EXECUTED" | "ADJUSTMENT_NOT_APPROVED" | "ADJUSTMENT_REVERSAL_UNAVAILABLE";
1475
+ /**
1476
+ * Immutable server-prepared value plan shown to both adjustment operators.
1477
+ *
1478
+ * Callers may request an account and component, but only a trusted adapter may
1479
+ * resolve the wallet, ledger accounts and deterministic source lot recorded
1480
+ * here. Browser or MCP supplied wallet and ledger identifiers are never input
1481
+ * authority.
1482
+ */
1483
+ interface OperatorAdjustmentPreviewV1 {
1484
+ readonly schemaVersion: EconomyContractVersion;
1485
+ readonly previewId: string;
1486
+ readonly adjustmentId: string;
1487
+ readonly operation: OperatorAdjustmentOperationV1;
1488
+ readonly targetAccountId: AccountId;
1489
+ readonly targetComponent: OperatorAdjustmentTargetComponentV1;
1490
+ readonly targetWalletId: WalletId;
1491
+ readonly targetLedgerAccountId: AccountId;
1492
+ readonly offsetLedgerAccountId: AccountId;
1493
+ readonly sourceLotId: LotId;
1494
+ /** Positive magnitude. Reversals carry direction in `operation`. */
1495
+ readonly amount: TokenSubunitString;
1496
+ readonly reasonCode: string;
1497
+ /** SHA-256 of an adapter-owned, bounded ticket reference. */
1498
+ readonly ticketReferenceHash: string;
1499
+ readonly transferPolicy: LotTransferPolicy;
1500
+ readonly refundPolicy: OperatorAdjustmentRefundPolicyV1;
1501
+ readonly originalSourceLotId?: LotId;
1502
+ readonly originalTransactionId?: TransactionId;
1503
+ readonly preparedAt: IsoTimestamp;
1504
+ readonly expiresAt: IsoTimestamp;
1505
+ }
1506
+ /** Immutable first-operator proposal bound to the exact prepared preview. */
1507
+ interface OperatorAdjustmentProposalV1 {
1508
+ readonly schemaVersion: EconomyContractVersion;
1509
+ readonly proposalId: string;
1510
+ readonly adjustmentId: string;
1511
+ readonly previewHash: string;
1512
+ readonly status: OperatorAdjustmentProposalStatusV1;
1513
+ readonly proposedByAccountId: AccountId;
1514
+ readonly proposedAt: IsoTimestamp;
1515
+ readonly expiresAt: IsoTimestamp;
1516
+ }
1517
+ /** Immutable second-operator decision bound to the exact preview hash. */
1518
+ interface OperatorAdjustmentDecisionV1 {
1519
+ readonly schemaVersion: EconomyContractVersion;
1520
+ readonly decisionId: string;
1521
+ readonly adjustmentId: string;
1522
+ readonly proposalId: string;
1523
+ readonly proposalHash: string;
1524
+ readonly previewHash: string;
1525
+ readonly decision: OperatorAdjustmentDecisionKindV1;
1526
+ readonly proposedByAccountId: AccountId;
1527
+ readonly decidedByAccountId: AccountId;
1528
+ readonly proposedAt: IsoTimestamp;
1529
+ readonly decidedAt: IsoTimestamp;
1530
+ }
1531
+ /** Immutable result edge linking an approved plan to its ledger transaction. */
1532
+ interface OperatorAdjustmentExecutionV1 {
1533
+ readonly schemaVersion: EconomyContractVersion;
1534
+ readonly executionId: string;
1535
+ readonly adjustmentId: string;
1536
+ readonly previewHash: string;
1537
+ readonly proposalHash: string;
1538
+ readonly decisionHash: string;
1539
+ readonly sourceLotId: LotId;
1540
+ readonly transactionId: TransactionId;
1541
+ readonly resultReceiptId: string;
1542
+ readonly executedAt: IsoTimestamp;
1543
+ }
1544
+ /** Validates one exact, positive and privacy-minimized operator value plan. */
1545
+ declare function assertOperatorAdjustmentPreview(preview: OperatorAdjustmentPreviewV1): void;
1546
+ /** Canonical preview bytes for an approved SHA-256 adapter. */
1547
+ declare function canonicalOperatorAdjustmentPreviewPayload(preview: OperatorAdjustmentPreviewV1): string;
1548
+ /** Validates a pending proposal against the exact server-prepared preview. */
1549
+ declare function assertOperatorAdjustmentProposal(proposal: OperatorAdjustmentProposalV1, preview: OperatorAdjustmentPreviewV1, expectedPreviewHash: string): void;
1550
+ /** Canonical proposal bytes for the immutable pending-approval fact. */
1551
+ declare function canonicalOperatorAdjustmentProposalPayload(proposal: OperatorAdjustmentProposalV1): string;
1552
+ /** Validates a distinct-operator decision against its immutable preview. */
1553
+ declare function assertOperatorAdjustmentDecision(decision: OperatorAdjustmentDecisionV1, proposal: OperatorAdjustmentProposalV1, preview: OperatorAdjustmentPreviewV1, expectedPreviewHash: string, expectedProposalHash: string): void;
1554
+ /** Canonical decision bytes for approval evidence and execution binding. */
1555
+ declare function canonicalOperatorAdjustmentDecisionPayload(decision: OperatorAdjustmentDecisionV1): string;
1556
+ /** Validates the immutable ledger-result edge for one approved adjustment. */
1557
+ declare function assertOperatorAdjustmentExecution(execution: OperatorAdjustmentExecutionV1, preview: OperatorAdjustmentPreviewV1, proposal: OperatorAdjustmentProposalV1, decision: OperatorAdjustmentDecisionV1, expectedPreviewHash: string, expectedProposalHash: string, expectedDecisionHash: string): void;
1558
+ /** Canonical execution bytes for authority and audit-graph records. */
1559
+ declare function canonicalOperatorAdjustmentExecutionPayload(execution: OperatorAdjustmentExecutionV1): string;
1560
+
1467
1561
  type PaidLotLifecycleStatusV1 = "clear" | "partially-reversed" | "disputed" | "fully-reversed" | "chargeback-lost";
1468
1562
  type PaidLotLifecycleEventTypeV1 = "refund" | "dispute-hold" | "dispute-won" | "dispute-lost" | "chargeback" | "reversal";
1469
1563
  /** Paid-purchase facts not already carried by the source lot. */
@@ -2159,4 +2253,72 @@ interface SpendRequestV1 {
2159
2253
  /** Validates future child requests while creation remains policy-disabled. */
2160
2254
  declare function assertSpendRequest(request: SpendRequestV1): void;
2161
2255
 
2162
- export { type AccountId, type ActivityEntryV1, type ActivityStatus, type ActivityType, type AdjustmentRequestV1, type AdjustmentStatus, type AllocationId, type AllocationStatus, type AuditedChainedEconomicJournalTransactionV1, type AuditedEconomyCommandEnvelopeV1, BASELINE_GBP_CATALOG_VERSION, BASELINE_GBP_REFERENCE_RATE, BASELINE_GBP_TOKEN_PACKS, BASELINE_MONTHLY_SUBSCRIPTION_PLAN, BASELINE_PURCHASE_LIMIT_POLICY, type BalanceProjection, type BalanceProjectionSnapshotV1, type BitLabsConversionState, type BoostGameplayAllocationInputV1, type CanonicalPayloadHashFunctionV1, type ChainedEconomicJournalTransactionV1, type CloseModuleAllowanceInputV1, type CreateGameplayAllocationInputV1, type CreateModuleAllowanceInputV1, type CreateModulePurchaseReceiptInputV1, type CreateModuleSpendHoldInputV1, type CreateModuleSpendQuoteInputV1, EARLY_BACKER_SETTLEMENT_POLICY_V2, ECONOMY_AUTHORITY_COMMIT_OVERHEAD_OPERATIONS, ECONOMY_AUTHORITY_MAX_BATCH_BYTES, ECONOMY_AUTHORITY_MAX_BATCH_OPERATIONS, ECONOMY_AUTHORITY_MAX_RECORD_REFERENCES, ECONOMY_CONTRACT_VERSION, ECONOMY_RECOVERY_PROTOCOL_VERSION, type EarlyBackerEvaluationV1, type EarlyBackerEvaluationV2, type EarlyBackerWindowV1, type EconomicActivityStatusV1, type EconomicJournalStatus, type EconomicJournalTransactionV1, type EconomicWalletActivityEntryV1, type EconomyAcceptedCommandReceiptV1, type EconomyAcquisitionProviderV1, type EconomyAuditGraphV1, type EconomyAuditedIdempotencyResultV1, type EconomyAuditedIdempotencyScopeV1, type EconomyAuditedIdempotencyStateV1, type EconomyAuthorityCommitKindV1, type EconomyAuthorityCommitManifestV1, type EconomyAuthorityHeadV1, type EconomyAuthorityRecordKindV1, type EconomyAuthorityRecordReferenceV1, type EconomyAuthorityStateV1, type EconomyAuthorityWriteKindV1, type EconomyAuthorizationEvidenceV1, type EconomyCausationKindV1, type EconomyCausationReferenceV1, type EconomyClockPort, type EconomyCommandEnvelopeV1, type EconomyCommandProcessingDispositionV1, type EconomyCommandProcessingModeV1, type EconomyCommandResultOutcomeV1, type EconomyCommandResultReceiptV1, type EconomyCommandSourceV1, type EconomyCommandType, type EconomyCommandWorkflowEventV1, type EconomyCommandWorkflowStateV1, type EconomyContractVersion, type EconomyEncryptedOperationalHandleBindingV1, EconomyError, type EconomyErrorCode, type EconomyErrorEnvelopeV1, type EconomyEvidenceRecordReferenceV1, type EconomyEvidenceSignatureAlgorithmV1, type EconomyEvidenceSignatureMetadataV1, type EconomyEvidenceSignatureV1, type EconomyEvidenceSignatureVerificationInputV1, type EconomyEvidenceSignatureVerifierV1, type EconomyHmacFingerprintDomainV1, type EconomyHmacFingerprintV1, type EconomyHmacSha256DigestV1, type EconomyIdPort, type EconomyIdempotencyScopeV1, type EconomyIntegrityAnchorManifestV1, type EconomyIntegrityFailureCodeV1, type EconomyIntegrityVerificationReceiptV1, type EconomyIntegrityVerificationStatusV1, type EconomyMerkleInclusionProofV1, type EconomyMerkleProofStepV1, type EconomyOperationalHandlePurposeV1, type EconomyOutboxEventV1, type EconomyPersistencePort, type EconomyPersistencePortV2, type EconomyPersistencePortV3, type EconomyPortableCustomerReceiptBodyV1, type EconomyPortableCustomerReceiptV1, type EconomyPortableEvidenceReferenceV1, type EconomyPreparedEvidenceSignatureV1, type EconomyPrincipalTypeV1, type EconomyProviderEvidenceHashV1, type EconomyProviderEvidenceManifestV1, type EconomyQueryPortV1, type EconomyRecoveryAcceptanceBodyV1, type EconomyRecoveryAcceptanceEnvelopeV1, type EconomyRecoveryCommittedResultBodyV1, type EconomyRecoveryCommittedResultV1, type EconomyRecoveryDirectionV1, type EconomyRecoveryProtocolVersion, type EconomyRecoveryRecordKindV1, type EconomyRegionalEvidenceReceiptBodyV1, type EconomyRegionalEvidenceReceiptV1, type EconomySealedRecoveryPayloadV1, type EconomyUnitOfWork, type EconomyUnitOfWorkV2, type EconomyUnitOfWorkV3, type FundModuleAllowanceInputV1, type FxSnapshotV1, type GameplayAllocationV1, type GameplayLimitsV1, type GbpMinorUnitString, type HashedEconomyAuthorityCommitManifestV1, type HouseholdId, type IsoTimestamp, type JournalChainHeadV1, type JournalChainId, type JournalChainVerificationFailureCodeV1, type JournalChainVerificationResultV1, type LearningEntitlementId, type LearningModuleVersionId, type LedgerPostingV1, type LedgerTransactionV1, type LotId, type LotRefundState, type LotTransferPolicy, type LotUseContextV1, type LotUseOperation, MODULE_ALLOWANCE_PURPOSE, type ModuleAllowanceId, type ModuleAllowanceStatusV1, type ModuleAllowanceV1, type ModulePurchaseEntitlementStateV1, type ModulePurchaseFinancialStateV1, type ModulePurchaseReceiptV1, type ModulePurchaseReconciliationActionV1, type ModulePurchaseReconciliationObservationV1, type ModulePurchaseReconciliationResultV1, type ModuleSpendHoldId, type ModuleSpendHoldStatusV1, type ModuleSpendHoldV1, type ModuleSpendQuoteId, type ModuleSpendQuoteV1, type ModuleSpendTransitionResultV1, PRE_UTILITY_BACKER_COHORT, type PaidLotLifecycleArithmeticV1, type PaidLotLifecycleEventTypeV1, type PaidLotLifecycleEventV1, type PaidLotLifecycleMutationResultV1, type PaidLotLifecycleReceiptV1, type PaidLotLifecycleStatusV1, type PaidLotLifecycleV1, type PaidLotPurchaseProvenanceV1, type PaidLotRetentionV1, type PeriodicLimitWindow, type PersistedIdempotencyResultV1, type PostingId, type ProviderEventId, type PurchaseCapMutationResultV1, type PurchaseCapReservationStatusV1, type PurchaseCapReservationTransitionReceiptV1, type PurchaseCapReservationTransitionTypeV1, type PurchaseCapReservationTransitionV1, type PurchaseCapReservationV1, type PurchaseCapScopeTypeV1, type PurchaseCreditInstructionV1, type PurchaseIntentDisputeDispositionV1, type PurchaseIntentLifecycleV1, type PurchaseIntentReductionV1, type PurchaseIntentStatus, type PurchaseIntentTransitionReceiptV1, type PurchaseIntentTransitionResultV1, type PurchaseIntentTransitionTypeV1, type PurchaseIntentTransitionV1, type PurchaseIntentV1, type PurchaseLimitPolicyV1, type ReclaimGameplayAllocationInputV1, type ReclaimModuleAllowanceInputV1, type RecurrenceInterval, type ReleaseModuleSpendHoldInputV1, type ReservePurchaseCapsCommandV1, type ReversalInputV1, type RewardActivityTransitionV1, type RewardConversionStatus, type RewardConversionV1, type RewardRateV1, type RollingPurchaseCapStateV1, type ScopedPersistedIdempotencyResultV1, type SettleModuleSpendHoldInputV1, type SourceLotMovementType, type SourceLotMovementV1, type SourceLotSliceV1, type SourceLotV1, type SpendRequestPurpose, type SpendRequestStatus, type SpendRequestV1, TOKEN_SUBUNITS_MAX, TOKEN_SUBUNITS_MIN, TOKEN_SUBUNITS_PER_TOKEN, type TokenPackV1, type TokenReferenceRateV1, type TokenSource, type TokenSubscriptionPlanV1, type TokenSubunitString, type TransactionId, type VersionedSourceLotV1, type WalletActivityEntryV1, type WalletActivityFilterV1, type WalletActivityPageRequestV1, type WalletActivityPageV1, type WalletActivityStatusV1, type WalletBalanceDeltaV1, type WalletBalanceProjectionV1, type WalletBalanceSummaryV1, type WalletBalanceTotalsV1, type WalletId, type WalletKind, type WalletLifetimeBucket, type WalletLifetimeDeltaV1, type WalletLifetimeSnapshotV1, type WalletLifetimeTotalsV1, type WalletOwnerReferenceV1, type WalletOwnerType, type WalletPortfolioBalanceComponentV1, type WalletPortfolioComponentRole, type WalletPortfolioComponentScopeV1, type WalletPortfolioLifetimeComponentV1, type WalletPortfolioLifetimeV1, type WalletPortfolioReadScopeV1, type WalletPortfolioSummaryV1, type WalletPostingAccountBindingV1, type WalletProjectionBucket, type WalletStatus, type WalletV1, type WorkflowActivityStatusV1, type WorkflowWalletActivityEntryV1, advanceEconomyAuthorityHead, advanceJournalChainHead, applyPaidLotLifecycleEvent, applyPurchaseIntentTransition, applySourceLotMovement, applyTransactionToProjection, applyWalletBalanceDelta, applyWalletLifetimeDeltas, assertActivityEntry, assertAuditedEconomyCommandEnvelope, assertBalancedTransaction, assertDeterministicWalletBalanceSummary, assertDistinctAdjustmentApproval, assertEconomicJournalTransaction, assertEconomyAcceptedCommandReceipt, assertEconomyAuditGraph, assertEconomyAuditedIdempotencyResult, assertEconomyAuditedIdempotencyScope, assertEconomyAuthorityBatchLimits, assertEconomyAuthorityCommitManifest, assertEconomyAuthorityHead, assertEconomyAuthorityRecordReference, assertEconomyAuthorityRecoveryEvidence, assertEconomyAuthorizationEvidence, assertEconomyCommandEnvelope, assertEconomyCommandResultReceipt, assertEconomyCommandWorkflowEvent, assertEconomyEncryptedOperationalHandleBinding, assertEconomyEvidenceSignature, assertEconomyEvidenceSignatureMetadata, assertEconomyHmacFingerprint, assertEconomyIdempotencyScope, assertEconomyIdentifier, assertEconomyIntegrityAnchorManifest, assertEconomyIntegrityVerificationReceipt, assertEconomyMerkleInclusion, assertEconomyMerkleInclusionProof, assertEconomyPortableCustomerReceipt, assertEconomyPortableCustomerReceiptEvidence, assertEconomyPortableCustomerReceiptSignature, assertEconomyProviderEvidenceHash, assertEconomyProviderEvidenceManifest, assertEconomyRecoveryAcceptanceEnvelope, assertEconomyRecoveryCommittedResult, assertEconomyRecoveryResultLink, assertEconomyRegionalEvidenceChain, assertEconomyRegionalEvidenceEquality, assertEconomyRegionalEvidenceReceipt, assertEconomyRegionalEvidenceReceiptSignature, assertEconomySealedRecoveryPayload, assertExactAuditedEconomyCommandReplay, assertFlatTokenCatalog, assertFxSnapshot, assertGameplayAllocation, assertJournalChainHead, assertModuleAllowance, assertModulePurchaseReceipt, assertModulePurchaseReconciliationObservation, assertModuleSpendHold, assertModuleSpendQuote, assertNonNegativeAccounts, assertOpenPurchaseIntent, assertPaidLotLifecycle, assertPaidLotLifecycleEvent, assertPaidLotPurchaseProvenance, assertPurchaseCapReservation, assertPurchaseCapReservationTransition, assertPurchaseIntentBinding, assertPurchaseIntentLifecycle, assertPurchaseIntentTransition, assertPurchaseLimitPolicy, assertReversalAvailable, assertRewardConversion, assertRewardRate, assertRollingPurchaseCapState, assertScopedPersistedIdempotencyResult, assertSourceLot, assertSourceLotMovement, assertSpendRequest, assertTokenPack, assertTokenReferenceRate, assertTokenSubscriptionPlan, assertVersionedSourceLot, assertWallet, assertWalletActivityEntry, assertWalletActivityPage, assertWalletActivityPageForPortfolio, assertWalletActivityPageRequest, assertWalletBalanceDelta, assertWalletBalanceDeltaBatch, assertWalletBalanceProjection, assertWalletBalanceSummary, assertWalletLifetimeSnapshot, assertWalletLifetimeTotals, assertWalletOwnerReference, assertWalletPortfolioLifetime, assertWalletPortfolioReadScope, assertWalletPortfolioSummary, availableSourceLotAmount, boostGameplayAllocation, calculateRollingPurchaseCapUsage, canUseSourceLot, canonicalAuditedEconomyCommandEnvelopePayload, canonicalEconomyAcceptedCommandReceiptPayload, canonicalEconomyAuthorityCommitManifestPayload, canonicalEconomyAuthorityHeadPayload, canonicalEconomyCommandResultReceiptPayload, canonicalEconomyEncryptedOperationalHandleBindingPayload, canonicalEconomyIntegrityAnchorManifestPayload, canonicalEconomyIntegrityVerificationReceiptPayload, canonicalEconomyPortableCustomerReceiptBodyPayload, canonicalEconomyPortableCustomerReceiptPayload, canonicalEconomyPortableCustomerReceiptSigningPayload, canonicalEconomyProviderEvidenceHashPayload, canonicalEconomyProviderEvidenceManifestPayload, canonicalEconomyRecoveryAcceptanceBodyPayload, canonicalEconomyRecoveryAcceptanceEnvelopePayload, canonicalEconomyRecoveryCommittedResultBodyPayload, canonicalEconomyRecoveryCommittedResultPayload, canonicalEconomyRegionalEvidenceReceiptBodyPayload, canonicalEconomyRegionalEvidenceReceiptPayload, canonicalEconomyRegionalEvidenceReceiptSigningPayload, canonicalTransactionPayload, closeModuleAllowance, convertRewardPayout, createEarlyBackerRetentionFromPaidLot, createEconomyPortableCustomerReceipt, createEconomyRecoveryAcceptanceEnvelope, createEconomyRecoveryCommittedResult, createEconomyRegionalEvidenceReceipt, createGameplayAllocation, createInitialSourceLotSnapshot, createModuleAllowance, createModulePurchaseReceipt, createModuleSpendHold, createModuleSpendQuote, createPaidLotLifecycle, createProjectionSnapshot, createPurchaseIntentLifecycle, createReversalTransaction, createRollingPurchaseCapState, createWalletBalanceSummary, createWalletPortfolioLifetime, createWalletPortfolioSummary, deriveWalletBalanceDeltas, deriveWalletLifetimeDeltas, economyAssert, evaluateEarlyBacker, evaluateEarlyBackerBySettlementV2, fundModuleAllowance, isWholeTokenAmount, mapBitLabsConversionState, parseGbpMinorUnits, parseIsoTimestamp, parseTokenSubunits, prepareEconomyPortableCustomerReceiptSignature, prepareEconomyRegionalEvidenceReceiptSignature, rebuildBalanceProjection, reclaimGameplayAllocation, reclaimModuleAllowance, reconcileModulePurchase, reducePaidLotLifecycleEvents, reducePurchaseIntentTransitions, releaseModuleSpendHold, reserveRollingPurchaseCaps, selectSourceLots, serializeGbpMinorUnits, serializeTokenSubunits, settleModuleSpendHold, sortEconomyAuthorityRecordReferences, sortStringRecord, subunitsToWholeTokens, sumTokenSubunits, toEconomyErrorEnvelope, transitionRollingPurchaseCapReservation, verifyJournalChainSegment, wholeTokensToSubunits };
2256
+ type WalletInitializationNoOpCodeV1 = "WALLET_INITIALIZED" | "WALLET_ALREADY_INITIALIZED";
2257
+ /** Deterministic storage identities for one self-owned personal wallet. */
2258
+ interface PersonalWalletInitializationDocumentIdsV1 {
2259
+ readonly walletDescriptorId: string;
2260
+ readonly accessProjectionId: string;
2261
+ readonly balanceProjectionId: string;
2262
+ readonly lifetimeProjectionId: string;
2263
+ readonly outboxEventId: string;
2264
+ }
2265
+ /** Privacy-minimized semantic payload bound by the audited command hash. */
2266
+ interface PersonalWalletInitializationCommandV1 {
2267
+ readonly schemaVersion: EconomyContractVersion;
2268
+ readonly commandType: "initialize-wallet";
2269
+ readonly walletKind: "personal";
2270
+ readonly subjectAccountId: AccountId;
2271
+ readonly walletId: string;
2272
+ readonly portfolioId: string;
2273
+ readonly initializedAt: IsoTimestamp;
2274
+ }
2275
+ /** Non-economic integration intent emitted in the same authority batch. */
2276
+ interface PersonalWalletInitializationOutboxIntentV1 {
2277
+ readonly schemaVersion: EconomyContractVersion;
2278
+ readonly eventType: "wallet.initialized.v1";
2279
+ readonly eventId: string;
2280
+ readonly subjectAccountId: AccountId;
2281
+ readonly walletId: string;
2282
+ readonly portfolioId: string;
2283
+ readonly occurredAt: IsoTimestamp;
2284
+ }
2285
+ /** Complete rebuildable baseline for one new self-owned personal wallet. */
2286
+ interface PersonalWalletInitializationStateV1 {
2287
+ readonly schemaVersion: EconomyContractVersion;
2288
+ readonly documentIds: PersonalWalletInitializationDocumentIdsV1;
2289
+ readonly command: PersonalWalletInitializationCommandV1;
2290
+ readonly wallet: WalletV1;
2291
+ readonly scope: WalletPortfolioReadScopeV1;
2292
+ readonly balance: WalletBalanceSummaryV1;
2293
+ readonly lifetime: WalletLifetimeSnapshotV1;
2294
+ /** Initialization itself is not an economic activity. */
2295
+ readonly activityEntries: readonly WalletActivityEntryV1[];
2296
+ readonly outboxIntent: PersonalWalletInitializationOutboxIntentV1;
2297
+ }
2298
+ interface CreatePersonalWalletInitializationStateInputV1 {
2299
+ readonly subjectAccountId: AccountId;
2300
+ readonly initializedAt: IsoTimestamp;
2301
+ }
2302
+ /** Produces stable, non-guessable-by-sequence IDs without owning cryptography. */
2303
+ declare function createPersonalWalletInitializationDocumentIds(subjectAccountId: AccountId, hash: CanonicalPayloadHashFunctionV1): PersonalWalletInitializationDocumentIdsV1 & {
2304
+ readonly walletId: string;
2305
+ readonly portfolioId: string;
2306
+ };
2307
+ /** Validates the exact semantic initialization payload before hashing it. */
2308
+ declare function assertPersonalWalletInitializationCommand(command: PersonalWalletInitializationCommandV1): void;
2309
+ /** Returns the exact UTF-8 JSON bytes an approved SHA-256 adapter must hash. */
2310
+ declare function canonicalPersonalWalletInitializationCommandPayload(command: PersonalWalletInitializationCommandV1): string;
2311
+ /** Validates the privacy-minimized outbox intent. */
2312
+ declare function assertPersonalWalletInitializationOutboxIntent(intent: PersonalWalletInitializationOutboxIntentV1): void;
2313
+ /** Canonical bytes for the create-only initialization outbox fact. */
2314
+ declare function canonicalPersonalWalletInitializationOutboxPayload(intent: PersonalWalletInitializationOutboxIntentV1): string;
2315
+ /**
2316
+ * Builds the complete exact-zero personal-wallet baseline. The caller supplies
2317
+ * SHA-256 and persists these records with receipts, idempotency, the authority
2318
+ * manifest, and the conditional head advance in one ACID boundary.
2319
+ */
2320
+ declare function createPersonalWalletInitializationState(input: CreatePersonalWalletInitializationStateInputV1, hash: CanonicalPayloadHashFunctionV1): PersonalWalletInitializationStateV1;
2321
+ /** Proves the personal-wallet initialization state is complete and exact-zero. */
2322
+ declare function assertPersonalWalletInitializationState(state: PersonalWalletInitializationStateV1): void;
2323
+
2324
+ export { type AccountId, type ActivityEntryV1, type ActivityStatus, type ActivityType, type AdjustmentRequestV1, type AdjustmentStatus, type AllocationId, type AllocationStatus, type AuditedChainedEconomicJournalTransactionV1, type AuditedEconomyCommandEnvelopeV1, BASELINE_GBP_CATALOG_VERSION, BASELINE_GBP_REFERENCE_RATE, BASELINE_GBP_TOKEN_PACKS, BASELINE_MONTHLY_SUBSCRIPTION_PLAN, BASELINE_PURCHASE_LIMIT_POLICY, type BalanceProjection, type BalanceProjectionSnapshotV1, type BitLabsConversionState, type BoostGameplayAllocationInputV1, type CanonicalPayloadHashFunctionV1, type ChainedEconomicJournalTransactionV1, type CloseModuleAllowanceInputV1, type CreateGameplayAllocationInputV1, type CreateModuleAllowanceInputV1, type CreateModulePurchaseReceiptInputV1, type CreateModuleSpendHoldInputV1, type CreateModuleSpendQuoteInputV1, type CreatePersonalWalletInitializationStateInputV1, EARLY_BACKER_SETTLEMENT_POLICY_V2, ECONOMY_AUTHORITY_COMMIT_OVERHEAD_OPERATIONS, ECONOMY_AUTHORITY_MAX_BATCH_BYTES, ECONOMY_AUTHORITY_MAX_BATCH_OPERATIONS, ECONOMY_AUTHORITY_MAX_RECORD_REFERENCES, ECONOMY_CONTRACT_VERSION, ECONOMY_RECOVERY_PROTOCOL_VERSION, type EarlyBackerEvaluationV1, type EarlyBackerEvaluationV2, type EarlyBackerWindowV1, type EconomicActivityStatusV1, type EconomicJournalStatus, type EconomicJournalTransactionV1, type EconomicWalletActivityEntryV1, type EconomyAcceptedCommandReceiptV1, type EconomyAcquisitionProviderV1, type EconomyAuditGraphV1, type EconomyAuditedCommandTypeV1, type EconomyAuditedIdempotencyResultV1, type EconomyAuditedIdempotencyScopeV1, type EconomyAuditedIdempotencyStateV1, type EconomyAuthorityCommitKindV1, type EconomyAuthorityCommitManifestV1, type EconomyAuthorityHeadV1, type EconomyAuthorityRecordKindV1, type EconomyAuthorityRecordReferenceV1, type EconomyAuthorityStateV1, type EconomyAuthorityWriteKindV1, type EconomyAuthorizationEvidenceV1, type EconomyCausationKindV1, type EconomyCausationReferenceV1, type EconomyClockPort, type EconomyCommandEnvelopeV1, type EconomyCommandProcessingDispositionV1, type EconomyCommandProcessingModeV1, type EconomyCommandResultOutcomeV1, type EconomyCommandResultReceiptV1, type EconomyCommandSourceV1, type EconomyCommandType, type EconomyCommandWorkflowEventV1, type EconomyCommandWorkflowStateV1, type EconomyContractVersion, type EconomyEncryptedOperationalHandleBindingV1, EconomyError, type EconomyErrorCode, type EconomyErrorEnvelopeV1, type EconomyEvidenceRecordReferenceV1, type EconomyEvidenceSignatureAlgorithmV1, type EconomyEvidenceSignatureMetadataV1, type EconomyEvidenceSignatureV1, type EconomyEvidenceSignatureVerificationInputV1, type EconomyEvidenceSignatureVerifierV1, type EconomyHmacFingerprintDomainV1, type EconomyHmacFingerprintV1, type EconomyHmacSha256DigestV1, type EconomyIdPort, type EconomyIdempotencyScopeV1, type EconomyIntegrityAnchorManifestV1, type EconomyIntegrityFailureCodeV1, type EconomyIntegrityVerificationReceiptV1, type EconomyIntegrityVerificationStatusV1, type EconomyMerkleInclusionProofV1, type EconomyMerkleProofStepV1, type EconomyOperationalHandlePurposeV1, type EconomyOutboxEventV1, type EconomyPersistencePort, type EconomyPersistencePortV2, type EconomyPersistencePortV3, type EconomyPortableCustomerReceiptBodyV1, type EconomyPortableCustomerReceiptV1, type EconomyPortableEvidenceReferenceV1, type EconomyPreparedEvidenceSignatureV1, type EconomyPrincipalTypeV1, type EconomyProviderEvidenceHashV1, type EconomyProviderEvidenceManifestV1, type EconomyQueryPortV1, type EconomyRecoveryAcceptanceBodyV1, type EconomyRecoveryAcceptanceEnvelopeV1, type EconomyRecoveryCommittedResultBodyV1, type EconomyRecoveryCommittedResultV1, type EconomyRecoveryDirectionV1, type EconomyRecoveryProtocolVersion, type EconomyRecoveryRecordKindV1, type EconomyRegionalEvidenceReceiptBodyV1, type EconomyRegionalEvidenceReceiptV1, type EconomySealedRecoveryPayloadV1, type EconomyUnitOfWork, type EconomyUnitOfWorkV2, type EconomyUnitOfWorkV3, type FundModuleAllowanceInputV1, type FxSnapshotV1, type GameplayAllocationV1, type GameplayLimitsV1, type GbpMinorUnitString, type HashedEconomyAuthorityCommitManifestV1, type HouseholdId, type IsoTimestamp, type JournalChainHeadV1, type JournalChainId, type JournalChainVerificationFailureCodeV1, type JournalChainVerificationResultV1, type LearningEntitlementId, type LearningModuleVersionId, type LedgerPostingV1, type LedgerTransactionV1, type LotId, type LotRefundState, type LotTransferPolicy, type LotUseContextV1, type LotUseOperation, MODULE_ALLOWANCE_PURPOSE, type ModuleAllowanceId, type ModuleAllowanceStatusV1, type ModuleAllowanceV1, type ModulePurchaseEntitlementStateV1, type ModulePurchaseFinancialStateV1, type ModulePurchaseReceiptV1, type ModulePurchaseReconciliationActionV1, type ModulePurchaseReconciliationObservationV1, type ModulePurchaseReconciliationResultV1, type ModuleSpendHoldId, type ModuleSpendHoldStatusV1, type ModuleSpendHoldV1, type ModuleSpendQuoteId, type ModuleSpendQuoteV1, type ModuleSpendTransitionResultV1, type OperatorAdjustmentDecisionKindV1, type OperatorAdjustmentDecisionV1, type OperatorAdjustmentExecutionV1, type OperatorAdjustmentFailureCodeV1, type OperatorAdjustmentOperationV1, type OperatorAdjustmentPreviewV1, type OperatorAdjustmentProposalStatusV1, type OperatorAdjustmentProposalV1, type OperatorAdjustmentRefundPolicyV1, type OperatorAdjustmentTargetComponentV1, PRE_UTILITY_BACKER_COHORT, type PaidLotLifecycleArithmeticV1, type PaidLotLifecycleEventTypeV1, type PaidLotLifecycleEventV1, type PaidLotLifecycleMutationResultV1, type PaidLotLifecycleReceiptV1, type PaidLotLifecycleStatusV1, type PaidLotLifecycleV1, type PaidLotPurchaseProvenanceV1, type PaidLotRetentionV1, type PeriodicLimitWindow, type PersistedIdempotencyResultV1, type PersonalWalletInitializationCommandV1, type PersonalWalletInitializationDocumentIdsV1, type PersonalWalletInitializationOutboxIntentV1, type PersonalWalletInitializationStateV1, type PostingId, type ProviderEventId, type PurchaseCapMutationResultV1, type PurchaseCapReservationStatusV1, type PurchaseCapReservationTransitionReceiptV1, type PurchaseCapReservationTransitionTypeV1, type PurchaseCapReservationTransitionV1, type PurchaseCapReservationV1, type PurchaseCapScopeTypeV1, type PurchaseCreditInstructionV1, type PurchaseIntentDisputeDispositionV1, type PurchaseIntentLifecycleV1, type PurchaseIntentReductionV1, type PurchaseIntentStatus, type PurchaseIntentTransitionReceiptV1, type PurchaseIntentTransitionResultV1, type PurchaseIntentTransitionTypeV1, type PurchaseIntentTransitionV1, type PurchaseIntentV1, type PurchaseLimitPolicyV1, type ReclaimGameplayAllocationInputV1, type ReclaimModuleAllowanceInputV1, type RecurrenceInterval, type ReleaseModuleSpendHoldInputV1, type ReservePurchaseCapsCommandV1, type ReversalInputV1, type RewardActivityTransitionV1, type RewardConversionStatus, type RewardConversionV1, type RewardRateV1, type RollingPurchaseCapStateV1, type ScopedPersistedIdempotencyResultV1, type SettleModuleSpendHoldInputV1, type SourceLotMovementType, type SourceLotMovementV1, type SourceLotSliceV1, type SourceLotV1, type SpendRequestPurpose, type SpendRequestStatus, type SpendRequestV1, TOKEN_SUBUNITS_MAX, TOKEN_SUBUNITS_MIN, TOKEN_SUBUNITS_PER_TOKEN, type TokenPackV1, type TokenReferenceRateV1, type TokenSource, type TokenSubscriptionPlanV1, type TokenSubunitString, type TransactionId, type VersionedSourceLotV1, type WalletActivityEntryV1, type WalletActivityFilterV1, type WalletActivityPageRequestV1, type WalletActivityPageV1, type WalletActivityStatusV1, type WalletBalanceDeltaV1, type WalletBalanceProjectionV1, type WalletBalanceSummaryV1, type WalletBalanceTotalsV1, type WalletId, type WalletInitializationNoOpCodeV1, type WalletKind, type WalletLifetimeBucket, type WalletLifetimeDeltaV1, type WalletLifetimeSnapshotV1, type WalletLifetimeTotalsV1, type WalletOwnerReferenceV1, type WalletOwnerType, type WalletPortfolioBalanceComponentV1, type WalletPortfolioComponentRole, type WalletPortfolioComponentScopeV1, type WalletPortfolioLifetimeComponentV1, type WalletPortfolioLifetimeV1, type WalletPortfolioReadScopeV1, type WalletPortfolioSummaryV1, type WalletPostingAccountBindingV1, type WalletProjectionBucket, type WalletStatus, type WalletV1, type WorkflowActivityStatusV1, type WorkflowWalletActivityEntryV1, advanceEconomyAuthorityHead, advanceJournalChainHead, applyPaidLotLifecycleEvent, applyPurchaseIntentTransition, applySourceLotMovement, applyTransactionToProjection, applyWalletBalanceDelta, applyWalletLifetimeDeltas, assertActivityEntry, assertAuditedEconomyCommandEnvelope, assertBalancedTransaction, assertDeterministicWalletBalanceSummary, assertDistinctAdjustmentApproval, assertEconomicJournalTransaction, assertEconomyAcceptedCommandReceipt, assertEconomyAuditGraph, assertEconomyAuditedIdempotencyResult, assertEconomyAuditedIdempotencyScope, assertEconomyAuthorityBatchLimits, assertEconomyAuthorityCommitManifest, assertEconomyAuthorityHead, assertEconomyAuthorityRecordReference, assertEconomyAuthorityRecoveryEvidence, assertEconomyAuthorizationEvidence, assertEconomyCommandEnvelope, assertEconomyCommandResultReceipt, assertEconomyCommandWorkflowEvent, assertEconomyEncryptedOperationalHandleBinding, assertEconomyEvidenceSignature, assertEconomyEvidenceSignatureMetadata, assertEconomyHmacFingerprint, assertEconomyIdempotencyScope, assertEconomyIdentifier, assertEconomyIntegrityAnchorManifest, assertEconomyIntegrityVerificationReceipt, assertEconomyMerkleInclusion, assertEconomyMerkleInclusionProof, assertEconomyPortableCustomerReceipt, assertEconomyPortableCustomerReceiptEvidence, assertEconomyPortableCustomerReceiptSignature, assertEconomyProviderEvidenceHash, assertEconomyProviderEvidenceManifest, assertEconomyRecoveryAcceptanceEnvelope, assertEconomyRecoveryCommittedResult, assertEconomyRecoveryResultLink, assertEconomyRegionalEvidenceChain, assertEconomyRegionalEvidenceEquality, assertEconomyRegionalEvidenceReceipt, assertEconomyRegionalEvidenceReceiptSignature, assertEconomySealedRecoveryPayload, assertExactAuditedEconomyCommandReplay, assertFlatTokenCatalog, assertFxSnapshot, assertGameplayAllocation, assertJournalChainHead, assertModuleAllowance, assertModulePurchaseReceipt, assertModulePurchaseReconciliationObservation, assertModuleSpendHold, assertModuleSpendQuote, assertNonNegativeAccounts, assertOpenPurchaseIntent, assertOperatorAdjustmentDecision, assertOperatorAdjustmentExecution, assertOperatorAdjustmentPreview, assertOperatorAdjustmentProposal, assertPaidLotLifecycle, assertPaidLotLifecycleEvent, assertPaidLotPurchaseProvenance, assertPersonalWalletInitializationCommand, assertPersonalWalletInitializationOutboxIntent, assertPersonalWalletInitializationState, assertPurchaseCapReservation, assertPurchaseCapReservationTransition, assertPurchaseIntentBinding, assertPurchaseIntentLifecycle, assertPurchaseIntentTransition, assertPurchaseLimitPolicy, assertReversalAvailable, assertRewardConversion, assertRewardRate, assertRollingPurchaseCapState, assertScopedPersistedIdempotencyResult, assertSourceLot, assertSourceLotMovement, assertSpendRequest, assertTokenPack, assertTokenReferenceRate, assertTokenSubscriptionPlan, assertVersionedSourceLot, assertWallet, assertWalletActivityEntry, assertWalletActivityPage, assertWalletActivityPageForPortfolio, assertWalletActivityPageRequest, assertWalletBalanceDelta, assertWalletBalanceDeltaBatch, assertWalletBalanceProjection, assertWalletBalanceSummary, assertWalletLifetimeSnapshot, assertWalletLifetimeTotals, assertWalletOwnerReference, assertWalletPortfolioLifetime, assertWalletPortfolioReadScope, assertWalletPortfolioSummary, availableSourceLotAmount, boostGameplayAllocation, calculateRollingPurchaseCapUsage, canUseSourceLot, canonicalAuditedEconomyCommandEnvelopePayload, canonicalEconomyAcceptedCommandReceiptPayload, canonicalEconomyAuthorityCommitManifestPayload, canonicalEconomyAuthorityHeadPayload, canonicalEconomyCommandResultReceiptPayload, canonicalEconomyEncryptedOperationalHandleBindingPayload, canonicalEconomyIntegrityAnchorManifestPayload, canonicalEconomyIntegrityVerificationReceiptPayload, canonicalEconomyPortableCustomerReceiptBodyPayload, canonicalEconomyPortableCustomerReceiptPayload, canonicalEconomyPortableCustomerReceiptSigningPayload, canonicalEconomyProviderEvidenceHashPayload, canonicalEconomyProviderEvidenceManifestPayload, canonicalEconomyRecoveryAcceptanceBodyPayload, canonicalEconomyRecoveryAcceptanceEnvelopePayload, canonicalEconomyRecoveryCommittedResultBodyPayload, canonicalEconomyRecoveryCommittedResultPayload, canonicalEconomyRegionalEvidenceReceiptBodyPayload, canonicalEconomyRegionalEvidenceReceiptPayload, canonicalEconomyRegionalEvidenceReceiptSigningPayload, canonicalOperatorAdjustmentDecisionPayload, canonicalOperatorAdjustmentExecutionPayload, canonicalOperatorAdjustmentPreviewPayload, canonicalOperatorAdjustmentProposalPayload, canonicalPersonalWalletInitializationCommandPayload, canonicalPersonalWalletInitializationOutboxPayload, canonicalTransactionPayload, closeModuleAllowance, convertRewardPayout, createEarlyBackerRetentionFromPaidLot, createEconomyPortableCustomerReceipt, createEconomyRecoveryAcceptanceEnvelope, createEconomyRecoveryCommittedResult, createEconomyRegionalEvidenceReceipt, createGameplayAllocation, createInitialSourceLotSnapshot, createModuleAllowance, createModulePurchaseReceipt, createModuleSpendHold, createModuleSpendQuote, createPaidLotLifecycle, createPersonalWalletInitializationDocumentIds, createPersonalWalletInitializationState, createProjectionSnapshot, createPurchaseIntentLifecycle, createReversalTransaction, createRollingPurchaseCapState, createWalletBalanceSummary, createWalletPortfolioLifetime, createWalletPortfolioSummary, deriveWalletBalanceDeltas, deriveWalletLifetimeDeltas, economyAssert, evaluateEarlyBacker, evaluateEarlyBackerBySettlementV2, fundModuleAllowance, isWholeTokenAmount, mapBitLabsConversionState, parseGbpMinorUnits, parseIsoTimestamp, parseTokenSubunits, prepareEconomyPortableCustomerReceiptSignature, prepareEconomyRegionalEvidenceReceiptSignature, rebuildBalanceProjection, reclaimGameplayAllocation, reclaimModuleAllowance, reconcileModulePurchase, reducePaidLotLifecycleEvents, reducePurchaseIntentTransitions, releaseModuleSpendHold, reserveRollingPurchaseCaps, selectSourceLots, serializeGbpMinorUnits, serializeTokenSubunits, settleModuleSpendHold, sortEconomyAuthorityRecordReferences, sortStringRecord, subunitsToWholeTokens, sumTokenSubunits, toEconomyErrorEnvelope, transitionRollingPurchaseCapReservation, verifyJournalChainSegment, wholeTokensToSubunits };