@hazbase/simplicity 0.2.1 → 0.3.1

package/README.md

@@ -193,6 +193,22 @@ RECEIVABLE_OUTPUT_BINDING_MODE=script-bound npm run e2e:receivable-testnet
 RECEIVABLE_OUTPUT_BINDING_MODE=descriptor-bound npm run e2e:receivable-testnet
 ```
 
+Liquid x402 buyer smoke test:
+
+```bash
+npm install --no-save lwk_node@^0.17.1
+npm run e2e:x402-lwk-address -- --generate
+npm run e2e:x402-lwk-buyer -- https://share.example/v/slug --dry-run
+LIQUID_X402_E2E_MNEMONIC="..." npm run e2e:x402-lwk-buyer -- https://share.example/v/slug --no-submit
+LIQUID_X402_E2E_MNEMONIC="..." npm run e2e:x402-lwk-buyer -- https://share.example/v/slug --output unlocked.bin
+```
+
+The address script derives a confidential Liquid receive address for funding a
+test buyer wallet. The buyer script then uses LWK locally to scan, build, sign,
+and finalize a Liquid PSET, then sends the resulting `X-PAYMENT` header back to
+the protected URL. `--dry-run` only inspects the 402 requirements, while
+`--no-submit` signs a payment without broadcasting through the seller backend.
+
 These commands are useful both as reproducible checks and as examples of the SDK's current validated surface.
 
 ## Where To Go Next

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,19 @@ 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>;
+            buildPaymentFromPset: typeof liquidX402.buildLiquidX402PaymentFromPset;
+            prepareLwkWasmPayment: typeof liquidX402.prepareLiquidX402LwkWasmPayment;
+            deriveLwkWasmAddress: typeof liquidX402.deriveLiquidX402LwkWasmAddress;
+            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,19 @@ 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),
+                buildPaymentFromPset: liquidX402.buildLiquidX402PaymentFromPset,
+                prepareLwkWasmPayment: liquidX402.prepareLiquidX402LwkWasmPayment,
+                deriveLwkWasmAddress: liquidX402.deriveLiquidX402LwkWasmAddress,
+                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/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,188 @@
+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 LiquidX402BuildPaymentFromPsetInput {
+    requirements: LiquidX402PaymentRequirements | Record<string, unknown>;
+    psetBase64: string;
+    decoded?: DecodePsbtResult;
+    payer?: string;
+    summaryHash?: string;
+}
+export interface LiquidX402PrepareLwkWasmPaymentInput {
+    requirements: LiquidX402PaymentRequirements | Record<string, unknown>;
+    mnemonic: string;
+    payer?: string;
+    esploraUrl?: string;
+    waterfalls?: boolean;
+    concurrency?: number;
+    utxoOnly?: boolean;
+    scan?: boolean;
+    scanToIndex?: number;
+    feeRate?: number;
+    finalize?: boolean;
+    lwk?: LiquidX402LwkWasmModule;
+    importLwk?: () => Promise<LiquidX402LwkWasmModule>;
+}
+export type LiquidX402PrepareLwkWasmPaymentResult = LiquidX402PreparePsetPaymentResult & {
+    descriptor: string;
+    dwid?: string;
+};
+export interface LiquidX402DeriveLwkWasmAddressInput {
+    mnemonic: string;
+    network?: LiquidX402Network;
+    index?: number;
+    lwk?: LiquidX402LwkWasmModule;
+    importLwk?: () => Promise<LiquidX402LwkWasmModule>;
+}
+export interface LiquidX402DeriveLwkWasmAddressResult {
+    network: LiquidX402Network;
+    address: string;
+    unconfidentialAddress?: string;
+    index: number;
+    isBlinded?: boolean;
+    descriptor: string;
+    dwid?: string;
+    policyAsset?: 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;
+}
+export type DecodePsbtResult = {
+    fees?: Record<string, number>;
+    outputs?: Array<{
+        amount?: number;
+        asset?: string;
+        script?: {
+            address?: string;
+            hex?: string;
+        };
+    }>;
+};
+export type LiquidX402LwkWasmModule = {
+    Address: {
+        new (value: string): any;
+        parse?: (value: string, network: any) => any;
+    };
+    AssetId: {
+        new (value: string): any;
+        fromString?: (value: string) => any;
+    };
+    EsploraClient: new (network: any, url: string, waterfalls: boolean, concurrency: number, utxoOnly: boolean) => any;
+    Mnemonic: new (value: string) => any;
+    Network: {
+        mainnet: () => any;
+        testnet: () => any;
+    };
+    Signer: new (mnemonic: any, network: any) => any;
+    Wollet: new (network: any, descriptor: any) => any;
+};
+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 buildLiquidX402PaymentFromPset(input: LiquidX402BuildPaymentFromPsetInput): LiquidX402PreparePsetPaymentResult;
+export declare function prepareLiquidX402LwkWasmPayment(input: LiquidX402PrepareLwkWasmPaymentInput): Promise<LiquidX402PrepareLwkWasmPaymentResult>;
+export declare function deriveLiquidX402LwkWasmAddress(input: LiquidX402DeriveLwkWasmAddressInput): Promise<LiquidX402DeriveLwkWasmAddressResult>;
+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;

package/dist/x402/index.js

@@ -0,0 +1,559 @@
+"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.buildLiquidX402PaymentFromPset = buildLiquidX402PaymentFromPset;
+exports.prepareLiquidX402LwkWasmPayment = prepareLiquidX402LwkWasmPayment;
+exports.deriveLiquidX402LwkWasmAddress = deriveLiquidX402LwkWasmAddress;
+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";
+const LIQUID_TESTNET_LBTC_ASSET_ID = "144c654344aa716d6f3abcc1ca90e5641e4e2a7f633bc09fe3baf64585819a49";
+const LIQUID_MAINNET_LBTC_ASSET_ID = "6f0279e9ed041c3d710a9f57d0c02928416460c4b722ae3457a11eec381c526d";
+exports.LIQUID_X402_ASSETS = {
+    liquidtestnet: {
+        lbtc: {
+            key: "lbtc",
+            label: "Liquid Bitcoin",
+            network: "liquidtestnet",
+            assetId: LIQUID_TESTNET_LBTC_ASSET_ID,
+            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: LIQUID_MAINNET_LBTC_ASSET_ID,
+            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,
+    };
+}
+function buildLiquidX402PaymentFromPset(input) {
+    const requirements = coerceRequirements(input.requirements);
+    const psetBase64 = String(input.psetBase64 ?? "").trim();
+    if (!psetBase64)
+        throw new Error("psetBase64 is required");
+    const summaryHash = input.summaryHash ?? buildLiquidPsetSummaryHash(input.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,
+        summaryHash,
+        ...(input.payer ? { payer: input.payer } : {}),
+        expiresAt: requirements.extra.expiresAt,
+    };
+    return {
+        paymentPayload,
+        xPayment: encodeLiquidXPayment(paymentPayload),
+        psetBase64,
+        summaryHash,
+    };
+}
+async function prepareLiquidX402LwkWasmPayment(input) {
+    const requirements = coerceRequirements(input.requirements);
+    ensureLwkWasmNodeTimerCompat();
+    const lwk = input.lwk ?? await loadLwkWasm(input.importLwk);
+    const network = requirements.network === "liquidv1" ? lwk.Network.mainnet() : lwk.Network.testnet();
+    const mnemonic = new lwk.Mnemonic(input.mnemonic);
+    const signer = new lwk.Signer(mnemonic, network);
+    const descriptor = signer.wpkhSlip77Descriptor();
+    const wollet = new lwk.Wollet(network, descriptor);
+    const client = input.esploraUrl
+        ? new lwk.EsploraClient(network, input.esploraUrl, input.waterfalls ?? false, input.concurrency ?? 4, input.utxoOnly ?? false)
+        : network.defaultEsploraClient();
+    if (input.scan !== false) {
+        const update = input.scanToIndex !== undefined
+            ? await client.fullScanToIndex(wollet, input.scanToIndex)
+            : await client.fullScan(wollet);
+        if (update)
+            wollet.applyUpdate(update);
+    }
+    let builder = network.txBuilder();
+    if (input.feeRate !== undefined)
+        builder = builder.feeRate(input.feeRate);
+    const recipient = parseLwkAddress(lwk, requirements.payTo, network);
+    const amount = BigInt(requirements.maxAmountRequired);
+    if (requirements.extra.asset === "lbtc") {
+        builder = builder.addLbtcRecipient(recipient, amount);
+    }
+    else {
+        builder = builder.addRecipient(recipient, amount, parseLwkAssetId(lwk, requirements.asset));
+    }
+    const unsigned = builder.finish(wollet);
+    const signed = signer.sign(unsigned);
+    const pset = input.finalize === false ? signed : wollet.finalize(signed);
+    const decoded = decodeLwkPsetForX402(pset, wollet);
+    const payment = buildLiquidX402PaymentFromPset({
+        requirements,
+        psetBase64: pset.toString(),
+        decoded,
+        payer: input.payer,
+    });
+    return {
+        ...payment,
+        descriptor: descriptor.toString(),
+        ...(typeof wollet.dwid === "function" ? { dwid: wollet.dwid() } : {}),
+    };
+}
+async function deriveLiquidX402LwkWasmAddress(input) {
+    const networkKey = normalizeNetwork(input.network ?? exports.LIQUID_X402_DEFAULT_NETWORK);
+    ensureLwkWasmNodeTimerCompat();
+    const lwk = input.lwk ?? await loadLwkWasm(input.importLwk);
+    const network = networkKey === "liquidv1" ? lwk.Network.mainnet() : lwk.Network.testnet();
+    const mnemonic = new lwk.Mnemonic(input.mnemonic);
+    const signer = new lwk.Signer(mnemonic, network);
+    const descriptor = signer.wpkhSlip77Descriptor();
+    const wollet = new lwk.Wollet(network, descriptor);
+    const addressResult = wollet.address(input.index ?? null);
+    const address = addressResult.address();
+    return {
+        network: networkKey,
+        address: address.toString(),
+        ...(typeof address.toUnconfidential === "function" ? { unconfidentialAddress: address.toUnconfidential().toString() } : {}),
+        index: typeof addressResult.index === "function" ? addressResult.index() : input.index ?? 0,
+        ...(typeof address.isBlinded === "function" ? { isBlinded: address.isBlinded() } : {}),
+        descriptor: descriptor.toString(),
+        ...(typeof wollet.dwid === "function" ? { dwid: wollet.dwid() } : {}),
+        ...(typeof network.policyAsset === "function" ? { policyAsset: network.policyAsset().toString() } : {}),
+    };
+}
+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,
+        expectedOutput: {
+            amountAtomic: req.maxAmountRequired,
+            assetId: req.asset,
+            payTo: req.payTo,
+        },
+        feeAsset: req.extra.feeAsset,
+        feeAssetId: req.extra.feeAssetId ?? exports.LIQUID_X402_ASSETS[req.network].lbtc.assetId,
+        maxFeeSat: req.extra.maxFeeSat ?? null,
+    }));
+}
+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 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);
+    const rawAssetId = String(raw.asset ?? extra.assetId ?? asset.assetId);
+    const assetId = isLiquidAssetAlias(rawAssetId) ? asset.assetId : rawAssetId;
+    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: assetId,
+        extra: {
+            paymentRequestId: String(extra.paymentRequestId ?? raw.paymentRequestId ?? ""),
+            asset: asset.key,
+            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;
+}
+async function loadLwkWasm(importer) {
+    ensureLwkWasmNodeTimerCompat();
+    if (importer)
+        return importer();
+    const dynamicImport = new Function("specifier", "return import(specifier)");
+    const failures = [];
+    for (const specifier of ["lwk_wasm", "lwk_node"]) {
+        try {
+            const imported = await dynamicImport(specifier);
+            return imported.default ?? imported;
+        }
+        catch (error) {
+            failures.push(`${specifier}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    throw new Error("lwk_wasm or lwk_node is required for lightweight Liquid x402 payments. " +
+        "Install one of them in the consuming app and bundle its WASM artifact when needed. " +
+        `Import failed: ${failures.join("; ")}`);
+}
+function ensureLwkWasmNodeTimerCompat() {
+    const scope = globalThis;
+    if (typeof scope.window === "undefined" && typeof scope.setTimeout === "function") {
+        scope.window = scope;
+    }
+    if (typeof scope.Window === "undefined" && typeof scope.window !== "undefined") {
+        scope.Window = Object;
+    }
+}
+function parseLwkAddress(lwk, address, network) {
+    return typeof lwk.Address.parse === "function" ? lwk.Address.parse(address, network) : new lwk.Address(address);
+}
+function parseLwkAssetId(lwk, assetId) {
+    return typeof lwk.AssetId.fromString === "function" ? lwk.AssetId.fromString(assetId) : new lwk.AssetId(assetId);
+}
+function decodeLwkPsetForX402(pset, wollet) {
+    const details = wollet.psetDetails(pset);
+    const balance = details.balance();
+    const recipients = typeof balance.recipients === "function" ? balance.recipients() : [];
+    const fee = typeof balance.fee === "function" ? balance.fee() : 0n;
+    return {
+        fees: { bitcoin: atomicToDecimalNumber(String(fee), 8) },
+        outputs: recipients.map((recipient) => ({
+            amount: recipient.value() === undefined ? undefined : atomicToDecimalNumber(String(recipient.value()), 8),
+            asset: recipient.asset()?.toString(),
+            script: {
+                address: recipient.address()?.toString(),
+            },
+        })),
+    };
+}
+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" || value === LIQUID_TESTNET_LBTC_ASSET_ID || value === LIQUID_MAINNET_LBTC_ASSET_ID) {
+        return "lbtc";
+    }
+    if (value === "usdt" ||
+        value === "usdt-liquid" ||
+        value === "tether" ||
+        value === LIQUID_TESTNET_USDT_ASSET_ID ||
+        value === LIQUID_MAINNET_USDT_ASSET_ID) {
+        return "usdt";
+    }
+    throw new Error(`unsupported Liquid x402 asset: ${String(input)}`);
+}
+function isLiquidAssetAlias(input) {
+    const value = String(input ?? "").trim().toLowerCase();
+    return value === "lbtc" ||
+        value === "bitcoin" ||
+        value === "usdt" ||
+        value === "usdt-liquid" ||
+        value === "tether";
+}
+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.1",
+  "version": "0.3.1",
   "description": "An SDK for Simplicity on Liquid",
   "author": "IndieSquare Inc <info@hazbase.com>",
   "keywords": [
@@ -50,6 +50,8 @@
     "e2e:receivable-local": "npm run build && node scripts/e2e-receivable-local.mjs",
     "e2e:receivable-testnet": "npm run build && node scripts/e2e-receivable-testnet.mjs",
     "e2e:receivable-consumer": "npm run build && node scripts/e2e-receivable-consumer.mjs",
+    "e2e:x402-lwk-address": "npm run build && node scripts/e2e-x402-lwk-address.mjs",
+    "e2e:x402-lwk-buyer": "npm run build && node scripts/e2e-x402-lwk-buyer.mjs",
     "e2e:simplicity-relayer": "npm run build && node scripts/e2e-simplicity-relayer.mjs",
     "prepublishOnly": "npm run build"
   },