open-agentpay 0.1.0 → 0.2.5

package/dist/core/state.js

@@ -0,0 +1,87 @@
+/**
+ * Core Multi-Dimensional State Enums and Entity Models for AgentPay.
+ *
+ * Defines the four orthogonal state objects adhering to specs/payment-state-machine-v2.md:
+ *   1. PaymentIntentState  (Buyer request lifecycle)
+ *   2. SettlementState     (Blockchain / clearing funds transfer)
+ *   3. FulfillmentState    (Upstream API / resource payload delivery)
+ *   4. BudgetLedgerState   (Buyer firewall local quota reservation)
+ */
+export var PaymentIntentState;
+(function (PaymentIntentState) {
+    PaymentIntentState["CREATED"] = "CREATED";
+    PaymentIntentState["AUTHORIZED"] = "AUTHORIZED";
+    PaymentIntentState["PROCESSING"] = "PROCESSING";
+    PaymentIntentState["SIGNATURE_SENT"] = "SIGNATURE_SENT";
+    PaymentIntentState["COMPLETED"] = "COMPLETED";
+    PaymentIntentState["SUCCEEDED"] = "SUCCEEDED";
+    PaymentIntentState["REJECTED"] = "REJECTED";
+    PaymentIntentState["EXPIRED"] = "EXPIRED";
+    PaymentIntentState["CANCELLED"] = "CANCELLED";
+    PaymentIntentState["RECOVERY_HOLD"] = "RECOVERY_HOLD";
+})(PaymentIntentState || (PaymentIntentState = {}));
+export var SettlementState;
+(function (SettlementState) {
+    SettlementState["NOT_STARTED"] = "NOT_STARTED";
+    SettlementState["NOT_SUBMITTED"] = "NOT_SUBMITTED";
+    SettlementState["SUBMITTED"] = "SUBMITTED";
+    SettlementState["PENDING"] = "PENDING";
+    SettlementState["CONFIRMED"] = "CONFIRMED";
+    SettlementState["SUCCESS"] = "SUCCESS";
+    SettlementState["FAILED"] = "FAILED";
+    SettlementState["REORGED"] = "REORGED";
+    SettlementState["UNKNOWN"] = "UNKNOWN";
+})(SettlementState || (SettlementState = {}));
+export var FulfillmentState;
+(function (FulfillmentState) {
+    FulfillmentState["NOT_STARTED"] = "NOT_STARTED";
+    FulfillmentState["NOT_DELIVERED"] = "NOT_DELIVERED";
+    FulfillmentState["PROCESSING"] = "PROCESSING";
+    FulfillmentState["DELIVERING"] = "DELIVERING";
+    FulfillmentState["DELIVERED"] = "DELIVERED";
+    FulfillmentState["FAILED"] = "FAILED";
+    FulfillmentState["RECOVERY_REQUIRED"] = "RECOVERY_REQUIRED";
+})(FulfillmentState || (FulfillmentState = {}));
+export var BudgetLedgerState;
+(function (BudgetLedgerState) {
+    BudgetLedgerState["RESERVED"] = "RESERVED";
+    BudgetLedgerState["COMMITTED"] = "COMMITTED";
+    BudgetLedgerState["RELEASED"] = "RELEASED";
+})(BudgetLedgerState || (BudgetLedgerState = {}));
+export class BuyerIntentRecord {
+    intentId;
+    policyId;
+    idempotencyKey;
+    payerAddress;
+    payeeAddress;
+    assetAddress;
+    networkId;
+    amountBaseUnits;
+    status;
+    nonce;
+    validAfter;
+    validBefore;
+    rawSignature;
+    createdAt;
+    updatedAt;
+    constructor(data) {
+        this.intentId = data.intentId;
+        this.policyId = data.policyId;
+        this.idempotencyKey = data.idempotencyKey;
+        this.payerAddress = data.payerAddress.toLowerCase();
+        this.payeeAddress = data.payeeAddress.toLowerCase();
+        this.assetAddress = data.assetAddress.toLowerCase();
+        this.networkId = data.networkId;
+        this.amountBaseUnits =
+            typeof data.amountBaseUnits === 'bigint' ? data.amountBaseUnits : BigInt(data.amountBaseUnits);
+        this.status = data.status ?? PaymentIntentState.CREATED;
+        this.nonce = data.nonce ?? null;
+        this.validAfter = data.validAfter ?? null;
+        this.validBefore = data.validBefore ?? null;
+        this.rawSignature = data.rawSignature ?? null;
+        this.createdAt = data.createdAt ?? 0;
+        this.updatedAt = data.updatedAt ?? 0;
+        Object.freeze(this);
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

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

package/dist/evm/constants.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Arbitrum Sepolia Testnet & EIP-3009 Constants for AgentPay.
+ *
+ * Authoritative reference for:
+ * - Arbitrum Sepolia Testnet (Chain ID 421614, CAIP-2: eip155:421614)
+ * - Native Circle FiatTokenV2_2 USDC contract
+ * - Function selectors and EIP-712 / EIP-3009 constants
+ */
+export declare const ARBITRUM_SEPOLIA_CHAIN_ID = 421614;
+export declare const ARBITRUM_SEPOLIA_CAIP2 = "eip155:421614";
+export declare const ARBITRUM_SEPOLIA_RPC_URL = "https://sepolia-rollup.arbitrum.io/rpc";
+export declare const ARBITRUM_SEPOLIA_EXPLORER_URL = "https://sepolia.arbiscan.io";
+export declare const ARBITRUM_SEPOLIA_USDC_ADDRESS = "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d";
+export declare const ARBITRUM_SEPOLIA_USDC_SYMBOL = "USDC";
+export declare const ARBITRUM_SEPOLIA_USDC_DECIMALS = 6;
+export declare const ARBITRUM_SEPOLIA_USDC_NAME = "USD Coin";
+export declare const ARBITRUM_SEPOLIA_USDC_VERSION = "2";
+export declare const TRANSFER_WITH_AUTHORIZATION_SELECTOR: Uint8Array<ArrayBuffer>;
+export declare const RECEIVE_WITH_AUTHORIZATION_SELECTOR: Uint8Array<ArrayBuffer>;
+export declare const CANCEL_AUTHORIZATION_SELECTOR: Uint8Array<ArrayBuffer>;
+export declare const AUTHORIZATION_STATE_SELECTOR: Uint8Array<ArrayBuffer>;
+export declare const BALANCE_OF_SELECTOR: Uint8Array<ArrayBuffer>;
+export declare const DOMAIN_SEPARATOR_SELECTOR: Uint8Array<ArrayBuffer>;
+export interface NetworkSpecInput {
+    name: string;
+    chainId: number;
+    caip2: string;
+    rpcUrl: string;
+    explorerUrl: string;
+    defaultAssetAddress: string;
+    defaultAssetSymbol?: string;
+    defaultAssetDecimals?: number;
+    tokenName?: string;
+    tokenVersion?: string;
+}
+export declare class NetworkSpec {
+    readonly name: string;
+    readonly chainId: number;
+    readonly caip2: string;
+    readonly rpcUrl: string;
+    readonly explorerUrl: string;
+    readonly defaultAssetAddress: `0x${string}`;
+    readonly defaultAssetSymbol: string;
+    readonly defaultAssetDecimals: number;
+    readonly tokenName: string;
+    readonly tokenVersion: string;
+    constructor(input: NetworkSpecInput);
+}
+export declare const ARBITRUM_SEPOLIA: NetworkSpec;
+export declare const KNOWN_NETWORKS: Readonly<Record<string, NetworkSpec>>;
+export declare function getNetworkSpec(networkOrChainId: string | number): NetworkSpec | undefined;
+//# sourceMappingURL=constants.d.ts.map

package/dist/evm/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/evm/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AACtD,eAAO,MAAM,wBAAwB,2CAA2C,CAAC;AACjF,eAAO,MAAM,6BAA6B,gCAAgC,CAAC;AAE3E,eAAO,MAAM,6BAA6B,+CAA+C,CAAC;AAC1F,eAAO,MAAM,4BAA4B,SAAS,CAAC;AACnD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,0BAA0B,aAAa,CAAC;AACrD,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAGjD,eAAO,MAAM,oCAAoC,yBAA2C,CAAC;AAC7F,eAAO,MAAM,mCAAmC,yBAA2C,CAAC;AAC5F,eAAO,MAAM,6BAA6B,yBAA2C,CAAC;AACtF,eAAO,MAAM,4BAA4B,yBAA2C,CAAC;AACrF,eAAO,MAAM,mBAAmB,yBAA2C,CAAC;AAC5E,eAAO,MAAM,yBAAyB,yBAA2C,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,KAAK,EAAE,gBAAgB;CAapC;AAED,eAAO,MAAM,gBAAgB,aAW3B,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAK/D,CAAC;AAEH,wBAAgB,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAGzF"}

package/dist/evm/constants.js

@@ -0,0 +1,72 @@
+/**
+ * Arbitrum Sepolia Testnet & EIP-3009 Constants for AgentPay.
+ *
+ * Authoritative reference for:
+ * - Arbitrum Sepolia Testnet (Chain ID 421614, CAIP-2: eip155:421614)
+ * - Native Circle FiatTokenV2_2 USDC contract
+ * - Function selectors and EIP-712 / EIP-3009 constants
+ */
+export const ARBITRUM_SEPOLIA_CHAIN_ID = 421614;
+export const ARBITRUM_SEPOLIA_CAIP2 = 'eip155:421614';
+export const ARBITRUM_SEPOLIA_RPC_URL = 'https://sepolia-rollup.arbitrum.io/rpc';
+export const ARBITRUM_SEPOLIA_EXPLORER_URL = 'https://sepolia.arbiscan.io';
+export const ARBITRUM_SEPOLIA_USDC_ADDRESS = '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d';
+export const ARBITRUM_SEPOLIA_USDC_SYMBOL = 'USDC';
+export const ARBITRUM_SEPOLIA_USDC_DECIMALS = 6;
+export const ARBITRUM_SEPOLIA_USDC_NAME = 'USD Coin';
+export const ARBITRUM_SEPOLIA_USDC_VERSION = '2';
+// EIP-3009 4-byte Function Selectors
+export const TRANSFER_WITH_AUTHORIZATION_SELECTOR = new Uint8Array([0xe3, 0xee, 0x16, 0x0e]);
+export const RECEIVE_WITH_AUTHORIZATION_SELECTOR = new Uint8Array([0xef, 0x55, 0xde, 0xc6]);
+export const CANCEL_AUTHORIZATION_SELECTOR = new Uint8Array([0x5b, 0x34, 0xb9, 0x66]);
+export const AUTHORIZATION_STATE_SELECTOR = new Uint8Array([0xe9, 0x4a, 0x01, 0x02]);
+export const BALANCE_OF_SELECTOR = new Uint8Array([0x70, 0xa0, 0x82, 0x31]);
+export const DOMAIN_SEPARATOR_SELECTOR = new Uint8Array([0x36, 0x44, 0xe5, 0x15]);
+export class NetworkSpec {
+    name;
+    chainId;
+    caip2;
+    rpcUrl;
+    explorerUrl;
+    defaultAssetAddress;
+    defaultAssetSymbol;
+    defaultAssetDecimals;
+    tokenName;
+    tokenVersion;
+    constructor(input) {
+        this.name = input.name;
+        this.chainId = input.chainId;
+        this.caip2 = input.caip2;
+        this.rpcUrl = input.rpcUrl;
+        this.explorerUrl = input.explorerUrl;
+        this.defaultAssetAddress = input.defaultAssetAddress.toLowerCase();
+        this.defaultAssetSymbol = input.defaultAssetSymbol ?? 'USDC';
+        this.defaultAssetDecimals = input.defaultAssetDecimals ?? 6;
+        this.tokenName = input.tokenName ?? 'USD Coin';
+        this.tokenVersion = input.tokenVersion ?? '2';
+        Object.freeze(this);
+    }
+}
+export const ARBITRUM_SEPOLIA = new NetworkSpec({
+    name: 'arbitrum-sepolia',
+    chainId: ARBITRUM_SEPOLIA_CHAIN_ID,
+    caip2: ARBITRUM_SEPOLIA_CAIP2,
+    rpcUrl: ARBITRUM_SEPOLIA_RPC_URL,
+    explorerUrl: ARBITRUM_SEPOLIA_EXPLORER_URL,
+    defaultAssetAddress: ARBITRUM_SEPOLIA_USDC_ADDRESS,
+    defaultAssetSymbol: ARBITRUM_SEPOLIA_USDC_SYMBOL,
+    defaultAssetDecimals: ARBITRUM_SEPOLIA_USDC_DECIMALS,
+    tokenName: ARBITRUM_SEPOLIA_USDC_NAME,
+    tokenVersion: ARBITRUM_SEPOLIA_USDC_VERSION,
+});
+export const KNOWN_NETWORKS = Object.freeze({
+    [ARBITRUM_SEPOLIA_CAIP2]: ARBITRUM_SEPOLIA,
+    [String(ARBITRUM_SEPOLIA_CHAIN_ID)]: ARBITRUM_SEPOLIA,
+    'arbitrum-sepolia': ARBITRUM_SEPOLIA,
+    'arb-sepolia': ARBITRUM_SEPOLIA,
+});
+export function getNetworkSpec(networkOrChainId) {
+    const key = String(networkOrChainId).trim().toLowerCase();
+    return KNOWN_NETWORKS[key];
+}
+//# sourceMappingURL=constants.js.map

package/dist/evm/constants.js.map

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

package/dist/evm/eip3009.d.ts

@@ -0,0 +1,43 @@
+/**
+ * EIP-3009 ABI Encoding and Decoding Utilities for AgentPay.
+ *
+ * Implements calldata builders and result decoders for FiatTokenV2_2 / EIP-3009:
+ * - transferWithAuthorization
+ * - authorizationState
+ * - balanceOf
+ */
+import { type PaymentAuthorization } from '../core/models.js';
+export interface TransferWithAuthorizationParams {
+    from: string;
+    to: string;
+    value: bigint | number;
+    validAfter: bigint | number;
+    validBefore: bigint | number;
+    nonce: string | Uint8Array;
+    v: number;
+    r: string | Uint8Array;
+    s: string | Uint8Array;
+}
+export interface DecodedTransferWithAuthorization {
+    from: `0x${string}`;
+    to: `0x${string}`;
+    value: bigint;
+    validAfter: bigint;
+    validBefore: bigint;
+    nonce: `0x${string}`;
+    v: number;
+    r: `0x${string}`;
+    s: `0x${string}`;
+}
+/**
+ * Encode calldata for ERC-3009 transferWithAuthorization.
+ * Selector: 0xe3ee160e (4 bytes) + 9 * 32 bytes = 292 bytes total.
+ */
+export declare function encodeTransferWithAuthorization(params: TransferWithAuthorizationParams): Uint8Array;
+export declare function encodeTransferFromAuthorization(authorization: PaymentAuthorization, toAddress: string, value: bigint | number): Uint8Array;
+export declare function decodeTransferWithAuthorization(calldata: Uint8Array | string): DecodedTransferWithAuthorization;
+export declare function encodeAuthorizationState(authorizer: string, nonce: string | Uint8Array): Uint8Array;
+export declare function decodeAuthorizationStateResult(data: Uint8Array | string): boolean;
+export declare function encodeBalanceOf(account: string): Uint8Array;
+export declare function decodeBalanceOfResult(data: Uint8Array | string): bigint;
+//# sourceMappingURL=eip3009.d.ts.map

package/dist/evm/eip3009.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eip3009.d.ts","sourceRoot":"","sources":["../../src/evm/eip3009.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,mBAAmB,CAAC;AA4D7E,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACvB,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IACpB,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IACjB,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,+BAA+B,GACtC,UAAU,CAaZ;AAED,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,oBAAoB,EACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,MAAM,GACrB,UAAU,CAeZ;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,UAAU,GAAG,MAAM,GAC5B,gCAAgC,CA2BlC;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAMnG;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAOjF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAE3D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAOvE"}

package/dist/evm/eip3009.js

@@ -0,0 +1,145 @@
+/**
+ * EIP-3009 ABI Encoding and Decoding Utilities for AgentPay.
+ *
+ * Implements calldata builders and result decoders for FiatTokenV2_2 / EIP-3009:
+ * - transferWithAuthorization
+ * - authorizationState
+ * - balanceOf
+ */
+import { SignatureData } from '../core/models.js';
+import { AUTHORIZATION_STATE_SELECTOR, BALANCE_OF_SELECTOR, TRANSFER_WITH_AUTHORIZATION_SELECTOR, } from './constants.js';
+function hexToBytes32(val) {
+    if (val instanceof Uint8Array) {
+        if (val.byteLength !== 32) {
+            throw new Error(`Expected 32 bytes, got ${val.byteLength}`);
+        }
+        return new Uint8Array(val);
+    }
+    const clean = val.startsWith('0x') ? val.slice(2) : val;
+    if (clean.length > 64 || !/^[0-9a-fA-F]*$/.test(clean)) {
+        throw new Error(`Invalid bytes32 hex value: ${val}`);
+    }
+    return new Uint8Array(Buffer.from(clean.padStart(64, '0'), 'hex'));
+}
+function encodeAddressWord(address) {
+    const clean = address.startsWith('0x') ? address.slice(2) : address;
+    if (clean.length !== 40 || !/^[0-9a-fA-F]{40}$/.test(clean)) {
+        throw new Error(`Invalid EVM address: ${address}`);
+    }
+    return new Uint8Array(Buffer.from(clean.toLowerCase().padStart(64, '0'), 'hex'));
+}
+function encodeUint256Word(value) {
+    const big = typeof value === 'bigint' ? value : BigInt(value);
+    if (big < 0n) {
+        throw new Error(`uint256 cannot be negative: ${big.toString()}`);
+    }
+    const hex = big.toString(16);
+    if (hex.length > 64) {
+        throw new Error(`uint256 overflow: ${big.toString()}`);
+    }
+    return new Uint8Array(Buffer.from(hex.padStart(64, '0'), 'hex'));
+}
+function concatBytes(chunks) {
+    const total = chunks.reduce((acc, c) => acc + c.byteLength, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return out;
+}
+function toRawBytes(data) {
+    if (data instanceof Uint8Array) {
+        return data;
+    }
+    const clean = data.startsWith('0x') ? data.slice(2) : data;
+    return new Uint8Array(Buffer.from(clean, 'hex'));
+}
+/**
+ * Encode calldata for ERC-3009 transferWithAuthorization.
+ * Selector: 0xe3ee160e (4 bytes) + 9 * 32 bytes = 292 bytes total.
+ */
+export function encodeTransferWithAuthorization(params) {
+    return concatBytes([
+        TRANSFER_WITH_AUTHORIZATION_SELECTOR,
+        encodeAddressWord(params.from),
+        encodeAddressWord(params.to),
+        encodeUint256Word(params.value),
+        encodeUint256Word(params.validAfter),
+        encodeUint256Word(params.validBefore),
+        hexToBytes32(params.nonce),
+        encodeUint256Word(params.v),
+        hexToBytes32(params.r),
+        hexToBytes32(params.s),
+    ]);
+}
+export function encodeTransferFromAuthorization(authorization, toAddress, value) {
+    if (!(authorization.signature instanceof SignatureData)) {
+        throw new Error('PaymentAuthorization.signature must be a SignatureData instance');
+    }
+    return encodeTransferWithAuthorization({
+        from: authorization.payer,
+        to: toAddress,
+        value,
+        validAfter: authorization.validAfter,
+        validBefore: authorization.validBefore,
+        nonce: authorization.nonce,
+        v: authorization.signature.v,
+        r: authorization.signature.r,
+        s: authorization.signature.s,
+    });
+}
+export function decodeTransferWithAuthorization(calldata) {
+    const raw = toRawBytes(calldata);
+    if (raw.byteLength < 292) {
+        throw new Error(`Calldata too short: expected 292 bytes, got ${raw.byteLength}`);
+    }
+    const selector = Buffer.from(raw.subarray(0, 4)).toString('hex');
+    const expectedSelector = Buffer.from(TRANSFER_WITH_AUTHORIZATION_SELECTOR).toString('hex');
+    if (selector !== expectedSelector) {
+        throw new Error(`Selector mismatch: expected ${expectedSelector}, got ${selector}`);
+    }
+    const readWordHex = (index) => {
+        const start = 4 + index * 32;
+        return Buffer.from(raw.subarray(start, start + 32)).toString('hex');
+    };
+    return {
+        from: `0x${readWordHex(0).slice(24).toLowerCase()}`,
+        to: `0x${readWordHex(1).slice(24).toLowerCase()}`,
+        value: BigInt(`0x${readWordHex(2)}`),
+        validAfter: BigInt(`0x${readWordHex(3)}`),
+        validBefore: BigInt(`0x${readWordHex(4)}`),
+        nonce: `0x${readWordHex(5).toLowerCase()}`,
+        v: Number(BigInt(`0x${readWordHex(6)}`)),
+        r: `0x${readWordHex(7).toLowerCase()}`,
+        s: `0x${readWordHex(8).toLowerCase()}`,
+    };
+}
+export function encodeAuthorizationState(authorizer, nonce) {
+    return concatBytes([
+        AUTHORIZATION_STATE_SELECTOR,
+        encodeAddressWord(authorizer),
+        hexToBytes32(nonce),
+    ]);
+}
+export function decodeAuthorizationStateResult(data) {
+    const raw = toRawBytes(data);
+    if (raw.byteLength < 32) {
+        return false;
+    }
+    const wordHex = Buffer.from(raw.subarray(0, 32)).toString('hex');
+    return BigInt(`0x${wordHex}`) !== 0n;
+}
+export function encodeBalanceOf(account) {
+    return concatBytes([BALANCE_OF_SELECTOR, encodeAddressWord(account)]);
+}
+export function decodeBalanceOfResult(data) {
+    const raw = toRawBytes(data);
+    if (raw.byteLength < 32) {
+        return 0n;
+    }
+    const wordHex = Buffer.from(raw.subarray(0, 32)).toString('hex');
+    return BigInt(`0x${wordHex}`);
+}
+//# sourceMappingURL=eip3009.js.map

package/dist/evm/eip3009.js.map

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

package/dist/evm/index.d.ts

@@ -0,0 +1,3 @@
+export { ARBITRUM_SEPOLIA, ARBITRUM_SEPOLIA_CAIP2, ARBITRUM_SEPOLIA_CHAIN_ID, ARBITRUM_SEPOLIA_EXPLORER_URL, ARBITRUM_SEPOLIA_RPC_URL, ARBITRUM_SEPOLIA_USDC_ADDRESS, ARBITRUM_SEPOLIA_USDC_DECIMALS, ARBITRUM_SEPOLIA_USDC_NAME, ARBITRUM_SEPOLIA_USDC_SYMBOL, ARBITRUM_SEPOLIA_USDC_VERSION, AUTHORIZATION_STATE_SELECTOR, BALANCE_OF_SELECTOR, CANCEL_AUTHORIZATION_SELECTOR, DOMAIN_SEPARATOR_SELECTOR, KNOWN_NETWORKS, NetworkSpec, type NetworkSpecInput, RECEIVE_WITH_AUTHORIZATION_SELECTOR, TRANSFER_WITH_AUTHORIZATION_SELECTOR, getNetworkSpec, } from './constants.js';
+export { type DecodedTransferWithAuthorization, type TransferWithAuthorizationParams, decodeAuthorizationStateResult, decodeBalanceOfResult, decodeTransferWithAuthorization, encodeAuthorizationState, encodeBalanceOf, encodeTransferFromAuthorization, encodeTransferWithAuthorization, } from './eip3009.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/evm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACxB,6BAA6B,EAC7B,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,6BAA6B,EAC7B,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,KAAK,gBAAgB,EACrB,mCAAmC,EACnC,oCAAoC,EACpC,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,EACpC,8BAA8B,EAC9B,qBAAqB,EACrB,+BAA+B,EAC/B,wBAAwB,EACxB,eAAe,EACf,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,cAAc,CAAC"}

package/dist/evm/index.js

@@ -0,0 +1,3 @@
+export { ARBITRUM_SEPOLIA, ARBITRUM_SEPOLIA_CAIP2, ARBITRUM_SEPOLIA_CHAIN_ID, ARBITRUM_SEPOLIA_EXPLORER_URL, ARBITRUM_SEPOLIA_RPC_URL, ARBITRUM_SEPOLIA_USDC_ADDRESS, ARBITRUM_SEPOLIA_USDC_DECIMALS, ARBITRUM_SEPOLIA_USDC_NAME, ARBITRUM_SEPOLIA_USDC_SYMBOL, ARBITRUM_SEPOLIA_USDC_VERSION, AUTHORIZATION_STATE_SELECTOR, BALANCE_OF_SELECTOR, CANCEL_AUTHORIZATION_SELECTOR, DOMAIN_SEPARATOR_SELECTOR, KNOWN_NETWORKS, NetworkSpec, RECEIVE_WITH_AUTHORIZATION_SELECTOR, TRANSFER_WITH_AUTHORIZATION_SELECTOR, getNetworkSpec, } from './constants.js';
+export { decodeAuthorizationStateResult, decodeBalanceOfResult, decodeTransferWithAuthorization, encodeAuthorizationState, encodeBalanceOf, encodeTransferFromAuthorization, encodeTransferWithAuthorization, } from './eip3009.js';
+//# sourceMappingURL=index.js.map

package/dist/evm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/evm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACxB,6BAA6B,EAC7B,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,6BAA6B,EAC7B,yBAAyB,EACzB,cAAc,EACd,WAAW,EAEX,mCAAmC,EACnC,oCAAoC,EACpC,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAGL,8BAA8B,EAC9B,qBAAqB,EACrB,+BAA+B,EAC/B,wBAAwB,EACxB,eAAe,EACf,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,cAAc,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AgentPay TypeScript SDK
+ * The Open-Source Payment Infrastructure & Financial Firewall for Autonomous AI Agents.
+ */
+export declare const VERSION = "0.2.5";
+export * from './core/index.js';
+export * from './evm/index.js';
+export * from './policy/index.js';
+export * from './client/index.js';
+export * from './state/index.js';
+export * from './integrations/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * AgentPay TypeScript SDK
+ * The Open-Source Payment Infrastructure & Financial Firewall for Autonomous AI Agents.
+ */
+export const VERSION = '0.2.5';
+export * from './core/index.js';
+export * from './evm/index.js';
+export * from './policy/index.js';
+export * from './client/index.js';
+export * from './state/index.js';
+export * from './integrations/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/integrations/index.d.ts

@@ -0,0 +1,4 @@
+export * from './langchain.js';
+export * from './vercel-ai.js';
+export * from './mcp.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}

package/dist/integrations/index.js

@@ -0,0 +1,4 @@
+export * from './langchain.js';
+export * from './vercel-ai.js';
+export * from './mcp.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}

package/dist/integrations/langchain.d.ts

@@ -0,0 +1,40 @@
+/**
+ * LangChain.js integration for AgentPay.
+ *
+ * Provides PaidStructuredTool and createPaidTool helper for wrapping
+ * LangChain tools with autonomous 402 payment negotiation and financial firewall guardrails.
+ */
+import type { AgentPayClient } from '../client/client.js';
+export declare class ToolException extends Error {
+    constructor(message: string);
+}
+export interface CreatePaidToolOptions<TParams = any, TResult = any> {
+    name: string;
+    description: string;
+    schema?: any;
+    client?: AgentPayClient;
+    handlePolicyViolation?: boolean;
+    func?: (params: TParams, context?: {
+        client?: AgentPayClient;
+        [key: string]: any;
+    }) => Promise<TResult> | TResult;
+    coroutine?: (params: TParams, context?: {
+        client?: AgentPayClient;
+        [key: string]: any;
+    }) => Promise<TResult>;
+    [key: string]: any;
+}
+export declare class PaidStructuredTool<TParams = any, TResult = any> {
+    readonly name: string;
+    readonly description: string;
+    readonly schema: any;
+    readonly client?: AgentPayClient;
+    readonly handlePolicyViolation: boolean;
+    private readonly targetFn;
+    constructor(options: CreatePaidToolOptions<TParams, TResult>);
+    call(arg: TParams, ...extra: any[]): Promise<TResult>;
+    _call(arg: TParams, ...extra: any[]): Promise<TResult>;
+    invoke(arg: TParams, ...extra: any[]): Promise<TResult>;
+}
+export declare function createPaidTool<TParams = any, TResult = any>(options: CreatePaidToolOptions<TParams, TResult>): PaidStructuredTool<TParams, TResult>;
+//# sourceMappingURL=langchain.d.ts.map

package/dist/integrations/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,cAAc,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAClH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,cAAc,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7G,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,qBAAa,kBAAkB,CAAC,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiE;gBAE9E,OAAO,EAAE,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC;IAc/C,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CA0BrE;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EACzD,OAAO,EAAE,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,GAC/C,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAEtC"}

package/dist/integrations/langchain.js

@@ -0,0 +1,68 @@
+/**
+ * LangChain.js integration for AgentPay.
+ *
+ * Provides PaidStructuredTool and createPaidTool helper for wrapping
+ * LangChain tools with autonomous 402 payment negotiation and financial firewall guardrails.
+ */
+import { X402Error } from '../core/errors.js';
+import { PolicyViolationError } from '../policy/errors.js';
+export class ToolException extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ToolException';
+    }
+}
+export class PaidStructuredTool {
+    name;
+    description;
+    schema;
+    client;
+    handlePolicyViolation;
+    targetFn;
+    constructor(options) {
+        this.name = options.name;
+        this.description = options.description;
+        this.schema = options.schema;
+        this.client = options.client;
+        this.handlePolicyViolation = options.handlePolicyViolation ?? true;
+        const fn = options.func ?? options.coroutine;
+        if (!fn) {
+            throw new Error("Either 'func' or 'coroutine' must be provided to PaidStructuredTool");
+        }
+        this.targetFn = fn;
+    }
+    async call(arg, ...extra) {
+        return this.invoke(arg, ...extra);
+    }
+    async _call(arg, ...extra) {
+        return this.invoke(arg, ...extra);
+    }
+    async invoke(arg, ...extra) {
+        const context = {
+            client: this.client,
+            ...(extra[0] && typeof extra[0] === 'object' ? extra[0] : {}),
+        };
+        try {
+            return await this.targetFn(arg, context);
+        }
+        catch (err) {
+            if (err instanceof PolicyViolationError) {
+                if (this.handlePolicyViolation) {
+                    throw new ToolException(`AgentPay Firewall Rejected: [${err.code}] ${err.detail || err.message}`);
+                }
+                throw err;
+            }
+            if (err instanceof X402Error) {
+                if (this.handlePolicyViolation) {
+                    throw new ToolException(`AgentPay x402 Protocol Error: ${err.message}`);
+                }
+                throw err;
+            }
+            throw err;
+        }
+    }
+}
+export function createPaidTool(options) {
+    return new PaidStructuredTool(options);
+}
+//# sourceMappingURL=langchain.js.map

package/dist/integrations/langchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAaD,MAAM,OAAO,kBAAkB;IACpB,IAAI,CAAS;IACb,WAAW,CAAS;IACpB,MAAM,CAAM;IACZ,MAAM,CAAkB;IACxB,qBAAqB,CAAU;IACvB,QAAQ,CAAiE;IAE1F,YAAY,OAAgD;QAC1D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,IAAI,IAAI,CAAC;QAEnE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;QAC7C,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,GAAY,EAAE,GAAG,KAAY;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,GAAY,EAAE,GAAG,KAAY;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,GAAY,EAAE,GAAG,KAAY;QAC/C,MAAM,OAAO,GAAG;YACd,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;gBACxC,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;oBAC/B,MAAM,IAAI,aAAa,CACrB,gCAAgC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CACzE,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;gBAC7B,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;oBAC/B,MAAM,IAAI,aAAa,CAAC,iCAAiC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1E,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAC5B,OAAgD;IAEhD,OAAO,IAAI,kBAAkB,CAAmB,OAAO,CAAC,CAAC;AAC3D,CAAC"}