@vapi-network/core 0.2.0-dev.2

package/dist/policy.d.ts

@@ -0,0 +1,24 @@
+import type { Address } from "viem";
+import type { SpendCaps } from "./config.js";
+import { type SpendLedger } from "./spend-policy.js";
+export type PaymentIntent = Readonly<{
+    amountAtomic: bigint;
+    network: string;
+    payTo: Address;
+    resourceUrl?: string;
+}>;
+/** A payment policy is always evaluated before a signature is requested. */
+export interface Policy {
+    authorize(intent: PaymentIntent): Promise<void>;
+}
+export declare class SpendPolicy implements Policy {
+    readonly caps: SpendCaps;
+    private readonly options;
+    constructor(caps: SpendCaps, options?: {
+        ledgerPath?: string;
+        now?: () => Date;
+    });
+    authorize(intent: PaymentIntent): Promise<void>;
+    reserve(amountAtomic: bigint): Promise<SpendLedger>;
+}
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,WAAW,MAAM;IACrB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,qBAAa,WAAY,YAAW,MAAM;aAEtB,IAAI,EAAE,SAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADR,IAAI,EAAE,SAAS,EACd,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;IAGpE,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAM1D"}

package/dist/receipts.d.ts

@@ -0,0 +1,60 @@
+import type { ListingProvenance } from "./discovery.js";
+import type { X402SettlementOutcome } from "./x402.js";
+export interface Receipt {
+    readonly id: string;
+    readonly timestamp: string;
+    readonly resourceUrl: string;
+    readonly method?: string;
+    /** Primary discovery source retained for compatibility with early receipt writers. */
+    readonly source?: string;
+    readonly provenance?: readonly ListingProvenance[];
+    readonly quote?: Readonly<{
+        network: string;
+        asset: string;
+        amountAtomic: string;
+        payTo: string;
+    }>;
+    readonly payer?: string;
+    readonly settlement?: Readonly<{
+        outcome: X402SettlementOutcome;
+        transaction?: string;
+        evidence?: unknown;
+    }>;
+    readonly latencyMs?: number;
+    readonly status?: number;
+    readonly error?: Readonly<{
+        code: string;
+        message: string;
+    }>;
+    readonly phases?: Readonly<{
+        discoverMs?: number;
+        quoteMs?: number;
+        signMs?: number;
+        requestMs?: number;
+        settleMs?: number;
+    }>;
+    readonly listing?: Readonly<{
+        name?: string;
+        providerHost?: string;
+        source: string;
+    }>;
+    readonly retry?: number;
+    readonly policy?: Readonly<{
+        maxPriceUsd?: string;
+        capsApplied: boolean;
+    }>;
+    readonly client?: Readonly<{
+        name: "vapi-network";
+        version: string;
+    }>;
+    readonly outcome?: "paid" | "declined_policy" | "failed_request" | "settlement_rejected" | "settlement_unknown";
+}
+export declare function parseReceipt(value: unknown): Receipt;
+/** Append exactly one receipt as one JSONL record. Existing records are never rewritten. */
+export declare function appendReceipt(receipt: Receipt, path?: string): Promise<Receipt>;
+export declare function readReceipts(path?: string, options?: {
+    limit?: number;
+}): Promise<Receipt[]>;
+/** Compatibility alias used by early CLI code. */
+export declare const listReceipts: typeof readReceipts;
+//# sourceMappingURL=receipts.d.ts.map

package/dist/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../src/receipts.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sFAAsF;IACtF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;QAC7B,OAAO,EAAE,qBAAqB,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC,CAAC;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QACzB,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,CAAC,EACf,MAAM,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;CAChG;AA8ED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED,4FAA4F;AAC5F,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,IAAI,SAA0B,GAC7B,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,YAAY,CAChC,IAAI,SAA0B,EAC9B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CAuBpB;AAED,kDAAkD;AAClD,eAAO,MAAM,YAAY,qBAAe,CAAC"}

package/dist/searches.d.ts

@@ -0,0 +1,15 @@
+export interface SearchEvent {
+    readonly timestamp: string;
+    readonly query: string;
+    readonly sources: ReadonlyArray<Readonly<{
+        source: string;
+        latencyMs: number;
+        count: number;
+        error?: string;
+    }>>;
+    readonly mergedCount: number;
+}
+export declare function parseSearchEvent(value: unknown): SearchEvent;
+export declare function appendSearchEvent(event: SearchEvent, path?: string): Promise<SearchEvent>;
+export declare function readSearchEvents(path?: string): Promise<SearchEvent[]>;
+//# sourceMappingURL=searches.d.ts.map

package/dist/searches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searches.d.ts","sourceRoot":"","sources":["../src/searches.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAC7B,QAAQ,CAAC;QACP,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CACH,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAgBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAE5D;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,WAAW,EAClB,IAAI,SAA0B,GAC7B,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,SAA0B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAkB7F"}

package/dist/spend-policy.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { type SpendCaps } from "./config.js";
+declare const ledgerSchema: z.ZodObject<{
+    date: z.ZodString;
+    spentAtomic: z.ZodString;
+}, z.core.$strip>;
+export type SpendLedger = z.infer<typeof ledgerSchema>;
+export declare class SpendCapError extends Error {
+    readonly code: "per_call_cap_exceeded" | "per_day_cap_exceeded";
+    constructor(code: "per_call_cap_exceeded" | "per_day_cap_exceeded", message: string);
+}
+export declare function utcDateKey(now?: Date): string;
+export declare function readSpendLedger(path?: string, now?: Date): Promise<SpendLedger>;
+export declare function reserveSpend(amountAtomic: bigint, caps: SpendCaps, options?: {
+    ledgerPath?: string;
+    now?: Date;
+}): Promise<SpendLedger>;
+export {};
+//# sourceMappingURL=spend-policy.d.ts.map

package/dist/spend-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-policy.d.ts","sourceRoot":"","sources":["../src/spend-policy.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/E,QAAA,MAAM,YAAY;;;iBAGhB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD,qBAAa,aAAc,SAAQ,KAAK;aAEpB,IAAI,EAAE,uBAAuB,GAAG,sBAAsB;gBAAtD,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,EACtE,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,UAAU,CAAC,GAAG,OAAa,GAAG,MAAM,CAEnD;AAED,wBAAsB,eAAe,CACnC,IAAI,SAA6B,EACjC,GAAG,OAAa,GACf,OAAO,CAAC,WAAW,CAAC,CAYtB;AAED,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAE,GAC5C,OAAO,CAAC,WAAW,CAAC,CAgCtB"}

package/dist/stats.d.ts

@@ -0,0 +1,55 @@
+import type { Receipt } from "./receipts.js";
+import type { SearchEvent } from "./searches.js";
+export declare const STATS_RANGES: readonly ["24h", "7d", "30d"];
+export type StatsRange = (typeof STATS_RANGES)[number];
+export type LatencyPercentiles = Readonly<{
+    p50Ms: number | null;
+    p95Ms: number | null;
+}>;
+export type ReceiptOutcome = NonNullable<Receipt["outcome"]>;
+export interface StatsReport {
+    readonly range: StatsRange;
+    readonly generatedAt: string;
+    readonly totals: Readonly<{
+        spendUsd: string;
+        calls: number;
+        uniqueApis: number;
+        policyDeclines: number;
+    }>;
+    readonly outcomes: Readonly<Record<ReceiptOutcome, Readonly<{
+        count: number;
+        rate: number;
+    }>>>;
+    readonly latency: Readonly<{
+        total: LatencyPercentiles;
+        phases: Readonly<Record<"discover" | "quote" | "sign" | "request" | "settle", LatencyPercentiles>>;
+    }>;
+    readonly topServices: Readonly<{
+        bySpend: readonly ServiceStats[];
+        byCalls: readonly ServiceStats[];
+    }>;
+    readonly search: Readonly<{
+        count: number;
+        zeroResultRate: number;
+        sources: Readonly<Record<string, Readonly<{
+            count: number;
+            p95Ms: number | null;
+        }>>>;
+    }>;
+}
+export interface ServiceStats {
+    readonly name: string;
+    readonly resourceUrl: string;
+    readonly providerHost?: string;
+    readonly spendUsd: string;
+    readonly calls: number;
+}
+export declare function aggregateStats(args: {
+    receipts: readonly Receipt[];
+    searches: readonly SearchEvent[];
+    range?: StatsRange;
+    now?: Date;
+}): StatsReport;
+export declare function filterReceiptsByRange(receipts: readonly Receipt[], range: StatsRange, now?: Date): Receipt[];
+export declare function receiptsToCsv(receipts: readonly Receipt[]): string;
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,eAAO,MAAM,YAAY,+BAAgC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC;AAC1F,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAe7D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC,CAAC;IAC/F,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;QACzB,KAAK,EAAE,kBAAkB,CAAC;QAC1B,MAAM,EAAE,QAAQ,CACd,MAAM,CAAC,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,EAAE,kBAAkB,CAAC,CACjF,CAAC;KACH,CAAC,CAAC;IACH,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;QAC7B,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;QACjC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;KAClC,CAAC,CAAC;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC,CAAC,CAAC,CAAC;KACtF,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,WAAW,CAoHd;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,KAAK,EAAE,UAAU,EACjB,GAAG,OAAa,GACf,OAAO,EAAE,CAGX;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAqElE"}

package/dist/sweep.d.ts

@@ -0,0 +1,57 @@
+import { type Address } from "viem";
+import type { PrivateKeyAccount } from "viem/accounts";
+import type { AgentCashConfig } from "./config.js";
+import type { LookupFn } from "./net-guard.js";
+export declare const ERC20_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "balance";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "success";
+        readonly type: "bool";
+    }];
+}];
+export type SweepResult = {
+    network: string;
+    amountAtomic: string;
+    transaction: `0x${string}`;
+};
+export declare function calculateSweepAmount(balanceAtomic: bigint, gasHeadroomAtomic: bigint): bigint;
+export declare function getArcGasHeadroomAtomic(): bigint;
+export declare function readUsdcBalance(args: {
+    network: string;
+    configured: AgentCashConfig["networks"][string];
+    address: Address;
+    allowPrivateNetwork?: boolean;
+    fetchImpl?: typeof fetch;
+    lookup?: LookupFn;
+}): Promise<bigint>;
+export declare function sweepBack(args: {
+    account: PrivateKeyAccount;
+    config: AgentCashConfig;
+    network: string;
+    destination: Address;
+    arcGasHeadroomAtomic?: bigint;
+    fetchImpl?: typeof fetch;
+    lookup?: LookupFn;
+}): Promise<SweepResult>;
+//# sourceMappingURL=sweep.d.ts.map

package/dist/sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep.d.ts","sourceRoot":"","sources":["../src/sweep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAUnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBZ,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAK7F;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAYhD;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB,GAAG,OAAO,CAAC,WAAW,CAAC,CA4DvB"}

package/dist/wallet.d.ts

@@ -0,0 +1,28 @@
+import type { Address, Hex } from "viem";
+import type { ConfiguredNetwork } from "./networks.js";
+import type { PaymentIntent, Policy } from "./policy.js";
+import type { X402TypedData } from "./x402.js";
+export interface Signer {
+    readonly address: Address;
+    signTypedData(typedData: X402TypedData): Promise<Hex>;
+}
+/** Local wallet seam: policy authorization is explicit and precedes signing. */
+export interface Wallet extends Signer {
+    authorize(intent: PaymentIntent): Promise<void>;
+    balance(network: string, configured: ConfiguredNetwork): Promise<bigint>;
+}
+export declare class LocalWallet implements Wallet {
+    private readonly account;
+    private readonly policy;
+    readonly address: Address;
+    constructor(account: Signer, policy: Policy);
+    authorize(intent: PaymentIntent): Promise<void>;
+    signTypedData(typedData: X402TypedData): Promise<Hex>;
+    balance(network: string, configured: ConfiguredNetwork): Promise<bigint>;
+}
+export declare function openWallet(options: {
+    passphrase: string;
+    policy: Policy;
+    keystorePath?: string;
+}): Promise<Wallet>;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAIzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACvD;AAED,gFAAgF;AAChF,MAAM,WAAW,MAAO,SAAQ,MAAM;IACpC,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1E;AAED,qBAAa,WAAY,YAAW,MAAM;IAItC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAGP,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;IAK3B,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC;IAIrD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAG/E;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlB"}

package/dist/x402-networks.d.ts

@@ -0,0 +1,32 @@
+import { type Address } from "viem";
+export declare const BASE_MAINNET_CAIP2: "eip155:8453";
+export declare const ARC_TESTNET_CAIP2: "eip155:5042002";
+export type CanonicalX402UsdcNetwork = typeof BASE_MAINNET_CAIP2 | typeof ARC_TESTNET_CAIP2;
+export type X402TokenDomain = Readonly<{
+    name: string;
+    version: string;
+}>;
+export type CanonicalX402UsdcIdentity = Readonly<{
+    usdc: Address;
+    eip712Domain: X402TokenDomain;
+}>;
+export type X402NetworkConfig = Readonly<Record<string, Readonly<{
+    usdc: string;
+    enabled?: boolean;
+    eip712Domain?: X402TokenDomain;
+}>>>;
+/** Canonical token and signing-domain identity. This is not an enablement policy. */
+export declare const CANONICAL_X402_USDC_NETWORKS: Readonly<{
+    "eip155:8453": Readonly<{
+        usdc: Address;
+        eip712Domain: X402TokenDomain;
+    }>;
+    "eip155:5042002": Readonly<{
+        usdc: Address;
+        eip712Domain: X402TokenDomain;
+    }>;
+}>;
+export declare function getCanonicalX402Usdc(network: string): CanonicalX402UsdcIdentity | undefined;
+/** Networks the browser-wallet adapter is currently allowed to execute on. */
+export declare const BROWSER_ENABLED_X402_NETWORK_CONFIG: X402NetworkConfig;
+//# sourceMappingURL=x402-networks.d.ts.map

package/dist/x402-networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-networks.d.ts","sourceRoot":"","sources":["../src/x402-networks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAEhD,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAC;AACzD,eAAO,MAAM,iBAAiB,EAAG,gBAAyB,CAAC;AAE3D,MAAM,MAAM,wBAAwB,GAAG,OAAO,kBAAkB,GAAG,OAAO,iBAAiB,CAAC;AAE5F,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,eAAe,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CACtC,MAAM,CACJ,MAAM,EACN,QAAQ,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC,CAAC,CACH,CACF,CAAC;AAqBF,qFAAqF;AACrF,eAAO,MAAM,4BAA4B;;cAnCjC,OAAO;sBACC,eAAe;;;cADvB,OAAO;sBACC,eAAe;;EAqCmD,CAAC;AAEnF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAK3F;AAUD,8EAA8E;AAC9E,eAAO,MAAM,mCAAmC,EAAE,iBAGhD,CAAC"}

package/dist/x402.d.ts

@@ -0,0 +1,138 @@
+import { type Address, type Hex } from "viem";
+import { type X402NetworkConfig } from "./x402-networks.js";
+export type { Address, Hex } from "viem";
+export { ARC_TESTNET_CAIP2, BASE_MAINNET_CAIP2, BROWSER_ENABLED_X402_NETWORK_CONFIG, CANONICAL_X402_USDC_NETWORKS, getCanonicalX402Usdc, type CanonicalX402UsdcIdentity, type CanonicalX402UsdcNetwork, type X402NetworkConfig, type X402TokenDomain, } from "./x402-networks.js";
+export declare const EIP3009_AUTHORIZATION_TYPES: {
+    readonly TransferWithAuthorization: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validAfter";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validBefore";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+    }];
+};
+export type X402Resource = {
+    url: string;
+    description?: string;
+    mimeType?: string;
+    serviceName?: string;
+    tags?: string[];
+    iconUrl?: string;
+};
+export type X402PaymentRequirements = {
+    scheme: "exact";
+    network: `eip155:${number}`;
+    asset: Address;
+    amount: string;
+    payTo: Address;
+    maxTimeoutSeconds: number;
+    extra: Record<string, unknown> & {
+        name: string;
+        version: string;
+    };
+};
+export type X402Quote = {
+    x402Version: 2;
+    amountAtomic: bigint;
+    resource: X402Resource;
+    accepted: X402PaymentRequirements;
+    extensions?: Record<string, unknown>;
+};
+export type Eip3009Authorization = {
+    from: Address;
+    to: Address;
+    value: string;
+    validAfter: "0";
+    validBefore: string;
+    nonce: Hex;
+};
+export type X402TypedData = {
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: Address;
+    };
+    types: typeof EIP3009_AUTHORIZATION_TYPES;
+    primaryType: "TransferWithAuthorization";
+    message: {
+        from: Address;
+        to: Address;
+        value: bigint;
+        validAfter: 0n;
+        validBefore: bigint;
+        nonce: Hex;
+    };
+};
+export type X402Signer = {
+    address: Address;
+    signTypedData(typedData: X402TypedData): Promise<Hex>;
+};
+export type X402PaymentPayload = {
+    x402Version: 2;
+    resource: X402Resource;
+    accepted: X402PaymentRequirements;
+    payload: {
+        signature: Hex;
+        authorization: Eip3009Authorization;
+    };
+    extensions?: Record<string, unknown>;
+};
+export type X402PaymentHeaders = {
+    "PAYMENT-SIGNATURE": string;
+};
+export type X402CompatiblePaymentHeaders = X402PaymentHeaders & {
+    "X-PAYMENT": string;
+};
+export type X402SettlementOutcome = "succeeded" | "rejected" | "unknown";
+export declare class X402Error extends Error {
+    readonly code: "invalid_challenge" | "unsupported_challenge" | "max_price_exceeded";
+    constructor(code: "invalid_challenge" | "unsupported_challenge" | "max_price_exceeded", message: string, options?: ErrorOptions);
+}
+export declare function parse402Challenge(challenge: unknown, configuredNetworks: X402NetworkConfig, fallbackResourceUrl?: string, requiredNetwork?: string, expectedPayTo?: string): X402Quote;
+export declare function parse402Response(response: Response, configuredNetworks: X402NetworkConfig, requiredNetwork?: string, expectedPayTo?: string): Promise<X402Quote>;
+export declare function buildEip3009TypedData(args: {
+    from: Address;
+    quote: X402Quote;
+    nonce: Hex;
+    nowSeconds: number;
+}): {
+    authorization: Eip3009Authorization;
+    typedData: X402TypedData;
+};
+export declare function buildX402Payment(args: {
+    signer: X402Signer;
+    quote: X402Quote;
+    nowSeconds?: number;
+    nonce?: Hex;
+}): Promise<{
+    payload: X402PaymentPayload;
+    headers: X402PaymentHeaders;
+}>;
+/** Adds the older X-PAYMENT header while keeping PAYMENT-SIGNATURE canonical. */
+export declare function buildCompatibleX402Payment(args: {
+    account: X402Signer;
+    quote: X402Quote;
+    nowSeconds?: number;
+    nonce?: Hex;
+}): Promise<{
+    payload: X402PaymentPayload;
+    headers: X402CompatiblePaymentHeaders;
+}>;
+export declare function assertMaxPrice(amountAtomic: bigint, maxPriceUsd: number | string | undefined): void;
+export declare function usdToAtomic(value: number | string): bigint;
+export declare function parseSettlementResponse(headers: Headers): unknown | null;
+export declare function classifySettlement(value: unknown): X402SettlementOutcome;
+//# sourceMappingURL=x402.d.ts.map

package/dist/x402.d.ts.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@vapi-network/core",
+  "version": "0.2.0-dev.2",
+  "description": "Non-custodial x402 protocol, wallet policy, discovery, and receipts core",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vAPI-Network/vapi-network.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/vAPI-Network/vapi-network#readme",
+  "bugs": {
+    "url": "https://github.com/vAPI-Network/vapi-network/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {},
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  }
+}