@vapi-network/core 0.3.0 → 0.7.0

package/dist/wallet-store.d.ts

@@ -1,9 +1,38 @@
 import { z } from "zod";
+import { type AuditRecord } from "./audit.js";
 import { type SpendCaps } from "./config.js";
 import { type VapiPaymentAccount } from "./keystore.js";
+import { type SecretStore } from "./secret-store.js";
+import { type PassphraseResolver } from "./vault-migrate.js";
 import { type WalletName } from "./wallet-name.js";
 export { DEFAULT_WALLET_NAME, isWalletName, walletNameSchema, WALLET_NAME_PATTERN, type WalletName, } from "./wallet-name.js";
-/** What `wallets.json` records about one wallet. The keys live in its keystore. */
+export type AgentLink = {
+    apiBase: string;
+    clientId: string;
+    owner: `0x${string}`;
+    label: string;
+    scopes: string[];
+    linkedAt: string;
+    routerBaseUrl?: string;
+};
+export declare const ROUTER_TOPUP_TIERS: readonly [1, 5, 20, 50];
+export type RouterTopupTier = (typeof ROUTER_TOPUP_TIERS)[number];
+export type RouterRefill = {
+    belowUsd: number;
+    tierUsd: RouterTopupTier;
+};
+declare const ceilingSweepPendingSchema: z.ZodObject<{
+    owner: z.ZodString;
+    amountAtomic: z.ZodString;
+    nonce: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    status: z.ZodEnum<{
+        unknown: "unknown";
+        planned: "planned";
+    }>;
+}, z.core.$strict>;
+export type WalletCeilingSweepPending = z.infer<typeof ceilingSweepPendingSchema>;
+/** What `wallets.json` records about one wallet. Keys live in the vault or a legacy keystore. */
 export declare const walletEntrySchema: z.ZodObject<{
     createdAt: z.ZodISODateTime;
     label: z.ZodOptional<z.ZodString>;
@@ -11,6 +40,20 @@ export declare const walletEntrySchema: z.ZodObject<{
         perCallAtomic: z.ZodString;
         perDayAtomic: z.ZodString;
     }, z.core.$strip>;
+    ceilingAtomic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ceilingSweepAttemptedAt: z.ZodOptional<z.ZodISODateTime>;
+    ceilingSweepPending: z.ZodOptional<z.ZodObject<{
+        owner: z.ZodString;
+        amountAtomic: z.ZodString;
+        nonce: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            planned: "planned";
+        }>;
+    }, z.core.$strict>>;
+    routerRefill: z.ZodOptional<z.ZodType<RouterRefill, unknown, z.core.$ZodTypeInternals<RouterRefill, unknown>>>;
+    link: z.ZodOptional<z.ZodType<AgentLink, unknown, z.core.$ZodTypeInternals<AgentLink, unknown>>>;
 }, z.core.$strip>;
 export declare const walletRegistrySchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
@@ -22,10 +65,28 @@ export declare const walletRegistrySchema: z.ZodObject<{
             perCallAtomic: z.ZodString;
             perDayAtomic: z.ZodString;
         }, z.core.$strip>;
+        ceilingAtomic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        ceilingSweepAttemptedAt: z.ZodOptional<z.ZodISODateTime>;
+        ceilingSweepPending: z.ZodOptional<z.ZodObject<{
+            owner: z.ZodString;
+            amountAtomic: z.ZodString;
+            nonce: z.ZodString;
+            createdAt: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                planned: "planned";
+            }>;
+        }, z.core.$strict>>;
+        routerRefill: z.ZodOptional<z.ZodType<RouterRefill, unknown, z.core.$ZodTypeInternals<RouterRefill, unknown>>>;
+        link: z.ZodOptional<z.ZodType<AgentLink, unknown, z.core.$ZodTypeInternals<AgentLink, unknown>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type WalletEntry = z.infer<typeof walletEntrySchema>;
 export type WalletRegistry = z.infer<typeof walletRegistrySchema>;
+export type WalletCeilingCaps = {
+    ceilingAtomic: bigint | null;
+    effectiveCeilingAtomic: bigint | null;
+};
 /** How a caller names the wallet it wants; every field is optional. */
 export type WalletSelection = {
     /** An explicit name, from `--wallet` or an MCP argument. */
@@ -49,7 +110,7 @@ export type WalletInfo = ResolvedWallet & {
 };
 export type CreatedWallet = ResolvedWallet & {
     account: VapiPaymentAccount;
-    recoveryPhrase: string;
+    recoveryPhrase?: string;
 };
 export type ImportedWallet = ResolvedWallet & {
     account: VapiPaymentAccount;
@@ -65,24 +126,34 @@ export type WalletBalanceReader = (address: string) => Promise<bigint>;
 export type WalletStoreOptions = {
     /** Injected clock, so `createdAt` is deterministic in tests. */
     now?: () => Date;
+    /** OS secret store holding the device vault key and optional legacy passphrases. */
+    secrets?: SecretStore;
+    /** Environment used for vault and legacy-keystore passwords. */
+    env?: NodeJS.ProcessEnv;
+    /** Resolves a 0.5 keystore passphrase without prompting. */
+    resolvePassphrase?: PassphraseResolver;
+    /** Writes migration audit records. */
+    audit?: (record: AuditRecord) => Promise<unknown>;
 };
 export type LayoutMigration = {
     moved: boolean;
     from?: string;
     to?: string;
 };
+export declare const VAULT_LOCKED_MESSAGE = "The vault is locked. Run vapi vault unlock, or set VAPI_VAULT_PASSWORD.";
 /**
- * The wallets on this machine: one registry file, one keystore per wallet, and
- * the rules for picking the wallet a command acts on. Keys never leave the
- * keystore files; the store only moves, names and caps them.
+ * The wallets on this machine: a vault of keys, a registry of settings, and the
+ * rules for picking the wallet a command acts on.
  *
  * Layout under the config home (`~/.vapi`, or `VAPI_HOME`):
  *
  * ```
+ * vault.json            encrypted device vault and named accounts
  * wallets.json          registry: default wallet, per-wallet caps and labels
- * wallets/<name>.json   one keystore per wallet, mode 0600
- * wallets/.trash/       removed wallets, kept encrypted, never auto-deleted
- * keystore.json         symlink to wallets/main.json after the 0.2.x migration
+ * wallets/<name>.json   0.5 keystores awaiting migration
+ * wallets.migrated/     migrated 0.5 keystores, retained as encrypted backups
+ * wallets/.trash/       removed accounts and their registry sidecars
+ * audit.log             append-only local audit trail
  * ```
  */
 export declare class WalletStore {
@@ -90,13 +161,20 @@ export declare class WalletStore {
     readonly home: string;
     private readonly options;
     private registry;
+    private readonly secrets;
+    private readonly environment;
+    private readonly passphraseResolver;
+    private readonly audit;
+    private cachedVault;
+    private vaultKey;
+    private balanceProbe;
     private constructor();
     /** Opens the store, migrating a 0.2.x single-keystore home on the way. */
     static open(home?: string, options?: WalletStoreOptions): Promise<WalletStore>;
     get registryPath(): string;
     get walletsDirectory(): string;
     get trashDirectory(): string;
-    /** The keystore path of a wallet, whether or not it exists yet. */
+    /** The legacy 0.5 keystore path of a wallet, whether or not it exists. */
     pathFor(name: string): string;
     /** The names this machine knows, in registry order. */
     names(): WalletName[];
@@ -106,9 +184,11 @@ export declare class WalletStore {
     hasRegistry(): boolean;
     entry(name: string): WalletEntry | undefined;
     has(name: string): boolean;
+    /** True only when the device vault currently contains an account with this name. */
+    hasVaultAccount(name: string): Promise<boolean>;
     /** A copy of the registry as it was last read or written. */
     snapshot(): WalletRegistry;
-    /** Re-reads `wallets.json` from disk. */
+    /** Re-reads `wallets.json` from disk and drops the process-local vault cache. */
     reload(): Promise<WalletRegistry>;
     /**
      * Picks the wallet a command acts on: an explicit name first, then
@@ -120,37 +200,62 @@ export declare class WalletStore {
     /** The stored Base address of a wallet, without its passphrase. */
     readAddress(name: string): Promise<string | undefined>;
     /**
-     * Creates a wallet from a fresh or supplied recovery phrase. The first wallet
-     * on a machine also becomes the default. The phrase is returned once and is
-     * never written anywhere but the encrypted keystore.
+     * Creates a vault account from a fresh or supplied recovery phrase. The first
+     * wallet on a machine also becomes the default. `passphrase` and
+     * `enableSolana` are accepted and ignored for one release. Every derived
+     * account returns the vault's shared phrase to preserve this method's public
+     * contract; callers decide whether their current flow may display it.
      */
     create(name: string, passphrase: string, options?: {
         phrase?: string;
         enableSolana?: boolean;
         label?: string;
         spendCaps?: SpendCaps;
-    }): Promise<CreatedWallet>;
-    /** Wraps a private key the user already holds in a new named wallet. */
+    }): Promise<CreatedWallet & {
+        recoveryPhrase: string;
+    }>;
+    /** Imports a private key into the vault. `passphrase` is ignored for one release. */
     importKey(name: string, passphrase: string, privateKey: string, options?: {
         label?: string;
         spendCaps?: SpendCaps;
     }): Promise<ImportedWallet>;
-    /** Opens one wallet's keystore with its passphrase. */
+    /** Returns one wallet's vault signer, migrating its legacy keystore if needed. */
     unlock(name: string, passphrase: string): Promise<VapiPaymentAccount>;
     setDefault(name: string): Promise<WalletRegistry>;
     setSpendCaps(name: string, caps: SpendCaps): Promise<WalletEntry>;
+    /** Stores an explicit atomic ceiling, or null to disable automatic sweeps. */
+    setCeiling(name: string, ceilingAtomic: bigint | null): Promise<WalletEntry>;
+    /** Updates a ceiling from the latest value while holding the registry write lock. */
+    updateCeiling(name: string, update: (current: bigint | null) => bigint | null): Promise<WalletEntry>;
+    /** Reads the configured ceiling and the per-day-cap floor for one wallet. */
+    ceilingCaps(name: string): WalletCeilingCaps;
+    /**
+     * Atomically claims the ten-minute sweep window. The timestamp is written
+     * before authorization work, so failed attempts consume the window too.
+     */
+    claimCeilingSweepAttempt(name: string, now: Date, guardMs?: number): Promise<boolean>;
+    /** Reads the durable authorization plan used to resume an uncertain sweep. */
+    ceilingSweepPending(name: string): WalletCeilingSweepPending | undefined;
+    /** Updates an uncertain sweep from the latest registry value under its lock. */
+    updateCeilingSweepPending(name: string, update: (current: Readonly<WalletCeilingSweepPending> | undefined) => WalletCeilingSweepPending | undefined): Promise<WalletCeilingSweepPending | undefined>;
+    /** Updates spend caps from the latest registry value while holding its write lock. */
+    updateSpendCaps(name: string, update: (current: Readonly<SpendCaps>) => SpendCaps): Promise<WalletEntry>;
+    setRouterRefill(name: string, refill: RouterRefill | null): Promise<WalletEntry>;
     /** Sets or, with `undefined`, clears the human label of a wallet. */
     setLabel(name: string, label: string | undefined): Promise<WalletEntry>;
+    setLink(name: WalletName, link: AgentLink): Promise<WalletEntry>;
+    clearLink(name: WalletName): Promise<WalletEntry>;
     /**
-     * Renames a wallet everywhere its name is recorded: the keystore file, the
-     * registry, and the wallet field of its receipts. The keystore contents are
-     * moved untouched.
+     * Renames a wallet everywhere its name is recorded: the vault or legacy
+     * keystore, the registry, and the wallet field of its receipts.
      */
-    rename(oldName: string, newName: string): Promise<ResolvedWallet>;
+    rename(oldName: string, newName: string, options?: {
+        secrets?: SecretStore;
+    }): Promise<ResolvedWallet>;
     /**
-     * Moves a wallet's keystore to `wallets/.trash/`. Nothing is deleted: the
-     * encrypted file stays, and its passphrase still opens it. The default wallet
-     * and a wallet that still holds USDC are refused unless forced.
+     * Moves a wallet's encrypted vault record or legacy keystore to
+     * `wallets/.trash/`. The default wallet and a wallet that still holds USDC
+     * are refused unless forced.
      *
      * `allowDefault` exists for one caller: `vapi import --replace`, which puts a
      * new wallet under the same name back in place immediately afterwards, so the
@@ -167,20 +272,19 @@ export declare class WalletStore {
     listTrash(): Promise<TrashedWallet[]>;
     /**
      * Moves a 0.2.x home into the wallet layout, once: `keystore.json` becomes
-     * `wallets/main.json` and `keystore.json` stays behind as a symlink for one
-     * release, so scripts and 0.2.x callers keep working. The keystore contents
-     * are never rewritten, and a home without a keystore migrates nothing.
+     * `wallets/main.json`, ready for vault migration. The keystore contents are
+     * never rewritten, and a home without a keystore migrates nothing.
      */
     migrateLegacyLayout(): Promise<LayoutMigration>;
     private now;
     private newEntry;
     private prepareNewWallet;
     private registerWallet;
-    /**
-     * Keeps the compatibility symlink honest: when the wallet it points at moves,
-     * the link follows it, and when that wallet is removed, the link goes too.
-     */
-    private retargetLegacyKeystoreLink;
+    private get vaultPath();
+    private readVaultUnlocked;
+    private registerMissingVaultAccounts;
+    private openVault;
+    private dropVaultCache;
     private update;
     private readRegistry;
     private writeRegistry;
@@ -190,6 +294,12 @@ export declare class WalletStore {
  * registry yet — the legacy `config.spendCaps`, and otherwise the defaults.
  */
 export declare function spendCapsForWallet(store: WalletStore, name?: WalletName): Promise<SpendCaps>;
+/** Formats atomic USDC without floating point for JSON-facing cap objects. */
+export declare function formatCeilingUsd(ceilingAtomic: bigint | null): string;
+/** The JSON fragment used by account and caps output. */
+export declare function ceilingCapsJson(caps: Pick<WalletCeilingCaps, "ceilingAtomic">): {
+    ceilingUsd: string;
+};
 /** Rejects anything that is not a wallet name, including path traversal. */
 export declare function assertWalletName(value: string): WalletName;
 //# sourceMappingURL=wallet-store.d.ts.map

package/dist/wallet-store.d.ts.map

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

package/dist/x402-networks.d.ts

@@ -1,20 +1,13 @@
 import { type Address } from "viem";
 export declare const BASE_MAINNET_CAIP2: "eip155:8453";
+export declare const ARC_MAINNET_CAIP2: "eip155:5042";
 export declare const ARC_TESTNET_CAIP2: "eip155:5042002";
-/**
- * Arc mainnet is not yet published by Arc or the x402 packages. Keep this
- * non-routable placeholder so callers do not mistake viem's reserved chain ID
- * for a usable x402 network.
- *
- * TODO: replace only after Arc publishes a mainnet RPC and canonical USDC.
- */
-export declare const ARC_MAINNET_CAIP2_PLACEHOLDER: null;
 /** Full Solana mainnet genesis hash requested by the persisted vAPI config. */
 export declare const SOLANA_MAINNET_CAIP2: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
 /** CAIP-2 identifier emitted by the x402 reference packages. */
 export declare const X402_SOLANA_MAINNET_CAIP2: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
 export declare const SOLANA_MAINNET_USDC: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
-export type CanonicalX402UsdcNetwork = typeof BASE_MAINNET_CAIP2 | typeof ARC_TESTNET_CAIP2;
+export type CanonicalX402UsdcNetwork = typeof BASE_MAINNET_CAIP2 | typeof ARC_MAINNET_CAIP2 | typeof ARC_TESTNET_CAIP2;
 export type X402TokenDomain = Readonly<{
     name: string;
     version: string;
@@ -35,6 +28,10 @@ export declare const CANONICAL_X402_USDC_NETWORKS: Readonly<{
         usdc: Address;
         eip712Domain: X402TokenDomain;
     }>;
+    "eip155:5042": Readonly<{
+        usdc: Address;
+        eip712Domain: X402TokenDomain;
+    }>;
     "eip155:5042002": Readonly<{
         usdc: Address;
         eip712Domain: X402TokenDomain;

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

@@ -1 +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;AAC3D;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,EAAE,IAAW,CAAC;AAExD,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAG,qDAA8D,CAAC;AACnG,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,EAAG,yCAAkD,CAAC;AAC5F,eAAO,MAAM,mBAAmB,EAAG,8CAAuD,CAAC;AAE3F,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,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC,CAAC,CACH,CACF,CAAC;AAqBF,qFAAqF;AACrF,eAAO,MAAM,4BAA4B;;cApCjC,OAAO;sBACC,eAAe;;;cADvB,OAAO;sBACC,eAAe;;EAsCmD,CAAC;AAEnF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAK3F;AAUD,8EAA8E;AAC9E,eAAO,MAAM,mCAAmC,EAAE,iBAGhD,CAAC"}
+{"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,aAAsB,CAAC;AACxD,eAAO,MAAM,iBAAiB,EAAG,gBAAyB,CAAC;AAE3D,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAG,qDAA8D,CAAC;AACnG,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,EAAG,yCAAkD,CAAC;AAC5F,eAAO,MAAM,mBAAmB,EAAG,8CAAuD,CAAC;AAE3F,MAAM,MAAM,wBAAwB,GAClC,OAAO,kBAAkB,GAAG,OAAO,iBAAiB,GAAG,OAAO,iBAAiB,CAAC;AAElF,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,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC,CAAC,CACH,CACF,CAAC;AAyBF,qFAAqF;AACrF,eAAO,MAAM,4BAA4B;;cAxCjC,OAAO;sBACC,eAAe;;;cADvB,OAAO;sBACC,eAAe;;;cADvB,OAAO;sBACC,eAAe;;EA2CmD,CAAC;AAEnF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAK3F;AAUD,8EAA8E;AAC9E,eAAO,MAAM,mCAAmC,EAAE,iBAIhD,CAAC"}

package/dist/x402-pay.d.ts

@@ -0,0 +1,136 @@
+import { type CeilingSweepHook } from "./ceiling.js";
+import type { SpendCaps, VapiConfig } from "./config.js";
+import type { VapiPaymentAccount } from "./keystore.js";
+import { type LookupFn } from "./net-guard.js";
+import { type Receipt } from "./receipts.js";
+import type { WalletName } from "./wallet-name.js";
+import { type X402Quote, type X402SettlementOutcome } from "./x402.js";
+export type PayRequestArgs = {
+    url: string;
+    init: RequestInit;
+    account: VapiPaymentAccount;
+    wallet: WalletName;
+    caps: SpendCaps;
+    config: VapiConfig;
+    fetchImpl: typeof fetch;
+    paths?: {
+        ledgerPath?: string;
+        receiptsPath?: string;
+    };
+    maxAtomic?: bigint;
+    preferNetworks?: string[];
+    paymentId?: string;
+    now?: Date;
+    nowMs?: () => number;
+    source?: string;
+    lookup?: LookupFn;
+    /** Optional settled-call hook; omitted or false keeps payment tests and custom SDK flows inert. */
+    ceilingSweep?: CeilingSweepHook | false;
+};
+export type PayRequestResult = {
+    response: Response;
+    receipt: Receipt;
+};
+export type X402PaymentAttempt = {
+    response: Response;
+    request: Request;
+    finish(): void;
+    waitFor<T>(operation: Promise<T>, response: Response): Promise<T>;
+};
+export type X402PossibleSettlement = {
+    network: string;
+    asset: string;
+    amountAtomic: string;
+    payTo: string;
+    payer: string;
+    paymentId?: string;
+    authorizationNonce?: string;
+    authorizationExpiresAt?: string;
+    authorizationTransaction?: string;
+    receipt: unknown | null;
+};
+export type X402PaymentTrace = {
+    phases: {
+        quoteMs?: number;
+        signMs?: number;
+        requestMs?: number;
+        settleMs?: number;
+    };
+    quote?: NonNullable<Receipt["quote"]>;
+    payer?: string;
+    paymentId?: string;
+    authorization?: NonNullable<Receipt["authorization"]>;
+    settlement?: NonNullable<Receipt["settlement"]>;
+    status?: number;
+    capsApplied: boolean;
+};
+export declare class X402PaymentError extends Error {
+    readonly code: "payment_rejected" | "response_unreadable" | "settlement_unknown";
+    readonly possibleSettlement?: X402PossibleSettlement | undefined;
+    readonly name = "X402PaymentError";
+    constructor(code: "payment_rejected" | "response_unreadable" | "settlement_unknown", message: string, possibleSettlement?: X402PossibleSettlement | undefined, options?: ErrorOptions & {
+        paymentRejection?: {
+            httpStatus: number;
+            receipt: unknown;
+        };
+        confirmedSettlement?: {
+            httpStatus: number;
+            receipt: unknown;
+        };
+    });
+    readonly paymentRejection?: {
+        httpStatus: number;
+        receipt: unknown;
+    };
+    readonly confirmedSettlement?: {
+        httpStatus: number;
+        receipt: unknown;
+    };
+}
+export type CompleteX402PaymentArgs<T = undefined> = {
+    challenge: X402PaymentAttempt;
+    account: VapiPaymentAccount;
+    caps: SpendCaps;
+    config: VapiConfig;
+    send(request: Request): Promise<X402PaymentAttempt>;
+    consumeResponse?: (response: Response) => Promise<T>;
+    fetchImpl?: typeof fetch;
+    ledgerPath?: string;
+    wallet?: WalletName;
+    maxAtomic?: bigint;
+    maxPriceUsd?: number | string;
+    preferNetworks?: string[];
+    requiredNetwork?: string;
+    expectedPayTo?: string;
+    paymentId?: string;
+    now?: Date;
+    nowMs?: () => number;
+    quoteStartedMs?: number;
+    trace?: X402PaymentTrace;
+    /** Runs only after a successful, decisively settled paid result is ready. */
+    ceilingSweep?: CeilingSweepHook | false;
+};
+export type CompleteX402PaymentResult<T = undefined> = {
+    response: Response;
+    request: Request;
+    body: T | undefined;
+    quote: X402Quote;
+    payer: string;
+    paymentId?: string;
+    settlement: unknown | null;
+    settlementOutcome: X402SettlementOutcome;
+};
+/**
+ * Sends one request and, only when it receives HTTP 402, completes the exact
+ * x402 payment flow. A non-402 response is returned with a receipt that has no
+ * quote, payer, authorization, or settlement fields. The existing receipt
+ * vocabulary records a successful unpaid response as `paid`.
+ */
+export declare function payRequest(args: PayRequestArgs): Promise<PayRequestResult>;
+/**
+ * Completes an already-received HTTP 402 challenge. The transport seam keeps
+ * redirect validation and timeout ownership with the caller while this module
+ * owns quote selection, policy, signing, paid replay, and settlement handling.
+ */
+export declare function completeX402Payment<T = undefined>(args: CompleteX402PaymentArgs<T>): Promise<CompleteX402PaymentResult<T>>;
+//# sourceMappingURL=x402-pay.d.ts.map

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

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

package/dist/x402.d.ts

@@ -2,7 +2,8 @@ import { type Address, type Hex } from "viem";
 import { ExactSvmScheme } from "@x402/svm/exact/client";
 import { type X402NetworkConfig } from "./x402-networks.js";
 export type { Address, Hex } from "viem";
-export { ARC_TESTNET_CAIP2, ARC_MAINNET_CAIP2_PLACEHOLDER, BASE_MAINNET_CAIP2, BROWSER_ENABLED_X402_NETWORK_CONFIG, CANONICAL_X402_USDC_NETWORKS, SOLANA_MAINNET_CAIP2, SOLANA_MAINNET_USDC, X402_SOLANA_MAINNET_CAIP2, getCanonicalX402Usdc, type CanonicalX402UsdcIdentity, type CanonicalX402UsdcNetwork, type X402NetworkConfig, type X402TokenDomain, } from "./x402-networks.js";
+export { ARC_MAINNET_CAIP2, ARC_TESTNET_CAIP2, BASE_MAINNET_CAIP2, BROWSER_ENABLED_X402_NETWORK_CONFIG, CANONICAL_X402_USDC_NETWORKS, SOLANA_MAINNET_CAIP2, SOLANA_MAINNET_USDC, X402_SOLANA_MAINNET_CAIP2, getCanonicalX402Usdc, type CanonicalX402UsdcIdentity, type CanonicalX402UsdcNetwork, type X402NetworkConfig, type X402TokenDomain, } from "./x402-networks.js";
+export declare const VAPI_BUILDER_CODE = "vapi";
 export declare const EIP3009_AUTHORIZATION_TYPES: {
     readonly TransferWithAuthorization: readonly [{
         readonly name: "from";
@@ -119,6 +120,18 @@ 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);
 }
+/** Returns whether a value is a valid x402 payment-identifier id. */
+export declare function isValidPaymentId(value: unknown): value is string;
+/** Creates a fresh x402 payment-identifier id from 16 random bytes. */
+export declare function createPaymentId(randomBytes?: (bytes: Uint8Array<ArrayBuffer>) => void): string;
+/**
+ * Builds the extensions sent in a payment payload without mutating the
+ * server-declared extensions. A payment id is required only when the server
+ * advertised payment-identifier.
+ */
+export declare function buildPaymentExtensions(serverExtensions: Readonly<Record<string, unknown>> | undefined, options?: Readonly<{
+    paymentId?: string;
+}>): Record<string, unknown>;
 export declare function parse402Challenge(challenge: unknown, configuredNetworks: X402NetworkConfig, fallbackResourceUrl?: string, requiredNetwork?: string, expectedPayTo?: string): X402Quote;
 /**
  * Drop a response body without waiting. Awaiting cancel() on a body that has
@@ -126,6 +139,8 @@ export declare function parse402Challenge(challenge: unknown, configuredNetworks
  * callers that only want to discard the bytes must not block on it.
  */
 export declare function discardBody(response: Response | null | undefined): void;
+/** Decodes a `PAYMENT-REQUIRED` header: base64 of the JSON payment offer. Throws when it is not. */
+export declare function decodePaymentRequiredHeader(value: string): unknown;
 export declare function parse402Response(response: Response, configuredNetworks: X402NetworkConfig, requiredNetwork?: string, expectedPayTo?: string): Promise<X402Quote>;
 export declare function buildEip3009TypedData(args: {
     from: Address;
@@ -142,9 +157,11 @@ export declare function buildX402Payment(args: {
     nowSeconds?: number;
     nonce?: Hex;
     fetchImpl?: typeof fetch;
+    paymentId?: string;
 }): Promise<{
     payload: X402PaymentPayload;
     headers: X402PaymentHeaders;
+    paymentId?: string;
 }>;
 /** Adds the older X-PAYMENT header while keeping PAYMENT-SIGNATURE canonical. */
 export declare function buildCompatibleX402Payment(args: {
@@ -153,9 +170,11 @@ export declare function buildCompatibleX402Payment(args: {
     nowSeconds?: number;
     nonce?: Hex;
     fetchImpl?: typeof fetch;
+    paymentId?: string;
 }): Promise<{
     payload: X402PaymentPayload;
     headers: X402CompatiblePaymentHeaders;
+    paymentId?: string;
 }>;
 export declare function assertMaxPrice(amountAtomic: bigint, maxPriceUsd: number | string | undefined): void;
 export declare function usdToAtomic(value: number | string): bigint;

package/dist/x402.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vapi-network/core",
-  "version": "0.3.0",
+  "version": "0.7.0",
   "description": "Non-custodial x402 protocol, wallet policy, discovery, and receipts core",
   "license": "Apache-2.0",
   "repository": {
@@ -26,6 +26,26 @@
     "./secrets": {
       "types": "./dist/secrets.d.ts",
       "import": "./dist/secrets.js"
+    },
+    "./backup": {
+      "types": "./dist/backup.d.ts",
+      "import": "./dist/backup.js"
+    },
+    "./cloud-backup": {
+      "types": "./dist/cloud-backup.d.ts",
+      "import": "./dist/cloud-backup.js"
+    },
+    "./api-key": {
+      "types": "./dist/api-key.d.ts",
+      "import": "./dist/api-key.js"
+    },
+    "./agent-link": {
+      "types": "./dist/agent-link.d.ts",
+      "import": "./dist/agent-link.js"
+    },
+    "./router-client": {
+      "types": "./dist/router-client.d.ts",
+      "import": "./dist/router-client.js"
     }
   },
   "dependencies": {},