@hazbase/simplicity 0.2.0 → 0.3.0

package/README.md

@@ -19,7 +19,7 @@ With the current public SDK you can build and test:
 - output binding with public support/fallback reporting
 - bond redemption / settlement / close-out flows
 - LP fund capital call / distribution / close-out flows
-- receivable repayment-first funding / repayment / closing flows
+- receivable repayment-first funding / partial repayment / closing flows
 - evidence, trust summary, lineage, and finality exports
 
 ## Public Architecture
@@ -130,9 +130,14 @@ Main entrypoints:
 Representative example:
 - [show-fund-claim-close-flow.ts](./examples/show-fund-claim-close-flow.ts)
 
+Operational note:
+- [fund-cutoff-runbook.md](./docs/fund-cutoff-runbook.md)
+
 ### Receivables
 
-Use `sdk.receivables` for repayment-first receivable or invoice-style pilots where you want canonical state transitions, runtime claim descriptors, lineage verification, and terminal closing.
+Use `sdk.receivables` for repayment-first receivable or invoice-style pilots where you want canonical state transitions, role-aware runtime claim descriptors, partial repayment handling, lineage verification, and terminal closing.
+
+By default, funding claims resolve against the originator claimant key and repayment claims resolve against the current holder claimant key, while `controllerXonly` remains the fallback for simpler pilots.
 
 Main entrypoints:
 - `sdk.receivables.define(...)`
@@ -221,3 +226,5 @@ For practical usage you typically need:
 - a reachable Elements / Liquid RPC endpoint
 
 Some commands are SDK-only and work without live spends. Local and testnet e2e flows need the toolchain and, for broadcasted flows, an RPC environment.
+
+The dedicated restricted OTC testnet runner clean-skips when RPC credentials are missing so it can stay in public CI and local verification scripts without turning missing env into a hard failure.

package/dist/cli.js

@@ -841,6 +841,10 @@ function formatReceivableClaimSummary(input) {
         `payerEntityId=${input.payerEntityId}`,
         `payeeEntityId=${input.payeeEntityId}`,
         `amountSat=${input.amountSat}`,
+        input.claimantAuthoritySource ? `claimantAuthoritySource=${input.claimantAuthoritySource}` : undefined,
+        input.roleSeparatedAuthorization !== undefined
+            ? `roleSeparatedAuthorization=${input.roleSeparatedAuthorization}`
+            : undefined,
         input.bindingMode ? `bindingMode=${input.bindingMode}` : undefined,
         input.reasonCode ? `reasonCode=${input.reasonCode}` : undefined,
         input.supportedForm ? `supportedForm=${input.supportedForm}` : undefined,
@@ -3427,6 +3431,7 @@ async function main() {
             nextStateValue: parseJsonArg("next-state-value"),
             stateId: getArg("state-id"),
             holderEntityId: getArg("holder-entity-id"),
+            holderClaimantXonly: getArg("holder-claimant-xonly"),
             fundedAt: getArg("funded-at"),
         });
         printJson({
@@ -3502,6 +3507,8 @@ async function main() {
                 payerEntityId: result.claimValue.payerEntityId,
                 payeeEntityId: result.claimValue.payeeEntityId,
                 amountSat: result.claimValue.amountSat,
+                claimantAuthoritySource: result.report.fundingClaimTrust?.claimantAuthoritySource,
+                roleSeparatedAuthorization: result.report.fundingClaimTrust?.roleSeparatedAuthorization,
                 bindingMode: result.report.fundingClaimTrust?.bindingMode,
                 reasonCode: result.report.fundingClaimTrust?.reasonCode,
                 supportedForm: result.report.fundingClaimTrust?.supportedForm,
@@ -3534,6 +3541,8 @@ async function main() {
                 payerEntityId: result.claimValue.payerEntityId,
                 payeeEntityId: result.claimValue.payeeEntityId,
                 amountSat: result.claimValue.amountSat,
+                claimantAuthoritySource: result.report.fundingClaimTrust?.claimantAuthoritySource,
+                roleSeparatedAuthorization: result.report.fundingClaimTrust?.roleSeparatedAuthorization,
                 bindingMode: result.report.fundingClaimTrust?.bindingMode,
                 reasonCode: result.report.fundingClaimTrust?.reasonCode,
                 supportedForm: result.report.fundingClaimTrust?.supportedForm,
@@ -3575,6 +3584,8 @@ async function main() {
                 payerEntityId: result.claimValue.payerEntityId,
                 payeeEntityId: result.claimValue.payeeEntityId,
                 amountSat: result.claimValue.amountSat,
+                claimantAuthoritySource: result.report.fundingClaimTrust?.claimantAuthoritySource,
+                roleSeparatedAuthorization: result.report.fundingClaimTrust?.roleSeparatedAuthorization,
                 bindingMode: result.report.fundingClaimTrust?.bindingMode,
                 reasonCode: result.report.fundingClaimTrust?.reasonCode,
                 supportedForm: result.report.fundingClaimTrust?.supportedForm,
@@ -3617,6 +3628,8 @@ async function main() {
                 payerEntityId: result.claimValue.payerEntityId,
                 payeeEntityId: result.claimValue.payeeEntityId,
                 amountSat: result.claimValue.amountSat,
+                claimantAuthoritySource: result.report.fundingClaimTrust?.claimantAuthoritySource,
+                roleSeparatedAuthorization: result.report.fundingClaimTrust?.roleSeparatedAuthorization,
                 bindingMode: result.report.fundingClaimTrust?.bindingMode,
                 reasonCode: result.report.fundingClaimTrust?.reasonCode,
                 supportedForm: result.report.fundingClaimTrust?.supportedForm,
@@ -3685,6 +3698,8 @@ async function main() {
                 payerEntityId: result.claimValue.payerEntityId,
                 payeeEntityId: result.claimValue.payeeEntityId,
                 amountSat: result.claimValue.amountSat,
+                claimantAuthoritySource: result.report.repaymentClaimTrust?.claimantAuthoritySource,
+                roleSeparatedAuthorization: result.report.repaymentClaimTrust?.roleSeparatedAuthorization,
                 bindingMode: result.report.repaymentClaimTrust?.bindingMode,
                 reasonCode: result.report.repaymentClaimTrust?.reasonCode,
                 supportedForm: result.report.repaymentClaimTrust?.supportedForm,
@@ -3717,6 +3732,8 @@ async function main() {
                 payerEntityId: result.claimValue.payerEntityId,
                 payeeEntityId: result.claimValue.payeeEntityId,
                 amountSat: result.claimValue.amountSat,
+                claimantAuthoritySource: result.report.repaymentClaimTrust?.claimantAuthoritySource,
+                roleSeparatedAuthorization: result.report.repaymentClaimTrust?.roleSeparatedAuthorization,
                 bindingMode: result.report.repaymentClaimTrust?.bindingMode,
                 reasonCode: result.report.repaymentClaimTrust?.reasonCode,
                 supportedForm: result.report.repaymentClaimTrust?.supportedForm,
@@ -3758,6 +3775,8 @@ async function main() {
                 payerEntityId: result.claimValue.payerEntityId,
                 payeeEntityId: result.claimValue.payeeEntityId,
                 amountSat: result.claimValue.amountSat,
+                claimantAuthoritySource: result.report.repaymentClaimTrust?.claimantAuthoritySource,
+                roleSeparatedAuthorization: result.report.repaymentClaimTrust?.roleSeparatedAuthorization,
                 bindingMode: result.report.repaymentClaimTrust?.bindingMode,
                 reasonCode: result.report.repaymentClaimTrust?.reasonCode,
                 supportedForm: result.report.repaymentClaimTrust?.supportedForm,
@@ -3800,6 +3819,8 @@ async function main() {
                 payerEntityId: result.claimValue.payerEntityId,
                 payeeEntityId: result.claimValue.payeeEntityId,
                 amountSat: result.claimValue.amountSat,
+                claimantAuthoritySource: result.report.repaymentClaimTrust?.claimantAuthoritySource,
+                roleSeparatedAuthorization: result.report.repaymentClaimTrust?.roleSeparatedAuthorization,
                 bindingMode: result.report.repaymentClaimTrust?.bindingMode,
                 reasonCode: result.report.repaymentClaimTrust?.reasonCode,
                 supportedForm: result.report.repaymentClaimTrust?.supportedForm,

package/dist/client/SimplicityClient.d.ts

@@ -3,6 +3,7 @@ import { ElementsRpcClient } from "../core/rpc";
 import { BondEvidenceBundle, OutputBindingSupportEvaluation, OutputBindingSupportMatrix, PolicyEvidenceBundle, ReceivableEvidenceBundle, PolicyTemplateManifestValidationResult, DefinitionInput, DefinitionVerificationResult, CompileFromFileInput, CompileFromPresetInput, DefinitionDescriptor, StateDocumentDescriptor, StateDocumentInput, StateVerificationResult, SimplicityArtifact, SimplicityClientConfig } from "../core/types";
 import { RelayerClient } from "../gasless/RelayerClient";
 import { GaslessTransferInput, GaslessTransferResult, RelayerClientConfig } from "../gasless/types";
+import * as liquidX402 from "../x402";
 import { CompiledContract } from "./ContractFactory";
 import { DeployedContract } from "./DeployedContract";
 import { prepareRedemption, prepareClosing, exportFinalityPayload, buildSettlement, verifySettlement, define, executeClosing, executeRedemption, exportEvidence, inspectClosing, inspectRedemption, issue, load, verify, verifyIssuanceHistory, verifyClosing, verifyRedemption } from "../domain/bond";
@@ -14,6 +15,16 @@ export declare class SimplicityClient {
     readonly rpc: ElementsRpcClient;
     readonly payments: {
         gaslessTransfer: (input: GaslessTransferInput) => Promise<GaslessTransferResult>;
+        x402: {
+            assets: typeof liquidX402.listLiquidX402Assets;
+            resolveAsset: typeof liquidX402.resolveLiquidX402Asset;
+            buildRequirements: typeof liquidX402.buildLiquidX402Requirements;
+            encodePayment: typeof liquidX402.encodeLiquidXPayment;
+            decodePayment: typeof liquidX402.decodeLiquidXPayment;
+            preparePsetPayment: (input: liquidX402.LiquidX402PreparePsetPaymentInput) => Promise<liquidX402.LiquidX402PreparePsetPaymentResult>;
+            verify: (input: liquidX402.LiquidX402VerifyPaymentInput) => Promise<liquidX402.LiquidX402VerifyPaymentResult>;
+            settle: (input: liquidX402.LiquidX402SettlePaymentInput) => Promise<liquidX402.LiquidX402SettlePaymentResult>;
+        };
     };
     readonly outputBinding: {
         describeSupport: () => OutputBindingSupportMatrix;

package/dist/client/SimplicityClient.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SimplicityClient = void 0;
 exports.createSimplicityClient = createSimplicityClient;
@@ -10,6 +43,7 @@ const errors_1 = require("../core/errors");
 const outputBinding_1 = require("../core/outputBinding");
 const rpc_1 = require("../core/rpc");
 const RelayerClient_1 = require("../gasless/RelayerClient");
+const liquidX402 = __importStar(require("../x402"));
 const ContractFactory_1 = require("./ContractFactory");
 const DeployedContract_1 = require("./DeployedContract");
 const bond_1 = require("../domain/bond");
@@ -30,6 +64,16 @@ class SimplicityClient {
         this.rpc = new rpc_1.ElementsRpcClient(config.rpc);
         this.payments = {
             gaslessTransfer: async (input) => this.gaslessTransfer(input),
+            x402: {
+                assets: liquidX402.listLiquidX402Assets,
+                resolveAsset: liquidX402.resolveLiquidX402Asset,
+                buildRequirements: liquidX402.buildLiquidX402Requirements,
+                encodePayment: liquidX402.encodeLiquidXPayment,
+                decodePayment: liquidX402.decodeLiquidXPayment,
+                preparePsetPayment: async (input) => liquidX402.prepareLiquidX402PsetPayment(this.rpc, input),
+                verify: async (input) => liquidX402.verifyLiquidX402Payment(this.rpc, input),
+                settle: async (input) => liquidX402.settleLiquidX402Payment(this.rpc, input),
+            },
         };
         this.outputBinding = {
             describeSupport: () => (0, outputBinding_1.describeOutputBindingSupport)(),

package/dist/core/types.d.ts

@@ -548,6 +548,7 @@ export type ReceivableStatus = "ORIGINATED" | "FUNDED" | "PARTIALLY_REPAID" | "R
 export type ReceivableTransitionType = "ORIGINATE" | "FUND" | "REPAY" | "WRITE_OFF";
 export type ReceivableClosingReason = "REPAID" | "DEFAULTED" | "CANCELLED";
 export type ReceivableClaimKind = "FUNDING" | "REPAYMENT";
+export type ReceivableClaimAuthoritySource = "originator-claimant" | "holder-claimant" | "controller-fallback";
 export type ReceivableVerificationReportSchemaVersion = "receivable-verification-report/v1";
 export type ReceivableEvidenceBundleSchemaVersion = "receivable-evidence-bundle/v1";
 export type ReceivableFinalityPayloadSchemaVersion = "receivable-finality-payload/v1";
@@ -559,6 +560,7 @@ export interface ReceivableDefinition {
     faceValue: number;
     dueDate: string;
     controllerXonly: string;
+    originatorClaimantXonly?: string;
 }
 export interface ReceivableStateTransition {
     type: ReceivableTransitionType;
@@ -573,6 +575,7 @@ export interface ReceivableState {
     holderEntityId: string;
     currencyAssetId: string;
     controllerXonly: string;
+    holderClaimantXonly?: string;
     faceValue: number;
     outstandingAmount: number;
     repaidAmount: number;
@@ -627,6 +630,8 @@ export interface ReceivableClosingTrust {
 }
 export interface ReceivableClaimTrust {
     claimKind: ReceivableClaimKind;
+    claimantAuthoritySource: ReceivableClaimAuthoritySource;
+    roleSeparatedAuthorization: boolean;
     generated: boolean;
     stateStatusEligible: boolean;
     receivableIdMatch: boolean;

package/dist/docs/definitions/receivable-definition.json

@@ -5,5 +5,6 @@
   "currencyAssetId": "bitcoin",
   "faceValue": 10000,
   "dueDate": "2027-12-31T00:00:00Z",
-  "controllerXonly": "1111111111111111111111111111111111111111111111111111111111111111"
+  "controllerXonly": "3333333333333333333333333333333333333333333333333333333333333333",
+  "originatorClaimantXonly": "1111111111111111111111111111111111111111111111111111111111111111"
 }

package/dist/docs/definitions/receivable-funding-claim.json

@@ -2,7 +2,7 @@
   "claimId": "REC-001-FUNDING-CLAIM",
   "claimKind": "FUNDING",
   "receivableId": "REC-001",
-  "currentStateHash": "7a61cc669844f3fd96165c99e3ca42cfae916e824dec4d60e51d56ef574e041a",
+  "currentStateHash": "13147d187ce3200d7044d73d7b86b93140c43f29dd048f919569f5eb7b47c562",
   "currentStatus": "FUNDED",
   "payerEntityId": "fund-1",
   "payeeEntityId": "originator-1",

package/dist/docs/definitions/receivable-repayment-claim-partial.json

@@ -0,0 +1,13 @@
+{
+  "claimId": "REC-001-REPAYMENT-CLAIM-PARTIAL",
+  "claimKind": "REPAYMENT",
+  "receivableId": "REC-001",
+  "currentStateHash": "34e4db6639ad5b3ccb555320af22fb0eca2ab393ff198602ce5ca69d398cec31",
+  "currentStatus": "PARTIALLY_REPAID",
+  "payerEntityId": "debtor-1",
+  "payeeEntityId": "fund-1",
+  "claimantXonly": "2222222222222222222222222222222222222222222222222222222222222222",
+  "currencyAssetId": "bitcoin",
+  "amountSat": 4000,
+  "eventTimestamp": "2027-02-01T00:00:00Z"
+}

package/dist/docs/definitions/receivable-repayment-claim.json

@@ -1,13 +1,13 @@
 {
-  "claimId": "REC-001-REPAYMENT-CLAIM",
+  "claimId": "REC-001-REPAYMENT-CLAIM-FINAL",
   "claimKind": "REPAYMENT",
   "receivableId": "REC-001",
-  "currentStateHash": "13ae81254644a47f33492812584e169b4ae2051dfedc5ad46d00510c137dc333",
+  "currentStateHash": "a18fdc99bf37de415bfa242a387cdb41b943d2581bfe177aec51c3e42e9e40bf",
   "currentStatus": "REPAID",
   "payerEntityId": "debtor-1",
   "payeeEntityId": "fund-1",
-  "claimantXonly": "1111111111111111111111111111111111111111111111111111111111111111",
+  "claimantXonly": "2222222222222222222222222222222222222222222222222222222222222222",
   "currencyAssetId": "bitcoin",
-  "amountSat": 10000,
-  "eventTimestamp": "2027-02-01T00:00:00Z"
+  "amountSat": 6000,
+  "eventTimestamp": "2027-03-01T00:00:00Z"
 }

package/dist/docs/definitions/receivable-state-funded.json

@@ -5,13 +5,14 @@
   "debtorEntityId": "debtor-1",
   "holderEntityId": "fund-1",
   "currencyAssetId": "bitcoin",
-  "controllerXonly": "1111111111111111111111111111111111111111111111111111111111111111",
+  "controllerXonly": "3333333333333333333333333333333333333333333333333333333333333333",
+  "holderClaimantXonly": "2222222222222222222222222222222222222222222222222222222222222222",
   "faceValue": 10000,
   "outstandingAmount": 10000,
   "repaidAmount": 0,
   "status": "FUNDED",
   "createdAt": "2027-01-02T00:00:00Z",
-  "previousStateHash": "575a96c8f73f9a68d8bc76f5683cf042f89dcff73c7136939daf26be6128d935",
+  "previousStateHash": "cdd1a8e867611a0bf486c35a7811c80c2459f28ca988c22f789fbacdd4ee5c9e",
   "lastTransition": {
     "type": "FUND",
     "amount": 10000,

package/dist/docs/definitions/receivable-state-originated.json

@@ -5,7 +5,8 @@
   "debtorEntityId": "debtor-1",
   "holderEntityId": "originator-1",
   "currencyAssetId": "bitcoin",
-  "controllerXonly": "1111111111111111111111111111111111111111111111111111111111111111",
+  "controllerXonly": "3333333333333333333333333333333333333333333333333333333333333333",
+  "holderClaimantXonly": "1111111111111111111111111111111111111111111111111111111111111111",
   "faceValue": 10000,
   "outstandingAmount": 10000,
   "repaidAmount": 0,

package/dist/docs/definitions/receivable-state-partially-repaid.json

@@ -0,0 +1,21 @@
+{
+  "stateId": "REC-001-S2",
+  "receivableId": "REC-001",
+  "originatorEntityId": "originator-1",
+  "debtorEntityId": "debtor-1",
+  "holderEntityId": "fund-1",
+  "currencyAssetId": "bitcoin",
+  "controllerXonly": "3333333333333333333333333333333333333333333333333333333333333333",
+  "holderClaimantXonly": "2222222222222222222222222222222222222222222222222222222222222222",
+  "faceValue": 10000,
+  "outstandingAmount": 6000,
+  "repaidAmount": 4000,
+  "status": "PARTIALLY_REPAID",
+  "createdAt": "2027-02-01T00:00:00Z",
+  "previousStateHash": "13147d187ce3200d7044d73d7b86b93140c43f29dd048f919569f5eb7b47c562",
+  "lastTransition": {
+    "type": "REPAY",
+    "amount": 4000,
+    "at": "2027-02-01T00:00:00Z"
+  }
+}

package/dist/docs/definitions/receivable-state-repaid.json

@@ -1,20 +1,21 @@
 {
-  "stateId": "REC-001-S2",
+  "stateId": "REC-001-S3",
   "receivableId": "REC-001",
   "originatorEntityId": "originator-1",
   "debtorEntityId": "debtor-1",
   "holderEntityId": "fund-1",
   "currencyAssetId": "bitcoin",
-  "controllerXonly": "1111111111111111111111111111111111111111111111111111111111111111",
+  "controllerXonly": "3333333333333333333333333333333333333333333333333333333333333333",
+  "holderClaimantXonly": "2222222222222222222222222222222222222222222222222222222222222222",
   "faceValue": 10000,
   "outstandingAmount": 0,
   "repaidAmount": 10000,
   "status": "REPAID",
-  "createdAt": "2027-02-01T00:00:00Z",
-  "previousStateHash": "7a61cc669844f3fd96165c99e3ca42cfae916e824dec4d60e51d56ef574e041a",
+  "createdAt": "2027-03-01T00:00:00Z",
+  "previousStateHash": "34e4db6639ad5b3ccb555320af22fb0eca2ab393ff198602ce5ca69d398cec31",
   "lastTransition": {
     "type": "REPAY",
-    "amount": 10000,
-    "at": "2027-02-01T00:00:00Z"
+    "amount": 6000,
+    "at": "2027-03-01T00:00:00Z"
   }
 }

package/dist/domain/receivable.d.ts

@@ -142,6 +142,7 @@ export declare function prepareFunding(sdk: SimplicityClient, input: {
     nextStateValue?: ReceivableState;
     stateId?: string;
     holderEntityId?: string;
+    holderClaimantXonly?: string;
     fundedAt?: string;
 }): Promise<{
     verified: boolean;

package/dist/domain/receivable.js

@@ -515,6 +515,7 @@ async function prepareFunding(sdk, input) {
                 previous: previous.value,
                 stateId: input.stateId ?? `${previous.value.receivableId}-FUNDED`,
                 holderEntityId: input.holderEntityId ?? previous.value.holderEntityId,
+                holderClaimantXonly: input.holderClaimantXonly,
                 fundedAt: input.fundedAt ?? new Date().toISOString(),
             }),
         });
@@ -545,6 +546,7 @@ async function loadReceivableFundingClaimDocument(sdk, input) {
     }
     const value = (0, receivableValidation_1.buildReceivableFundingClaimDescriptor)({
         claimId: input.claimId,
+        definition: input.definitionValue,
         currentState: input.currentStateValue,
         payerEntityId: input.payerEntityId,
         payeeEntityId: input.payeeEntityId,
@@ -728,6 +730,7 @@ async function prepareFundingClaim(sdk, input) {
     const claim = await loadReceivableFundingClaimDocument(sdk, {
         fundingClaimPath: input.fundingClaimPath,
         fundingClaimValue: input.fundingClaimValue,
+        definitionValue: definition.value,
         currentStateValue: currentState.value,
         claimId: input.claimId ?? `${currentState.value.receivableId}-FUNDING-CLAIM`,
         payerEntityId: input.payerEntityId,
@@ -741,6 +744,7 @@ async function prepareFundingClaim(sdk, input) {
         ? (0, receivableValidation_1.verifyReceivableStateHistory)({ history: history.map((entry) => entry.value) })
         : undefined;
     const claimChecks = (0, receivableValidation_1.validateReceivableFundingClaimAgainstState)({
+        definition: definition.value,
         currentState: currentState.value,
         claim: claim.value,
     });
@@ -784,12 +788,14 @@ async function verifyFundingClaim(sdk, input) {
     const claim = await loadReceivableFundingClaimDocument(sdk, {
         fundingClaimPath: input.fundingClaimPath,
         fundingClaimValue: input.fundingClaimValue,
+        definitionValue: definition.value,
     });
     const crossChecks = (0, receivableValidation_1.validateReceivableCrossChecks)(definition.value, currentState.value);
     const lineageChecks = history.length > 0
         ? (0, receivableValidation_1.verifyReceivableStateHistory)({ history: history.map((entry) => entry.value) })
         : undefined;
     const claimChecks = (0, receivableValidation_1.validateReceivableFundingClaimAgainstState)({
+        definition: definition.value,
         currentState: currentState.value,
         claim: claim.value,
     });
@@ -887,6 +893,8 @@ async function inspectFundingClaim(sdk, input) {
                 claimantXonlyCommitted: verified.report.fundingClaimTrust?.claimantXonlyCommitted ?? true,
                 checks: {
                     claimKind: verified.report.fundingClaimTrust?.claimKind ?? "FUNDING",
+                    claimantAuthoritySource: verified.report.fundingClaimTrust?.claimantAuthoritySource ?? "controller-fallback",
+                    roleSeparatedAuthorization: verified.report.fundingClaimTrust?.roleSeparatedAuthorization ?? false,
                     stateStatusEligible: verified.report.fundingClaimTrust?.stateStatusEligible ?? false,
                     receivableIdMatch: verified.report.fundingClaimTrust?.receivableIdMatch ?? false,
                     currentStateHashMatch: verified.report.fundingClaimTrust?.currentStateHashMatch ?? false,
@@ -1101,6 +1109,8 @@ async function inspectRepaymentClaim(sdk, input) {
                 claimantXonlyCommitted: verified.report.repaymentClaimTrust?.claimantXonlyCommitted ?? true,
                 checks: {
                     claimKind: verified.report.repaymentClaimTrust?.claimKind ?? "REPAYMENT",
+                    claimantAuthoritySource: verified.report.repaymentClaimTrust?.claimantAuthoritySource ?? "controller-fallback",
+                    roleSeparatedAuthorization: verified.report.repaymentClaimTrust?.roleSeparatedAuthorization ?? false,
                     stateStatusEligible: verified.report.repaymentClaimTrust?.stateStatusEligible ?? false,
                     receivableIdMatch: verified.report.repaymentClaimTrust?.receivableIdMatch ?? false,
                     currentStateHashMatch: verified.report.repaymentClaimTrust?.currentStateHashMatch ?? false,

package/dist/domain/receivableValidation.d.ts

@@ -37,6 +37,7 @@ export declare function buildFundedReceivableState(input: {
     previous: ReceivableState;
     stateId: string;
     holderEntityId: string;
+    holderClaimantXonly?: string;
     fundedAt: string;
 }): ReceivableState;
 export declare function applyReceivableRepayment(input: {
@@ -59,6 +60,7 @@ export declare function buildReceivableClosingDescriptor(input: {
 }): ReceivableClosingDescriptor;
 export declare function buildReceivableFundingClaimDescriptor(input: {
     claimId: string;
+    definition?: ReceivableDefinition;
     currentState: ReceivableState;
     payerEntityId?: string;
     payeeEntityId?: string;
@@ -76,6 +78,7 @@ export declare function buildReceivableRepaymentClaimDescriptor(input: {
     eventTimestamp?: string;
 }): ReceivableRepaymentClaimDescriptor;
 export declare function validateReceivableFundingClaimAgainstState(input: {
+    definition: ReceivableDefinition;
     currentState: ReceivableState;
     claim: ReceivableFundingClaimDescriptor;
 }): Omit<ReceivableClaimTrust, "generated" | "bindingMode" | "requestedMode" | "supportedForm" | "reasonCode" | "nextReceiverRuntimeCommitted" | "nextOutputHashRuntimeBound" | "nextOutputScriptRuntimeBound" | "amountRuntimeBound" | "autoDerived" | "fallbackReason" | "bindingInputs" | "claimantXonlyCommitted">;

package/dist/domain/receivableValidation.js

@@ -119,6 +119,9 @@ function validateReceivableDefinition(value) {
     assertFinitePositiveNumber(definition?.faceValue, "RECEIVABLE_FACE_VALUE_INVALID", "faceValue must be a positive finite number");
     assertIsoDateLike(definition?.dueDate, "RECEIVABLE_DUE_DATE_INVALID", "dueDate must be an ISO8601 string");
     assertXonlyPubkey(definition?.controllerXonly, "RECEIVABLE_CONTROLLER_INVALID", "controllerXonly must be a 32-byte xonly public key");
+    if (definition.originatorClaimantXonly !== undefined) {
+        assertXonlyPubkey(definition.originatorClaimantXonly, "RECEIVABLE_ORIGINATOR_CLAIMANT_INVALID", "originatorClaimantXonly must be a 32-byte xonly public key");
+    }
     return {
         receivableId: definition.receivableId,
         originatorEntityId: definition.originatorEntityId,
@@ -127,6 +130,7 @@ function validateReceivableDefinition(value) {
         faceValue: definition.faceValue,
         dueDate: definition.dueDate,
         controllerXonly: definition.controllerXonly,
+        ...(definition.originatorClaimantXonly ? { originatorClaimantXonly: definition.originatorClaimantXonly } : {}),
     };
 }
 function validateReceivableState(value) {
@@ -138,6 +142,9 @@ function validateReceivableState(value) {
     assertNonEmptyString(state?.holderEntityId, "RECEIVABLE_HOLDER_INVALID", "holderEntityId must be a non-empty string");
     assertNonEmptyString(state?.currencyAssetId, "RECEIVABLE_CURRENCY_INVALID", "currencyAssetId must be a non-empty string");
     assertXonlyPubkey(state?.controllerXonly, "RECEIVABLE_CONTROLLER_INVALID", "controllerXonly must be a 32-byte xonly public key");
+    if (state.holderClaimantXonly !== undefined) {
+        assertXonlyPubkey(state.holderClaimantXonly, "RECEIVABLE_HOLDER_CLAIMANT_INVALID", "holderClaimantXonly must be a 32-byte xonly public key");
+    }
     assertFinitePositiveNumber(state?.faceValue, "RECEIVABLE_FACE_VALUE_INVALID", "faceValue must be a positive finite number");
     assertFiniteNonNegativeNumber(state?.outstandingAmount, "RECEIVABLE_OUTSTANDING_INVALID", "outstandingAmount must be a non-negative finite number");
     assertFiniteNonNegativeNumber(state?.repaidAmount, "RECEIVABLE_REPAID_INVALID", "repaidAmount must be a non-negative finite number");
@@ -240,6 +247,7 @@ function validateReceivableState(value) {
         holderEntityId: state.holderEntityId,
         currencyAssetId: state.currencyAssetId,
         controllerXonly: state.controllerXonly,
+        ...(state.holderClaimantXonly ? { holderClaimantXonly: state.holderClaimantXonly } : {}),
         faceValue: state.faceValue,
         outstandingAmount: state.outstandingAmount,
         repaidAmount: state.repaidAmount,
@@ -432,6 +440,9 @@ function buildFundedReceivableState(input) {
         ...previous,
         stateId: input.stateId,
         holderEntityId: input.holderEntityId,
+        holderClaimantXonly: input.holderEntityId === previous.holderEntityId
+            ? previous.holderClaimantXonly ?? previous.controllerXonly
+            : input.holderClaimantXonly ?? previous.controllerXonly,
         status: "FUNDED",
         createdAt: input.fundedAt,
         previousStateHash: summarizeReceivableState(previous).hash,
@@ -508,6 +519,7 @@ function buildReceivableClosingDescriptor(input) {
     });
 }
 function buildReceivableFundingClaimDescriptor(input) {
+    const definition = input.definition ? validateReceivableDefinition(input.definition) : undefined;
     const currentState = validateReceivableState(input.currentState);
     const currentStateHash = summarizeReceivableState(currentState).hash;
     return validateReceivableFundingClaimDescriptor({
@@ -518,7 +530,7 @@ function buildReceivableFundingClaimDescriptor(input) {
         currentStatus: currentState.status,
         payerEntityId: input.payerEntityId ?? currentState.holderEntityId,
         payeeEntityId: input.payeeEntityId ?? currentState.originatorEntityId,
-        claimantXonly: input.claimantXonly ?? currentState.controllerXonly,
+        claimantXonly: input.claimantXonly ?? definition?.originatorClaimantXonly ?? currentState.controllerXonly,
         currencyAssetId: currentState.currencyAssetId,
         amountSat: input.amountSat ?? currentState.lastTransition?.amount ?? currentState.outstandingAmount,
         eventTimestamp: input.eventTimestamp ?? currentState.lastTransition?.at ?? currentState.createdAt,
@@ -535,15 +547,41 @@ function buildReceivableRepaymentClaimDescriptor(input) {
         currentStatus: currentState.status,
         payerEntityId: input.payerEntityId ?? currentState.debtorEntityId,
         payeeEntityId: input.payeeEntityId ?? currentState.holderEntityId,
-        claimantXonly: input.claimantXonly ?? currentState.controllerXonly,
+        claimantXonly: input.claimantXonly ?? currentState.holderClaimantXonly ?? currentState.controllerXonly,
         currencyAssetId: currentState.currencyAssetId,
         amountSat: input.amountSat ?? currentState.lastTransition?.amount ?? currentState.repaidAmount,
         eventTimestamp: input.eventTimestamp ?? currentState.lastTransition?.at ?? currentState.createdAt,
     });
 }
+function resolveFundingClaimAuthority(definition, currentState) {
+    if (definition.originatorClaimantXonly) {
+        return {
+            claimantXonly: definition.originatorClaimantXonly,
+            authoritySource: "originator-claimant",
+        };
+    }
+    return {
+        claimantXonly: currentState.controllerXonly,
+        authoritySource: "controller-fallback",
+    };
+}
+function resolveRepaymentClaimAuthority(currentState) {
+    if (currentState.holderClaimantXonly) {
+        return {
+            claimantXonly: currentState.holderClaimantXonly,
+            authoritySource: "holder-claimant",
+        };
+    }
+    return {
+        claimantXonly: currentState.controllerXonly,
+        authoritySource: "controller-fallback",
+    };
+}
 function validateReceivableFundingClaimAgainstState(input) {
+    const definition = validateReceivableDefinition(input.definition);
     const currentState = validateReceivableState(input.currentState);
     const claim = validateReceivableFundingClaimDescriptor(input.claim);
+    const authority = resolveFundingClaimAuthority(definition, currentState);
     const currentStateHash = summarizeReceivableState(currentState).hash;
     const stateStatusEligible = currentState.status === "FUNDED";
     const receivableIdMatch = claim.receivableId === currentState.receivableId;
@@ -551,12 +589,14 @@ function validateReceivableFundingClaimAgainstState(input) {
     const currentStatusMatch = claim.currentStatus === currentState.status;
     const payerEntityMatch = claim.payerEntityId === currentState.holderEntityId;
     const payeeEntityMatch = claim.payeeEntityId === currentState.originatorEntityId;
-    const claimantXonlyMatch = claim.claimantXonly === currentState.controllerXonly;
+    const claimantXonlyMatch = claim.claimantXonly === authority.claimantXonly;
     const currencyAssetMatch = claim.currencyAssetId === currentState.currencyAssetId;
     const amountMatch = currentState.lastTransition?.type === "FUND" && claim.amountSat === currentState.lastTransition.amount;
     const eventTimestampMatch = currentState.lastTransition?.type === "FUND" && claim.eventTimestamp === currentState.lastTransition.at;
     return {
         claimKind: "FUNDING",
+        claimantAuthoritySource: authority.authoritySource,
+        roleSeparatedAuthorization: authority.authoritySource !== "controller-fallback",
         stateStatusEligible,
         receivableIdMatch,
         currentStateHashMatch,
@@ -582,6 +622,7 @@ function validateReceivableFundingClaimAgainstState(input) {
 function validateReceivableRepaymentClaimAgainstState(input) {
     const currentState = validateReceivableState(input.currentState);
     const claim = validateReceivableRepaymentClaimDescriptor(input.claim);
+    const authority = resolveRepaymentClaimAuthority(currentState);
     const currentStateHash = summarizeReceivableState(currentState).hash;
     const stateStatusEligible = currentState.status === "PARTIALLY_REPAID" || currentState.status === "REPAID";
     const receivableIdMatch = claim.receivableId === currentState.receivableId;
@@ -589,12 +630,14 @@ function validateReceivableRepaymentClaimAgainstState(input) {
     const currentStatusMatch = claim.currentStatus === currentState.status;
     const payerEntityMatch = claim.payerEntityId === currentState.debtorEntityId;
     const payeeEntityMatch = claim.payeeEntityId === currentState.holderEntityId;
-    const claimantXonlyMatch = claim.claimantXonly === currentState.controllerXonly;
+    const claimantXonlyMatch = claim.claimantXonly === authority.claimantXonly;
     const currencyAssetMatch = claim.currencyAssetId === currentState.currencyAssetId;
     const amountMatch = currentState.lastTransition?.type === "REPAY" && claim.amountSat === currentState.lastTransition.amount;
     const eventTimestampMatch = currentState.lastTransition?.type === "REPAY" && claim.eventTimestamp === currentState.lastTransition.at;
     return {
         claimKind: "REPAYMENT",
+        claimantAuthoritySource: authority.authoritySource,
+        roleSeparatedAuthorization: authority.authoritySource !== "controller-fallback",
         stateStatusEligible,
         receivableIdMatch,
         currentStateHashMatch,

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { createSimplicityClient, SimplicityClient } from "./client/SimplicityCli
 export { CompiledContract } from "./client/ContractFactory";
 export { DeployedContract } from "./client/DeployedContract";
 export { RelayerClient } from "./gasless/RelayerClient";
+export { ElementsRpcClient } from "./core/rpc";
+export * from "./x402";
 export * from "./core/types";
 export * from "./core/errors";
 export { listPresets, getPresetOrThrow } from "./core/presets";

package/dist/index.js

@@ -14,10 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyPositionReceipt = exports.signPositionReceipt = exports.verifyCapitalCall = exports.executeCapitalCallRefund = exports.inspectCapitalCallRefund = exports.executeCapitalCallRollover = exports.inspectCapitalCallRollover = exports.executeCapitalCallClaim = exports.inspectCapitalCallClaim = exports.prepareCapitalCall = exports.loadFund = exports.verifyFund = exports.defineFund = exports.exportFinalityPayload = exports.exportBondEvidence = exports.verifyClosing = exports.executeClosing = exports.inspectClosing = exports.prepareClosing = exports.verifySettlement = exports.buildSettlement = exports.verifyRedemption = exports.executeRedemption = exports.inspectRedemption = exports.prepareRedemption = exports.issueBond = exports.loadBond = exports.verifyIssuanceHistory = exports.verifyBond = exports.defineBond = exports.verifyStateDescriptorAgainstArtifact = exports.verifyStateAgainstArtifact = exports.buildArtifactStateMetadata = exports.loadStateInput = exports.verifyDefinitionDescriptorAgainstArtifact = exports.verifyDefinitionAgainstArtifact = exports.buildArtifactDefinitionMetadata = exports.loadDefinitionInput = exports.evaluateOutputBindingSupport = exports.describeOutputBindingSupport = exports.normalizeArtifact = exports.saveArtifact = exports.loadArtifact = exports.getPresetOrThrow = exports.listPresets = exports.RelayerClient = exports.DeployedContract = exports.CompiledContract = exports.SimplicityClient = exports.createSimplicityClient = void 0;
-exports.validateCapitalCallState = exports.validateFundDefinition = exports.summarizeFundFinalityPayload = exports.summarizeFundClosingDescriptor = exports.summarizeDistributionDescriptor = exports.summarizeLPPositionReceipt = exports.summarizeCapitalCallState = exports.summarizeFundDefinition = exports.validateBondSettlementMatchesExpected = exports.validateBondSettlementDescriptor = exports.summarizeBondSettlementDescriptor = exports.verifyBondIssuanceHistory = exports.summarizeBondIssuanceState = exports.buildRedeemedBondIssuanceState = exports.validateBondStateTransition = exports.validateBondCrossChecks = exports.validateBondIssuanceState = exports.validateBondDefinition = exports.exportReceivableFinalityPayload = exports.exportReceivableEvidence = exports.verifyReceivableStateHistory = exports.verifyReceivableClosing = exports.prepareReceivableClosing = exports.verifyReceivableWriteOff = exports.prepareReceivableWriteOff = exports.verifyReceivableRepaymentClaim = exports.executeReceivableRepaymentClaim = exports.inspectReceivableRepaymentClaim = exports.prepareReceivableRepaymentClaim = exports.verifyReceivableRepayment = exports.prepareReceivableRepayment = exports.verifyReceivableFundingClaim = exports.executeReceivableFundingClaim = exports.inspectReceivableFundingClaim = exports.prepareReceivableFundingClaim = exports.verifyReceivableFunding = exports.prepareReceivableFunding = exports.loadReceivable = exports.verifyReceivable = exports.defineReceivable = exports.exportFundFinalityPayload = exports.exportFundEvidence = exports.verifyFundClosing = exports.prepareFundClosing = exports.verifyDistribution = exports.executeDistributionClaim = exports.inspectDistributionClaim = exports.reconcilePosition = exports.prepareDistribution = exports.verifyPositionReceiptChain = void 0;
-exports.verifyTransfer = exports.verifyState = exports.inspectTransfer = exports.executeTransfer = exports.prepareTransfer = exports.issue = exports.validatePolicyTemplateParams = exports.describePolicyTemplate = exports.validatePolicyTemplateManifest = exports.loadPolicyTemplateManifest = exports.listPolicyTemplates = exports.buildPolicyOutputDescriptor = exports.compilePolicyStateContract = exports.verifyReceivableStateHistoryValidation = exports.validateReceivableWriteOffTransition = exports.validateReceivableRepaymentTransition = exports.validateReceivableFundingTransition = exports.validateReceivableCrossChecks = exports.validateReceivableState = exports.validateReceivableRepaymentClaimDescriptor = exports.validateReceivableRepaymentClaimAgainstState = exports.validateReceivableFundingClaimDescriptor = exports.validateReceivableFundingClaimAgainstState = exports.validateReceivableDefinition = exports.validateReceivableClosingDescriptor = exports.validateReceivableClosingAgainstState = exports.summarizeReceivableState = exports.summarizeReceivableRepaymentClaimDescriptor = exports.summarizeReceivableFundingClaimDescriptor = exports.summarizeReceivableDefinition = exports.summarizeReceivableClosingDescriptor = exports.buildReceivableRepaymentClaimDescriptor = exports.buildReceivableFundingClaimDescriptor = exports.buildReceivableClosingDescriptor = exports.buildFundedReceivableState = exports.buildDefaultedReceivableState = exports.applyReceivableRepayment = exports.buildFundClosingDescriptor = exports.buildDistributionDescriptor = exports.applyDistributionsToReceipt = exports.applyDistributionToReceipt = exports.buildLPPositionReceipt = exports.buildRefundedCapitalCallState = exports.buildClaimedCapitalCallState = exports.validateClosingAgainstReceipt = exports.validateDistributionAgainstReceipt = exports.validateFundCrossChecks = exports.validateFundClosingDescriptor = exports.validateDistributionDescriptor = exports.validateLPPositionReceipt = void 0;
-exports.validatePolicyTransferDescriptor = exports.validatePolicyOutputDescriptor = exports.validatePolicyState = exports.summarizePolicyTransferDescriptor = exports.summarizePolicyOutputDescriptor = exports.summarizePolicyState = exports.exportPolicyEvidence = void 0;
+exports.signPositionReceipt = exports.verifyCapitalCall = exports.executeCapitalCallRefund = exports.inspectCapitalCallRefund = exports.executeCapitalCallRollover = exports.inspectCapitalCallRollover = exports.executeCapitalCallClaim = exports.inspectCapitalCallClaim = exports.prepareCapitalCall = exports.loadFund = exports.verifyFund = exports.defineFund = exports.exportFinalityPayload = exports.exportBondEvidence = exports.verifyClosing = exports.executeClosing = exports.inspectClosing = exports.prepareClosing = exports.verifySettlement = exports.buildSettlement = exports.verifyRedemption = exports.executeRedemption = exports.inspectRedemption = exports.prepareRedemption = exports.issueBond = exports.loadBond = exports.verifyIssuanceHistory = exports.verifyBond = exports.defineBond = exports.verifyStateDescriptorAgainstArtifact = exports.verifyStateAgainstArtifact = exports.buildArtifactStateMetadata = exports.loadStateInput = exports.verifyDefinitionDescriptorAgainstArtifact = exports.verifyDefinitionAgainstArtifact = exports.buildArtifactDefinitionMetadata = exports.loadDefinitionInput = exports.evaluateOutputBindingSupport = exports.describeOutputBindingSupport = exports.normalizeArtifact = exports.saveArtifact = exports.loadArtifact = exports.getPresetOrThrow = exports.listPresets = exports.ElementsRpcClient = exports.RelayerClient = exports.DeployedContract = exports.CompiledContract = exports.SimplicityClient = exports.createSimplicityClient = void 0;
+exports.validateFundDefinition = exports.summarizeFundFinalityPayload = exports.summarizeFundClosingDescriptor = exports.summarizeDistributionDescriptor = exports.summarizeLPPositionReceipt = exports.summarizeCapitalCallState = exports.summarizeFundDefinition = exports.validateBondSettlementMatchesExpected = exports.validateBondSettlementDescriptor = exports.summarizeBondSettlementDescriptor = exports.verifyBondIssuanceHistory = exports.summarizeBondIssuanceState = exports.buildRedeemedBondIssuanceState = exports.validateBondStateTransition = exports.validateBondCrossChecks = exports.validateBondIssuanceState = exports.validateBondDefinition = exports.exportReceivableFinalityPayload = exports.exportReceivableEvidence = exports.verifyReceivableStateHistory = exports.verifyReceivableClosing = exports.prepareReceivableClosing = exports.verifyReceivableWriteOff = exports.prepareReceivableWriteOff = exports.verifyReceivableRepaymentClaim = exports.executeReceivableRepaymentClaim = exports.inspectReceivableRepaymentClaim = exports.prepareReceivableRepaymentClaim = exports.verifyReceivableRepayment = exports.prepareReceivableRepayment = exports.verifyReceivableFundingClaim = exports.executeReceivableFundingClaim = exports.inspectReceivableFundingClaim = exports.prepareReceivableFundingClaim = exports.verifyReceivableFunding = exports.prepareReceivableFunding = exports.loadReceivable = exports.verifyReceivable = exports.defineReceivable = exports.exportFundFinalityPayload = exports.exportFundEvidence = exports.verifyFundClosing = exports.prepareFundClosing = exports.verifyDistribution = exports.executeDistributionClaim = exports.inspectDistributionClaim = exports.reconcilePosition = exports.prepareDistribution = exports.verifyPositionReceiptChain = exports.verifyPositionReceipt = void 0;
+exports.verifyState = exports.inspectTransfer = exports.executeTransfer = exports.prepareTransfer = exports.issue = exports.validatePolicyTemplateParams = exports.describePolicyTemplate = exports.validatePolicyTemplateManifest = exports.loadPolicyTemplateManifest = exports.listPolicyTemplates = exports.buildPolicyOutputDescriptor = exports.compilePolicyStateContract = exports.verifyReceivableStateHistoryValidation = exports.validateReceivableWriteOffTransition = exports.validateReceivableRepaymentTransition = exports.validateReceivableFundingTransition = exports.validateReceivableCrossChecks = exports.validateReceivableState = exports.validateReceivableRepaymentClaimDescriptor = exports.validateReceivableRepaymentClaimAgainstState = exports.validateReceivableFundingClaimDescriptor = exports.validateReceivableFundingClaimAgainstState = exports.validateReceivableDefinition = exports.validateReceivableClosingDescriptor = exports.validateReceivableClosingAgainstState = exports.summarizeReceivableState = exports.summarizeReceivableRepaymentClaimDescriptor = exports.summarizeReceivableFundingClaimDescriptor = exports.summarizeReceivableDefinition = exports.summarizeReceivableClosingDescriptor = exports.buildReceivableRepaymentClaimDescriptor = exports.buildReceivableFundingClaimDescriptor = exports.buildReceivableClosingDescriptor = exports.buildFundedReceivableState = exports.buildDefaultedReceivableState = exports.applyReceivableRepayment = exports.buildFundClosingDescriptor = exports.buildDistributionDescriptor = exports.applyDistributionsToReceipt = exports.applyDistributionToReceipt = exports.buildLPPositionReceipt = exports.buildRefundedCapitalCallState = exports.buildClaimedCapitalCallState = exports.validateClosingAgainstReceipt = exports.validateDistributionAgainstReceipt = exports.validateFundCrossChecks = exports.validateFundClosingDescriptor = exports.validateDistributionDescriptor = exports.validateLPPositionReceipt = exports.validateCapitalCallState = void 0;
+exports.validatePolicyTransferDescriptor = exports.validatePolicyOutputDescriptor = exports.validatePolicyState = exports.summarizePolicyTransferDescriptor = exports.summarizePolicyOutputDescriptor = exports.summarizePolicyState = exports.exportPolicyEvidence = exports.verifyTransfer = void 0;
 var SimplicityClient_1 = require("./client/SimplicityClient");
 Object.defineProperty(exports, "createSimplicityClient", { enumerable: true, get: function () { return SimplicityClient_1.createSimplicityClient; } });
 Object.defineProperty(exports, "SimplicityClient", { enumerable: true, get: function () { return SimplicityClient_1.SimplicityClient; } });
@@ -27,6 +27,9 @@ var DeployedContract_1 = require("./client/DeployedContract");
 Object.defineProperty(exports, "DeployedContract", { enumerable: true, get: function () { return DeployedContract_1.DeployedContract; } });
 var RelayerClient_1 = require("./gasless/RelayerClient");
 Object.defineProperty(exports, "RelayerClient", { enumerable: true, get: function () { return RelayerClient_1.RelayerClient; } });
+var rpc_1 = require("./core/rpc");
+Object.defineProperty(exports, "ElementsRpcClient", { enumerable: true, get: function () { return rpc_1.ElementsRpcClient; } });
+__exportStar(require("./x402"), exports);
 __exportStar(require("./core/types"), exports);
 __exportStar(require("./core/errors"), exports);
 var presets_1 = require("./core/presets");

package/dist/x402/index.d.ts

@@ -0,0 +1,125 @@
+import { ElementsRpcClient } from "../core/rpc";
+export declare const LIQUID_X402_SCHEME: "exact-liquid-pset";
+export declare const LIQUID_X402_VERSION: 1;
+export declare const LIQUID_X402_DEFAULT_NETWORK: "liquidtestnet";
+export declare const LIQUID_X402_DEFAULT_TIMEOUT_SECONDS = 60;
+export type LiquidX402Network = "liquidtestnet" | "liquidv1";
+export type LiquidX402AssetKey = "lbtc" | "usdt";
+export interface LiquidX402Asset {
+    key: LiquidX402AssetKey;
+    label: string;
+    network: LiquidX402Network;
+    assetId: string;
+    decimals: number;
+    isNative: boolean;
+}
+export interface LiquidX402RequirementsInput {
+    paymentRequestId: string;
+    resource: string;
+    payTo: string;
+    amountAtomic: string | number | bigint;
+    network?: LiquidX402Network;
+    asset?: LiquidX402AssetKey | string;
+    description?: string;
+    mimeType?: string;
+    maxTimeoutSeconds?: number;
+    expiresAt?: string | Date;
+    maxFeeSat?: string | number | bigint;
+    metadata?: Record<string, unknown>;
+}
+export interface LiquidX402PaymentRequirements {
+    scheme: typeof LIQUID_X402_SCHEME;
+    network: LiquidX402Network;
+    maxAmountRequired: string;
+    resource: string;
+    description: string;
+    mimeType: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    asset: string;
+    extra: {
+        paymentRequestId: string;
+        asset: LiquidX402AssetKey;
+        assetId: string;
+        decimals: number;
+        expiresAt: string;
+        feeAsset: "lbtc";
+        feeAssetId?: string;
+        maxFeeSat?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface LiquidX402PaymentPayload {
+    scheme: typeof LIQUID_X402_SCHEME;
+    network: LiquidX402Network;
+    paymentRequestId: string;
+    asset: LiquidX402AssetKey;
+    assetId: string;
+    amountAtomic: string;
+    payTo: string;
+    psetBase64: string;
+    summaryHash: string;
+    payer?: string;
+    expiresAt: string;
+}
+export interface LiquidX402PreparePsetPaymentInput {
+    requirements: LiquidX402PaymentRequirements;
+    wallet: string;
+    payer?: string;
+    locktime?: number;
+    sign?: boolean;
+}
+export interface LiquidX402PreparePsetPaymentResult {
+    paymentPayload: LiquidX402PaymentPayload;
+    xPayment: string;
+    psetBase64: string;
+    summaryHash: string;
+}
+export interface LiquidX402VerifyPaymentInput {
+    requirements: LiquidX402PaymentRequirements | Record<string, unknown>;
+    paymentPayload: LiquidX402PaymentPayload | Record<string, unknown>;
+    now?: Date;
+}
+export interface LiquidX402VerifyPaymentResult {
+    isValid: boolean;
+    invalidReason?: string;
+    payer?: string | null;
+    network?: LiquidX402Network;
+    paymentRequestId?: string;
+    summaryHash?: string;
+}
+export interface LiquidX402SettlePaymentInput extends LiquidX402VerifyPaymentInput {
+    wallet?: string;
+    broadcast?: boolean;
+}
+export interface LiquidX402SettlePaymentResult {
+    success: boolean;
+    errorCode?: string;
+    txId?: string;
+    transactionHash?: string;
+    rawTxHex?: string;
+    summaryHash?: string;
+}
+type DecodePsbtResult = {
+    fees?: Record<string, number>;
+    outputs?: Array<{
+        amount?: number;
+        asset?: string;
+        script?: {
+            address?: string;
+            hex?: string;
+        };
+    }>;
+};
+export declare const LIQUID_X402_ASSETS: Record<LiquidX402Network, Record<LiquidX402AssetKey, LiquidX402Asset>>;
+export declare function listLiquidX402Assets(network?: LiquidX402Network): LiquidX402Asset[];
+export declare function resolveLiquidX402Asset(asset: LiquidX402AssetKey | string, network?: LiquidX402Network): LiquidX402Asset;
+export declare function buildLiquidX402Requirements(input: LiquidX402RequirementsInput): LiquidX402PaymentRequirements;
+export declare function encodeLiquidXPayment(payload: LiquidX402PaymentPayload): string;
+export declare function decodeLiquidXPayment(raw: string): LiquidX402PaymentPayload | null;
+export declare function prepareLiquidX402PsetPayment(rpc: ElementsRpcClient, input: LiquidX402PreparePsetPaymentInput): Promise<LiquidX402PreparePsetPaymentResult>;
+export declare function verifyLiquidX402Payment(rpc: ElementsRpcClient | null, input: LiquidX402VerifyPaymentInput): Promise<LiquidX402VerifyPaymentResult>;
+export declare function settleLiquidX402Payment(rpc: ElementsRpcClient, input: LiquidX402SettlePaymentInput): Promise<LiquidX402SettlePaymentResult>;
+export declare function verifyLiquidX402PayloadFields(requirements: LiquidX402PaymentRequirements | Record<string, unknown>, payload: LiquidX402PaymentPayload | Record<string, unknown>, now?: Date): LiquidX402VerifyPaymentResult;
+export declare function buildLiquidPsetSummaryHash(decoded: DecodePsbtResult, requirements: LiquidX402PaymentRequirements | Record<string, unknown>): string;
+export {};

package/dist/x402/index.js

@@ -0,0 +1,396 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIQUID_X402_ASSETS = exports.LIQUID_X402_DEFAULT_TIMEOUT_SECONDS = exports.LIQUID_X402_DEFAULT_NETWORK = exports.LIQUID_X402_VERSION = exports.LIQUID_X402_SCHEME = void 0;
+exports.listLiquidX402Assets = listLiquidX402Assets;
+exports.resolveLiquidX402Asset = resolveLiquidX402Asset;
+exports.buildLiquidX402Requirements = buildLiquidX402Requirements;
+exports.encodeLiquidXPayment = encodeLiquidXPayment;
+exports.decodeLiquidXPayment = decodeLiquidXPayment;
+exports.prepareLiquidX402PsetPayment = prepareLiquidX402PsetPayment;
+exports.verifyLiquidX402Payment = verifyLiquidX402Payment;
+exports.settleLiquidX402Payment = settleLiquidX402Payment;
+exports.verifyLiquidX402PayloadFields = verifyLiquidX402PayloadFields;
+exports.buildLiquidPsetSummaryHash = buildLiquidPsetSummaryHash;
+const node_crypto_1 = require("node:crypto");
+exports.LIQUID_X402_SCHEME = "exact-liquid-pset";
+exports.LIQUID_X402_VERSION = 1;
+exports.LIQUID_X402_DEFAULT_NETWORK = "liquidtestnet";
+exports.LIQUID_X402_DEFAULT_TIMEOUT_SECONDS = 60;
+const LIQUID_TESTNET_USDT_ASSET_ID = "b612eb46313a2cd6ebabd8b7a8eed5696e29898b87a43bff41c94f51acef9d73";
+const LIQUID_MAINNET_USDT_ASSET_ID = "ce091c998b83c78bb71a632313ba3760f1763d9cfcffae02258ffa9865a37bd2";
+exports.LIQUID_X402_ASSETS = {
+    liquidtestnet: {
+        lbtc: {
+            key: "lbtc",
+            label: "Liquid Bitcoin",
+            network: "liquidtestnet",
+            assetId: "bitcoin",
+            decimals: 8,
+            isNative: true,
+        },
+        usdt: {
+            key: "usdt",
+            label: "Tether USDt",
+            network: "liquidtestnet",
+            assetId: LIQUID_TESTNET_USDT_ASSET_ID,
+            decimals: 8,
+            isNative: false,
+        },
+    },
+    liquidv1: {
+        lbtc: {
+            key: "lbtc",
+            label: "Liquid Bitcoin",
+            network: "liquidv1",
+            assetId: "bitcoin",
+            decimals: 8,
+            isNative: true,
+        },
+        usdt: {
+            key: "usdt",
+            label: "Tether USDt",
+            network: "liquidv1",
+            assetId: LIQUID_MAINNET_USDT_ASSET_ID,
+            decimals: 8,
+            isNative: false,
+        },
+    },
+};
+function listLiquidX402Assets(network) {
+    if (network)
+        return Object.values(exports.LIQUID_X402_ASSETS[network]);
+    return Object.values(exports.LIQUID_X402_ASSETS).flatMap((assets) => Object.values(assets));
+}
+function resolveLiquidX402Asset(asset, network = exports.LIQUID_X402_DEFAULT_NETWORK) {
+    const key = normalizeAssetKey(asset);
+    const resolved = exports.LIQUID_X402_ASSETS[network]?.[key];
+    if (!resolved) {
+        throw new Error(`unsupported Liquid x402 asset: ${asset} on ${network}`);
+    }
+    return resolved;
+}
+function buildLiquidX402Requirements(input) {
+    const network = normalizeNetwork(input.network ?? exports.LIQUID_X402_DEFAULT_NETWORK);
+    const asset = resolveLiquidX402Asset(input.asset ?? "usdt", network);
+    const amountAtomic = normalizeAmountAtomic(input.amountAtomic);
+    const expiresAt = normalizeExpiresAt(input.expiresAt, input.maxTimeoutSeconds);
+    const description = String(input.description ?? "").trim() || "Unlock resource";
+    const mimeType = String(input.mimeType ?? "").trim() || "application/octet-stream";
+    const maxTimeoutSeconds = normalizeTimeout(input.maxTimeoutSeconds);
+    const paymentRequestId = String(input.paymentRequestId ?? "").trim();
+    if (!paymentRequestId)
+        throw new Error("paymentRequestId is required");
+    const resource = String(input.resource ?? "").trim();
+    if (!resource)
+        throw new Error("resource is required");
+    const payTo = String(input.payTo ?? "").trim();
+    if (!payTo)
+        throw new Error("payTo is required");
+    return {
+        scheme: exports.LIQUID_X402_SCHEME,
+        network,
+        maxAmountRequired: amountAtomic,
+        resource,
+        description,
+        mimeType,
+        payTo,
+        maxTimeoutSeconds,
+        asset: asset.assetId,
+        extra: {
+            paymentRequestId,
+            asset: asset.key,
+            assetId: asset.assetId,
+            decimals: asset.decimals,
+            expiresAt,
+            feeAsset: "lbtc",
+            feeAssetId: exports.LIQUID_X402_ASSETS[network].lbtc.assetId,
+            ...(input.maxFeeSat !== undefined ? { maxFeeSat: normalizeAmountAtomic(input.maxFeeSat) } : {}),
+            ...(input.metadata ? { metadata: input.metadata } : {}),
+        },
+    };
+}
+function encodeLiquidXPayment(payload) {
+    return Buffer.from(JSON.stringify(payload)).toString("base64url");
+}
+function decodeLiquidXPayment(raw) {
+    const value = String(raw ?? "").trim();
+    if (!value)
+        return null;
+    try {
+        const parsed = JSON.parse(Buffer.from(value, "base64url").toString("utf8"));
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return null;
+        if (String(parsed.scheme ?? "") !== exports.LIQUID_X402_SCHEME)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+async function prepareLiquidX402PsetPayment(rpc, input) {
+    const requirements = coerceRequirements(input.requirements);
+    const amount = atomicToDecimalNumber(requirements.maxAmountRequired, requirements.extra.decimals);
+    const outputs = [
+        { [requirements.payTo]: amount, asset: requirements.asset },
+    ];
+    const pset = await rpc.call("createpsbt", [[], outputs, input.locktime ?? 0, true], input.wallet);
+    const updatedPset = await rpc.call("utxoupdatepsbt", [pset], input.wallet);
+    const signed = input.sign === false
+        ? updatedPset
+        : (await rpc.call("walletprocesspsbt", [updatedPset, true, "ALL", true], input.wallet)).psbt ?? updatedPset;
+    const decoded = await rpc.call("decodepsbt", [signed], input.wallet);
+    const summaryHash = buildLiquidPsetSummaryHash(decoded, requirements);
+    const paymentPayload = {
+        scheme: exports.LIQUID_X402_SCHEME,
+        network: requirements.network,
+        paymentRequestId: requirements.extra.paymentRequestId,
+        asset: requirements.extra.asset,
+        assetId: requirements.asset,
+        amountAtomic: requirements.maxAmountRequired,
+        payTo: requirements.payTo,
+        psetBase64: signed,
+        summaryHash,
+        ...(input.payer ? { payer: input.payer } : {}),
+        expiresAt: requirements.extra.expiresAt,
+    };
+    return {
+        paymentPayload,
+        xPayment: encodeLiquidXPayment(paymentPayload),
+        psetBase64: signed,
+        summaryHash,
+    };
+}
+async function verifyLiquidX402Payment(rpc, input) {
+    const requirements = coerceRequirements(input.requirements);
+    const payload = coercePaymentPayload(input.paymentPayload);
+    const basic = verifyLiquidX402PayloadFields(requirements, payload, input.now);
+    if (!basic.isValid)
+        return basic;
+    if (!rpc) {
+        return basic;
+    }
+    try {
+        const decoded = await rpc.call("decodepsbt", [payload.psetBase64]);
+        const actualSummaryHash = buildLiquidPsetSummaryHash(decoded, requirements);
+        if (actualSummaryHash !== payload.summaryHash) {
+            return { ...basic, isValid: false, invalidReason: "pset_summary_mismatch" };
+        }
+        if (!decodedContainsExpectedOutput(decoded, requirements)) {
+            return { ...basic, isValid: false, invalidReason: "pset_expected_output_missing" };
+        }
+        if (!decodedFeeWithinCap(decoded, requirements)) {
+            return { ...basic, isValid: false, invalidReason: "fee_too_high" };
+        }
+        return basic;
+    }
+    catch {
+        return { ...basic, isValid: false, invalidReason: "pset_decode_failed" };
+    }
+}
+async function settleLiquidX402Payment(rpc, input) {
+    const verification = await verifyLiquidX402Payment(rpc, input);
+    if (!verification.isValid) {
+        return { success: false, errorCode: verification.invalidReason ?? "payment_verification_failed" };
+    }
+    const payload = coercePaymentPayload(input.paymentPayload);
+    try {
+        const finalized = await rpc.call("finalizepsbt", [payload.psetBase64, true], input.wallet);
+        if (!finalized.complete || !finalized.hex) {
+            return { success: false, errorCode: "pset_not_complete", summaryHash: payload.summaryHash };
+        }
+        const mempool = await rpc.call("testmempoolaccept", [[finalized.hex]], input.wallet);
+        if (mempool[0]?.allowed !== true) {
+            return {
+                success: false,
+                errorCode: mempool[0]?.reject_reason || "mempool_rejected",
+                rawTxHex: finalized.hex,
+                summaryHash: payload.summaryHash,
+            };
+        }
+        if (input.broadcast === false) {
+            return { success: true, rawTxHex: finalized.hex, summaryHash: payload.summaryHash };
+        }
+        const txId = await rpc.call("sendrawtransaction", [finalized.hex], input.wallet);
+        return {
+            success: true,
+            txId,
+            transactionHash: txId,
+            rawTxHex: finalized.hex,
+            summaryHash: payload.summaryHash,
+        };
+    }
+    catch {
+        return { success: false, errorCode: "settlement_rpc_failed", summaryHash: payload.summaryHash };
+    }
+}
+function verifyLiquidX402PayloadFields(requirements, payload, now = new Date()) {
+    const req = coerceRequirements(requirements);
+    const parsed = coercePaymentPayload(payload);
+    const base = {
+        payer: parsed.payer ?? null,
+        network: parsed.network,
+        paymentRequestId: parsed.paymentRequestId,
+        summaryHash: parsed.summaryHash,
+    };
+    if (parsed.scheme !== exports.LIQUID_X402_SCHEME)
+        return { ...base, isValid: false, invalidReason: "unsupported_scheme" };
+    if (parsed.network !== req.network)
+        return { ...base, isValid: false, invalidReason: "network_mismatch" };
+    if (parsed.paymentRequestId !== req.extra.paymentRequestId) {
+        return { ...base, isValid: false, invalidReason: "payment_request_mismatch" };
+    }
+    if (parsed.asset !== req.extra.asset || parsed.assetId !== req.asset) {
+        return { ...base, isValid: false, invalidReason: "asset_mismatch" };
+    }
+    if (parsed.amountAtomic !== req.maxAmountRequired) {
+        return { ...base, isValid: false, invalidReason: "amount_mismatch" };
+    }
+    if (parsed.payTo !== req.payTo)
+        return { ...base, isValid: false, invalidReason: "recipient_mismatch" };
+    if (!parsed.psetBase64)
+        return { ...base, isValid: false, invalidReason: "pset_missing" };
+    if (!parsed.summaryHash)
+        return { ...base, isValid: false, invalidReason: "summary_hash_missing" };
+    if (new Date(parsed.expiresAt).getTime() <= now.getTime()) {
+        return { ...base, isValid: false, invalidReason: "payment_expired" };
+    }
+    return { ...base, isValid: true };
+}
+function buildLiquidPsetSummaryHash(decoded, requirements) {
+    const req = coerceRequirements(requirements);
+    return sha256Hex(stableStringify({
+        scheme: exports.LIQUID_X402_SCHEME,
+        network: req.network,
+        paymentRequestId: req.extra.paymentRequestId,
+        asset: req.extra.asset,
+        assetId: req.asset,
+        amountAtomic: req.maxAmountRequired,
+        payTo: req.payTo,
+        outputs: normalizeDecodedOutputs(decoded),
+        fees: decoded.fees ?? {},
+    }));
+}
+function decodedContainsExpectedOutput(decoded, requirements) {
+    const expectedAmount = atomicToDecimalNumber(requirements.maxAmountRequired, requirements.extra.decimals);
+    return (decoded.outputs ?? []).some((output) => (String(output.asset ?? "").toLowerCase() === requirements.asset.toLowerCase() &&
+        Math.round(Number(output.amount ?? 0) * 10 ** requirements.extra.decimals) ===
+            Math.round(expectedAmount * 10 ** requirements.extra.decimals) &&
+        String(output.script?.address ?? "") === requirements.payTo));
+}
+function normalizeDecodedOutputs(decoded) {
+    return (decoded.outputs ?? []).map((output) => ({
+        amount: output.amount ?? null,
+        asset: output.asset ?? null,
+        address: output.script?.address ?? null,
+        scriptPubKey: output.script?.hex ?? null,
+    }));
+}
+function coerceRequirements(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("requirements must be an object");
+    const raw = value;
+    const extra = raw.extra && typeof raw.extra === "object" && !Array.isArray(raw.extra) ? raw.extra : {};
+    const network = normalizeNetwork(raw.network);
+    const asset = resolveLiquidX402Asset(extra.asset ?? raw.asset, network);
+    return {
+        scheme: exports.LIQUID_X402_SCHEME,
+        network,
+        maxAmountRequired: normalizeAmountAtomic(raw.maxAmountRequired),
+        resource: String(raw.resource ?? ""),
+        description: String(raw.description ?? ""),
+        mimeType: String(raw.mimeType ?? ""),
+        payTo: String(raw.payTo ?? ""),
+        maxTimeoutSeconds: normalizeTimeout(raw.maxTimeoutSeconds),
+        asset: String(raw.asset ?? extra.assetId ?? asset.assetId),
+        extra: {
+            paymentRequestId: String(extra.paymentRequestId ?? raw.paymentRequestId ?? ""),
+            asset: asset.key,
+            assetId: String(extra.assetId ?? raw.asset ?? asset.assetId),
+            decimals: Number(extra.decimals ?? asset.decimals),
+            expiresAt: String(extra.expiresAt ?? ""),
+            feeAsset: "lbtc",
+            feeAssetId: String(extra.feeAssetId ?? exports.LIQUID_X402_ASSETS[network].lbtc.assetId),
+            ...(extra.maxFeeSat !== undefined ? { maxFeeSat: normalizeAmountAtomic(extra.maxFeeSat) } : {}),
+            ...(extra.metadata ? { metadata: extra.metadata } : {}),
+        },
+    };
+}
+function decodedFeeWithinCap(decoded, requirements) {
+    if (requirements.extra.maxFeeSat === undefined)
+        return true;
+    const maxFeeSat = BigInt(requirements.extra.maxFeeSat);
+    const feeSat = Object.values(decoded.fees ?? {}).reduce((sum, amount) => {
+        const sat = Math.round(Number(amount) * 100_000_000);
+        return sum + BigInt(Number.isFinite(sat) ? sat : 0);
+    }, 0n);
+    return feeSat <= maxFeeSat;
+}
+function coercePaymentPayload(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("payment payload must be an object");
+    const raw = value;
+    return {
+        scheme: exports.LIQUID_X402_SCHEME,
+        network: normalizeNetwork(raw.network),
+        paymentRequestId: String(raw.paymentRequestId ?? ""),
+        asset: normalizeAssetKey(String(raw.asset ?? "")),
+        assetId: String(raw.assetId ?? ""),
+        amountAtomic: normalizeAmountAtomic(raw.amountAtomic),
+        payTo: String(raw.payTo ?? ""),
+        psetBase64: String(raw.psetBase64 ?? ""),
+        summaryHash: String(raw.summaryHash ?? ""),
+        ...(raw.payer ? { payer: String(raw.payer) } : {}),
+        expiresAt: String(raw.expiresAt ?? ""),
+    };
+}
+function normalizeNetwork(input) {
+    const value = String(input ?? "").trim().toLowerCase();
+    if (value === "liquidtestnet" || value === "liquidv1")
+        return value;
+    throw new Error(`unsupported Liquid x402 network: ${String(input)}`);
+}
+function normalizeAssetKey(input) {
+    const value = String(input ?? "").trim().toLowerCase();
+    if (value === "lbtc" || value === "bitcoin")
+        return "lbtc";
+    if (value === "usdt" || value === "usdt-liquid" || value === "tether")
+        return "usdt";
+    throw new Error(`unsupported Liquid x402 asset: ${String(input)}`);
+}
+function normalizeAmountAtomic(input) {
+    const raw = typeof input === "bigint" ? input.toString() : String(input ?? "").trim();
+    if (!/^\d+$/u.test(raw))
+        throw new Error("amountAtomic must be an integer string");
+    return BigInt(raw).toString();
+}
+function normalizeTimeout(input) {
+    const parsed = Number(input ?? exports.LIQUID_X402_DEFAULT_TIMEOUT_SECONDS);
+    return Number.isFinite(parsed) && parsed > 0 ? Math.trunc(parsed) : exports.LIQUID_X402_DEFAULT_TIMEOUT_SECONDS;
+}
+function normalizeExpiresAt(expiresAt, timeoutSeconds) {
+    if (expiresAt instanceof Date)
+        return expiresAt.toISOString();
+    const raw = String(expiresAt ?? "").trim();
+    if (raw)
+        return new Date(raw).toISOString();
+    return new Date(Date.now() + normalizeTimeout(timeoutSeconds) * 1000).toISOString();
+}
+function atomicToDecimalNumber(amountAtomic, decimals) {
+    const amount = BigInt(amountAtomic);
+    const scale = 10n ** BigInt(decimals);
+    const whole = amount / scale;
+    const frac = amount % scale;
+    return Number(`${whole}.${frac.toString().padStart(decimals, "0")}`);
+}
+function sha256Hex(value) {
+    return (0, node_crypto_1.createHash)("sha256").update(value, "utf8").digest("hex");
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
+    const record = value;
+    return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`).join(",")}}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hazbase/simplicity",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "An SDK for Simplicity on Liquid",
   "author": "IndieSquare Inc <info@hazbase.com>",
   "keywords": [