@x402api/agent-wallet-core 0.1.0

package/dist/payment/authorize.js

@@ -0,0 +1,386 @@
+import { resolve } from "node:path";
+import { Wallet, } from "ethers";
+import { TronWeb } from "tronweb";
+import nacl from "tweetnacl";
+import { jsonRpc, readWalletBalance, SOLANA_MAINNET_GENESIS_HASH, validateRpcUrl, } from "../balances.js";
+import { AgentWalletError } from "../errors.js";
+import { BASE_MAINNET_NETWORK, BASE_USDC_BUYER_FUNDED_PROFILE, BASE_USDC_MAINNET_CONTRACT, buildBaseUsdcAuthorization, buildBaseUsdcEip1559TransactionRequest, encodeBaseUsdcTransferWithAuthorization, verifyBuyerSignedBaseUsdcTransaction, } from "../protocol/base.js";
+import { verifyExternalRecipientDeclaration } from "../protocol/external-recipient.js";
+import { createPaymentPayload, encodePaymentSignature, } from "../protocol/http.js";
+import { createSolanaPayment, SOLANA_MAINNET_NETWORK, SOLANA_USDT_BUYER_FUNDED_PROFILE, SOLANA_USDT_MAINNET_MINT, } from "../protocol/solana.js";
+import { createTronUsdtPayment, TRON_MAINNET_CHAIN_ID, TRON_USDT_MAINNET_CONTRACT, TronWebTransactionBuilder, } from "../protocol/tron.js";
+import { unlockWallet } from "../storage/keystore.js";
+import { AttemptStore } from "./attempt-store.js";
+import { createBuyerPaymentIdentifier, loadRequestEnvelope, requirementDigest, } from "./contracts.js";
+function payloadProfile(requirement) {
+    const value = requirement.extra.payloadProfile;
+    return typeof value === "string" ? value : null;
+}
+function selectRequirement(paymentRequired, wallet) {
+    const networkMatches = paymentRequired.accepts.filter((requirement) => requirement.network === wallet.network);
+    if (networkMatches.length === 0) {
+        throw new AgentWalletError("unsupported_network", "challenge does not advertise the wallet network");
+    }
+    const expected = wallet.network === BASE_MAINNET_NETWORK
+        ? {
+            asset: BASE_USDC_MAINNET_CONTRACT.toLowerCase(),
+            profile: BASE_USDC_BUYER_FUNDED_PROFILE,
+        }
+        : wallet.network === SOLANA_MAINNET_NETWORK
+            ? {
+                asset: SOLANA_USDT_MAINNET_MINT,
+                profile: SOLANA_USDT_BUYER_FUNDED_PROFILE,
+            }
+            : {
+                asset: TRON_USDT_MAINNET_CONTRACT,
+                profile: "com.k1hub.x402.tron-exact.v1",
+            };
+    const assetMatches = networkMatches.filter((requirement) => wallet.network === BASE_MAINNET_NETWORK
+        ? requirement.asset.toLowerCase() === expected.asset
+        : requirement.asset === expected.asset);
+    if (assetMatches.length === 0) {
+        throw new AgentWalletError("unsupported_asset", "challenge does not advertise the exact supported asset");
+    }
+    const profileMatches = assetMatches.filter((requirement) => payloadProfile(requirement) === expected.profile);
+    if (profileMatches.length !== 1) {
+        throw new AgentWalletError("unsupported_profile", "challenge must advertise exactly one supported payload profile");
+    }
+    return profileMatches[0];
+}
+function enforceLocalPolicy(wallet, amount) {
+    if (wallet.maximumPaymentAtomic !== undefined &&
+        BigInt(amount) > BigInt(wallet.maximumPaymentAtomic)) {
+        throw new AgentWalletError("payment_limit_exceeded", "payment amount exceeds the wallet's local per-payment ceiling", {
+            details: {
+                amountAtomic: amount,
+                maximumPaymentAtomic: wallet.maximumPaymentAtomic,
+            },
+        });
+    }
+}
+async function enforceBalances(options) {
+    const balance = await readWalletBalance({
+        network: options.wallet.network,
+        address: options.wallet.address,
+        rpc: options.rpc,
+    });
+    if (BigInt(balance.assetAtomic) < BigInt(options.amount)) {
+        throw new AgentWalletError("insufficient_asset_balance", `${balance.assetSymbol} balance is below the exact payment amount`, {
+            details: {
+                requiredAtomic: options.amount,
+                availableAtomic: balance.assetAtomic,
+            },
+        });
+    }
+    if (BigInt(balance.nativeAtomic) === 0n &&
+        (balance.network !== "tron:mainnet" ||
+            BigInt(balance.feeResources?.energyAvailable ?? "0") === 0n)) {
+        throw new AgentWalletError("insufficient_network_fee_resources", `${balance.nativeSymbol} or network fee resources are required`);
+    }
+}
+function typedDataParts(value) {
+    const domain = value.domain;
+    const types = value.types;
+    const message = value.message;
+    if (typeof domain !== "object" ||
+        domain === null ||
+        Array.isArray(domain) ||
+        typeof types !== "object" ||
+        types === null ||
+        Array.isArray(types) ||
+        typeof message !== "object" ||
+        message === null ||
+        Array.isArray(message)) {
+        throw new AgentWalletError("request_binding_mismatch", "Base typed data is malformed");
+    }
+    const transfer = types.TransferWithAuthorization;
+    if (!Array.isArray(transfer)) {
+        throw new AgentWalletError("request_binding_mismatch", "Base typed data types are malformed");
+    }
+    return {
+        domain: domain,
+        types: {
+            TransferWithAuthorization: transfer,
+        },
+        message: message,
+    };
+}
+function requestFromJson(value) {
+    const required = [
+        "chainId",
+        "nonce",
+        "gas",
+        "maxFeePerGas",
+        "maxPriorityFeePerGas",
+        "to",
+        "value",
+        "data",
+    ];
+    if (required.some((key) => typeof value[key] !== "string")) {
+        throw new AgentWalletError("request_binding_mismatch", "Base transaction request is malformed");
+    }
+    return {
+        type: 2,
+        chainId: BigInt(value.chainId),
+        nonce: Number(BigInt(value.nonce)),
+        gasLimit: BigInt(value.gas),
+        maxFeePerGas: BigInt(value.maxFeePerGas),
+        maxPriorityFeePerGas: BigInt(value.maxPriorityFeePerGas),
+        to: value.to,
+        value: BigInt(value.value),
+        data: value.data,
+        accessList: [],
+    };
+}
+async function basePayment(options) {
+    if (!options.wallet.secret.privateKeyHex) {
+        throw new AgentWalletError("wallet_locked", "Base private key is unavailable");
+    }
+    const endpoint = validateRpcUrl(options.rpc, "Base");
+    const chainId = await jsonRpc(endpoint, "eth_chainId", []);
+    if (chainId !== "0x2105") {
+        throw new AgentWalletError("unsupported_network", "Base RPC is not chain ID 8453");
+    }
+    await verifyExternalRecipientDeclaration({
+        paymentRequired: options.paymentRequired,
+        accepted: options.accepted,
+    });
+    const signer = new Wallet(`0x${options.wallet.secret.privateKeyHex}`);
+    const material = buildBaseUsdcAuthorization({
+        accepted: options.accepted,
+        payer: signer.address,
+        nowSeconds: Math.floor(Date.now() / 1000),
+        challengeDigest: options.challengeDigest,
+    });
+    const typed = typedDataParts(material.typedData);
+    const authorizationSignature = await signer.signTypedData(typed.domain, typed.types, typed.message);
+    const data = encodeBaseUsdcTransferWithAuthorization({
+        authorization: material.authorization,
+        signature: authorizationSignature,
+    });
+    const [nonceRaw, blockRaw, priorityRaw] = await Promise.all([
+        jsonRpc(endpoint, "eth_getTransactionCount", [signer.address, "pending"]),
+        jsonRpc(endpoint, "eth_getBlockByNumber", ["latest", false]),
+        jsonRpc(endpoint, "eth_maxPriorityFeePerGas", []),
+    ]);
+    if (typeof nonceRaw !== "string" ||
+        typeof priorityRaw !== "string" ||
+        typeof blockRaw !== "object" ||
+        blockRaw === null ||
+        !("baseFeePerGas" in blockRaw) ||
+        typeof blockRaw.baseFeePerGas !== "string") {
+        throw new AgentWalletError("rpc_unavailable", "Base fee policy is unavailable");
+    }
+    const priority = BigInt(priorityRaw);
+    const maxFee = BigInt(blockRaw.baseFeePerGas) * 2n + priority;
+    const provisional = buildBaseUsdcEip1559TransactionRequest({
+        accepted: options.accepted,
+        payer: signer.address,
+        data,
+        policy: {
+            nonce: BigInt(nonceRaw),
+            gasLimit: 150000n,
+            maxFeePerGas: maxFee,
+            maxPriorityFeePerGas: priority,
+        },
+    });
+    const estimatedRaw = await jsonRpc(endpoint, "eth_estimateGas", [provisional]);
+    if (typeof estimatedRaw !== "string") {
+        throw new AgentWalletError("rpc_unavailable", "Base gas estimate is unavailable");
+    }
+    const estimated = BigInt(estimatedRaw);
+    const gasLimit = (estimated * 120n + 99n) / 100n;
+    const request = buildBaseUsdcEip1559TransactionRequest({
+        accepted: options.accepted,
+        payer: signer.address,
+        data,
+        policy: {
+            nonce: BigInt(nonceRaw),
+            gasLimit,
+            maxFeePerGas: maxFee,
+            maxPriorityFeePerGas: priority,
+        },
+    });
+    const signedTransaction = await signer.signTransaction(requestFromJson(request));
+    verifyBuyerSignedBaseUsdcTransaction({ signedTransaction, request });
+    return encodePaymentSignature(createPaymentPayload({
+        paymentRequired: options.paymentRequired,
+        accepted: options.accepted,
+        paymentIdentifier: options.buyerPaymentIdentifier,
+        schemePayload: { transaction: signedTransaction },
+    }));
+}
+async function solanaPayment(options) {
+    if (!options.wallet.secret.seedBase64) {
+        throw new AgentWalletError("wallet_locked", "Solana seed is unavailable");
+    }
+    const endpoint = validateRpcUrl(options.rpc, "Solana");
+    const genesis = await jsonRpc(endpoint, "getGenesisHash", []);
+    if (genesis !== SOLANA_MAINNET_GENESIS_HASH) {
+        throw new AgentWalletError("unsupported_network", "Solana RPC is not Mainnet Beta");
+    }
+    const seed = Buffer.from(options.wallet.secret.seedBase64, "base64");
+    const keyPair = nacl.sign.keyPair.fromSeed(seed);
+    const rpc = {
+        latestBlockhash: async () => {
+            const result = await jsonRpc(endpoint, "getLatestBlockhash", [
+                { commitment: "confirmed" },
+            ]);
+            const blockhash = typeof result === "object" &&
+                result !== null &&
+                "value" in result &&
+                typeof result.value === "object" &&
+                result.value !== null &&
+                "blockhash" in result.value
+                ? result.value.blockhash
+                : null;
+            if (typeof blockhash !== "string") {
+                throw new AgentWalletError("rpc_unavailable", "Solana blockhash is unavailable");
+            }
+            return blockhash;
+        },
+    };
+    const transport = {
+        connect: async () => options.wallet.metadata.address,
+        signTransaction: async ({ transactionBase64 }) => {
+            const transaction = Buffer.from(transactionBase64, "base64");
+            if (transaction[0] !== 1 || transaction.length < 66) {
+                throw new AgentWalletError("request_binding_mismatch", "Solana transaction is malformed");
+            }
+            const message = transaction.subarray(65);
+            const signature = nacl.sign.detached(message, keyPair.secretKey);
+            const signed = Buffer.from(transaction);
+            signed.set(signature, 1);
+            return signed.toString("base64");
+        },
+    };
+    return encodePaymentSignature(await createSolanaPayment({
+        rpc,
+        wallet: transport,
+        paymentRequired: options.paymentRequired,
+        accepted: options.accepted,
+        buyerPaymentIdentifier: options.buyerPaymentIdentifier,
+    }));
+}
+async function tronPayment(options) {
+    if (!options.wallet.secret.privateKeyHex) {
+        throw new AgentWalletError("wallet_locked", "TRON private key is unavailable");
+    }
+    const endpoint = validateRpcUrl(options.rpc, "TRON");
+    const tronWeb = new TronWeb({
+        fullHost: endpoint,
+        privateKey: options.wallet.secret.privateKeyHex,
+    });
+    const provider = {
+        requestAccounts: async () => [options.wallet.metadata.address],
+        getNetwork: async () => ({ networkType: "Mainnet", chainId: TRON_MAINNET_CHAIN_ID }),
+        signTransaction: async (transaction) => {
+            if (!transaction.walletDocument) {
+                throw new AgentWalletError("request_binding_mismatch", "TRON wallet document is missing");
+            }
+            const signed = (await tronWeb.trx.sign(transaction.walletDocument, options.wallet.secret.privateKeyHex));
+            const result = {
+                txID: String(signed.txID),
+                raw_data_hex: String(signed.raw_data_hex),
+                walletDocument: signed,
+            };
+            if (Array.isArray(signed.signature)) {
+                result.signature = signed.signature.map((value) => String(value));
+            }
+            return result;
+        },
+        disconnect: async () => undefined,
+    };
+    const builder = new TronWebTransactionBuilder({
+        tronWeb: tronWeb,
+        feeLimitSun: 150_000_000,
+    });
+    return encodePaymentSignature(await createTronUsdtPayment({
+        builder,
+        provider,
+        paymentRequired: options.paymentRequired,
+        accepted: options.accepted,
+        buyerPaymentIdentifier: options.buyerPaymentIdentifier,
+        trustedAssetContracts: [TRON_USDT_MAINNET_CONTRACT],
+        maxFeeLimitSun: 150_000_000,
+    }));
+}
+export async function authorizePayment(options) {
+    const unlocked = await unlockWallet(options.walletsDirectory, options.wallet, options.passphrase);
+    const loaded = await loadRequestEnvelope(options.requestEnvelopePath);
+    const accepted = selectRequirement(loaded.paymentRequired, unlocked.metadata);
+    enforceLocalPolicy(unlocked.metadata, accepted.amount);
+    const store = new AttemptStore(options.attemptsDirectory);
+    const existing = await store.findByRequestDigest(loaded.requestDigest);
+    if (existing !== null && !["terminal_failed", "abandoned_local"].includes(existing.state)) {
+        throw new AgentWalletError("attempt_already_exists", "reuse the existing payment attempt for this exact request", { details: { attemptId: existing.attemptId, state: existing.state } });
+    }
+    await enforceBalances({
+        wallet: unlocked.metadata,
+        amount: accepted.amount,
+        rpc: options.rpc,
+    });
+    const buyerPaymentIdentifier = createBuyerPaymentIdentifier();
+    let paymentSignature;
+    if (unlocked.metadata.network === BASE_MAINNET_NETWORK) {
+        if (!options.rpc.base)
+            throw new AgentWalletError("rpc_not_configured", "Base RPC is required");
+        paymentSignature = await basePayment({
+            wallet: unlocked,
+            paymentRequired: loaded.paymentRequired,
+            accepted,
+            challengeDigest: loaded.envelope.challengeDigest,
+            buyerPaymentIdentifier,
+            rpc: options.rpc.base,
+        });
+    }
+    else if (unlocked.metadata.network === SOLANA_MAINNET_NETWORK) {
+        if (!options.rpc.solana) {
+            throw new AgentWalletError("rpc_not_configured", "Solana RPC is required");
+        }
+        paymentSignature = await solanaPayment({
+            wallet: unlocked,
+            paymentRequired: loaded.paymentRequired,
+            accepted,
+            buyerPaymentIdentifier,
+            rpc: options.rpc.solana,
+        });
+    }
+    else {
+        if (!options.rpc.tron)
+            throw new AgentWalletError("rpc_not_configured", "TRON RPC is required");
+        paymentSignature = await tronPayment({
+            wallet: unlocked,
+            paymentRequired: loaded.paymentRequired,
+            accepted,
+            buyerPaymentIdentifier,
+            rpc: options.rpc.tron,
+        });
+    }
+    const selectedRequirementDigest = requirementDigest(accepted);
+    const expiresAt = new Date(Date.now() + Math.min(accepted.maxTimeoutSeconds, 3600) * 1000).toISOString();
+    const { record } = await store.persistAuthorized({
+        requestDigest: loaded.requestDigest,
+        challengeDigest: loaded.envelope.challengeDigest,
+        selectedRequirementDigest,
+        buyerPaymentIdentifier,
+        wallet: unlocked.metadata.name,
+        network: unlocked.metadata.network,
+        payerAddress: unlocked.metadata.address,
+        paymentSignature,
+        artifactPath: resolve(options.artifactPath),
+        expiresAt,
+    });
+    return {
+        version: 1,
+        attemptId: record.attemptId,
+        wallet: unlocked.metadata.name,
+        payerAddress: unlocked.metadata.address,
+        network: unlocked.metadata.network,
+        asset: accepted.asset,
+        amountAtomic: accepted.amount,
+        artifactPath: record.artifactPath,
+        state: "authorized",
+    };
+}
+//# sourceMappingURL=authorize.js.map

package/dist/payment/authorize.js.map

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

package/dist/payment/contracts.d.ts

@@ -0,0 +1,36 @@
+import { type JsonObject, type PaymentRequired, type PaymentRequirement } from "../protocol/http.js";
+export type RequestEnvelope = {
+    version: 1;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    url: string;
+    contentType: string;
+    bodyBase64: string;
+    paymentRequired: string;
+    challengeDigest: string;
+    merchantReference?: string;
+};
+export type PaymentArtifact = {
+    version: 1;
+    attemptId: string;
+    requestDigest: string;
+    buyerPaymentIdentifier: string;
+    wallet: string;
+    payerAddress: string;
+    selectedRequirementDigest: string;
+    paymentSignature: string;
+    createdAt: string;
+    expiresAt: string;
+};
+export declare function normalizeRequestUrl(value: string): string;
+export declare function parseRequestEnvelope(value: unknown): {
+    envelope: RequestEnvelope;
+    paymentRequired: PaymentRequired;
+    body: Uint8Array;
+    requestDigest: string;
+};
+export declare function loadRequestEnvelope(path: string): Promise<ReturnType<typeof parseRequestEnvelope>>;
+export declare function digestBytes(value: Uint8Array | string): string;
+export declare function digestJson(value: JsonObject): string;
+export declare function requirementDigest(requirement: PaymentRequirement): string;
+export declare function createBuyerPaymentIdentifier(): string;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/payment/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/payment/contracts.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB,EAAE,MAAM,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAqBF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBzD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IACpD,QAAQ,EAAE,eAAe,CAAC;IAC1B,eAAe,EAAE,eAAe,CAAC;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CA4EA;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAoBxG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,CAEzE;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}

package/dist/payment/contracts.js

@@ -0,0 +1,132 @@
+import { createHash, randomBytes } from "node:crypto";
+import { lstat, readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { AgentWalletError } from "../errors.js";
+import { canonicalJson, decodePaymentRequiredHeader, } from "../protocol/http.js";
+const METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE"]);
+const SHA256 = /^sha256:[0-9a-f]{64}$/;
+const CONTENT_TYPE = /^[\x21-\x7e]{1,256}$/;
+function exactObject(value, keys, label) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new AgentWalletError("invalid_input", `${label} is not an object`);
+    }
+    const object = value;
+    if (Object.keys(object).some((key) => !keys.includes(key))) {
+        throw new AgentWalletError("invalid_input", `${label} has unknown fields`);
+    }
+    return object;
+}
+export function normalizeRequestUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch (error) {
+        throw new AgentWalletError("invalid_input", "request URL is invalid", {
+            cause: error,
+        });
+    }
+    if (url.protocol !== "https:" ||
+        url.username ||
+        url.password ||
+        url.hash ||
+        value !== url.toString()) {
+        throw new AgentWalletError("invalid_input", "request URL must be a normalized credential-free HTTPS URL");
+    }
+    return url.toString();
+}
+export function parseRequestEnvelope(value) {
+    const object = exactObject(value, [
+        "version",
+        "method",
+        "url",
+        "contentType",
+        "bodyBase64",
+        "paymentRequired",
+        "challengeDigest",
+        "merchantReference",
+    ], "request envelope");
+    if (object.version !== 1 ||
+        typeof object.method !== "string" ||
+        !METHODS.has(object.method) ||
+        typeof object.url !== "string" ||
+        typeof object.contentType !== "string" ||
+        !CONTENT_TYPE.test(object.contentType) ||
+        typeof object.bodyBase64 !== "string" ||
+        typeof object.paymentRequired !== "string" ||
+        typeof object.challengeDigest !== "string" ||
+        !SHA256.test(object.challengeDigest) ||
+        (object.merchantReference !== undefined &&
+            (typeof object.merchantReference !== "string" ||
+                object.merchantReference.length > 256))) {
+        throw new AgentWalletError("invalid_input", "request envelope is malformed");
+    }
+    const body = Buffer.from(object.bodyBase64, "base64");
+    if (body.length > 2 * 1024 * 1024 ||
+        body.toString("base64") !== object.bodyBase64) {
+        throw new AgentWalletError("invalid_input", "request body is not bounded canonical base64");
+    }
+    const envelope = {
+        version: 1,
+        method: object.method,
+        url: normalizeRequestUrl(object.url),
+        contentType: object.contentType,
+        bodyBase64: object.bodyBase64,
+        paymentRequired: object.paymentRequired,
+        challengeDigest: object.challengeDigest,
+        ...(object.merchantReference === undefined
+            ? {}
+            : { merchantReference: object.merchantReference }),
+    };
+    let paymentRequired;
+    try {
+        paymentRequired = decodePaymentRequiredHeader(envelope.paymentRequired);
+    }
+    catch (error) {
+        throw new AgentWalletError("request_binding_mismatch", "PAYMENT-REQUIRED could not be decoded strictly", { cause: error });
+    }
+    if (normalizeRequestUrl(paymentRequired.resource.url) !== envelope.url) {
+        throw new AgentWalletError("request_binding_mismatch", "PAYMENT-REQUIRED resource does not match the exact request URL");
+    }
+    return {
+        envelope,
+        paymentRequired,
+        body,
+        requestDigest: digestJson(envelope),
+    };
+}
+export async function loadRequestEnvelope(path) {
+    const absolute = resolve(path);
+    const stat = await lstat(absolute).catch((error) => {
+        if (error.code === "ENOENT") {
+            throw new AgentWalletError("invalid_input", `request envelope not found: ${absolute}`);
+        }
+        throw error;
+    });
+    if (!stat.isFile() || stat.isSymbolicLink() || stat.size < 2 || stat.size > 3 * 1024 * 1024) {
+        throw new AgentWalletError("invalid_input", "request envelope file is unsafe or too large");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(absolute, "utf8"));
+    }
+    catch (error) {
+        throw new AgentWalletError("invalid_input", "request envelope is not JSON", {
+            cause: error,
+        });
+    }
+    return parseRequestEnvelope(parsed);
+}
+export function digestBytes(value) {
+    return `sha256:${createHash("sha256").update(value).digest("hex")}`;
+}
+export function digestJson(value) {
+    return digestBytes(canonicalJson(value));
+}
+export function requirementDigest(requirement) {
+    return digestJson(requirement);
+}
+export function createBuyerPaymentIdentifier() {
+    return randomBytes(24).toString("base64url");
+}
+//# sourceMappingURL=contracts.js.map

package/dist/payment/contracts.js.map

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