@degenerate/generic 0.3.2 → 0.6.0

package/dist/models/share-data/share-data-persistence-models.d.ts

@@ -25,6 +25,8 @@ export declare const PersistedCreationConfigSchema: z.ZodObject<{
             Clearing: "Clearing";
             Funding: "Funding";
             Distribution: "Distribution";
+            GraceRepayment: "GraceRepayment";
+            Settlement: "Settlement";
         }>;
         relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
@@ -90,12 +92,14 @@ export type PersistedTransaction = z.infer<typeof PersistedTransactionSchema>;
  * a snapshot whose state was edited without re-signing fails loudly.
  */
 export declare const PersistedShareDataSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<2>;
+    schemaVersion: z.ZodLiteral<3>;
     id: z.ZodString;
     blockType: z.ZodEnum<{
         Clearing: "Clearing";
         Funding: "Funding";
         Distribution: "Distribution";
+        GraceRepayment: "GraceRepayment";
+        Settlement: "Settlement";
     }>;
     signingCurve: z.ZodEnum<{
         ed25519: EllipticalCurvesSigning.Curve25519;
@@ -114,6 +118,8 @@ export declare const PersistedShareDataSchema: z.ZodObject<{
                 Clearing: "Clearing";
                 Funding: "Funding";
                 Distribution: "Distribution";
+                GraceRepayment: "GraceRepayment";
+                Settlement: "Settlement";
             }>;
             relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
@@ -131,6 +137,10 @@ export declare const PersistedShareDataSchema: z.ZodObject<{
         timestamp: z.ZodNumber;
         purpose: z.ZodString;
     }, z.core.$strip>>;
+    authorizedSigners: z.ZodArray<z.ZodObject<{
+        publicKey: z.ZodString;
+        functionIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
     transactionLog: z.ZodArray<z.ZodObject<{
         functionId: z.ZodString;
         input: z.ZodOptional<z.ZodAny>;
@@ -154,5 +164,5 @@ export declare const PersistedShareDataSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type PersistedShareData = z.infer<typeof PersistedShareDataSchema>;
 /** The only schema version this build understands. */
-export declare const PERSISTED_SHARE_DATA_SCHEMA_VERSION: 2;
+export declare const PERSISTED_SHARE_DATA_SCHEMA_VERSION: 3;
 //# sourceMappingURL=share-data-persistence-models.d.ts.map

package/dist/models/share-data/share-data-persistence-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"share-data-persistence-models.d.ts","sourceRoot":"","sources":["../../../src/models/share-data/share-data-persistence-models.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAEH,cAAc,EAEjB,MAAM,iCAAiC,CAAC;AAkBzC;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;EAGtC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;iBAIxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,cAAc,CAAC;IAC1B,cAAc,EAAE,uBAAuB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;iBAOrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,sDAAsD;AACtD,eAAO,MAAM,mCAAmC,EAAG,CAAU,CAAC"}
+{"version":3,"file":"share-data-persistence-models.d.ts","sourceRoot":"","sources":["../../../src/models/share-data/share-data-persistence-models.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAEH,cAAc,EAEjB,MAAM,iCAAiC,CAAC;AAmBzC;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;EAGtC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;iBAIxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,cAAc,CAAC;IAC1B,cAAc,EAAE,uBAAuB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;iBAOrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,sDAAsD;AACtD,eAAO,MAAM,mCAAmC,EAAG,CAAU,CAAC"}

package/dist/models/share-data/share-data-persistence-models.js

@@ -73,13 +73,20 @@ exports.PersistedTransactionSchema = zod_1.default.object({
  * a snapshot whose state was edited without re-signing fails loudly.
  */
 exports.PersistedShareDataSchema = zod_1.default.object({
-    schemaVersion: zod_1.default.literal(2),
+    schemaVersion: zod_1.default.literal(3),
     id: zod_1.default.string(),
     blockType: shareblock_models_1.ShareBlockTypeSchema,
     signingCurve: exports.PersistedSigningCurveSchema,
     initialCrypto: share_data_crypto_models_1.IShareDataInitialCryptoDataSchema,
     creationConfig: exports.PersistedCreationConfigSchema,
     structuralProofs: share_data_crypto_models_1.ShareDataProofsSchema,
+    // The delegated-signer grants registered at construction (least-privilege
+    // function scoping per grant). The registration *proofs* live in
+    // `structuralProofs` keyed by their `delegate:<key>:<ids>` purpose; this
+    // field carries the grant tuples the builder replays via
+    // `addAuthorizedSigner` so the rebuilt block re-derives the same signer set
+    // (and the same canonical hash). Empty for blocks with no delegations.
+    authorizedSigners: zod_1.default.array(share_data_crypto_models_1.IAuthorizedSignerSchema),
     transactionLog: zod_1.default.array(exports.PersistedTransactionSchema),
     // Integrity cross-checks — compared against the replayed result, never
     // trusted as source of truth.
@@ -90,5 +97,5 @@ exports.PersistedShareDataSchema = zod_1.default.object({
     expectedVersion: zod_1.default.number(),
 });
 /** The only schema version this build understands. */
-exports.PERSISTED_SHARE_DATA_SCHEMA_VERSION = 2;
+exports.PERSISTED_SHARE_DATA_SCHEMA_VERSION = 3;
 //#endregion Persistence Schemas

package/dist/models/shareblock/shareblock-models.d.ts

@@ -1,15 +1,27 @@
 import z from 'zod';
 /**
- * The three ShareBlock specializations the platform uses to move money
- * through a loan's lifecycle.
+ * The ShareBlock specializations the platform uses to move money through a
+ * loan's lifecycle, plus the cross-block settlement coordinator.
  *
- *   - `Clearing`     — neutral holding spot funds pass through before they're
- *                      committed to either side of a deal. Used to net
- *                      borrower and lender flows before settling.
- *   - `Funding`      — the lender-funded pool that backs a specific loan.
- *                      Holds principal between funding and disbursement.
- *   - `Distribution` — the destination ShareBlock that pays principal to a
- *                      borrower or returns/interest to a lender.
+ *   - `Clearing`       — neutral holding spot funds pass through before they're
+ *                        committed to either side of a deal. Used to net
+ *                        borrower and lender flows before settling.
+ *   - `Funding`        — the lender-funded pool that backs a specific loan.
+ *                        Holds principal between funding and disbursement.
+ *   - `Distribution`   — the destination ShareBlock that pays principal to a
+ *                        borrower or returns/interest to a lender.
+ *   - `GraceRepayment` — the borrower-repayment block for Rapture's Grace
+ *                        product. Per-lender Grace-or-yield decisions are
+ *                        toggled while the loan is in flight, snapshotted at
+ *                        repayment-initiate, and drive the blended-rate
+ *                        allocation when the borrower pays. Terminal state is
+ *                        either `fullyRepaid: true` OR `defaulted: true`,
+ *                        mutually exclusive.
+ *   - `Settlement`     — a cross-block atomic-settlement coordinator. Not a
+ *                        money-holding block: its state is the settlement
+ *                        plan + per-leg status + two-phase-commit phase, and
+ *                        its append-only history is the recovery journal that
+ *                        drives funds across the blocks above all-or-nothing.
  *
  * New ShareBlock variants should be additive — never re-use a value with new
  * semantics, since downstream rule libraries pattern-match on the literal.
@@ -17,13 +29,43 @@ import z from 'zod';
 export declare enum ShareBlockType {
     Clearing = "Clearing",
     Funding = "Funding",
-    Distribution = "Distribution"
+    Distribution = "Distribution",
+    GraceRepayment = "GraceRepayment",
+    Settlement = "Settlement"
 }
 export declare const ShareBlockTypeSchema: z.ZodEnum<{
     Clearing: "Clearing";
     Funding: "Funding";
     Distribution: "Distribution";
+    GraceRepayment: "GraceRepayment";
+    Settlement: "Settlement";
 }>;
+/**
+ * Direction of a settlement leg relative to one participating block:
+ *
+ *   - `debit`  — funds leave this block (it is the source). On reserve the
+ *                amount is removed from spendable `balance` and held.
+ *   - `credit` — funds arrive at this block (it is the destination). On
+ *                reserve nothing moves yet; the amount lands at commit.
+ *
+ * Shared by the per-block reservation bucket and the coordinator's leg list.
+ */
+export declare const SettlementLegDirectionSchema: z.ZodEnum<{
+    debit: "debit";
+    credit: "credit";
+}>;
+export type SettlementLegDirection = z.infer<typeof SettlementLegDirectionSchema>;
+/**
+ * Lifecycle of one block's reservation for a settlement. Advances forward
+ * only: `reserved → committed` (finalized) or `reserved → released` (unwound
+ * on abort). A standard rule enforces the monotonicity.
+ */
+export declare const ReservationStatusSchema: z.ZodEnum<{
+    reserved: "reserved";
+    committed: "committed";
+    released: "released";
+}>;
+export type ReservationStatus = z.infer<typeof ReservationStatusSchema>;
 /**
  * Roles a participant plays inside a ShareBlock. A single party may hold
  * multiple roles across different ShareBlocks (e.g. the same uid is `Lender`
@@ -59,6 +101,37 @@ export declare const IShareBlockParticipantSchema: z.ZodObject<{
     settledAmount: z.ZodNumber;
 }, z.core.$strip>;
 export type IShareBlockParticipant = z.infer<typeof IShareBlockParticipantSchema>;
+/**
+ * One block's record of funds it is holding for an in-flight settlement,
+ * stored under `settlementId` in the block's `reservations` bucket. The
+ * per-block half of the two-phase-commit money model:
+ *
+ *   - debit leg  — `amountCents` is already removed from `balance` and held
+ *                  here until the settlement commits (finalized out) or aborts
+ *                  (returned to `balance`).
+ *   - credit leg — pending incoming funds; `balance` is unchanged until the
+ *                  settlement commits, at which point `amountCents` lands.
+ *
+ * `againstHash` pins the leg to the block's current-state hash at sign time
+ * (D5 drift guard): if the block advanced since the leg was signed, the
+ * reserve proof fails at the transaction boundary and the settlement aborts.
+ */
+export declare const IReservedLegSchema: z.ZodObject<{
+    settlementId: z.ZodString;
+    direction: z.ZodEnum<{
+        debit: "debit";
+        credit: "credit";
+    }>;
+    amountCents: z.ZodNumber;
+    currency: z.ZodString;
+    againstHash: z.ZodString;
+    status: z.ZodEnum<{
+        reserved: "reserved";
+        committed: "committed";
+        released: "released";
+    }>;
+}, z.core.$strip>;
+export type IReservedLeg = z.infer<typeof IReservedLegSchema>;
 /**
  * The mutable state carried inside a ShareBlock's `_currentState`. This is
  * the canonical shape rules and functions inspect when proposing changes.
@@ -71,12 +144,19 @@ export type IShareBlockParticipant = z.infer<typeof IShareBlockParticipantSchema
  *   - `participants` — committed parties keyed by `userId`. Adding a
  *                participant goes through a rule-gated function so the
  *                participant list itself is auditable.
+ *   - `reservations` — in-flight settlement holds keyed by `settlementId`.
+ *                Optional and absent by default; a block only carries this
+ *                once it opts into the settlement capability and a settlement
+ *                reserves against it. Funds held here are excluded from
+ *                spendable `balance` (debit legs are already deducted).
  */
 export declare const IShareBlockStateSchema: z.ZodObject<{
     blockType: z.ZodEnum<{
         Clearing: "Clearing";
         Funding: "Funding";
         Distribution: "Distribution";
+        GraceRepayment: "GraceRepayment";
+        Settlement: "Settlement";
     }>;
     balance: z.ZodNumber;
     currency: z.ZodString;
@@ -92,6 +172,21 @@ export declare const IShareBlockStateSchema: z.ZodObject<{
         committedAmount: z.ZodNumber;
         settledAmount: z.ZodNumber;
     }, z.core.$strip>>;
+    reservations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        settlementId: z.ZodString;
+        direction: z.ZodEnum<{
+            debit: "debit";
+            credit: "credit";
+        }>;
+        amountCents: z.ZodNumber;
+        currency: z.ZodString;
+        againstHash: z.ZodString;
+        status: z.ZodEnum<{
+            reserved: "reserved";
+            committed: "committed";
+            released: "released";
+        }>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type IShareBlockState = z.infer<typeof IShareBlockStateSchema>;
 /**
@@ -120,6 +215,21 @@ export declare const IFundingShareBlockStateSchema: z.ZodObject<{
         committedAmount: z.ZodNumber;
         settledAmount: z.ZodNumber;
     }, z.core.$strip>>;
+    reservations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        settlementId: z.ZodString;
+        direction: z.ZodEnum<{
+            debit: "debit";
+            credit: "credit";
+        }>;
+        amountCents: z.ZodNumber;
+        currency: z.ZodString;
+        againstHash: z.ZodString;
+        status: z.ZodEnum<{
+            reserved: "reserved";
+            committed: "committed";
+            released: "released";
+        }>;
+    }, z.core.$strip>>>;
     blockType: z.ZodLiteral<"Funding">;
     committed: z.ZodBoolean;
     committedBy: z.ZodOptional<z.ZodString>;
@@ -153,12 +263,161 @@ export declare const IDistributionShareBlockStateSchema: z.ZodObject<{
         committedAmount: z.ZodNumber;
         settledAmount: z.ZodNumber;
     }, z.core.$strip>>;
+    reservations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        settlementId: z.ZodString;
+        direction: z.ZodEnum<{
+            debit: "debit";
+            credit: "credit";
+        }>;
+        amountCents: z.ZodNumber;
+        currency: z.ZodString;
+        againstHash: z.ZodString;
+        status: z.ZodEnum<{
+            reserved: "reserved";
+            committed: "committed";
+            released: "released";
+        }>;
+    }, z.core.$strip>>>;
     blockType: z.ZodLiteral<"Distribution">;
     distributed: z.ZodBoolean;
     distributedBy: z.ZodOptional<z.ZodString>;
     distributedAt: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type IDistributionShareBlockState = z.infer<typeof IDistributionShareBlockStateSchema>;
+/**
+ * GraceRepayment-specific participant. Extends the base participant with
+ * three Grace-specific fields plus a denormalized ShareBlock count:
+ *
+ *   - `graceDecision`     — Lender-only field. The lender's current
+ *                            choice: take their yield, grant Grace, or
+ *                            undecided (the initial state when the
+ *                            GraceRepayment block is constructed).
+ *                            Borrower and Platform participants always
+ *                            carry `'undecided'` and never mutate it.
+ *   - `decidedAtMs`       — Unix-ms timestamp the lender last set their
+ *                            decision. `null` while undecided.
+ *   - `snapshotDecision`  — The locked-in decision at the moment the
+ *                            borrower initiated repayment. `null` until
+ *                            snapshot. After snapshot it's the
+ *                            authoritative value the per-lender
+ *                            settlement uses.
+ *   - `shareBlockCount`   — Derived count of $10 ShareBlocks held by
+ *                            this lender on this loan
+ *                            (`committedAmount / 1000` for cents-based
+ *                            committed amounts). Cached for fast UI
+ *                            queries; the canonical source is still
+ *                            `committedAmount`.
+ */
+export declare const IGraceRepaymentParticipantSchema: z.ZodObject<{
+    userId: z.ZodString;
+    role: z.ZodEnum<{
+        Borrower: "Borrower";
+        Lender: "Lender";
+        Platform: "Platform";
+        Recipient: "Recipient";
+    }>;
+    committedAmount: z.ZodNumber;
+    settledAmount: z.ZodNumber;
+    graceDecision: z.ZodEnum<{
+        yield: "yield";
+        grace: "grace";
+        undecided: "undecided";
+    }>;
+    decidedAtMs: z.ZodOptional<z.ZodNumber>;
+    snapshotDecision: z.ZodOptional<z.ZodEnum<{
+        yield: "yield";
+        grace: "grace";
+    }>>;
+    shareBlockCount: z.ZodNumber;
+}, z.core.$strip>;
+export type IGraceRepaymentParticipant = z.infer<typeof IGraceRepaymentParticipantSchema>;
+/**
+ * GraceRepayment-specific extension of `IShareBlockState`. Adds:
+ *
+ *   - `outstandingPrincipalCents`  — running principal balance the
+ *                                     borrower owes. Decrements as
+ *                                     repayments land.
+ *   - `outstandingInterestCents`   — interest owed at the time of
+ *                                     repayment snapshot. Computed
+ *                                     atomically at snapshot from the
+ *                                     blended rate; decrements as
+ *                                     repayments land.
+ *   - `repaymentSnapshotAtMs`      — unix-ms timestamp the per-lender
+ *                                     Grace decisions were locked in.
+ *                                     `null` until the borrower
+ *                                     initiates repayment.
+ *   - `blendedRatePercent`         — weighted-average effective rate
+ *                                     computed at snapshot. `null` pre-
+ *                                     snapshot.
+ *   - `finalEffectiveRatePercent`  — what the borrower actually pays;
+ *                                     equal to `blendedRatePercent`
+ *                                     under the standard formula. `null`
+ *                                     pre-snapshot.
+ *   - `fullyRepaid` / `defaulted`  — mutually exclusive terminal flags.
+ *                                     Both monotonic (once true, never
+ *                                     back to false).
+ *   - `defaultReason` / `defaultedAtMs` — audit attribution for the
+ *                                          default moment.
+ *
+ * Participants are typed as `IGraceRepaymentParticipant` (extended
+ * with per-lender Grace decision fields).
+ */
+export declare const IGraceRepaymentShareBlockStateSchema: z.ZodObject<{
+    balance: z.ZodNumber;
+    currency: z.ZodString;
+    isOpen: z.ZodBoolean;
+    reservations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        settlementId: z.ZodString;
+        direction: z.ZodEnum<{
+            debit: "debit";
+            credit: "credit";
+        }>;
+        amountCents: z.ZodNumber;
+        currency: z.ZodString;
+        againstHash: z.ZodString;
+        status: z.ZodEnum<{
+            reserved: "reserved";
+            committed: "committed";
+            released: "released";
+        }>;
+    }, z.core.$strip>>>;
+    blockType: z.ZodLiteral<"GraceRepayment">;
+    participants: z.ZodRecord<z.ZodString, z.ZodObject<{
+        userId: z.ZodString;
+        role: z.ZodEnum<{
+            Borrower: "Borrower";
+            Lender: "Lender";
+            Platform: "Platform";
+            Recipient: "Recipient";
+        }>;
+        committedAmount: z.ZodNumber;
+        settledAmount: z.ZodNumber;
+        graceDecision: z.ZodEnum<{
+            yield: "yield";
+            grace: "grace";
+            undecided: "undecided";
+        }>;
+        decidedAtMs: z.ZodOptional<z.ZodNumber>;
+        snapshotDecision: z.ZodOptional<z.ZodEnum<{
+            yield: "yield";
+            grace: "grace";
+        }>>;
+        shareBlockCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    outstandingPrincipalCents: z.ZodNumber;
+    outstandingInterestCents: z.ZodNumber;
+    repaymentSnapshotAtMs: z.ZodOptional<z.ZodNumber>;
+    blendedRatePercent: z.ZodOptional<z.ZodNumber>;
+    finalEffectiveRatePercent: z.ZodOptional<z.ZodNumber>;
+    snapshotBaselineRatePercent: z.ZodOptional<z.ZodNumber>;
+    snapshotGraceMicroInterestPercent: z.ZodOptional<z.ZodNumber>;
+    snapshotGracePerShareBlockFeeCents: z.ZodOptional<z.ZodNumber>;
+    fullyRepaid: z.ZodBoolean;
+    defaulted: z.ZodBoolean;
+    defaultReason: z.ZodOptional<z.ZodString>;
+    defaultedAtMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type IGraceRepaymentShareBlockState = z.infer<typeof IGraceRepaymentShareBlockStateSchema>;
 /**
  * Static information about a ShareBlock — set at construction and never
  * mutated through transactions. Lives outside `IShareBlockState` because
@@ -171,6 +430,8 @@ export declare const IShareBlockMetadataSchema: z.ZodObject<{
         Clearing: "Clearing";
         Funding: "Funding";
         Distribution: "Distribution";
+        GraceRepayment: "GraceRepayment";
+        Settlement: "Settlement";
     }>;
     relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
@@ -277,4 +538,128 @@ export declare const IShareBlockMarkFullyDistributedInputSchema: z.ZodObject<{
     userId: z.ZodString;
 }, z.core.$strip>;
 export type IShareBlockMarkFullyDistributedInput = z.infer<typeof IShareBlockMarkFullyDistributedInputSchema>;
+/**
+ * Input for the GraceRepayment `setLenderGraceDecision` function.
+ * Lender-callable while the block is open and pre-snapshot. The block's
+ * rules also enforce that the calling userId matches the participant
+ * being mutated (lenders can only set their own decisions, not others').
+ */
+export declare const IShareBlockSetLenderGraceDecisionInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    decision: z.ZodEnum<{
+        yield: "yield";
+        grace: "grace";
+    }>;
+    decidedAtMs: z.ZodNumber;
+}, z.core.$strip>;
+export type IShareBlockSetLenderGraceDecisionInput = z.infer<typeof IShareBlockSetLenderGraceDecisionInputSchema>;
+/**
+ * Input for the GraceRepayment `snapshotForRepayment` function.
+ * Platform-only. Atomic: freezes every Lender participant's
+ * `snapshotDecision` from their current `graceDecision`, computes
+ * `blendedRatePercent` and `finalEffectiveRatePercent` from the
+ * weighted decisions, sets `outstandingInterestCents` to the final
+ * computed amount, and stamps `repaymentSnapshotAtMs`.
+ *
+ * `graceMicroInterestPercent` and `gracePerShareBlockFeeCents` are the
+ * platform-fee configuration values used in the math; passing them via
+ * the input keeps the variant function pure (no implicit config
+ * lookup).
+ */
+export declare const IShareBlockSnapshotForRepaymentInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    baselineRatePercent: z.ZodNumber;
+    termDays: z.ZodNumber;
+    graceMicroInterestPercent: z.ZodNumber;
+    gracePerShareBlockFeeCents: z.ZodNumber;
+    snapshotAtMs: z.ZodNumber;
+}, z.core.$strip>;
+export type IShareBlockSnapshotForRepaymentInput = z.infer<typeof IShareBlockSnapshotForRepaymentInputSchema>;
+/**
+ * Input for the GraceRepayment `recordRepayment` function. Platform-only.
+ * Applies an inbound borrower payment per the snapshot decisions:
+ * yield-ShareBlock lenders receive their share of `borrowerInterest`;
+ * grace-ShareBlock lenders receive only the micro-interest minus the
+ * per-ShareBlock fee. Decrements `outstandingInterestCents` first,
+ * then `outstandingPrincipalCents`. Auto-marks `fullyRepaid` when
+ * both reach zero.
+ *
+ * `paymentAttemptId` is the idempotency key — a second call with the
+ * same id is a no-op.
+ */
+export declare const IShareBlockRecordRepaymentInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    paymentAttemptId: z.ZodString;
+    amountCents: z.ZodNumber;
+    paidAtMs: z.ZodNumber;
+}, z.core.$strip>;
+export type IShareBlockRecordRepaymentInput = z.infer<typeof IShareBlockRecordRepaymentInputSchema>;
+/**
+ * Input for the GraceRepayment `markFullyRepaid` function. Platform-only.
+ * Asserts `outstandingPrincipalCents === 0 && outstandingInterestCents
+ * === 0` before flipping. Mutually exclusive with `markDefaulted`.
+ */
+export declare const IShareBlockMarkFullyRepaidInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    asOf: z.ZodNumber;
+}, z.core.$strip>;
+export type IShareBlockMarkFullyRepaidInput = z.infer<typeof IShareBlockMarkFullyRepaidInputSchema>;
+/**
+ * Input for the GraceRepayment `markDefaulted` function. Platform-only.
+ * Mutually exclusive with `markFullyRepaid`. Sets the terminal default
+ * flag + audit metadata; the post-default flow (lender write-off,
+ * borrower loyalty reset, identity-reveal opt-ins) happens in Rapture's
+ * trigger layer, not here.
+ */
+export declare const IShareBlockMarkDefaultedInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    reason: z.ZodString;
+    asOf: z.ZodNumber;
+}, z.core.$strip>;
+export type IShareBlockMarkDefaultedInput = z.infer<typeof IShareBlockMarkDefaultedInputSchema>;
+/**
+ * Input for the generic `reserveForSettlement` function (any block that opted
+ * into the settlement capability). Phase-1 (PREPARE) of the two-phase commit:
+ * holds `amountCents` for `settlementId`. `direction` selects debit (deduct
+ * from `balance`) vs credit (pending incoming, no balance change).
+ * `expectedHash` is the block's current-state hash the leg was signed against
+ * — the function rejects if it does not match, backing up the proof-chain
+ * drift guard (D5). Idempotent: a second reserve for the same `settlementId`
+ * is a no-op.
+ */
+export declare const IShareBlockReserveForSettlementInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    settlementId: z.ZodString;
+    direction: z.ZodEnum<{
+        debit: "debit";
+        credit: "credit";
+    }>;
+    amountCents: z.ZodNumber;
+    currency: z.ZodString;
+    expectedHash: z.ZodString;
+}, z.core.$strip>;
+export type IShareBlockReserveForSettlementInput = z.infer<typeof IShareBlockReserveForSettlementInputSchema>;
+/**
+ * Input for the generic `commitSettlement` function. Phase-2 finalize for one
+ * leg: credit legs add the held amount to `balance`; both directions then
+ * clear the reservation. Carries only the settlement id — amount and
+ * direction are read from the stored reservation. Idempotent: a second call
+ * once the reservation is gone is a no-op.
+ */
+export declare const IShareBlockCommitSettlementInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    settlementId: z.ZodString;
+}, z.core.$strip>;
+export type IShareBlockCommitSettlementInput = z.infer<typeof IShareBlockCommitSettlementInputSchema>;
+/**
+ * Input for the generic `releaseSettlement` function. Abort-path unwind for
+ * one leg: debit legs return the held amount to `balance`; both directions
+ * delete the reservation. Idempotent: releasing an absent reservation is a
+ * no-op.
+ */
+export declare const IShareBlockReleaseSettlementInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    settlementId: z.ZodString;
+}, z.core.$strip>;
+export type IShareBlockReleaseSettlementInput = z.infer<typeof IShareBlockReleaseSettlementInputSchema>;
 //# sourceMappingURL=shareblock-models.d.ts.map

package/dist/models/shareblock/shareblock-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shareblock-models.d.ts","sourceRoot":"","sources":["../../../src/models/shareblock/shareblock-models.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shareblock-models.d.ts","sourceRoot":"","sources":["../../../src/models/shareblock/shareblock-models.ts"],"names":[],"mappings":"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"}