@x402api/agent-wallet-core 0.1.0

package/dist/protocol/base.d.ts

@@ -0,0 +1,78 @@
+import { type JsonObject, type PaymentPayload, type PaymentRequired, type PaymentRequirement } from "./http.js";
+export interface Eip1193Provider {
+    request(args: {
+        method: string;
+        params?: readonly unknown[] | Record<string, unknown>;
+    }): Promise<unknown>;
+}
+export type Eip3009Authorization = {
+    from: string;
+    to: string;
+    value: string;
+    validAfter: string;
+    validBefore: string;
+    nonce: string;
+};
+export declare const BASE_MAINNET_NETWORK = "eip155:8453";
+export declare const BASE_MAINNET_CHAIN_ID = 8453;
+export declare const BASE_USDC_MAINNET_CONTRACT = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+export declare const BASE_USDC_BUYER_FUNDED_PROFILE = "com.k1hub.x402.base-usdc-eip3009-buyer-funded.v1";
+export type BaseEip1559TransactionPolicy = {
+    nonce: bigint;
+    gasLimit: bigint;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+};
+export type BaseTransactionTransport = "eip1193_broadcast" | "signed_raw";
+export type BaseUsdcAuthorizationMaterial = {
+    authorization: Eip3009Authorization;
+    typedData: JsonObject;
+};
+export declare function buildBaseUsdcAuthorization(options: {
+    accepted: PaymentRequirement;
+    payer: string;
+    nowSeconds: number;
+    challengeDigest: string;
+}): BaseUsdcAuthorizationMaterial;
+export declare function encodeBaseUsdcTransferWithAuthorization(options: {
+    authorization: Eip3009Authorization;
+    signature: string;
+}): string;
+export declare function buildBaseUsdcEip1559TransactionRequest(options: {
+    accepted: PaymentRequirement;
+    payer: string;
+    data: string;
+    policy: BaseEip1559TransactionPolicy;
+}): JsonObject;
+/**
+ * Decode and compare every frozen EIP-1559 field returned by the wallet.
+ *
+ * Sender recovery and EIP-3009 signature recovery are repeated by K1Hub's
+ * backend before reservation. This browser-side check prevents a wallet from
+ * silently changing chain, nonce, fees, destination, value, calldata, or
+ * access list.
+ */
+export declare function verifyBuyerSignedBaseUsdcTransaction(options: {
+    signedTransaction: string;
+    request: JsonObject;
+}): void;
+/**
+ * Construct the exact external-wallet V1 Base USDC x402 payload.
+ *
+ * The default path asks the buyer's ordinary EIP-1193 wallet to broadcast the
+ * exact EIP-1559 request. K1Hub receives only its hash plus the frozen
+ * authorization/request and independently verifies the transaction through
+ * its RPC quorum. Wallets that support `eth_signTransaction` may opt into raw
+ * transport; K1Hub relays those already-signed bytes without signing or gas.
+ */
+export declare function createBaseUsdcPayment(options: {
+    provider: Eip1193Provider;
+    paymentRequired: PaymentRequired;
+    accepted: PaymentRequirement;
+    buyerPaymentIdentifier: string;
+    challengeDigest: string;
+    transactionPolicy: BaseEip1559TransactionPolicy;
+    transactionTransport?: BaseTransactionTransport;
+    nowSeconds?: number;
+}): Promise<PaymentPayload>;
+//# sourceMappingURL=base.d.ts.map

package/dist/protocol/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/protocol/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAInB,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,IAAI,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvD,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAClD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,0BAA0B,+CACO,CAAC;AAC/C,eAAO,MAAM,8BAA8B,qDACS,CAAC;AAgBrD,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,GAAG,YAAY,CAAC;AAE1E,MAAM,MAAM,6BAA6B,GAAG;IAC1C,aAAa,EAAE,oBAAoB,CAAC;IACpC,SAAS,EAAE,UAAU,CAAC;CACvB,CAAC;AA0FF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,6BAA6B,CAmDhC;AAED,wBAAgB,uCAAuC,CAAC,OAAO,EAAE;IAC/D,aAAa,EAAE,oBAAoB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAkCT;AAED,wBAAgB,sCAAsC,CAAC,OAAO,EAAE;IAC9D,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,4BAA4B,CAAC;CACtC,GAAG,UAAU,CAqCb;AAuHD;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE;IAC5D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,UAAU,CAAC;CACrB,GAAG,IAAI,CAmEP;AAeD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,QAAQ,EAAE,eAAe,CAAC;IAC1B,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,4BAA4B,CAAC;IAChD,oBAAoB,CAAC,EAAE,wBAAwB,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyF1B"}

package/dist/protocol/base.js

@@ -0,0 +1,459 @@
+import { createPaymentPayload, } from "./http.js";
+import { verifyExternalRecipientDeclaration } from "./external-recipient.js";
+export const BASE_MAINNET_NETWORK = "eip155:8453";
+export const BASE_MAINNET_CHAIN_ID = 8453;
+export const BASE_USDC_MAINNET_CONTRACT = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+export const BASE_USDC_BUYER_FUNDED_PROFILE = "com.k1hub.x402.base-usdc-eip3009-buyer-funded.v1";
+const BASE_CHAIN_ID_HEX = "0x2105";
+const BASE_MAX_AUTHORIZATION_SECONDS = 300;
+const BASE_MAX_GAS_LIMIT = 200000n;
+const ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+const DECIMAL = /^(?:0|[1-9][0-9]{0,77})$/;
+const DIGEST = /^sha256:([0-9a-f]{64})$/;
+const SIGNATURE = /^0x[0-9a-fA-F]{130}$/;
+const SIGNED_TYPE_2_TRANSACTION = /^0x02[0-9a-f]+$/;
+const SECP256K1_ORDER = 0xfffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141n;
+const SECP256K1_HALF_ORDER = SECP256K1_ORDER / 2n;
+const UINT256_MAX = (1n << 256n) - 1n;
+const TRANSFER_WITH_AUTHORIZATION_SELECTOR = "e3ee160e";
+function validateBaseRequirement(accepted) {
+    const extra = accepted.extra;
+    if (accepted.scheme !== "exact" ||
+        accepted.network !== BASE_MAINNET_NETWORK ||
+        accepted.asset.toLowerCase() !== BASE_USDC_MAINNET_CONTRACT.toLowerCase() ||
+        !ADDRESS.test(accepted.asset) ||
+        !ADDRESS.test(accepted.payTo) ||
+        !DECIMAL.test(accepted.amount) ||
+        accepted.amount === "0" ||
+        !Number.isSafeInteger(accepted.maxTimeoutSeconds) ||
+        accepted.maxTimeoutSeconds < 1 ||
+        typeof extra !== "object" ||
+        extra === null ||
+        Object.keys(extra).sort().join(",") !==
+            "assetTransferMethod,name,payloadProfile,version" ||
+        extra.assetTransferMethod !== "eip3009" ||
+        extra.name !== "USD Coin" ||
+        extra.version !== "2" ||
+        extra.payloadProfile !== BASE_USDC_BUYER_FUNDED_PROFILE) {
+        throw new Error("requirement is not buyer-funded issuer-native Base USDC EIP-3009");
+    }
+}
+function decimalUint256(value, field) {
+    if (!DECIMAL.test(value))
+        throw new Error(`${field} is not canonical decimal`);
+    const result = BigInt(value);
+    if (result > UINT256_MAX)
+        throw new Error(`${field} exceeds uint256`);
+    return result;
+}
+function boundedUint256(value, field) {
+    if (typeof value !== "bigint" || value < 0n || value > UINT256_MAX) {
+        throw new Error(`${field} is outside uint256`);
+    }
+    return value;
+}
+function hexQuantity(value) {
+    return `0x${value.toString(16)}`;
+}
+function word(value) {
+    return boundedUint256(value, "ABI integer").toString(16).padStart(64, "0");
+}
+function addressWord(value) {
+    if (!ADDRESS.test(value))
+        throw new Error("ABI address is malformed");
+    return value.slice(2).toLowerCase().padStart(64, "0");
+}
+function signatureParts(signature) {
+    if (!SIGNATURE.test(signature)) {
+        throw new Error("wallet returned an invalid EIP-3009 signature");
+    }
+    const rHex = signature.slice(2, 66).toLowerCase();
+    const sHex = signature.slice(66, 130).toLowerCase();
+    const rawRecoveryId = Number.parseInt(signature.slice(130, 132), 16);
+    const recoveryId = rawRecoveryId === 0 || rawRecoveryId === 1
+        ? rawRecoveryId + 27
+        : rawRecoveryId;
+    const r = BigInt(`0x${rHex}`);
+    const s = BigInt(`0x${sHex}`);
+    if (![27, 28].includes(recoveryId) ||
+        r < 1n ||
+        r >= SECP256K1_ORDER ||
+        s < 1n ||
+        s > SECP256K1_HALF_ORDER) {
+        throw new Error("EIP-3009 signature is not canonical low-s secp256k1");
+    }
+    return { recoveryId, r, s, rHex, sHex };
+}
+export function buildBaseUsdcAuthorization(options) {
+    validateBaseRequirement(options.accepted);
+    if (!ADDRESS.test(options.payer) ||
+        !Number.isSafeInteger(options.nowSeconds) ||
+        options.nowSeconds < 1) {
+        throw new Error("payer or current time is invalid");
+    }
+    const digest = DIGEST.exec(options.challengeDigest);
+    if (digest === null)
+        throw new Error("payment challenge digest is invalid");
+    const validFor = Math.min(options.accepted.maxTimeoutSeconds, BASE_MAX_AUTHORIZATION_SECONDS);
+    const authorization = {
+        from: options.payer,
+        to: options.accepted.payTo,
+        value: options.accepted.amount,
+        validAfter: String(options.nowSeconds - 1),
+        validBefore: String(options.nowSeconds + validFor),
+        nonce: `0x${digest[1]}`,
+    };
+    decimalUint256(authorization.value, "authorization value");
+    const typedData = {
+        types: {
+            EIP712Domain: [
+                { name: "name", type: "string" },
+                { name: "version", type: "string" },
+                { name: "chainId", type: "uint256" },
+                { name: "verifyingContract", type: "address" },
+            ],
+            TransferWithAuthorization: [
+                { name: "from", type: "address" },
+                { name: "to", type: "address" },
+                { name: "value", type: "uint256" },
+                { name: "validAfter", type: "uint256" },
+                { name: "validBefore", type: "uint256" },
+                { name: "nonce", type: "bytes32" },
+            ],
+        },
+        primaryType: "TransferWithAuthorization",
+        domain: {
+            name: "USD Coin",
+            version: "2",
+            chainId: BASE_MAINNET_CHAIN_ID,
+            verifyingContract: options.accepted.asset,
+        },
+        message: authorization,
+    };
+    return { authorization, typedData };
+}
+export function encodeBaseUsdcTransferWithAuthorization(options) {
+    const { authorization } = options;
+    if (!ADDRESS.test(authorization.from) ||
+        !ADDRESS.test(authorization.to) ||
+        !/^0x[0-9a-f]{64}$/.test(authorization.nonce)) {
+        throw new Error("EIP-3009 authorization is malformed");
+    }
+    const value = decimalUint256(authorization.value, "authorization value");
+    const validAfter = decimalUint256(authorization.validAfter, "authorization validAfter");
+    const validBefore = decimalUint256(authorization.validBefore, "authorization validBefore");
+    if (validAfter >= validBefore) {
+        throw new Error("EIP-3009 authorization validity window is empty");
+    }
+    const { recoveryId, rHex, sHex } = signatureParts(options.signature);
+    return (`0x${TRANSFER_WITH_AUTHORIZATION_SELECTOR}` +
+        addressWord(authorization.from) +
+        addressWord(authorization.to) +
+        word(value) +
+        word(validAfter) +
+        word(validBefore) +
+        authorization.nonce.slice(2) +
+        word(BigInt(recoveryId)) +
+        rHex.padStart(64, "0") +
+        sHex.padStart(64, "0"));
+}
+export function buildBaseUsdcEip1559TransactionRequest(options) {
+    validateBaseRequirement(options.accepted);
+    if (!ADDRESS.test(options.payer))
+        throw new Error("payer is malformed");
+    if (!/^0xe3ee160e[0-9a-f]{576}$/.test(options.data)) {
+        throw new Error("Base USDC transfer calldata is not canonical");
+    }
+    const { policy } = options;
+    const nonce = boundedUint256(policy.nonce, "transaction nonce");
+    const gasLimit = boundedUint256(policy.gasLimit, "transaction gas limit");
+    const maxFeePerGas = boundedUint256(policy.maxFeePerGas, "transaction max fee");
+    const maxPriorityFeePerGas = boundedUint256(policy.maxPriorityFeePerGas, "transaction priority fee");
+    if (gasLimit < 21000n ||
+        gasLimit > BASE_MAX_GAS_LIMIT ||
+        maxPriorityFeePerGas > maxFeePerGas) {
+        throw new Error("Base EIP-1559 fee policy is outside the client ceiling");
+    }
+    return {
+        type: "0x2",
+        chainId: BASE_CHAIN_ID_HEX,
+        from: options.payer,
+        to: options.accepted.asset,
+        value: "0x0",
+        data: options.data,
+        nonce: hexQuantity(nonce),
+        gas: hexQuantity(gasLimit),
+        maxFeePerGas: hexQuantity(maxFeePerGas),
+        maxPriorityFeePerGas: hexQuantity(maxPriorityFeePerGas),
+        accessList: [],
+    };
+}
+function readBigEndian(value) {
+    if (value.length > 4)
+        throw new Error("RLP length exceeds client bound");
+    let result = 0;
+    for (const byte of value)
+        result = result * 256 + byte;
+    return result;
+}
+function parseRlp(input, offset, depth = 0) {
+    if (depth > 3 || offset >= input.length) {
+        throw new Error("signed EIP-1559 transaction RLP is malformed");
+    }
+    const prefix = input[offset];
+    if (prefix <= 0x7f) {
+        return { value: input.slice(offset, offset + 1), next: offset + 1 };
+    }
+    let payloadStart;
+    let payloadLength;
+    let list = false;
+    if (prefix <= 0xb7) {
+        payloadLength = prefix - 0x80;
+        payloadStart = offset + 1;
+        if (payloadLength === 1 && input[payloadStart] <= 0x7f) {
+            throw new Error("signed EIP-1559 transaction RLP is noncanonical");
+        }
+    }
+    else if (prefix <= 0xbf) {
+        const lengthLength = prefix - 0xb7;
+        const lengthBytes = input.slice(offset + 1, offset + 1 + lengthLength);
+        if (lengthBytes[0] === 0) {
+            throw new Error("signed EIP-1559 transaction RLP is noncanonical");
+        }
+        payloadLength = readBigEndian(lengthBytes);
+        if (payloadLength < 56) {
+            throw new Error("signed EIP-1559 transaction RLP is noncanonical");
+        }
+        payloadStart = offset + 1 + lengthLength;
+    }
+    else if (prefix <= 0xf7) {
+        list = true;
+        payloadLength = prefix - 0xc0;
+        payloadStart = offset + 1;
+    }
+    else {
+        list = true;
+        const lengthLength = prefix - 0xf7;
+        const lengthBytes = input.slice(offset + 1, offset + 1 + lengthLength);
+        if (lengthBytes[0] === 0) {
+            throw new Error("signed EIP-1559 transaction RLP is noncanonical");
+        }
+        payloadLength = readBigEndian(lengthBytes);
+        if (payloadLength < 56) {
+            throw new Error("signed EIP-1559 transaction RLP is noncanonical");
+        }
+        payloadStart = offset + 1 + lengthLength;
+    }
+    const payloadEnd = payloadStart + payloadLength;
+    if (payloadStart > input.length || payloadEnd > input.length) {
+        throw new Error("signed EIP-1559 transaction RLP is truncated");
+    }
+    if (!list) {
+        return { value: input.slice(payloadStart, payloadEnd), next: payloadEnd };
+    }
+    const values = [];
+    let cursor = payloadStart;
+    while (cursor < payloadEnd) {
+        const parsed = parseRlp(input, cursor, depth + 1);
+        if (parsed.next > payloadEnd) {
+            throw new Error("signed EIP-1559 transaction RLP list is malformed");
+        }
+        values.push(parsed.value);
+        cursor = parsed.next;
+    }
+    if (cursor !== payloadEnd) {
+        throw new Error("signed EIP-1559 transaction RLP list is malformed");
+    }
+    return { value: values, next: payloadEnd };
+}
+function rlpBytes(value, field) {
+    if (Array.isArray(value))
+        throw new Error(`${field} is not an RLP string`);
+    return value;
+}
+function rlpInteger(value, field) {
+    const bytes = rlpBytes(value, field);
+    if (bytes.length > 32 || (bytes.length > 0 && bytes[0] === 0)) {
+        throw new Error(`${field} is not a canonical uint256`);
+    }
+    let result = 0n;
+    for (const byte of bytes)
+        result = (result << 8n) | BigInt(byte);
+    return result;
+}
+function hexBytes(value) {
+    return [...value].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function policyFromRequest(request) {
+    const quantity = (field) => {
+        const value = request[field];
+        if (typeof value !== "string" ||
+            !/^0x(?:0|[1-9a-f][0-9a-f]*)$/.test(value)) {
+            throw new Error(`${field} is not a canonical JSON-RPC quantity`);
+        }
+        return BigInt(value);
+    };
+    return {
+        nonce: quantity("nonce"),
+        gasLimit: quantity("gas"),
+        maxFeePerGas: quantity("maxFeePerGas"),
+        maxPriorityFeePerGas: quantity("maxPriorityFeePerGas"),
+    };
+}
+/**
+ * Decode and compare every frozen EIP-1559 field returned by the wallet.
+ *
+ * Sender recovery and EIP-3009 signature recovery are repeated by K1Hub's
+ * backend before reservation. This browser-side check prevents a wallet from
+ * silently changing chain, nonce, fees, destination, value, calldata, or
+ * access list.
+ */
+export function verifyBuyerSignedBaseUsdcTransaction(options) {
+    const { signedTransaction, request } = options;
+    if (typeof signedTransaction !== "string" ||
+        signedTransaction.length > 32_770 ||
+        signedTransaction.length % 2 !== 0 ||
+        !SIGNED_TYPE_2_TRANSACTION.test(signedTransaction)) {
+        throw new Error("wallet returned no canonical signed EIP-1559 transaction");
+    }
+    const raw = Uint8Array.from(signedTransaction.slice(2).match(/../g) ?? [], (pair) => Number.parseInt(pair, 16));
+    if (raw[0] !== 2)
+        throw new Error("wallet returned the wrong transaction type");
+    const parsed = parseRlp(raw, 1);
+    if (parsed.next !== raw.length || !Array.isArray(parsed.value)) {
+        throw new Error("signed EIP-1559 transaction has trailing data");
+    }
+    const fields = parsed.value;
+    if (fields.length !== 12) {
+        throw new Error("signed EIP-1559 transaction has the wrong field count");
+    }
+    const [chainId, nonce, priorityFee, maxFee, gas, to, value, data, accessList, parity, signatureR, signatureS,] = fields;
+    const expected = policyFromRequest(request);
+    const expectedTo = request.to;
+    const expectedData = request.data;
+    const transactionR = rlpInteger(signatureR, "transaction signature r");
+    const transactionS = rlpInteger(signatureS, "transaction signature s");
+    if (rlpInteger(chainId, "transaction chainId") !==
+        BigInt(BASE_MAINNET_CHAIN_ID) ||
+        rlpInteger(nonce, "transaction nonce") !== expected.nonce ||
+        rlpInteger(priorityFee, "transaction priority fee") !==
+            expected.maxPriorityFeePerGas ||
+        rlpInteger(maxFee, "transaction max fee") !== expected.maxFeePerGas ||
+        rlpInteger(gas, "transaction gas") !== expected.gasLimit ||
+        typeof expectedTo !== "string" ||
+        `0x${hexBytes(rlpBytes(to, "transaction to"))}`.toLowerCase() !==
+            expectedTo.toLowerCase() ||
+        rlpInteger(value, "transaction value") !== 0n ||
+        typeof expectedData !== "string" ||
+        `0x${hexBytes(rlpBytes(data, "transaction data"))}` !== expectedData ||
+        !Array.isArray(accessList) ||
+        accessList.length !== 0 ||
+        ![0n, 1n].includes(rlpInteger(parity, "transaction y parity")) ||
+        transactionR < 1n ||
+        transactionR >= SECP256K1_ORDER ||
+        transactionS < 1n ||
+        transactionS > SECP256K1_HALF_ORDER) {
+        throw new Error("wallet changed the frozen buyer-funded Base transaction");
+    }
+}
+function signedTransactionResult(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "object" &&
+        value !== null &&
+        "raw" in value &&
+        typeof value.raw === "string") {
+        return value.raw;
+    }
+    throw new Error("wallet returned no signed EIP-1559 transaction");
+}
+/**
+ * Construct the exact external-wallet V1 Base USDC x402 payload.
+ *
+ * The default path asks the buyer's ordinary EIP-1193 wallet to broadcast the
+ * exact EIP-1559 request. K1Hub receives only its hash plus the frozen
+ * authorization/request and independently verifies the transaction through
+ * its RPC quorum. Wallets that support `eth_signTransaction` may opt into raw
+ * transport; K1Hub relays those already-signed bytes without signing or gas.
+ */
+export async function createBaseUsdcPayment(options) {
+    const { provider, accepted, paymentRequired } = options;
+    validateBaseRequirement(accepted);
+    const nowSeconds = options.nowSeconds ?? Math.floor(Date.now() / 1_000);
+    if (!Number.isSafeInteger(nowSeconds) || nowSeconds < 1) {
+        throw new Error("current time is invalid");
+    }
+    await verifyExternalRecipientDeclaration({
+        paymentRequired,
+        accepted,
+    });
+    if ((await provider.request({ method: "eth_chainId" })) !== BASE_CHAIN_ID_HEX) {
+        throw new Error("wallet is not connected to Base Mainnet");
+    }
+    const accounts = await provider.request({ method: "eth_requestAccounts" });
+    if (!Array.isArray(accounts) ||
+        typeof accounts[0] !== "string" ||
+        !ADDRESS.test(accounts[0])) {
+        throw new Error("wallet returned no valid Base account");
+    }
+    const payer = accounts[0];
+    if (payer.toLowerCase() === accepted.payTo.toLowerCase()) {
+        throw new Error("payer and recipient must be distinct");
+    }
+    const { authorization, typedData } = buildBaseUsdcAuthorization({
+        accepted,
+        payer,
+        nowSeconds,
+        challengeDigest: options.challengeDigest,
+    });
+    const authorizationSignature = await provider.request({
+        method: "eth_signTypedData_v4",
+        params: [payer, JSON.stringify(typedData)],
+    });
+    if (typeof authorizationSignature !== "string") {
+        throw new Error("wallet returned no EIP-3009 signature");
+    }
+    const data = encodeBaseUsdcTransferWithAuthorization({
+        authorization,
+        signature: authorizationSignature,
+    });
+    const request = buildBaseUsdcEip1559TransactionRequest({
+        accepted,
+        payer,
+        data,
+        policy: options.transactionPolicy,
+    });
+    if ((options.transactionTransport ?? "eip1193_broadcast") === "signed_raw") {
+        const signedTransaction = signedTransactionResult(await provider.request({
+            method: "eth_signTransaction",
+            params: [request],
+        }));
+        verifyBuyerSignedBaseUsdcTransaction({ signedTransaction, request });
+        return createPaymentPayload({
+            paymentRequired,
+            accepted,
+            paymentIdentifier: options.buyerPaymentIdentifier,
+            schemePayload: { transaction: signedTransaction },
+        });
+    }
+    const transactionHash = await provider.request({
+        method: "eth_sendTransaction",
+        params: [request],
+    });
+    if (typeof transactionHash !== "string" ||
+        !/^0x[0-9a-f]{64}$/.test(transactionHash)) {
+        throw new Error("wallet returned no canonical buyer-broadcast Base transaction hash");
+    }
+    return createPaymentPayload({
+        paymentRequired,
+        accepted,
+        paymentIdentifier: options.buyerPaymentIdentifier,
+        schemePayload: {
+            transactionHash,
+            transactionRequest: request,
+            authorization,
+            signature: authorizationSignature,
+        },
+    });
+}
+//# sourceMappingURL=base.js.map

package/dist/protocol/base.js.map

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

package/dist/protocol/external-recipient.d.ts

@@ -0,0 +1,22 @@
+import { type JsonObject, type PaymentRequired, type PaymentRequirement } from "./http.js";
+export declare const EXTERNAL_RECIPIENT_EXTENSION = "com.k1hub.external-recipient";
+export type VerifiedExternalRecipient = {
+    network: string;
+    asset: string;
+    payTo: string;
+    recipientDescriptorDigest: string;
+    recipientDescriptor: JsonObject;
+};
+/**
+ * Verify the immutable address-only recipient declaration before a browser
+ * asks any wallet for accounts, signatures, or a transaction.
+ *
+ * This declaration is intentionally separate from the dormant managed-wallet
+ * manifest protocol. Its digest binds the exact receiving-address descriptor
+ * whose signed-nonce proof of control was admitted by K1Hub.
+ */
+export declare function verifyExternalRecipientDeclaration(options: {
+    paymentRequired: PaymentRequired;
+    accepted: PaymentRequirement;
+}): Promise<VerifiedExternalRecipient>;
+//# sourceMappingURL=external-recipient.d.ts.map

package/dist/protocol/external-recipient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-recipient.d.ts","sourceRoot":"","sources":["../../src/protocol/external-recipient.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAQ3E,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB,EAAE,MAAM,CAAC;IAClC,mBAAmB,EAAE,UAAU,CAAC;CACjC,CAAC;AAoHF;;;;;;;GAOG;AACH,wBAAsB,kCAAkC,CAAC,OAAO,EAAE;IAChE,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAgFrC"}