@orbserv-labs/orb-wallet 0.1.0

package/dist/modules/policy.d.ts

@@ -0,0 +1,51 @@
+import type { HttpClient } from "../utils/http.js";
+import type { PolicyData, UpdatePolicyOptions } from "../types.js";
+/**
+ * Manages spending-policy operations for a single wallet.
+ *
+ * Obtained via `agentWallet.policy`.
+ *
+ * @example
+ * ```typescript
+ * await wallet.policy.update({ dailyLimit: 100 })
+ * await wallet.policy.pause()
+ * await wallet.policy.resume()
+ * ```
+ */
+export declare class PolicyModule {
+    private readonly http;
+    private readonly walletId;
+    constructor(http: HttpClient, walletId: string);
+    /**
+     * Retrieve the current policy for this wallet.
+     *
+     * @returns The current {@link PolicyData}.
+     */
+    get(): Promise<PolicyData>;
+    /**
+     * Update one or more policy fields.
+     *
+     * @param options - Fields to update. Only the provided fields are changed.
+     * @returns The updated {@link PolicyData}.
+     *
+     * @example
+     * ```typescript
+     * await wallet.policy.update({ dailyLimit: 100, maxPerTx: 25 })
+     * ```
+     */
+    update(options: UpdatePolicyOptions): Promise<PolicyData>;
+    /**
+     * Pause the spending policy, effectively blocking all outgoing transactions
+     * from this wallet until `resume()` is called.
+     *
+     * @returns The updated {@link PolicyData} with `status: "paused"`.
+     */
+    pause(): Promise<PolicyData>;
+    /**
+     * Resume a previously paused policy, re-enabling outgoing transactions.
+     *
+     * @returns The updated {@link PolicyData} with `status: "active"`.
+     */
+    resume(): Promise<PolicyData>;
+}
+//# sourceMappingURL=policy.d.ts.map

package/dist/modules/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/modules/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IAS9C;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;IAMhC;;;;;;;;;;OAUG;IACG,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAO/D;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAMlC;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;CAKpC"}

package/dist/modules/policy.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PolicyModule = void 0;
+/**
+ * Manages spending-policy operations for a single wallet.
+ *
+ * Obtained via `agentWallet.policy`.
+ *
+ * @example
+ * ```typescript
+ * await wallet.policy.update({ dailyLimit: 100 })
+ * await wallet.policy.pause()
+ * await wallet.policy.resume()
+ * ```
+ */
+class PolicyModule {
+    constructor(http, walletId) {
+        this.http = http;
+        this.walletId = walletId;
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * Retrieve the current policy for this wallet.
+     *
+     * @returns The current {@link PolicyData}.
+     */
+    async get() {
+        return this.http.get(`/wallets/${this.walletId}/policy`);
+    }
+    /**
+     * Update one or more policy fields.
+     *
+     * @param options - Fields to update. Only the provided fields are changed.
+     * @returns The updated {@link PolicyData}.
+     *
+     * @example
+     * ```typescript
+     * await wallet.policy.update({ dailyLimit: 100, maxPerTx: 25 })
+     * ```
+     */
+    async update(options) {
+        return this.http.patch(`/wallets/${this.walletId}/policy`, options);
+    }
+    /**
+     * Pause the spending policy, effectively blocking all outgoing transactions
+     * from this wallet until `resume()` is called.
+     *
+     * @returns The updated {@link PolicyData} with `status: "paused"`.
+     */
+    async pause() {
+        return this.http.post(`/wallets/${this.walletId}/policy/pause`);
+    }
+    /**
+     * Resume a previously paused policy, re-enabling outgoing transactions.
+     *
+     * @returns The updated {@link PolicyData} with `status: "active"`.
+     */
+    async resume() {
+        return this.http.post(`/wallets/${this.walletId}/policy/resume`);
+    }
+}
+exports.PolicyModule = PolicyModule;
+//# sourceMappingURL=policy.js.map

package/dist/modules/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/modules/policy.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;GAWG;AACH,MAAa,YAAY;IAIvB,YAAY,IAAgB,EAAE,QAAgB;QAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;;;OAIG;IACH,KAAK,CAAC,GAAG;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,YAAY,IAAI,CAAC,QAAQ,SAAS,CACnC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CAAC,OAA4B;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CACpB,YAAY,IAAI,CAAC,QAAQ,SAAS,EAClC,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,YAAY,IAAI,CAAC,QAAQ,eAAe,CACzC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,YAAY,IAAI,CAAC,QAAQ,gBAAgB,CAC1C,CAAC;IACJ,CAAC;CACF;AAhED,oCAgEC"}

package/dist/modules/wallet.d.ts

@@ -0,0 +1,70 @@
+import type { HttpClient } from "../utils/http.js";
+import type { CreateWalletOptions } from "../types.js";
+import { AgentWallet } from "./agent-wallet.js";
+/**
+ * Manages wallet lifecycle operations: create, retrieve, and list wallets.
+ *
+ * Exposed as `orb.wallet` on the top-level {@link OrbWallet} client.
+ *
+ * @example
+ * ```typescript
+ * const wallet = await orb.wallet.create({
+ *   name: "my-agent",
+ *   chains: ["solana", "base", "ethereum", "arbitrum"],
+ *   policy: { dailyLimit: 50, maxPerTx: 10 }
+ * })
+ * ```
+ */
+export declare class WalletModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a new agent wallet.
+     *
+     * @param options - Wallet creation parameters: name, chains, and optional policy.
+     * @returns A fully initialised {@link AgentWallet} instance.
+     *
+     * @example
+     * ```typescript
+     * const wallet = await orb.wallet.create({
+     *   name: "my-agent",
+     *   chains: ["solana", "base", "ethereum", "arbitrum"],
+     *   policy: {
+     *     dailyLimit: 50,
+     *     maxPerTx: 10,
+     *     whitelist: ["x402", "inference"],
+     *     alertAbove: 20
+     *   }
+     * })
+     *
+     * console.log(wallet.solana.address)  // Sol address
+     * console.log(wallet.evm.address)     // 0x address
+     * ```
+     */
+    create(options: CreateWalletOptions): Promise<AgentWallet>;
+    /**
+     * Retrieve an existing wallet by its ID.
+     *
+     * @param id - The wallet ID (e.g. `"wal_abc123"`).
+     * @returns The {@link AgentWallet} instance.
+     *
+     * @example
+     * ```typescript
+     * const wallet = await orb.wallet.get("wal_abc123")
+     * ```
+     */
+    get(id: string): Promise<AgentWallet>;
+    /**
+     * List all wallets associated with the current API key.
+     *
+     * @returns An array of {@link AgentWallet} instances.
+     *
+     * @example
+     * ```typescript
+     * const wallets = await orb.wallet.list()
+     * wallets.forEach(w => console.log(w.id, w.name))
+     * ```
+     */
+    list(): Promise<AgentWallet[]>;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/modules/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/modules/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAc,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAQ5B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAKhE;;;;;;;;;;OAUG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAK3C;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAIrC"}

package/dist/modules/wallet.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletModule = void 0;
+const agent_wallet_js_1 = require("./agent-wallet.js");
+/**
+ * Manages wallet lifecycle operations: create, retrieve, and list wallets.
+ *
+ * Exposed as `orb.wallet` on the top-level {@link OrbWallet} client.
+ *
+ * @example
+ * ```typescript
+ * const wallet = await orb.wallet.create({
+ *   name: "my-agent",
+ *   chains: ["solana", "base", "ethereum", "arbitrum"],
+ *   policy: { dailyLimit: 50, maxPerTx: 10 }
+ * })
+ * ```
+ */
+class WalletModule {
+    constructor(http) {
+        this.http = http;
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * Create a new agent wallet.
+     *
+     * @param options - Wallet creation parameters: name, chains, and optional policy.
+     * @returns A fully initialised {@link AgentWallet} instance.
+     *
+     * @example
+     * ```typescript
+     * const wallet = await orb.wallet.create({
+     *   name: "my-agent",
+     *   chains: ["solana", "base", "ethereum", "arbitrum"],
+     *   policy: {
+     *     dailyLimit: 50,
+     *     maxPerTx: 10,
+     *     whitelist: ["x402", "inference"],
+     *     alertAbove: 20
+     *   }
+     * })
+     *
+     * console.log(wallet.solana.address)  // Sol address
+     * console.log(wallet.evm.address)     // 0x address
+     * ```
+     */
+    async create(options) {
+        const data = await this.http.post("/wallets", options);
+        return new agent_wallet_js_1.AgentWallet(data, this.http);
+    }
+    /**
+     * Retrieve an existing wallet by its ID.
+     *
+     * @param id - The wallet ID (e.g. `"wal_abc123"`).
+     * @returns The {@link AgentWallet} instance.
+     *
+     * @example
+     * ```typescript
+     * const wallet = await orb.wallet.get("wal_abc123")
+     * ```
+     */
+    async get(id) {
+        const data = await this.http.get(`/wallets/${id}`);
+        return new agent_wallet_js_1.AgentWallet(data, this.http);
+    }
+    /**
+     * List all wallets associated with the current API key.
+     *
+     * @returns An array of {@link AgentWallet} instances.
+     *
+     * @example
+     * ```typescript
+     * const wallets = await orb.wallet.list()
+     * wallets.forEach(w => console.log(w.id, w.name))
+     * ```
+     */
+    async list() {
+        const data = await this.http.get("/wallets");
+        return data.map((d) => new agent_wallet_js_1.AgentWallet(d, this.http));
+    }
+}
+exports.WalletModule = WalletModule;
+//# sourceMappingURL=wallet.js.map

package/dist/modules/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/modules/wallet.ts"],"names":[],"mappings":";;;AAEA,uDAAgD;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAa,YAAY;IAGvB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,MAAM,CAAC,OAA4B;QACvC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAa,UAAU,EAAE,OAAO,CAAC,CAAC;QACnE,OAAO,IAAI,6BAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAa,YAAY,EAAE,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,6BAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,UAAU,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,6BAAW,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC;CACF;AAtED,oCAsEC"}

package/dist/modules/x402.d.ts

@@ -0,0 +1,45 @@
+import type { HttpClient } from "../utils/http.js";
+import type { X402DiscoverOptions, X402DiscoverResponse, X402FetchResult } from "../types.js";
+/**
+ * Handles x402-protocol operations: service discovery and auto-pay HTTP fetch.
+ *
+ * Exposed as `orb.x402` on the top-level client.
+ * Also used internally by `AgentWallet.fetch()`.
+ */
+export declare class X402Module {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Discover x402-compatible services registered in the orbserv marketplace.
+     *
+     * @param options - Optional filters: category, free-text query, limit.
+     * @returns A list of {@link X402Service} entries and a total count.
+     *
+     * @example
+     * ```typescript
+     * const services = await orb.x402.discover({ category: "inference" })
+     * console.log(services.services[0].baseUrl)
+     * ```
+     */
+    discover(options?: X402DiscoverOptions): Promise<X402DiscoverResponse>;
+    /**
+     * Perform an HTTP request, automatically handling x402 payment challenges.
+     *
+     * When the target URL returns `HTTP 402`, the SDK negotiates payment using
+     * the wallet associated with this SDK instance and retries the request.
+     *
+     * @param walletId - The wallet to charge for the request.
+     * @param url - The target URL.
+     * @param init - Optional fetch `RequestInit` options.
+     * @returns An {@link X402FetchResult} containing the raw Response and
+     *   optional payment receipt information.
+     *
+     * @example
+     * ```typescript
+     * const result = await wallet.fetch("https://api.service.com/data")
+     * const json = await result.response.json()
+     * ```
+     */
+    fetch(walletId: string, url: string, init?: RequestInit): Promise<X402FetchResult>;
+}
+//# sourceMappingURL=x402.d.ts.map

package/dist/modules/x402.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/modules/x402.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAQ5B;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAgBhF;;;;;;;;;;;;;;;;;OAiBG;IACG,KAAK,CACT,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,eAAe,CAAC;CA8B5B"}

package/dist/modules/x402.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402Module = void 0;
+/**
+ * Handles x402-protocol operations: service discovery and auto-pay HTTP fetch.
+ *
+ * Exposed as `orb.x402` on the top-level client.
+ * Also used internally by `AgentWallet.fetch()`.
+ */
+class X402Module {
+    constructor(http) {
+        this.http = http;
+    }
+    // -------------------------------------------------------------------------
+    // Top-level discovery (orb.x402.discover)
+    // -------------------------------------------------------------------------
+    /**
+     * Discover x402-compatible services registered in the orbserv marketplace.
+     *
+     * @param options - Optional filters: category, free-text query, limit.
+     * @returns A list of {@link X402Service} entries and a total count.
+     *
+     * @example
+     * ```typescript
+     * const services = await orb.x402.discover({ category: "inference" })
+     * console.log(services.services[0].baseUrl)
+     * ```
+     */
+    async discover(options = {}) {
+        const params = new URLSearchParams();
+        if (options.category)
+            params.set("category", options.category);
+        if (options.query)
+            params.set("query", options.query);
+        if (options.limit !== undefined)
+            params.set("limit", String(options.limit));
+        const query = params.toString();
+        return this.http.get(`/x402/services${query ? `?${query}` : ""}`);
+    }
+    // -------------------------------------------------------------------------
+    // Auto-pay fetch (used by AgentWallet.fetch)
+    // -------------------------------------------------------------------------
+    /**
+     * Perform an HTTP request, automatically handling x402 payment challenges.
+     *
+     * When the target URL returns `HTTP 402`, the SDK negotiates payment using
+     * the wallet associated with this SDK instance and retries the request.
+     *
+     * @param walletId - The wallet to charge for the request.
+     * @param url - The target URL.
+     * @param init - Optional fetch `RequestInit` options.
+     * @returns An {@link X402FetchResult} containing the raw Response and
+     *   optional payment receipt information.
+     *
+     * @example
+     * ```typescript
+     * const result = await wallet.fetch("https://api.service.com/data")
+     * const json = await result.response.json()
+     * ```
+     */
+    async fetch(walletId, url, init) {
+        // Delegate to the backend proxy endpoint so the server can handle
+        // x402 negotiation securely with the wallet's private key.
+        const response = await this.http.post("/x402/fetch", {
+            walletId,
+            url,
+            method: init?.method ?? "GET",
+            headers: init?.headers ?? {},
+            body: init?.body ?? null,
+        });
+        // Re-construct a Response from the proxied result so callers get a
+        // familiar interface.
+        const proxiedResponse = new Response(response.body, {
+            status: response.status,
+            headers: response.headers,
+        });
+        return {
+            response: proxiedResponse,
+            paymentReceipt: response.paymentReceipt,
+            amountCharged: response.amountCharged,
+        };
+    }
+}
+exports.X402Module = X402Module;
+//# sourceMappingURL=x402.js.map

package/dist/modules/x402.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.js","sourceRoot":"","sources":["../../src/modules/x402.ts"],"names":[],"mappings":";;;AAOA;;;;;GAKG;AACH,MAAa,UAAU;IAGrB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,4EAA4E;IAC5E,0CAA0C;IAC1C,4EAA4E;IAE5E;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,CAAC,UAA+B,EAAE;QAC9C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/D,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAE5E,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,iBAAiB,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5C,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,6CAA6C;IAC7C,4EAA4E;IAE5E;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,KAAK,CACT,QAAgB,EAChB,GAAW,EACX,IAAkB;QAElB,kEAAkE;QAClE,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAMlC,aAAa,EAAE;YAChB,QAAQ;YACR,GAAG;YACH,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK;YAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE;YAC5B,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;SACzB,CAAC,CAAC;QAEH,mEAAmE;QACnE,sBAAsB;QACtB,MAAM,eAAe,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;YAClD,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,eAAe;YACzB,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,aAAa,EAAE,QAAQ,CAAC,aAAa;SACtC,CAAC;IACJ,CAAC;CACF;AA3FD,gCA2FC"}

package/dist/types.d.ts

@@ -0,0 +1,168 @@
+/** Supported chain identifiers. */
+export type Chain = "solana" | "base" | "ethereum" | "arbitrum";
+/** Token identifiers. */
+export type Token = "USDC" | "ETH" | "SOL" | "USDT";
+/** Spending-policy configuration attached to a wallet. */
+export interface PolicyConfig {
+    /** Maximum cumulative USDC spend per 24-hour rolling window. */
+    dailyLimit?: number;
+    /** Maximum USDC spend allowed in a single transaction. */
+    maxPerTx?: number;
+    /** Allow-list of service categories or tags (e.g. `"x402"`, `"inference"`). */
+    whitelist?: string[];
+    /** Trigger an alert when single-tx spend exceeds this threshold (USDC). */
+    alertAbove?: number;
+}
+/** Options passed to `WalletModule.create()`. */
+export interface CreateWalletOptions {
+    /** Human-readable label for the wallet (used in logs and dashboards). */
+    name: string;
+    /** Chains to activate addresses on. */
+    chains: Chain[];
+    /** Optional initial spending policy. */
+    policy?: PolicyConfig;
+}
+/** Chain-specific address object returned by the API. */
+export interface ChainAddress {
+    address: string;
+    chain: Chain;
+}
+/** Raw wallet object as returned by the REST API. */
+export interface WalletData {
+    id: string;
+    name: string;
+    createdAt: string;
+    /** Present when Solana chain is active. */
+    solana?: ChainAddress;
+    /** Single EVM address shared across Base, Ethereum, Arbitrum. */
+    evm?: ChainAddress;
+    policy: PolicyConfig;
+    status: "active" | "paused" | "suspended";
+}
+/** Options for `AgentWallet.send()`. */
+export interface SendOptions {
+    /** Recipient address (EVM `0x…` or Solana base58). */
+    to: string;
+    /** Amount in USDC (or the specified token's native units). */
+    amount: number;
+    /** Token to send. Defaults to `"USDC"`. */
+    token?: Token;
+    /** Chain to execute the transfer on. */
+    chain: Chain;
+    /**
+     * When `true`, the transfer is routed through a ZK shielded layer
+     * to obscure the on-chain trail.
+     */
+    privacy?: boolean;
+}
+/** Canonical transaction record. */
+export interface Transaction {
+    id: string;
+    walletId: string;
+    type: "send" | "receive" | "x402";
+    chain: Chain;
+    token: Token;
+    amount: number;
+    to?: string;
+    from?: string;
+    txHash?: string;
+    status: "pending" | "confirmed" | "failed";
+    privacy: boolean;
+    createdAt: string;
+    confirmedAt?: string;
+}
+/** Options for `AgentWallet.history()`. */
+export interface HistoryOptions {
+    /** Maximum number of records to return (default: 50, max: 200). */
+    limit?: number;
+    /** Cursor for pagination (opaque string from a previous response). */
+    cursor?: string;
+    /** Filter to a specific chain. */
+    chain?: Chain;
+    /** Filter to a specific token. */
+    token?: Token;
+}
+/** Paginated history response. */
+export interface HistoryResponse {
+    transactions: Transaction[];
+    /** Present when there are more pages. */
+    nextCursor?: string;
+    total: number;
+}
+/** Per-chain, per-token balance entry. */
+export interface BalanceEntry {
+    chain: Chain;
+    token: Token;
+    amount: number;
+    /** Amount denominated in USD using current market price. */
+    usdValue: number;
+}
+/** Aggregated balance response. */
+export interface BalanceResponse {
+    walletId: string;
+    balances: BalanceEntry[];
+    /** Total USD value across all chains and tokens. */
+    totalUsdValue: number;
+    updatedAt: string;
+}
+/** Full policy resource as stored server-side. */
+export interface PolicyData {
+    walletId: string;
+    dailyLimit: number;
+    maxPerTx: number;
+    whitelist: string[];
+    alertAbove: number;
+    status: "active" | "paused";
+    updatedAt: string;
+}
+/** Fields that can be updated via `policy.update()`. */
+export type UpdatePolicyOptions = Partial<PolicyConfig>;
+/** Options for `X402Module.discover()`. */
+export interface X402DiscoverOptions {
+    /** Filter services by category (e.g. `"inference"`, `"data"`, `"storage"`). */
+    category?: string;
+    /** Free-text search query. */
+    query?: string;
+    /** Maximum number of results (default: 20). */
+    limit?: number;
+}
+/** A single x402-compatible service listing. */
+export interface X402Service {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    baseUrl: string;
+    /** Supported tokens for payment. */
+    tokens: Token[];
+    /** Supported chains for payment. */
+    chains: Chain[];
+    /** Typical price per API call in USDC. */
+    pricePerCall?: number;
+    tags: string[];
+}
+/** Discovery response. */
+export interface X402DiscoverResponse {
+    services: X402Service[];
+    total: number;
+}
+/** x402 fetch response wrapping the raw Response. */
+export interface X402FetchResult {
+    /** The raw fetch Response (body unconsumed). */
+    response: Response;
+    /** Payment receipt returned in the `X-Payment-Receipt` header, if any. */
+    paymentReceipt?: string;
+    /** Amount deducted from the wallet for this call (USDC). */
+    amountCharged?: number;
+}
+/** Options accepted by the `OrbWallet` constructor. */
+export interface OrbWalletOptions {
+    /** Secret API key issued from the orbserv dashboard. */
+    apiKey: string;
+    /**
+     * Override the default API base URL.
+     * Defaults to `https://api.orbserv.co/v1`.
+     */
+    baseUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// =============================================================================
+// Wallet creation & representation
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Base error class for all orb-wallet SDK errors.
+ */
+export declare class OrbError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when the API returns a non-2xx response.
+ * Contains the HTTP status code and the raw response body.
+ */
+export declare class OrbApiError extends OrbError {
+    readonly statusCode: number;
+    readonly body: unknown;
+    constructor(statusCode: number, body: unknown);
+}
+/**
+ * Thrown when the request fails due to authentication issues (401 / 403).
+ */
+export declare class OrbAuthError extends OrbApiError {
+    constructor(statusCode: number, body: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAM5B;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEX,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAW9C;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAK9C"}