@x402api/agent-wallet-core 0.1.0

package/README.md

@@ -0,0 +1,12 @@
+# `@x402api/agent-wallet-core`
+
+Security-sensitive primitives for persistent local agent wallets. The package
+owns encrypted keystores, strict x402 request contracts, supported Base,
+Solana, and TRON payment authorization, balances, and durable attempt records.
+
+Use the `@x402api/agent-wallet-cli` package for the supported command-line
+surface. This library deliberately exposes no arbitrary-signing API.
+
+The core also creates wallet-signed, subscription-scoped refill notification
+requests. Email recipients and display content are resolved by x402api from
+verified server-side tenant and product records.

package/dist/balances.d.ts

@@ -0,0 +1,32 @@
+import type { SupportedNetwork } from "./storage/keystore.js";
+export declare const SOLANA_MAINNET_GENESIS_HASH = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+export declare const TRON_MAINNET_GENESIS_BLOCK_ID = "00000000000000001ebf88508a03865c71d452e25f4d51194196a1d22b6653dc";
+export type RpcConfiguration = {
+    base?: string;
+    solana?: string;
+    tron?: string;
+};
+export type WalletBalance = {
+    version: 1;
+    network: SupportedNetwork;
+    address: string;
+    asset: string;
+    assetSymbol: "USDC" | "USDT";
+    assetAtomic: string;
+    nativeSymbol: "ETH" | "SOL" | "TRX";
+    nativeAtomic: string;
+    feeResources?: {
+        energyAvailable: string;
+        bandwidthAvailable: string;
+    };
+    checkedAt: string;
+};
+export declare function validateRpcUrl(value: string, label: string): string;
+export declare function jsonRpc(endpoint: string, method: string, params: unknown[]): Promise<unknown>;
+export declare function verifyTronMainnetRpc(endpoint: string): Promise<void>;
+export declare function readWalletBalance(options: {
+    network: SupportedNetwork;
+    address: string;
+    rpc: RpcConfiguration;
+}): Promise<WalletBalance>;
+//# sourceMappingURL=balances.d.ts.map

package/dist/balances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.d.ts","sourceRoot":"","sources":["../src/balances.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,eAAO,MAAM,2BAA2B,iDACQ,CAAC;AACjD,eAAO,MAAM,6BAA6B,qEAC0B,CAAC;AAErE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuBnE;AAED,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAkID,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC1E;AA+CD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,gBAAgB,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,CAazB"}

package/dist/balances.js

@@ -0,0 +1,278 @@
+import { TronWeb } from "tronweb";
+import { AgentWalletError } from "./errors.js";
+import { BASE_USDC_MAINNET_CONTRACT, } from "./protocol/base.js";
+import { SOLANA_USDT_MAINNET_MINT, } from "./protocol/solana.js";
+import { TRON_USDT_MAINNET_CONTRACT } from "./protocol/tron.js";
+export const SOLANA_MAINNET_GENESIS_HASH = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+export const TRON_MAINNET_GENESIS_BLOCK_ID = "00000000000000001ebf88508a03865c71d452e25f4d51194196a1d22b6653dc";
+export function validateRpcUrl(value, label) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch (error) {
+        throw new AgentWalletError("rpc_not_configured", `${label} RPC URL is invalid`, {
+            cause: error,
+        });
+    }
+    const local = ["localhost", "127.0.0.1", "::1"].includes(url.hostname);
+    if ((!local && url.protocol !== "https:") ||
+        (local && !["http:", "https:"].includes(url.protocol)) ||
+        url.username ||
+        url.password ||
+        url.hash) {
+        throw new AgentWalletError("rpc_not_configured", `${label} RPC URL must be credential-free HTTPS (HTTP is allowed only for localhost)`);
+    }
+    return url.toString();
+}
+export async function jsonRpc(endpoint, method, params) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 15_000);
+    try {
+        const response = await fetch(endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
+            redirect: "error",
+            signal: controller.signal,
+        });
+        const text = await response.text();
+        if (!response.ok || text.length > 1024 * 1024) {
+            throw new Error(`RPC returned HTTP ${response.status}`);
+        }
+        const body = JSON.parse(text);
+        if (typeof body !== "object" || body === null || !("result" in body)) {
+            throw new Error("RPC response has no result");
+        }
+        return body.result;
+    }
+    catch (error) {
+        throw new AgentWalletError("rpc_unavailable", `${method} RPC request failed`, {
+            retryable: true,
+            cause: error,
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function hexQuantity(value, field) {
+    if (typeof value !== "string" || !/^0x(?:0|[1-9a-f][0-9a-f]*)$/i.test(value)) {
+        throw new AgentWalletError("rpc_unavailable", `${field} is not a canonical hex quantity`);
+    }
+    return BigInt(value);
+}
+async function baseBalance(endpoint, address) {
+    const paddedAddress = address.toLowerCase().replace(/^0x/, "").padStart(64, "0");
+    const [chainId, native, token] = await Promise.all([
+        jsonRpc(endpoint, "eth_chainId", []),
+        jsonRpc(endpoint, "eth_getBalance", [address, "latest"]),
+        jsonRpc(endpoint, "eth_call", [
+            {
+                to: BASE_USDC_MAINNET_CONTRACT,
+                data: `0x70a08231${paddedAddress}`,
+            },
+            "latest",
+        ]),
+    ]);
+    if (chainId !== "0x2105") {
+        throw new AgentWalletError("unsupported_network", "Base RPC is not chain ID 8453");
+    }
+    return {
+        version: 1,
+        network: "eip155:8453",
+        address,
+        asset: BASE_USDC_MAINNET_CONTRACT,
+        assetSymbol: "USDC",
+        assetAtomic: hexQuantity(token, "USDC balance").toString(),
+        nativeSymbol: "ETH",
+        nativeAtomic: hexQuantity(native, "ETH balance").toString(),
+        checkedAt: new Date().toISOString(),
+    };
+}
+async function solanaBalance(endpoint, address) {
+    const [genesisHash, nativeResult, tokenResult] = await Promise.all([
+        jsonRpc(endpoint, "getGenesisHash", []),
+        jsonRpc(endpoint, "getBalance", [address, { commitment: "confirmed" }]),
+        jsonRpc(endpoint, "getTokenAccountsByOwner", [
+            address,
+            { mint: SOLANA_USDT_MAINNET_MINT },
+            { encoding: "jsonParsed", commitment: "confirmed" },
+        ]),
+    ]);
+    if (genesisHash !== SOLANA_MAINNET_GENESIS_HASH) {
+        throw new AgentWalletError("unsupported_network", "Solana RPC is not Mainnet Beta");
+    }
+    const native = typeof nativeResult === "object" &&
+        nativeResult !== null &&
+        "value" in nativeResult &&
+        typeof nativeResult.value === "number" &&
+        Number.isSafeInteger(nativeResult.value)
+        ? BigInt(nativeResult.value)
+        : null;
+    if (native === null) {
+        throw new AgentWalletError("rpc_unavailable", "Solana RPC returned an invalid SOL balance");
+    }
+    const accounts = typeof tokenResult === "object" &&
+        tokenResult !== null &&
+        "value" in tokenResult &&
+        Array.isArray(tokenResult.value)
+        ? tokenResult.value
+        : null;
+    if (accounts === null) {
+        throw new AgentWalletError("rpc_unavailable", "Solana RPC returned invalid token accounts");
+    }
+    let asset = 0n;
+    for (const account of accounts) {
+        const amount = typeof account === "object" &&
+            account !== null &&
+            "account" in account &&
+            typeof account.account === "object" &&
+            account.account !== null &&
+            "data" in account.account &&
+            typeof account.account.data === "object" &&
+            account.account.data !== null &&
+            "parsed" in account.account.data &&
+            typeof account.account.data.parsed === "object" &&
+            account.account.data.parsed !== null &&
+            "info" in account.account.data.parsed &&
+            typeof account.account.data.parsed.info === "object" &&
+            account.account.data.parsed.info !== null &&
+            "tokenAmount" in account.account.data.parsed.info &&
+            typeof account.account.data.parsed.info.tokenAmount === "object" &&
+            account.account.data.parsed.info.tokenAmount !== null &&
+            "amount" in account.account.data.parsed.info.tokenAmount
+            ? account.account.data.parsed.info.tokenAmount.amount
+            : null;
+        if (typeof amount !== "string" || !/^(?:0|[1-9][0-9]*)$/.test(amount)) {
+            throw new AgentWalletError("rpc_unavailable", "Solana token amount is malformed");
+        }
+        asset += BigInt(amount);
+    }
+    return {
+        version: 1,
+        network: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+        address,
+        asset: SOLANA_USDT_MAINNET_MINT,
+        assetSymbol: "USDT",
+        assetAtomic: asset.toString(),
+        nativeSymbol: "SOL",
+        nativeAtomic: native.toString(),
+        checkedAt: new Date().toISOString(),
+    };
+}
+function bigintString(value, field) {
+    try {
+        if (typeof value === "bigint")
+            return value.toString();
+        if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0) {
+            return String(value);
+        }
+        if (typeof value === "string" && /^(?:0|[1-9][0-9]*)$/.test(value))
+            return value;
+        if (typeof value === "object" && value !== null && "toString" in value) {
+            const result = String(value);
+            if (/^(?:0|[1-9][0-9]*)$/.test(result))
+                return result;
+        }
+    }
+    catch {
+        // Normalize to one stable error below.
+    }
+    throw new AgentWalletError("rpc_unavailable", `${field} is malformed`);
+}
+export async function verifyTronMainnetRpc(endpoint) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 15_000);
+    try {
+        const base = endpoint.endsWith("/") ? endpoint : `${endpoint}/`;
+        const response = await fetch(new URL("wallet/getblockbynum", base), {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ num: 0 }),
+            redirect: "error",
+            signal: controller.signal,
+        });
+        const text = await response.text();
+        if (!response.ok || text.length > 2 * 1024 * 1024) {
+            throw new Error(`TRON RPC returned HTTP ${response.status}`);
+        }
+        const body = JSON.parse(text);
+        if (typeof body !== "object" ||
+            body === null ||
+            !("blockID" in body) ||
+            body.blockID !== TRON_MAINNET_GENESIS_BLOCK_ID) {
+            throw new AgentWalletError("unsupported_network", "TRON RPC genesis block is not Mainnet");
+        }
+    }
+    catch (error) {
+        if (error instanceof AgentWalletError)
+            throw error;
+        throw new AgentWalletError("rpc_unavailable", "TRON genesis check failed", {
+            retryable: true,
+            cause: error,
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function tronBalance(endpoint, address) {
+    try {
+        await verifyTronMainnetRpc(endpoint);
+        const tronWeb = new TronWeb({ fullHost: endpoint });
+        const [native, contract, resources] = await Promise.all([
+            tronWeb.trx.getBalance(address),
+            tronWeb.contract().at(TRON_USDT_MAINNET_CONTRACT),
+            tronWeb.trx.getAccountResources(address),
+        ]);
+        const token = await contract.balanceOf(address).call();
+        const resourceRecord = resources;
+        const energyLimit = BigInt(bigintString(resourceRecord.EnergyLimit ?? 0, "TRON energy limit"));
+        const energyUsed = BigInt(bigintString(resourceRecord.EnergyUsed ?? 0, "TRON energy used"));
+        const bandwidthLimit = BigInt(bigintString(resourceRecord.freeNetLimit ?? 0, "TRON bandwidth limit")) +
+            BigInt(bigintString(resourceRecord.NetLimit ?? 0, "TRON staked bandwidth limit"));
+        const bandwidthUsed = BigInt(bigintString(resourceRecord.freeNetUsed ?? 0, "TRON bandwidth used")) +
+            BigInt(bigintString(resourceRecord.NetUsed ?? 0, "TRON staked bandwidth used"));
+        return {
+            version: 1,
+            network: "tron:mainnet",
+            address,
+            asset: TRON_USDT_MAINNET_CONTRACT,
+            assetSymbol: "USDT",
+            assetAtomic: bigintString(token, "TRON USDT balance"),
+            nativeSymbol: "TRX",
+            nativeAtomic: bigintString(native, "TRX balance"),
+            feeResources: {
+                energyAvailable: (energyLimit > energyUsed ? energyLimit - energyUsed : 0n).toString(),
+                bandwidthAvailable: (bandwidthLimit > bandwidthUsed ? bandwidthLimit - bandwidthUsed : 0n).toString(),
+            },
+            checkedAt: new Date().toISOString(),
+        };
+    }
+    catch (error) {
+        if (error instanceof AgentWalletError)
+            throw error;
+        throw new AgentWalletError("rpc_unavailable", "TRON balance request failed", {
+            retryable: true,
+            cause: error,
+        });
+    }
+}
+export async function readWalletBalance(options) {
+    if (options.network === "eip155:8453") {
+        if (!options.rpc.base)
+            throw new AgentWalletError("rpc_not_configured", "Base RPC is required");
+        return baseBalance(validateRpcUrl(options.rpc.base, "Base"), options.address);
+    }
+    if (options.network === "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp") {
+        if (!options.rpc.solana) {
+            throw new AgentWalletError("rpc_not_configured", "Solana RPC is required");
+        }
+        return solanaBalance(validateRpcUrl(options.rpc.solana, "Solana"), options.address);
+    }
+    if (!options.rpc.tron)
+        throw new AgentWalletError("rpc_not_configured", "TRON RPC is required");
+    return tronBalance(validateRpcUrl(options.rpc.tron, "TRON"), options.address);
+}
+//# sourceMappingURL=balances.js.map

package/dist/balances.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+export declare const ERROR_CODES: readonly ["invalid_input", "wallet_not_found", "wallet_exists", "wallet_locked", "wallet_storage_unsafe", "password_required", "insufficient_asset_balance", "insufficient_network_fee_resources", "unsupported_network", "unsupported_asset", "unsupported_profile", "request_binding_mismatch", "payment_limit_exceeded", "attempt_already_exists", "attempt_not_found", "attempt_ambiguous", "challenge_expired", "rpc_not_configured", "rpc_unavailable", "notification_not_configured", "notification_unavailable", "payment_artifact_corrupt", "operator_confirmation_required", "operation_not_supported"];
+export type AgentWalletErrorCode = (typeof ERROR_CODES)[number];
+export declare class AgentWalletError extends Error {
+    readonly code: AgentWalletErrorCode;
+    readonly retryable: boolean;
+    readonly exitCode: number;
+    readonly details?: Record<string, unknown>;
+    constructor(code: AgentWalletErrorCode, message: string, options?: {
+        retryable?: boolean;
+        details?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+export declare function asAgentWalletError(error: unknown): AgentWalletError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,mlBAyBd,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AA6BhE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;CAST;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAOnE"}

package/dist/errors.js

@@ -0,0 +1,73 @@
+export const ERROR_CODES = [
+    "invalid_input",
+    "wallet_not_found",
+    "wallet_exists",
+    "wallet_locked",
+    "wallet_storage_unsafe",
+    "password_required",
+    "insufficient_asset_balance",
+    "insufficient_network_fee_resources",
+    "unsupported_network",
+    "unsupported_asset",
+    "unsupported_profile",
+    "request_binding_mismatch",
+    "payment_limit_exceeded",
+    "attempt_already_exists",
+    "attempt_not_found",
+    "attempt_ambiguous",
+    "challenge_expired",
+    "rpc_not_configured",
+    "rpc_unavailable",
+    "notification_not_configured",
+    "notification_unavailable",
+    "payment_artifact_corrupt",
+    "operator_confirmation_required",
+    "operation_not_supported",
+];
+const EXIT_CODES = {
+    invalid_input: 2,
+    wallet_not_found: 10,
+    wallet_exists: 11,
+    wallet_locked: 12,
+    wallet_storage_unsafe: 13,
+    password_required: 14,
+    insufficient_asset_balance: 20,
+    insufficient_network_fee_resources: 21,
+    unsupported_network: 30,
+    unsupported_asset: 31,
+    unsupported_profile: 32,
+    request_binding_mismatch: 33,
+    payment_limit_exceeded: 34,
+    attempt_already_exists: 40,
+    attempt_not_found: 41,
+    attempt_ambiguous: 42,
+    challenge_expired: 43,
+    rpc_not_configured: 50,
+    rpc_unavailable: 51,
+    notification_not_configured: 52,
+    notification_unavailable: 53,
+    payment_artifact_corrupt: 60,
+    operator_confirmation_required: 70,
+    operation_not_supported: 71,
+};
+export class AgentWalletError extends Error {
+    code;
+    retryable;
+    exitCode;
+    details;
+    constructor(code, message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = "AgentWalletError";
+        this.code = code;
+        this.retryable = options.retryable ?? false;
+        this.exitCode = EXIT_CODES[code];
+        if (options.details !== undefined)
+            this.details = options.details;
+    }
+}
+export function asAgentWalletError(error) {
+    if (error instanceof AgentWalletError)
+        return error;
+    return new AgentWalletError("invalid_input", error instanceof Error ? error.message : "unexpected wallet error", { cause: error });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe;IACf,kBAAkB;IAClB,eAAe;IACf,eAAe;IACf,uBAAuB;IACvB,mBAAmB;IACnB,4BAA4B;IAC5B,oCAAoC;IACpC,qBAAqB;IACrB,mBAAmB;IACnB,qBAAqB;IACrB,0BAA0B;IAC1B,wBAAwB;IACxB,wBAAwB;IACxB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,iBAAiB;IACjB,6BAA6B;IAC7B,0BAA0B;IAC1B,0BAA0B;IAC1B,gCAAgC;IAChC,yBAAyB;CACjB,CAAC;AAIX,MAAM,UAAU,GAAyC;IACvD,aAAa,EAAE,CAAC;IAChB,gBAAgB,EAAE,EAAE;IACpB,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,qBAAqB,EAAE,EAAE;IACzB,iBAAiB,EAAE,EAAE;IACrB,0BAA0B,EAAE,EAAE;IAC9B,kCAAkC,EAAE,EAAE;IACtC,mBAAmB,EAAE,EAAE;IACvB,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,EAAE;IACvB,wBAAwB,EAAE,EAAE;IAC5B,sBAAsB,EAAE,EAAE;IAC1B,sBAAsB,EAAE,EAAE;IAC1B,iBAAiB,EAAE,EAAE;IACrB,iBAAiB,EAAE,EAAE;IACrB,iBAAiB,EAAE,EAAE;IACrB,kBAAkB,EAAE,EAAE;IACtB,eAAe,EAAE,EAAE;IACnB,2BAA2B,EAAE,EAAE;IAC/B,wBAAwB,EAAE,EAAE;IAC5B,wBAAwB,EAAE,EAAE;IAC5B,8BAA8B,EAAE,EAAE;IAClC,uBAAuB,EAAE,EAAE;CAC5B,CAAC;AAEF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,SAAS,CAAU;IACnB,QAAQ,CAAS;IACjB,OAAO,CAA2B;IAE3C,YACE,IAA0B,EAC1B,OAAe,EACf,UAII,EAAE;QAEN,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACpE,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,IAAI,gBAAgB,CACzB,eAAe,EACf,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,EAClE,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./balances.js";
+export * from "./errors.js";
+export * from "./notifications.js";
+export * from "./payment/attempt-store.js";
+export * from "./payment/authorize.js";
+export * from "./payment/contracts.js";
+export * from "./protocol/base.js";
+export * from "./protocol/external-recipient.js";
+export * from "./protocol/http.js";
+export * from "./protocol/solana.js";
+export * from "./protocol/tron.js";
+export * from "./storage/keystore.js";
+export * from "./storage/paths.js";
+export * from "./storage/private-files.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,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from "./balances.js";
+export * from "./errors.js";
+export * from "./notifications.js";
+export * from "./payment/attempt-store.js";
+export * from "./payment/authorize.js";
+export * from "./payment/contracts.js";
+export * from "./protocol/base.js";
+export * from "./protocol/external-recipient.js";
+export * from "./protocol/http.js";
+export * from "./protocol/solana.js";
+export * from "./protocol/tron.js";
+export * from "./storage/keystore.js";
+export * from "./storage/paths.js";
+export * from "./storage/private-files.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,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/notifications.d.ts

@@ -0,0 +1,71 @@
+import { type RpcConfiguration, type WalletBalance } from "./balances.js";
+import { type UnlockedWallet } from "./storage/keystore.js";
+export type RefillReason = "low_balance" | "renewal";
+export type RefillNotificationIntent = {
+    version: 1;
+    kind: "x402api.refill-notification.v1";
+    audience: string;
+    subscriptionReference: string;
+    wallet: {
+        network: string;
+        address: string;
+    };
+    balance: {
+        asset: string;
+        assetSymbol: "USDC" | "USDT";
+        currentAtomic: string;
+        targetAtomic: string;
+        refillAtomic: string;
+    };
+    renewBy: string;
+    reason: RefillReason;
+    createdAt: string;
+    expiresAt: string;
+    nonce: string;
+};
+export type SignedRefillNotification = {
+    version: 1;
+    intent: RefillNotificationIntent;
+    signature: {
+        scheme: "eip191" | "ed25519" | "tron-message-v2";
+        value: string;
+    };
+};
+export type RefillNotificationResult = {
+    version: 1;
+    status: "accepted" | "deduplicated" | "not_required";
+    notificationId?: string;
+    wallet: string;
+    network: string;
+    address: string;
+    asset: string;
+    assetSymbol: "USDC" | "USDT";
+    currentBalanceAtomic: string;
+    targetBalanceAtomic: string;
+    refillAmountAtomic: string;
+    renewBy: string;
+    subscriptionReference: string;
+};
+export declare function validateNotificationUrl(value: string): string;
+export declare function createSignedRefillNotification(options: {
+    wallet: UnlockedWallet;
+    balance: WalletBalance;
+    notificationUrl: string;
+    subscriptionReference: string;
+    targetBalanceAtomic: string;
+    renewBy: string;
+    reason: RefillReason;
+    now?: number;
+}): Promise<SignedRefillNotification>;
+export declare function requestRefillNotification(options: {
+    walletsDirectory: string;
+    wallet: string;
+    passphrase: string;
+    rpc: RpcConfiguration;
+    notificationUrl: string;
+    subscriptionReference: string;
+    targetBalanceAtomic: string;
+    renewBy: string;
+    reason: RefillReason;
+}): Promise<RefillNotificationResult>;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAMA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAG7F,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE1E,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;AAErD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,gCAAgC,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,EAAE;QACT,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,iBAAiB,CAAC;QACjD,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,cAAc,CAAC;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAMF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA0B7D;AA0BD,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA2EpC;AA0BD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,gBAAgB,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA8EpC"}