@vapi-network/core 0.3.0 → 0.7.0

package/dist/call-contracts-wire.d.ts

@@ -44,8 +44,8 @@ export declare const CALLABLE_CATEGORY_LABELS: {
 export declare function isCallableListing(kind: string, category: string): boolean;
 export declare const serviceTierSchema: z.ZodEnum<{
     partner: "partner";
-    listed: "listed";
     verified: "verified";
+    listed: "listed";
 }>;
 export type ServiceTier = z.infer<typeof serviceTierSchema>;
 export declare const discoveryEndpointSchema: z.ZodObject<{
@@ -95,8 +95,8 @@ export declare const serviceSummarySchema: z.ZodObject<{
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     group: z.ZodOptional<z.ZodEnum<{
-        partner: "partner";
         vapi: "vapi";
+        partner: "partner";
         added: "added";
         external: "external";
     }>>;
@@ -104,6 +104,34 @@ export declare const serviceSummarySchema: z.ZodObject<{
         bps: z.ZodNumber;
         label: z.ZodString;
     }, z.core.$loose>>;
+    verification: z.ZodCatch<z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        requested: "requested";
+        verified: "verified";
+    }>>>;
+    liveness: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        uptime7d: z.ZodNumber;
+        latencyP50Ms: z.ZodNullable<z.ZodNumber>;
+        latencyP95Ms: z.ZodNullable<z.ZodNumber>;
+        checks7d: z.ZodNumber;
+    }, z.core.$loose>>>;
+    conformance: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        declaredVersion: z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        versionConformant: z.ZodBoolean;
+        offerTransport: z.ZodEnum<{
+            body: "body";
+            header: "header";
+            both: "both";
+        }>;
+        issues: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>>>;
+    identity: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        erc8004Id: z.ZodString;
+        reputation: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            score: z.ZodNumber;
+            count: z.ZodNumber;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
     id: z.ZodString;
     name: z.ZodString;
     description: z.ZodString;
@@ -117,8 +145,8 @@ export declare const serviceSummarySchema: z.ZodObject<{
     }>;
     tier: z.ZodEnum<{
         partner: "partner";
-        listed: "listed";
         verified: "verified";
+        listed: "listed";
     }>;
 }, z.core.$loose>;
 export type ServiceSummary = z.infer<typeof serviceSummarySchema>;
@@ -149,8 +177,8 @@ export declare const searchServicesResponseSchema: z.ZodObject<{
             }, z.core.$loose>>;
         }, z.core.$loose>>;
         group: z.ZodOptional<z.ZodEnum<{
-            partner: "partner";
             vapi: "vapi";
+            partner: "partner";
             added: "added";
             external: "external";
         }>>;
@@ -158,6 +186,34 @@ export declare const searchServicesResponseSchema: z.ZodObject<{
             bps: z.ZodNumber;
             label: z.ZodString;
         }, z.core.$loose>>;
+        verification: z.ZodCatch<z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            requested: "requested";
+            verified: "verified";
+        }>>>;
+        liveness: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            uptime7d: z.ZodNumber;
+            latencyP50Ms: z.ZodNullable<z.ZodNumber>;
+            latencyP95Ms: z.ZodNullable<z.ZodNumber>;
+            checks7d: z.ZodNumber;
+        }, z.core.$loose>>>;
+        conformance: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            declaredVersion: z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            versionConformant: z.ZodBoolean;
+            offerTransport: z.ZodEnum<{
+                body: "body";
+                header: "header";
+                both: "both";
+            }>;
+            issues: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>>>;
+        identity: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            erc8004Id: z.ZodString;
+            reputation: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                score: z.ZodNumber;
+                count: z.ZodNumber;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
         id: z.ZodString;
         name: z.ZodString;
         description: z.ZodString;
@@ -171,8 +227,8 @@ export declare const searchServicesResponseSchema: z.ZodObject<{
         }>;
         tier: z.ZodEnum<{
             partner: "partner";
-            listed: "listed";
             verified: "verified";
+            listed: "listed";
         }>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
@@ -204,8 +260,8 @@ export declare const listServicesResponseSchema: z.ZodObject<{
             }, z.core.$loose>>;
         }, z.core.$loose>>;
         group: z.ZodOptional<z.ZodEnum<{
-            partner: "partner";
             vapi: "vapi";
+            partner: "partner";
             added: "added";
             external: "external";
         }>>;
@@ -213,6 +269,34 @@ export declare const listServicesResponseSchema: z.ZodObject<{
             bps: z.ZodNumber;
             label: z.ZodString;
         }, z.core.$loose>>;
+        verification: z.ZodCatch<z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            requested: "requested";
+            verified: "verified";
+        }>>>;
+        liveness: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            uptime7d: z.ZodNumber;
+            latencyP50Ms: z.ZodNullable<z.ZodNumber>;
+            latencyP95Ms: z.ZodNullable<z.ZodNumber>;
+            checks7d: z.ZodNumber;
+        }, z.core.$loose>>>;
+        conformance: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            declaredVersion: z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            versionConformant: z.ZodBoolean;
+            offerTransport: z.ZodEnum<{
+                body: "body";
+                header: "header";
+                both: "both";
+            }>;
+            issues: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>>>;
+        identity: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            erc8004Id: z.ZodString;
+            reputation: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                score: z.ZodNumber;
+                count: z.ZodNumber;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
         id: z.ZodString;
         name: z.ZodString;
         description: z.ZodString;
@@ -226,8 +310,8 @@ export declare const listServicesResponseSchema: z.ZodObject<{
         }>;
         tier: z.ZodEnum<{
             partner: "partner";
-            listed: "listed";
             verified: "verified";
+            listed: "listed";
         }>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
@@ -258,8 +342,8 @@ export declare const discoveryServiceSchema: z.ZodObject<{
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     group: z.ZodOptional<z.ZodEnum<{
-        partner: "partner";
         vapi: "vapi";
+        partner: "partner";
         added: "added";
         external: "external";
     }>>;
@@ -267,6 +351,34 @@ export declare const discoveryServiceSchema: z.ZodObject<{
         bps: z.ZodNumber;
         label: z.ZodString;
     }, z.core.$loose>>;
+    verification: z.ZodCatch<z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        requested: "requested";
+        verified: "verified";
+    }>>>;
+    liveness: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        uptime7d: z.ZodNumber;
+        latencyP50Ms: z.ZodNullable<z.ZodNumber>;
+        latencyP95Ms: z.ZodNullable<z.ZodNumber>;
+        checks7d: z.ZodNumber;
+    }, z.core.$loose>>>;
+    conformance: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        declaredVersion: z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        versionConformant: z.ZodBoolean;
+        offerTransport: z.ZodEnum<{
+            body: "body";
+            header: "header";
+            both: "both";
+        }>;
+        issues: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>>>;
+    identity: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        erc8004Id: z.ZodString;
+        reputation: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            score: z.ZodNumber;
+            count: z.ZodNumber;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
     id: z.ZodString;
     name: z.ZodString;
     description: z.ZodString;
@@ -280,8 +392,8 @@ export declare const discoveryServiceSchema: z.ZodObject<{
     }>;
     tier: z.ZodEnum<{
         partner: "partner";
-        listed: "listed";
         verified: "verified";
+        listed: "listed";
     }>;
 }, z.core.$loose>;
 export type DiscoveryService = ServiceSummary;
@@ -312,8 +424,8 @@ export declare const discoveryResponseSchema: z.ZodObject<{
             }, z.core.$loose>>;
         }, z.core.$loose>>;
         group: z.ZodOptional<z.ZodEnum<{
-            partner: "partner";
             vapi: "vapi";
+            partner: "partner";
             added: "added";
             external: "external";
         }>>;
@@ -321,6 +433,34 @@ export declare const discoveryResponseSchema: z.ZodObject<{
             bps: z.ZodNumber;
             label: z.ZodString;
         }, z.core.$loose>>;
+        verification: z.ZodCatch<z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            requested: "requested";
+            verified: "verified";
+        }>>>;
+        liveness: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            uptime7d: z.ZodNumber;
+            latencyP50Ms: z.ZodNullable<z.ZodNumber>;
+            latencyP95Ms: z.ZodNullable<z.ZodNumber>;
+            checks7d: z.ZodNumber;
+        }, z.core.$loose>>>;
+        conformance: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            declaredVersion: z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            versionConformant: z.ZodBoolean;
+            offerTransport: z.ZodEnum<{
+                body: "body";
+                header: "header";
+                both: "both";
+            }>;
+            issues: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>>>;
+        identity: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            erc8004Id: z.ZodString;
+            reputation: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                score: z.ZodNumber;
+                count: z.ZodNumber;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
         id: z.ZodString;
         name: z.ZodString;
         description: z.ZodString;
@@ -334,8 +474,8 @@ export declare const discoveryResponseSchema: z.ZodObject<{
         }>;
         tier: z.ZodEnum<{
             partner: "partner";
-            listed: "listed";
             verified: "verified";
+            listed: "listed";
         }>;
     }, z.core.$loose>>;
 }, z.core.$loose>;

package/dist/call-contracts-wire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call-contracts-wire.d.ts","sourceRoot":"","sources":["../src/call-contracts-wire.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,aAAa,EAAG,OAAgB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,wDAAyD,CAAC;AAE1F,eAAO,MAAM,sBAAsB;;;;;;EAA8B,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAKtE,eAAO,MAAM,oBAAoB,iEAA6C,CAAC;AAC/E,eAAO,MAAM,uBAAuB;;;;;;;EAA+B,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;CAM8C,CAAC;AAIpF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED,eAAO,MAAM,iBAAiB;;;;EAA4C,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;iBAqBlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA+B,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAG9E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAuB,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAC9C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA+B,CAAC;AACpE,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"call-contracts-wire.d.ts","sourceRoot":"","sources":["../src/call-contracts-wire.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,aAAa,EAAG,OAAgB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,wDAAyD,CAAC;AAE1F,eAAO,MAAM,sBAAsB;;;;;;EAA8B,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAKtE,eAAO,MAAM,oBAAoB,iEAA6C,CAAC;AAC/E,eAAO,MAAM,uBAAuB;;;;;;;EAA+B,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;CAM8C,CAAC;AAIpF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED,eAAO,MAAM,iBAAiB;;;;EAA4C,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;iBAqBlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA+B,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAG9E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAuB,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAC9C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA+B,CAAC;AACpE,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,CAAC"}

package/dist/ceiling.d.ts

@@ -0,0 +1,90 @@
+import { type Hex } from "viem";
+import { type AuthorizationState } from "./authorization-state.js";
+import { type VapiConfig } from "./config.js";
+import { type LookupFn } from "./net-guard.js";
+import { type Receipt } from "./receipts.js";
+import type { SecretStore } from "./secret-store.js";
+import { type SiblingsResult } from "./siblings.js";
+import { type TransferArgs, type TransferResult } from "./transfer.js";
+import type { WalletCeilingSweepPending, WalletName, WalletStore } from "./wallet-store.js";
+export declare const CEILING_SWEEP_MINIMUM_ATOMIC = 100000n;
+export declare const CEILING_SWEEP_GUARD_MS: number;
+export declare const CEILING_SWEEP_TIMEOUT_MS = 10000;
+export type SweepTargetAccount = {
+    account: WalletName;
+    owner: `0x${string}`;
+};
+/** The single recipient seam future swarm treasury routing will replace. */
+export declare function sweepTarget(account: SweepTargetAccount): `0x${string}`;
+/** A disabled ceiling stays disabled; otherwise the daily cap is its floor. */
+export declare function effectiveCeiling(ceilingAtomic: bigint | null, perDayCapAtomic?: bigint | null): bigint | null;
+/** True when the per-day cap, rather than the configured ceiling, sets the floor. */
+export declare function ceilingFloorApplies(ceilingAtomic: bigint | null, perDayCapAtomic?: bigint | null): boolean;
+export type CeilingSweepStatus = "swept" | "skipped" | "failed" | "unknown";
+export type CeilingSweepResult = {
+    account: WalletName;
+    status: CeilingSweepStatus;
+    reason?: string;
+    amountUsd?: string;
+    txHash?: string;
+};
+export type CeilingBalanceReader = (args: {
+    address: `0x${string}`;
+    signal?: AbortSignal;
+}) => Promise<bigint>;
+export type CeilingSiblingsFetcher = (args: {
+    apiBase: string;
+    account: WalletName;
+    secrets: SecretStore;
+    wallets: WalletStore;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}) => Promise<SiblingsResult>;
+export type CeilingTransfer = (args: TransferArgs) => Promise<TransferResult>;
+export type CeilingAuthorizationStateReader = (input: {
+    receipt: Receipt;
+    pending: Readonly<WalletCeilingSweepPending>;
+}) => Promise<AuthorizationState>;
+export type SweepAboveCeilingArgs = {
+    store: WalletStore;
+    secrets: SecretStore;
+    apiBase: string;
+    account: WalletName;
+    config?: VapiConfig;
+    balanceReader?: CeilingBalanceReader;
+    addressReader?: (account: WalletName) => Promise<string | undefined>;
+    fetchSiblingsImpl?: CeilingSiblingsFetcher;
+    transfer?: CeilingTransfer;
+    authorizationState?: CeilingAuthorizationStateReader;
+    randomNonce?: () => Hex;
+    unlock?: TransferArgs["unlock"];
+    fetchImpl?: typeof fetch;
+    lookup?: LookupFn;
+    now?: () => number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    auditHome?: string;
+    warn?: (message: string) => void;
+};
+/**
+ * Best-effort Base USDC ceiling enforcement for one local account. Expected
+ * network, link, balance, signing, and relay failures are returned, not thrown.
+ */
+export declare function sweepAboveCeiling(args: SweepAboveCeilingArgs): Promise<CeilingSweepResult>;
+export type SweepAllAboveCeilingArgs = Omit<SweepAboveCeilingArgs, "account">;
+/** Runs local accounts in registry order; relay and registry work stays serial. */
+export declare function sweepAllAboveCeiling(args: SweepAllAboveCeilingArgs): Promise<CeilingSweepResult[]>;
+export type CeilingSweepHook = {
+    account: WalletName;
+    auditHome: string;
+    run: (signal: AbortSignal) => Promise<unknown>;
+    timeoutMs?: number;
+    now?: () => number;
+};
+/** Starts a settled-call sweep off the result path and tracks it for short-lived clients. */
+export declare function scheduleCeilingSweep(hook: CeilingSweepHook): void;
+/** Waits for currently queued sweeps without holding a CLI longer than the bound. */
+export declare function drainCeilingSweeps(timeoutMs?: number): Promise<void>;
+//# sourceMappingURL=ceiling.d.ts.map

package/dist/ceiling.d.ts.map

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

package/dist/cloud-backup.d.ts

@@ -0,0 +1,125 @@
+import { type BackupKdf, type BackupPlaintext } from "./backup.js";
+import type { SecretStore } from "./secret-store.js";
+import { type VaultEnv } from "./vault-key.js";
+import { type VaultAccount } from "./vault.js";
+import type { WalletStore } from "./wallet-store.js";
+export type RelayPurpose = "enroll" | "restore";
+export type RelayKeyPair = {
+    publicKey: Uint8Array;
+    privateKey: Uint8Array;
+};
+export type RelayPayload = {
+    format: "vapi-vault-relay-payload";
+    v: 1;
+    purpose: RelayPurpose;
+    owner: `0x${string}`;
+    device: string;
+    kdf: BackupKdf;
+    key: Uint8Array;
+    vault?: BackupPlaintext;
+};
+export type CloudBackupErrorCode = "relay_create_failed" | "relay_expired" | "relay_aborted" | "payload_invalid" | "payload_device_mismatch" | "payload_purpose_mismatch" | "payload_owner_mismatch" | "secret_store_unavailable" | "vault_exists" | "restore_failed";
+export declare class CloudBackupError extends Error {
+    readonly code: CloudBackupErrorCode;
+    constructor(code: CloudBackupErrorCode);
+}
+export type StoredBackupKey = {
+    owner: `0x${string}`;
+    device: string;
+    kdf: BackupKdf;
+    key: Uint8Array;
+};
+export type CloudBackupState = {
+    enabled: boolean;
+    lastUploadAt?: string;
+    sizeBytes?: number;
+};
+export type UploadBackupResult = {
+    status: "uploaded";
+    account: string;
+    bytes: number;
+    uploadedAt: string;
+} | {
+    status: "skipped";
+    reason: "no_backup_key" | "no_vault" | "vault_locked" | "not_linked" | "device_unknown" | "rejected" | "network" | "timeout";
+    httpStatus?: number;
+};
+type RandomBytes = (length: number) => Uint8Array;
+export declare function startRelay(options: {
+    apiBase: string;
+    device: string;
+    purpose: RelayPurpose;
+    fetchImpl?: typeof fetch;
+    now?: () => Date;
+    randomBytes?: RandomBytes;
+}): Promise<{
+    code: string;
+    expiresAt: string;
+    keyPair: RelayKeyPair;
+}>;
+export declare function awaitRelay(options: {
+    apiBase: string;
+    code: string;
+    keyPair: RelayKeyPair;
+    expiresAt: string;
+    expectedOwner?: string;
+    device: string;
+    purpose: RelayPurpose;
+    signal?: AbortSignal;
+    pollMs?: number;
+    fetchImpl?: typeof fetch;
+    now?: () => Date;
+    sleep?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+}): Promise<RelayPayload>;
+export declare function backupKeyAccount(device: string): string;
+export declare function backupStateAccount(device: string): string;
+export declare function storeBackupKey(options: {
+    secrets: SecretStore;
+    device: string;
+    owner: string;
+    kdf: BackupKdf;
+    key: Uint8Array;
+}): Promise<void>;
+export declare function readBackupKey(options: {
+    secrets: SecretStore;
+    device: string;
+}): Promise<StoredBackupKey | undefined>;
+export declare function forgetBackupKey(options: {
+    secrets: SecretStore;
+    device: string;
+}): Promise<boolean>;
+export declare function readCloudBackupState(options: {
+    secrets: SecretStore;
+    device: string;
+}): Promise<CloudBackupState>;
+export declare function uploadBackup(options: {
+    store: WalletStore;
+    secrets: SecretStore;
+    device: string;
+    apiBase?: string;
+    account?: string;
+    networks?: readonly string[];
+    env?: VaultEnv;
+    fetchImpl?: typeof fetch;
+    now?: () => Date;
+    randomBytes?: RandomBytes;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<UploadBackupResult>;
+export declare function restoreFromOwner(options: {
+    payload: RelayPayload;
+    home: string;
+    vaultKey: Uint8Array;
+    secrets: SecretStore;
+    password?: string;
+    env?: VaultEnv;
+    randomBytes?: RandomBytes;
+    now?: () => Date;
+}): Promise<{
+    accounts: VaultAccount[];
+    default?: string;
+    protected: boolean;
+    networks: string[];
+}>;
+export {};
+//# sourceMappingURL=cloud-backup.d.ts.map

package/dist/cloud-backup.d.ts.map

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