@degenerate/generic 0.3.2 → 0.4.0

package/dist/_settings/database-settings.d.ts

@@ -14,5 +14,8 @@ export declare const DatabaseSettingsFirestore: {
     ShareData: {
         Collection: string;
     };
+    ReplayTransactions: {
+        Collection: string;
+    };
 };
 //# sourceMappingURL=database-settings.d.ts.map

package/dist/_settings/database-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database-settings.d.ts","sourceRoot":"","sources":["../../src/_settings/database-settings.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;CAgBrC,CAAA"}
+{"version":3,"file":"database-settings.d.ts","sourceRoot":"","sources":["../../src/_settings/database-settings.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;CAmBrC,CAAA"}

package/dist/_settings/database-settings.js

@@ -19,5 +19,8 @@ exports.DatabaseSettingsFirestore = {
     ShareData: {
         Collection: 'ShareData', // /{default}/ShareData
     },
+    ReplayTransactions: {
+        Collection: 'ReplayTransactions', // /{default}/ReplayTransactions
+    },
 };
 //#endregion Firestore

package/dist/errors/share-data/share-data-errors.d.ts

@@ -138,6 +138,19 @@ export declare class ShareDataTransactionProofFailedError extends BaseError {
 export declare class ShareDataTransactionNotAuthorizedError extends BaseError {
     constructor(shareDataId: string, signingPublicKey: string);
 }
+/**
+ * This error is thrown when a delegated-signer registration is rejected.
+ * Distinct from {@link ShareDataTransactionNotAuthorizedError} (which rejects a
+ * runtime *transaction* whose signer is not authorized): this rejects the
+ * *registration* of a delegate — either because the registration proof was not
+ * signed by the block's `creationPublicKey` (only the owner may delegate; there
+ * is no transitive delegation), because the granted function-id set is empty,
+ * or because the proof's `purpose` does not bind the exact
+ * `(signerPublicKey, functionIds)` grant being registered.
+ */
+export declare class ShareDataDelegationNotAuthorizedError extends BaseError {
+    constructor(shareDataId: string, registeringPublicKey: string);
+}
 /**
  * This error is thrown when the system attempts to get the previous share data hash
  * but the share data has not been initialized for the proof yet.

package/dist/errors/share-data/share-data-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"share-data-errors.d.ts","sourceRoot":"","sources":["../../../src/errors/share-data/share-data-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAEvF;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;IACjD;;OAEG;gBACS,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc;CAGjE;AAED;;GAEG;AACH,qBAAa,2CAA4C,SAAQ,SAAS;IACtE;;OAEG;gBACS,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;IAClD;;OAEG;gBACS,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,yDAA0D,SAAQ,SAAS;IACpF;;OAEG;gBACS,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAI5E;AAGD;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,SAAS;IACxD;;OAEG;gBACS,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM;CAIjG;AAKD;;GAEG;AACH,qBAAa,yCAA0C,SAAQ,SAAS;IACpE;;OAEG;gBACS,MAAM,EAAE,MAAM;CAG7B;AAED;;GAEG;AACH,qBAAa,0CAA2C,SAAQ,SAAS;IACrE;;OAEG;gBACS,MAAM,EAAE,MAAM;CAG7B;AAID;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,SAAS;gBAC1C,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;gBACrC,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;gBACtC,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,iCAAkC,SAAQ,SAAS;gBAChD,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,6CAA8C,SAAQ,SAAS;gBAC5D,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,SAAS;gBAC9C,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,0CAA2C,SAAQ,SAAS;gBACzD,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,mCAAoC,SAAQ,SAAS;gBAClD,WAAW,EAAE,MAAM;CAGlC;AAED;;;;;;;;;GASG;AACH,qBAAa,oCAAqC,SAAQ,SAAS;gBACnD,WAAW,EAAE,MAAM;CAGlC;AAED;;;;;;;;;GASG;AACH,qBAAa,sCAAuC,SAAQ,SAAS;gBACrD,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM;CAM5D;AAED;;;GAGG;AACH,qBAAa,sCAAuC,SAAQ,SAAS;gBACrD,WAAW,EAAE,MAAM;CAIlC;AAED;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,SAAS;gBACxC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGlD"}
+{"version":3,"file":"share-data-errors.d.ts","sourceRoot":"","sources":["../../../src/errors/share-data/share-data-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAEvF;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;IACjD;;OAEG;gBACS,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc;CAGjE;AAED;;GAEG;AACH,qBAAa,2CAA4C,SAAQ,SAAS;IACtE;;OAEG;gBACS,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;IAClD;;OAEG;gBACS,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,yDAA0D,SAAQ,SAAS;IACpF;;OAEG;gBACS,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAI5E;AAGD;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,SAAS;IACxD;;OAEG;gBACS,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM;CAIjG;AAKD;;GAEG;AACH,qBAAa,yCAA0C,SAAQ,SAAS;IACpE;;OAEG;gBACS,MAAM,EAAE,MAAM;CAG7B;AAED;;GAEG;AACH,qBAAa,0CAA2C,SAAQ,SAAS;IACrE;;OAEG;gBACS,MAAM,EAAE,MAAM;CAG7B;AAID;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,SAAS;gBAC1C,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;gBACrC,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;gBACtC,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,iCAAkC,SAAQ,SAAS;gBAChD,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,6CAA8C,SAAQ,SAAS;gBAC5D,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,SAAS;gBAC9C,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,0CAA2C,SAAQ,SAAS;gBACzD,WAAW,EAAE,MAAM;CAGlC;AAED;;GAEG;AACH,qBAAa,mCAAoC,SAAQ,SAAS;gBAClD,WAAW,EAAE,MAAM;CAGlC;AAED;;;;;;;;;GASG;AACH,qBAAa,oCAAqC,SAAQ,SAAS;gBACnD,WAAW,EAAE,MAAM;CAGlC;AAED;;;;;;;;;GASG;AACH,qBAAa,sCAAuC,SAAQ,SAAS;gBACrD,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM;CAM5D;AAED;;;;;;;;;GASG;AACH,qBAAa,qCAAsC,SAAQ,SAAS;gBACpD,WAAW,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM;CAOhE;AAED;;;GAGG;AACH,qBAAa,sCAAuC,SAAQ,SAAS;gBACrD,WAAW,EAAE,MAAM;CAIlC;AAED;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,SAAS;gBACxC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGlD"}

package/dist/errors/share-data/share-data-errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ShareDataPersistenceError = exports.ShareDataPreviousHashNotAvailableError = exports.ShareDataTransactionNotAuthorizedError = exports.ShareDataTransactionProofFailedError = exports.ShareDataStructuralProofFailedError = exports.ShareDataStructuralProofAlreadyExistsError = exports.ShareDataCryptoProofFailedError = exports.CryptoInitializationPublicKeyIsDifferentError = exports.ShareDataCryptoAlreadyExistsError = exports.ShareDataDuplicateError = exports.ShareDataNotFoundError = exports.ShareDataAlreadyExistsError = exports.ShareRuleProposedConditionsNotPresentError = exports.ShareRuleCurrentConditionsNotPresentError = exports.ShareDataFunctionHashNotValid = exports.ShareDataFunctionBeingAppliedDoesNotExistOnShareDataError = exports.ShareDataIntegrityError = exports.ShareDataCurrentAndProposalDataMatchesError = exports.ShareDataIsLockedError = void 0;
+exports.ShareDataPersistenceError = exports.ShareDataPreviousHashNotAvailableError = exports.ShareDataDelegationNotAuthorizedError = exports.ShareDataTransactionNotAuthorizedError = exports.ShareDataTransactionProofFailedError = exports.ShareDataStructuralProofFailedError = exports.ShareDataStructuralProofAlreadyExistsError = exports.ShareDataCryptoProofFailedError = exports.CryptoInitializationPublicKeyIsDifferentError = exports.ShareDataCryptoAlreadyExistsError = exports.ShareDataDuplicateError = exports.ShareDataNotFoundError = exports.ShareDataAlreadyExistsError = exports.ShareRuleProposedConditionsNotPresentError = exports.ShareRuleCurrentConditionsNotPresentError = exports.ShareDataFunctionHashNotValid = exports.ShareDataFunctionBeingAppliedDoesNotExistOnShareDataError = exports.ShareDataIntegrityError = exports.ShareDataCurrentAndProposalDataMatchesError = exports.ShareDataIsLockedError = void 0;
 const base_error_1 = require("../base-error");
 /**
  * This error is thrown when a function is tried to be applied to the share data thats state is locked.
@@ -195,6 +195,24 @@ class ShareDataTransactionNotAuthorizedError extends base_error_1.BaseError {
     }
 }
 exports.ShareDataTransactionNotAuthorizedError = ShareDataTransactionNotAuthorizedError;
+/**
+ * This error is thrown when a delegated-signer registration is rejected.
+ * Distinct from {@link ShareDataTransactionNotAuthorizedError} (which rejects a
+ * runtime *transaction* whose signer is not authorized): this rejects the
+ * *registration* of a delegate — either because the registration proof was not
+ * signed by the block's `creationPublicKey` (only the owner may delegate; there
+ * is no transitive delegation), because the granted function-id set is empty,
+ * or because the proof's `purpose` does not bind the exact
+ * `(signerPublicKey, functionIds)` grant being registered.
+ */
+class ShareDataDelegationNotAuthorizedError extends base_error_1.BaseError {
+    constructor(shareDataId, registeringPublicKey) {
+        super(`Share data with id ${shareDataId} rejected a delegated-signer registration: ` +
+            `key ${registeringPublicKey} is not authorized to delegate, or the registration ` +
+            `proof does not bind the requested grant.`);
+    }
+}
+exports.ShareDataDelegationNotAuthorizedError = ShareDataDelegationNotAuthorizedError;
 /**
  * This error is thrown when the system attempts to get the previous share data hash
  * but the share data has not been initialized for the proof yet.

package/dist/models/safe/transactions/sharedata-transactions-models.d.ts

@@ -33,6 +33,7 @@ export declare const ISAFETransactionShareDataDataSchema: z.ZodObject<{
             Clearing: "Clearing";
             Funding: "Funding";
             Distribution: "Distribution";
+            GraceRepayment: "GraceRepayment";
         }>;
         relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
@@ -91,6 +92,7 @@ export declare const ISAFETransactionShareDataSchema: z.ZodObject<{
                     Clearing: "Clearing";
                     Funding: "Funding";
                     Distribution: "Distribution";
+                    GraceRepayment: "GraceRepayment";
                 }>;
                 relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
@@ -148,6 +150,7 @@ export declare const ISAFETransactionShareDataAddSchema: z.ZodObject<{
                     Clearing: "Clearing";
                     Funding: "Funding";
                     Distribution: "Distribution";
+                    GraceRepayment: "GraceRepayment";
                 }>;
                 relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
@@ -204,6 +207,7 @@ export declare const ISAFETransactionShareDataUpdateSchema: z.ZodObject<{
                     Clearing: "Clearing";
                     Funding: "Funding";
                     Distribution: "Distribution";
+                    GraceRepayment: "GraceRepayment";
                 }>;
                 relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
@@ -260,6 +264,7 @@ export declare const ISAFETransactionShareDataDeleteSchema: z.ZodObject<{
                     Clearing: "Clearing";
                     Funding: "Funding";
                     Distribution: "Distribution";
+                    GraceRepayment: "GraceRepayment";
                 }>;
                 relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;

package/dist/models/safe/transactions/sharedata-transactions-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sharedata-transactions-models.d.ts","sourceRoot":"","sources":["../../../../src/models/safe/transactions/sharedata-transactions-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACH,mBAAmB,EACnB,yBAAyB,EAG5B,MAAM,4BAA4B,CAAC;AASpC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK9C,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAIxF;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhD,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhD,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC"}
+{"version":3,"file":"sharedata-transactions-models.d.ts","sourceRoot":"","sources":["../../../../src/models/safe/transactions/sharedata-transactions-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACH,mBAAmB,EACnB,yBAAyB,EAG5B,MAAM,4BAA4B,CAAC;AASpC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK9C,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAIxF;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhD,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhD,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC"}

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

@@ -45,6 +45,43 @@ export declare const ShareDataProofsSchema: z.ZodRecord<z.ZodString, z.ZodObject
     purpose: z.ZodString;
 }, z.core.$strip>>;
 export type ShareDataProofs = z.infer<typeof ShareDataProofsSchema>;
+/**
+ * A single delegated-signer grant on a block: a public key the block owner has
+ * authorized to propose runtime transactions, scoped to a specific set of
+ * function ids (least privilege — a granted key can only drive the function(s)
+ * it was delegated, not arbitrary mutations).
+ *
+ * Field-declaration order is load-bearing, NOT cosmetic — same constraint as
+ * {@link IShareDataCryptoProofSchema}. The grant is folded into the canonical
+ * share-data string via order-sensitive `JSON.stringify` (see `getArrayString`
+ * / `calculateShareDataString`), so a grant that round-trips through `.parse()`
+ * (persistence reload) must come back with the SAME key order a freshly-built
+ * grant has, or the block's hash diverges and later proofs fail to verify.
+ * Keep `publicKey` before `functionIds`, matching the object literal pushed in
+ * `ShareData.addAuthorizedSigner`.
+ */
+export declare const IAuthorizedSignerSchema: z.ZodObject<{
+    publicKey: z.ZodString;
+    functionIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type IAuthorizedSigner = z.infer<typeof IAuthorizedSignerSchema>;
+/** Prefix marking a structural proof's `purpose` as a delegate registration. */
+export declare const DELEGATE_PURPOSE_PREFIX = "delegate:";
+/**
+ * Builds the canonical `purpose` for a delegated-signer registration proof.
+ *
+ * The registration proof is signed over the block's PRE-append state (the grant
+ * is not yet folded into `_authorizedSigners` at signing time), so the proof's
+ * `purpose` is the only thing that cryptographically attests to the exact
+ * `(signerPublicKey, functionIds)` grant. Binding both into the purpose means a
+ * tampered snapshot cannot widen a delegate's scope (add function ids) or lift
+ * the signature to authorize a different key without invalidating the proof.
+ *
+ * `functionIds` are normalized (trimmed, de-duped, sorted) and JSON-encoded so
+ * the encoding is collision-free regardless of characters in the ids and
+ * order-independent across live-create and replay.
+ */
+export declare const buildDelegatePurpose: (signerPublicKey: string, functionIds: string[]) => string;
 /**
  * This contains the interface for the share data property config
  * for creating strings from the object to ensure that signatures and

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

@@ -1 +1 @@
-{"version":3,"file":"share-data-crypto-models.d.ts","sourceRoot":"","sources":["../../../src/models/share-data/share-data-crypto-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;;iBAK5C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;;;;;;;;;GAUG;AASH,eAAO,MAAM,2BAA2B;;;;;;;iBAOtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;kBAAoD,CAAC;AAEvF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;iBAGzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;kBAA0C,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMpD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC"}
+{"version":3,"file":"share-data-crypto-models.d.ts","sourceRoot":"","sources":["../../../src/models/share-data/share-data-crypto-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;;iBAK5C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;;;;;;;;;GAUG;AASH,eAAO,MAAM,2BAA2B;;;;;;;iBAOtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;kBAAoD,CAAC;AAEvF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAC7B,iBAAiB,MAAM,EACvB,aAAa,MAAM,EAAE,KACtB,MAKF,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;iBAGzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;kBAA0C,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMpD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC"}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IShareDataAdditionalValuesToIncludeSchema = exports.IShareDataConfigSchema = exports.IShareDataPropertyConfigSchema = exports.ShareDataProofsSchema = exports.IShareDataCryptoProofSchema = exports.IShareDataInitialCryptoDataSchema = void 0;
+exports.IShareDataAdditionalValuesToIncludeSchema = exports.IShareDataConfigSchema = exports.IShareDataPropertyConfigSchema = exports.buildDelegatePurpose = exports.DELEGATE_PURPOSE_PREFIX = exports.IAuthorizedSignerSchema = exports.ShareDataProofsSchema = exports.IShareDataCryptoProofSchema = exports.IShareDataInitialCryptoDataSchema = void 0;
 const zod_1 = require("zod");
 const share_rule_models_1 = require("../rules/share-rule-models");
 const share_data_models_1 = require("./share-data-models");
@@ -51,6 +51,46 @@ exports.IShareDataCryptoProofSchema = zod_1.z.object({
  * `addFunction` / `addRule` call.
  */
 exports.ShareDataProofsSchema = zod_1.z.record(zod_1.z.string(), exports.IShareDataCryptoProofSchema);
+/**
+ * A single delegated-signer grant on a block: a public key the block owner has
+ * authorized to propose runtime transactions, scoped to a specific set of
+ * function ids (least privilege — a granted key can only drive the function(s)
+ * it was delegated, not arbitrary mutations).
+ *
+ * Field-declaration order is load-bearing, NOT cosmetic — same constraint as
+ * {@link IShareDataCryptoProofSchema}. The grant is folded into the canonical
+ * share-data string via order-sensitive `JSON.stringify` (see `getArrayString`
+ * / `calculateShareDataString`), so a grant that round-trips through `.parse()`
+ * (persistence reload) must come back with the SAME key order a freshly-built
+ * grant has, or the block's hash diverges and later proofs fail to verify.
+ * Keep `publicKey` before `functionIds`, matching the object literal pushed in
+ * `ShareData.addAuthorizedSigner`.
+ */
+exports.IAuthorizedSignerSchema = zod_1.z.object({
+    publicKey: zod_1.z.string(), // the delegate's public key (hex)
+    functionIds: zod_1.z.array(zod_1.z.string()), // the function ids this key may drive (sorted)
+});
+/** Prefix marking a structural proof's `purpose` as a delegate registration. */
+exports.DELEGATE_PURPOSE_PREFIX = 'delegate:';
+/**
+ * Builds the canonical `purpose` for a delegated-signer registration proof.
+ *
+ * The registration proof is signed over the block's PRE-append state (the grant
+ * is not yet folded into `_authorizedSigners` at signing time), so the proof's
+ * `purpose` is the only thing that cryptographically attests to the exact
+ * `(signerPublicKey, functionIds)` grant. Binding both into the purpose means a
+ * tampered snapshot cannot widen a delegate's scope (add function ids) or lift
+ * the signature to authorize a different key without invalidating the proof.
+ *
+ * `functionIds` are normalized (trimmed, de-duped, sorted) and JSON-encoded so
+ * the encoding is collision-free regardless of characters in the ids and
+ * order-independent across live-create and replay.
+ */
+const buildDelegatePurpose = (signerPublicKey, functionIds) => {
+    const normalized = Array.from(new Set(functionIds.map((id) => id.trim()).filter((id) => id.length > 0))).sort();
+    return `${exports.DELEGATE_PURPOSE_PREFIX}${signerPublicKey}:${JSON.stringify(normalized)}`;
+};
+exports.buildDelegatePurpose = buildDelegatePurpose;
 //#endregion Share Data Crypto Schemas
 //#region Stringify Configurations
 /**

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

@@ -25,6 +25,7 @@ export declare const PersistedCreationConfigSchema: z.ZodObject<{
             Clearing: "Clearing";
             Funding: "Funding";
             Distribution: "Distribution";
+            GraceRepayment: "GraceRepayment";
         }>;
         relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
@@ -90,12 +91,13 @@ 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";
     }>;
     signingCurve: z.ZodEnum<{
         ed25519: EllipticalCurvesSigning.Curve25519;
@@ -114,6 +116,7 @@ export declare const PersistedShareDataSchema: z.ZodObject<{
                 Clearing: "Clearing";
                 Funding: "Funding";
                 Distribution: "Distribution";
+                GraceRepayment: "GraceRepayment";
             }>;
             relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
@@ -131,6 +134,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 +161,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,22 @@
 import z from 'zod';
 /**
- * The three ShareBlock specializations the platform uses to move money
+ * The four ShareBlock specializations the platform uses to move money
  * through a loan's lifecycle.
  *
- *   - `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.
  *
  * New ShareBlock variants should be additive — never re-use a value with new
  * semantics, since downstream rule libraries pattern-match on the literal.
@@ -17,12 +24,14 @@ import z from 'zod';
 export declare enum ShareBlockType {
     Clearing = "Clearing",
     Funding = "Funding",
-    Distribution = "Distribution"
+    Distribution = "Distribution",
+    GraceRepayment = "GraceRepayment"
 }
 export declare const ShareBlockTypeSchema: z.ZodEnum<{
     Clearing: "Clearing";
     Funding: "Funding";
     Distribution: "Distribution";
+    GraceRepayment: "GraceRepayment";
 }>;
 /**
  * Roles a participant plays inside a ShareBlock. A single party may hold
@@ -77,6 +86,7 @@ export declare const IShareBlockStateSchema: z.ZodObject<{
         Clearing: "Clearing";
         Funding: "Funding";
         Distribution: "Distribution";
+        GraceRepayment: "GraceRepayment";
     }>;
     balance: z.ZodNumber;
     currency: z.ZodString;
@@ -159,6 +169,125 @@ export declare const IDistributionShareBlockStateSchema: z.ZodObject<{
     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;
+    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 +300,7 @@ export declare const IShareBlockMetadataSchema: z.ZodObject<{
         Clearing: "Clearing";
         Funding: "Funding";
         Distribution: "Distribution";
+        GraceRepayment: "GraceRepayment";
     }>;
     relatedLoanApplicationId: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
@@ -277,4 +407,83 @@ 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>;
 //# 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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"}

package/dist/models/shareblock/shareblock-models.js

@@ -3,20 +3,27 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IShareBlockMarkFullyDistributedInputSchema = exports.IShareBlockDisburseInputSchema = exports.IShareBlockFundInputSchema = exports.IShareBlockRegisterLenderInputSchema = exports.IShareBlockCommitInputSchema = exports.IShareBlockCloseInputSchema = exports.IShareBlockWithdrawInputSchema = exports.IShareBlockDepositInputSchema = exports.IShareBlockInitialStateInputSchema = exports.IShareBlockMetadataSchema = exports.IDistributionShareBlockStateSchema = exports.IFundingShareBlockStateSchema = exports.IShareBlockStateSchema = exports.IShareBlockParticipantSchema = exports.ShareBlockParticipantRoleSchema = exports.ShareBlockParticipantRole = exports.ShareBlockTypeSchema = exports.ShareBlockType = void 0;
+exports.IShareBlockMarkDefaultedInputSchema = exports.IShareBlockMarkFullyRepaidInputSchema = exports.IShareBlockRecordRepaymentInputSchema = exports.IShareBlockSnapshotForRepaymentInputSchema = exports.IShareBlockSetLenderGraceDecisionInputSchema = exports.IShareBlockMarkFullyDistributedInputSchema = exports.IShareBlockDisburseInputSchema = exports.IShareBlockFundInputSchema = exports.IShareBlockRegisterLenderInputSchema = exports.IShareBlockCommitInputSchema = exports.IShareBlockCloseInputSchema = exports.IShareBlockWithdrawInputSchema = exports.IShareBlockDepositInputSchema = exports.IShareBlockInitialStateInputSchema = exports.IShareBlockMetadataSchema = exports.IGraceRepaymentShareBlockStateSchema = exports.IGraceRepaymentParticipantSchema = exports.IDistributionShareBlockStateSchema = exports.IFundingShareBlockStateSchema = exports.IShareBlockStateSchema = exports.IShareBlockParticipantSchema = exports.ShareBlockParticipantRoleSchema = exports.ShareBlockParticipantRole = exports.ShareBlockTypeSchema = exports.ShareBlockType = void 0;
 const zod_1 = __importDefault(require("zod"));
 //#region Enums
 /**
- * The three ShareBlock specializations the platform uses to move money
+ * The four ShareBlock specializations the platform uses to move money
  * through a loan's lifecycle.
  *
- *   - `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.
  *
  * New ShareBlock variants should be additive — never re-use a value with new
  * semantics, since downstream rule libraries pattern-match on the literal.
@@ -26,11 +33,13 @@ var ShareBlockType;
     ShareBlockType["Clearing"] = "Clearing";
     ShareBlockType["Funding"] = "Funding";
     ShareBlockType["Distribution"] = "Distribution";
+    ShareBlockType["GraceRepayment"] = "GraceRepayment";
 })(ShareBlockType || (exports.ShareBlockType = ShareBlockType = {}));
 exports.ShareBlockTypeSchema = zod_1.default.enum([
     'Clearing',
     'Funding',
     'Distribution',
+    'GraceRepayment',
 ]);
 //#endregion Enums
 //#region Participant
@@ -121,6 +130,99 @@ exports.IDistributionShareBlockStateSchema = exports.IShareBlockStateSchema.exte
     distributedBy: zod_1.default.string().optional(),
     distributedAt: zod_1.default.number().optional(),
 });
+/**
+ * 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`.
+ */
+exports.IGraceRepaymentParticipantSchema = exports.IShareBlockParticipantSchema.extend({
+    graceDecision: zod_1.default.enum(['yield', 'grace', 'undecided']),
+    /** Unset until the lender first sets a decision. */
+    decidedAtMs: zod_1.default.number().int().nonnegative().optional(),
+    /** Unset until the borrower initiates repayment. */
+    snapshotDecision: zod_1.default.enum(['yield', 'grace']).optional(),
+    shareBlockCount: zod_1.default.number().int().nonnegative(),
+});
+/**
+ * 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).
+ */
+exports.IGraceRepaymentShareBlockStateSchema = exports.IShareBlockStateSchema.extend({
+    blockType: zod_1.default.literal(exports.ShareBlockTypeSchema.enum.GraceRepayment),
+    participants: zod_1.default.record(zod_1.default.string(), exports.IGraceRepaymentParticipantSchema),
+    outstandingPrincipalCents: zod_1.default.number().int().nonnegative(),
+    outstandingInterestCents: zod_1.default.number().int().nonnegative(),
+    /** Unset until the borrower initiates repayment. */
+    repaymentSnapshotAtMs: zod_1.default.number().int().nonnegative().optional(),
+    /** Computed at snapshot; unset pre-snapshot. */
+    blendedRatePercent: zod_1.default.number().optional(),
+    /** Computed at snapshot; unset pre-snapshot. */
+    finalEffectiveRatePercent: zod_1.default.number().optional(),
+    /**
+     * Borrower's baseline rate at snapshot. Captured so the
+     * `recordRepayment` per-lender settlement can recompute the
+     * yield-side interest allocation without rolling the inputs back
+     * in through the call (the audit chain already carries
+     * `snapshotForRepayment`'s input, but the per-lender allocation
+     * function reads from current state, not the prior transaction).
+     */
+    snapshotBaselineRatePercent: zod_1.default.number().optional(),
+    /** Grace micro-interest at snapshot (e.g., 0.77). */
+    snapshotGraceMicroInterestPercent: zod_1.default.number().optional(),
+    /** Grace per-ShareBlock fee at snapshot (cents, e.g., 1 = $0.01). */
+    snapshotGracePerShareBlockFeeCents: zod_1.default.number().int().nonnegative().optional(),
+    fullyRepaid: zod_1.default.boolean(),
+    defaulted: zod_1.default.boolean(),
+    /** Set when the block transitions to `defaulted: true`. */
+    defaultReason: zod_1.default.string().optional(),
+    defaultedAtMs: zod_1.default.number().int().nonnegative().optional(),
+});
 //#endregion State
 //#region Metadata
 /**
@@ -219,4 +321,75 @@ exports.IShareBlockDisburseInputSchema = zod_1.default.object({
 exports.IShareBlockMarkFullyDistributedInputSchema = zod_1.default.object({
     userId: zod_1.default.string(),
 });
+/**
+ * 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').
+ */
+exports.IShareBlockSetLenderGraceDecisionInputSchema = zod_1.default.object({
+    userId: zod_1.default.string(),
+    decision: zod_1.default.enum(['yield', 'grace']),
+    decidedAtMs: zod_1.default.number().int().nonnegative(),
+});
+/**
+ * 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).
+ */
+exports.IShareBlockSnapshotForRepaymentInputSchema = zod_1.default.object({
+    userId: zod_1.default.string(),
+    baselineRatePercent: zod_1.default.number().positive(),
+    termDays: zod_1.default.number().int().positive(),
+    graceMicroInterestPercent: zod_1.default.number().nonnegative(),
+    gracePerShareBlockFeeCents: zod_1.default.number().int().nonnegative(),
+    snapshotAtMs: zod_1.default.number().int().nonnegative(),
+});
+/**
+ * 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.
+ */
+exports.IShareBlockRecordRepaymentInputSchema = zod_1.default.object({
+    userId: zod_1.default.string(),
+    paymentAttemptId: zod_1.default.string(),
+    amountCents: zod_1.default.number().int().positive(),
+    paidAtMs: zod_1.default.number().int().nonnegative(),
+});
+/**
+ * Input for the GraceRepayment `markFullyRepaid` function. Platform-only.
+ * Asserts `outstandingPrincipalCents === 0 && outstandingInterestCents
+ * === 0` before flipping. Mutually exclusive with `markDefaulted`.
+ */
+exports.IShareBlockMarkFullyRepaidInputSchema = zod_1.default.object({
+    userId: zod_1.default.string(),
+    asOf: zod_1.default.number().int().nonnegative(),
+});
+/**
+ * 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.
+ */
+exports.IShareBlockMarkDefaultedInputSchema = zod_1.default.object({
+    userId: zod_1.default.string(),
+    reason: zod_1.default.string().min(1),
+    asOf: zod_1.default.number().int().nonnegative(),
+});
 //#endregion Transaction Function Inputs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@degenerate/generic",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "This contains the generic information needed for the ShareData Adaptive Framework Ecosystem (SAFE) network",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,7 +45,7 @@
     "jsonwebtoken": "^9.0.3",
     "zod": "^4.4.3"
   },
-  "gitHead": "c33ed2f06679f5bd76c2eccf7054212c1820a014",
+  "gitHead": "9453d9ab785e03fd01eb5b408ed0e3ca22baefd5",
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/eslint__js": "^8.42.3",