@orbserv-labs/orb-wallet 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 orbserv Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,181 @@
+# orb-wallet
+
+**`@orbserv-labs/orb-wallet`** — TypeScript SDK for the orbserv agent wallet API.
+Give your AI agents a multi-chain crypto wallet with built-in spending policies and x402 auto-pay in minutes.
+
+---
+
+## Installation
+
+```bash
+npm install @orbserv-labs/orb-wallet
+# or
+pnpm add @orbserv-labs/orb-wallet
+# or
+yarn add @orbserv-labs/orb-wallet
+```
+
+**Requirements**: Node.js >= 18 (uses native `fetch`). No runtime dependencies.
+
+---
+
+## Quick start
+
+```typescript
+import { OrbWallet } from '@orbserv-labs/orb-wallet'
+
+const orb = new OrbWallet({ apiKey: process.env.ORB_API_KEY! })
+
+// Create a wallet
+const wallet = await orb.wallet.create({
+  name: "my-agent",
+  chains: ["solana", "base", "ethereum", "arbitrum"],
+  policy: {
+    dailyLimit: 50,      // USDC per day
+    maxPerTx: 10,        // USDC per transaction
+    whitelist: ["x402", "inference"],
+    alertAbove: 20       // alert when a single tx exceeds this
+  }
+})
+
+console.log(wallet.solana.address)  // Sol address
+console.log(wallet.evm.address)     // 0x EVM address (Base / ETH / Arbitrum)
+
+// Send tokens
+await wallet.send({
+  to: "0xRecipient",
+  amount: 5,
+  token: "USDC",
+  chain: "base",
+  privacy: true   // ZK shielded transfer
+})
+
+// Transaction history
+const history = await wallet.history({ limit: 20 })
+history.transactions.forEach(tx => console.log(tx.txHash, tx.amount))
+
+// Balance across all chains
+const balance = await wallet.balance()
+console.log(`Total: $${balance.totalUsdValue}`)
+
+// x402 auto-pay fetch — handles 402 Payment Required automatically
+const { response } = await wallet.fetch("https://api.service.com/data")
+const data = await response.json()
+```
+
+---
+
+## Policy management
+
+```typescript
+// Update spending limits
+await wallet.policy.update({ dailyLimit: 100, maxPerTx: 25 })
+
+// Pause all outgoing transactions
+await wallet.policy.pause()
+
+// Re-enable transactions
+await wallet.policy.resume()
+
+// Read current policy
+const policy = await wallet.policy.get()
+console.log(policy.dailyLimit, policy.status)
+```
+
+---
+
+## x402 service discovery
+
+```typescript
+// Discover x402-compatible services on the orbserv marketplace
+const services = await orb.x402.discover({ category: "inference" })
+services.services.forEach(s => console.log(s.name, s.baseUrl))
+```
+
+---
+
+## Wallet management
+
+```typescript
+// Retrieve an existing wallet by ID
+const wallet = await orb.wallet.get("wal_abc123")
+
+// List all wallets for this API key
+const wallets = await orb.wallet.list()
+```
+
+---
+
+## Error handling
+
+```typescript
+import { OrbApiError, OrbAuthError } from '@orbserv-labs/orb-wallet'
+
+try {
+  const wallet = await orb.wallet.create({ name: "agent", chains: ["base"] })
+} catch (err) {
+  if (err instanceof OrbAuthError) {
+    // 401 or 403 — check your API key
+    console.error("Auth failed:", err.statusCode, err.body)
+  } else if (err instanceof OrbApiError) {
+    // Any other non-2xx response
+    console.error("API error:", err.statusCode, err.body)
+  } else {
+    throw err
+  }
+}
+```
+
+---
+
+## API reference
+
+### `new OrbWallet(options)`
+
+| Option    | Type     | Required | Description                                           |
+|-----------|----------|----------|-------------------------------------------------------|
+| `apiKey`  | `string` | Yes      | Your orbserv API key                                  |
+| `baseUrl` | `string` | No       | Override base URL (default: `https://api.orbserv.co/v1`) |
+
+### `orb.wallet`
+
+| Method                    | Returns          | Description                         |
+|---------------------------|------------------|-------------------------------------|
+| `create(options)`         | `AgentWallet`    | Create a new wallet                 |
+| `get(id)`                 | `AgentWallet`    | Fetch an existing wallet by ID      |
+| `list()`                  | `AgentWallet[]`  | List all wallets for this API key   |
+
+### `wallet` (AgentWallet)
+
+| Method / Property         | Returns              | Description                                   |
+|---------------------------|----------------------|-----------------------------------------------|
+| `id`                      | `string`             | Wallet ID                                     |
+| `name`                    | `string`             | Wallet name                                   |
+| `solana.address`          | `string`             | Solana address                                |
+| `evm.address`             | `string`             | EVM address (0x…)                             |
+| `send(options)`           | `Transaction`        | Send tokens                                   |
+| `history(options?)`       | `HistoryResponse`    | Paginated transaction history                 |
+| `balance()`               | `BalanceResponse`    | Per-chain, per-token balances                 |
+| `fetch(url, init?)`       | `X402FetchResult`    | x402 auto-pay HTTP fetch                      |
+| `policy`                  | `PolicyModule`       | Spending policy manager                       |
+
+### `wallet.policy`
+
+| Method           | Returns       | Description                        |
+|------------------|---------------|------------------------------------|
+| `get()`          | `PolicyData`  | Read current policy                |
+| `update(opts)`   | `PolicyData`  | Update policy fields               |
+| `pause()`        | `PolicyData`  | Block all outgoing transactions    |
+| `resume()`       | `PolicyData`  | Re-enable outgoing transactions    |
+
+### `orb.x402`
+
+| Method             | Returns                  | Description                         |
+|--------------------|--------------------------|-------------------------------------|
+| `discover(opts?)`  | `X402DiscoverResponse`   | Discover x402-compatible services   |
+
+---
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,49 @@
+import type { OrbWalletOptions } from "./types.js";
+import { WalletModule } from "./modules/wallet.js";
+import { X402Module } from "./modules/x402.js";
+/**
+ * Main entry point for the `@orbserv-labs/orb-wallet` SDK.
+ *
+ * Construct a single instance per application and reuse it.
+ *
+ * @example
+ * ```typescript
+ * import { OrbWallet } from '@orbserv-labs/orb-wallet'
+ *
+ * const orb = new OrbWallet({ apiKey: process.env.ORB_API_KEY! })
+ *
+ * // Create a wallet
+ * const wallet = await orb.wallet.create({
+ *   name: "my-agent",
+ *   chains: ["solana", "base", "ethereum", "arbitrum"],
+ *   policy: { dailyLimit: 50, maxPerTx: 10 }
+ * })
+ *
+ * // Discover x402 services
+ * const services = await orb.x402.discover({ category: "inference" })
+ * ```
+ */
+export declare class OrbWallet {
+    /**
+     * Wallet lifecycle operations: create, get, list.
+     *
+     * @see {@link WalletModule}
+     */
+    readonly wallet: WalletModule;
+    /**
+     * x402 protocol operations: service discovery and auto-pay fetch.
+     *
+     * @see {@link X402Module}
+     */
+    readonly x402: X402Module;
+    private readonly http;
+    /**
+     * @param options.apiKey  - Your orbserv API key (required).
+     * @param options.baseUrl - Override the API base URL. Defaults to
+     *   `https://api.orbserv.co/v1`.
+     *
+     * @throws {TypeError} When `apiKey` is missing or empty.
+     */
+    constructor(options: OrbWalletOptions);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,SAAS;IACpB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC;;;;;;OAMG;gBACS,OAAO,EAAE,gBAAgB;CAiBtC"}

package/dist/client.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrbWallet = void 0;
+const http_js_1 = require("./utils/http.js");
+const wallet_js_1 = require("./modules/wallet.js");
+const x402_js_1 = require("./modules/x402.js");
+/** Default API base URL. Override via `OrbWalletOptions.baseUrl`. */
+const DEFAULT_BASE_URL = "https://api.orbserv.co/v1";
+/**
+ * Main entry point for the `@orbserv-labs/orb-wallet` SDK.
+ *
+ * Construct a single instance per application and reuse it.
+ *
+ * @example
+ * ```typescript
+ * import { OrbWallet } from '@orbserv-labs/orb-wallet'
+ *
+ * const orb = new OrbWallet({ apiKey: process.env.ORB_API_KEY! })
+ *
+ * // Create a wallet
+ * const wallet = await orb.wallet.create({
+ *   name: "my-agent",
+ *   chains: ["solana", "base", "ethereum", "arbitrum"],
+ *   policy: { dailyLimit: 50, maxPerTx: 10 }
+ * })
+ *
+ * // Discover x402 services
+ * const services = await orb.x402.discover({ category: "inference" })
+ * ```
+ */
+class OrbWallet {
+    /**
+     * @param options.apiKey  - Your orbserv API key (required).
+     * @param options.baseUrl - Override the API base URL. Defaults to
+     *   `https://api.orbserv.co/v1`.
+     *
+     * @throws {TypeError} When `apiKey` is missing or empty.
+     */
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new TypeError("OrbWallet: `apiKey` is required. " +
+                "Pass it via `new OrbWallet({ apiKey: '...' })` or set the " +
+                "ORB_API_KEY environment variable.");
+        }
+        this.http = new http_js_1.HttpClient(options.baseUrl ?? DEFAULT_BASE_URL, options.apiKey);
+        this.wallet = new wallet_js_1.WalletModule(this.http);
+        this.x402 = new x402_js_1.X402Module(this.http);
+    }
+}
+exports.OrbWallet = OrbWallet;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AACA,6CAA6C;AAC7C,mDAAmD;AACnD,+CAA+C;AAE/C,qEAAqE;AACrE,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,SAAS;IAiBpB;;;;;;OAMG;IACH,YAAY,OAAyB;QACnC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,SAAS,CACjB,mCAAmC;gBACjC,4DAA4D;gBAC5D,mCAAmC,CACtC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,oBAAU,CACxB,OAAO,CAAC,OAAO,IAAI,gBAAgB,EACnC,OAAO,CAAC,MAAM,CACf,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,oBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF;AAzCD,8BAyCC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @orbserv-labs/orb-wallet
+ *
+ * TypeScript SDK for the orbserv agent wallet API.
+ *
+ * @example
+ * ```typescript
+ * import { OrbWallet } from '@orbserv-labs/orb-wallet'
+ *
+ * const orb = new OrbWallet({ apiKey: process.env.ORB_API_KEY! })
+ * const wallet = await orb.wallet.create({ name: "my-agent", chains: ["solana", "base"] })
+ * ```
+ *
+ * @module
+ */
+export { OrbWallet } from "./client.js";
+export { WalletModule } from "./modules/wallet.js";
+export { AgentWallet } from "./modules/agent-wallet.js";
+export { PolicyModule } from "./modules/policy.js";
+export { X402Module } from "./modules/x402.js";
+export { OrbError, OrbApiError, OrbAuthError } from "./utils/errors.js";
+export { HttpClient } from "./utils/http.js";
+export type { Chain, Token, OrbWalletOptions, CreateWalletOptions, WalletData, ChainAddress, PolicyConfig, SendOptions, Transaction, HistoryOptions, HistoryResponse, BalanceEntry, BalanceResponse, PolicyData, UpdatePolicyOptions, X402DiscoverOptions, X402DiscoverResponse, X402Service, X402FetchResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,YAAY,EAEV,KAAK,EACL,KAAK,EAEL,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,YAAY,EAEZ,WAAW,EACX,WAAW,EAEX,cAAc,EACd,eAAe,EAEf,YAAY,EACZ,eAAe,EAEf,UAAU,EACV,mBAAmB,EAEnB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @orbserv-labs/orb-wallet
+ *
+ * TypeScript SDK for the orbserv agent wallet API.
+ *
+ * @example
+ * ```typescript
+ * import { OrbWallet } from '@orbserv-labs/orb-wallet'
+ *
+ * const orb = new OrbWallet({ apiKey: process.env.ORB_API_KEY! })
+ * const wallet = await orb.wallet.create({ name: "my-agent", chains: ["solana", "base"] })
+ * ```
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = exports.OrbAuthError = exports.OrbApiError = exports.OrbError = exports.X402Module = exports.PolicyModule = exports.AgentWallet = exports.WalletModule = exports.OrbWallet = void 0;
+// Main client
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "OrbWallet", { enumerable: true, get: function () { return client_js_1.OrbWallet; } });
+// Modules (useful for typing constructor params / DI)
+var wallet_js_1 = require("./modules/wallet.js");
+Object.defineProperty(exports, "WalletModule", { enumerable: true, get: function () { return wallet_js_1.WalletModule; } });
+var agent_wallet_js_1 = require("./modules/agent-wallet.js");
+Object.defineProperty(exports, "AgentWallet", { enumerable: true, get: function () { return agent_wallet_js_1.AgentWallet; } });
+var policy_js_1 = require("./modules/policy.js");
+Object.defineProperty(exports, "PolicyModule", { enumerable: true, get: function () { return policy_js_1.PolicyModule; } });
+var x402_js_1 = require("./modules/x402.js");
+Object.defineProperty(exports, "X402Module", { enumerable: true, get: function () { return x402_js_1.X402Module; } });
+// Error classes
+var errors_js_1 = require("./utils/errors.js");
+Object.defineProperty(exports, "OrbError", { enumerable: true, get: function () { return errors_js_1.OrbError; } });
+Object.defineProperty(exports, "OrbApiError", { enumerable: true, get: function () { return errors_js_1.OrbApiError; } });
+Object.defineProperty(exports, "OrbAuthError", { enumerable: true, get: function () { return errors_js_1.OrbAuthError; } });
+// HTTP client (exposed for advanced use, e.g. testing)
+var http_js_1 = require("./utils/http.js");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_js_1.HttpClient; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,cAAc;AACd,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,sDAAsD;AACtD,iDAAmD;AAA1C,yGAAA,YAAY,OAAA;AACrB,6DAAwD;AAA/C,8GAAA,WAAW,OAAA;AACpB,iDAAmD;AAA1C,yGAAA,YAAY,OAAA;AACrB,6CAA+C;AAAtC,qGAAA,UAAU,OAAA;AAEnB,gBAAgB;AAChB,+CAAwE;AAA/D,qGAAA,QAAQ,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,yGAAA,YAAY,OAAA;AAE5C,uDAAuD;AACvD,2CAA6C;AAApC,qGAAA,UAAU,OAAA"}

package/dist/modules/agent-wallet.d.ts

@@ -0,0 +1,118 @@
+import type { HttpClient } from "../utils/http.js";
+import type { WalletData, ChainAddress, SendOptions, Transaction, HistoryOptions, HistoryResponse, BalanceResponse, X402FetchResult } from "../types.js";
+import { PolicyModule } from "./policy.js";
+/**
+ * Represents a live agent wallet instance.
+ *
+ * Returned by `orb.wallet.create()`, `orb.wallet.get()`, and `orb.wallet.list()`.
+ * Provides direct methods for sending funds, querying history/balance, and
+ * managing the wallet's spending policy.
+ *
+ * @example
+ * ```typescript
+ * const wallet = await orb.wallet.create({ name: "my-agent", chains: ["solana", "base"] })
+ *
+ * wallet.solana.address  // Sol address
+ * wallet.evm.address     // 0x address
+ *
+ * await wallet.send({ to: "0xRecipient", amount: 5, token: "USDC", chain: "base" })
+ * ```
+ */
+export declare class AgentWallet {
+    /** Unique wallet identifier. */
+    readonly id: string;
+    /** Human-readable wallet name. */
+    readonly name: string;
+    /**
+     * Solana address details.
+     * Present only when the wallet was created with `chains: ["solana", ...]`.
+     */
+    readonly solana: ChainAddress;
+    /**
+     * EVM address details (shared across Base, Ethereum, Arbitrum).
+     * Present only when at least one EVM chain was included at creation.
+     */
+    readonly evm: ChainAddress;
+    /** ISO 8601 timestamp of wallet creation. */
+    readonly createdAt: string;
+    /** Current wallet status. */
+    readonly status: WalletData["status"];
+    /**
+     * Spending policy manager for this wallet.
+     *
+     * @example
+     * ```typescript
+     * await wallet.policy.update({ dailyLimit: 100 })
+     * await wallet.policy.pause()
+     * await wallet.policy.resume()
+     * ```
+     */
+    readonly policy: PolicyModule;
+    private readonly http;
+    private readonly x402Module;
+    constructor(data: WalletData, http: HttpClient);
+    /**
+     * Send tokens from this wallet to another address.
+     *
+     * @param options - Transfer parameters including recipient, amount, token, chain,
+     *   and optional ZK-shielding via `privacy: true`.
+     * @returns The resulting {@link Transaction} record.
+     *
+     * @example
+     * ```typescript
+     * await wallet.send({
+     *   to: "0xRecipient",
+     *   amount: 5,
+     *   token: "USDC",
+     *   chain: "base",
+     *   privacy: true
+     * })
+     * ```
+     */
+    send(options: SendOptions): Promise<Transaction>;
+    /**
+     * Retrieve paginated transaction history for this wallet.
+     *
+     * @param options - Optional filters and pagination parameters.
+     * @returns A {@link HistoryResponse} containing transactions and cursor.
+     *
+     * @example
+     * ```typescript
+     * const history = await wallet.history({ limit: 20 })
+     * history.transactions.forEach(tx => console.log(tx.txHash))
+     * ```
+     */
+    history(options?: HistoryOptions): Promise<HistoryResponse>;
+    /**
+     * Get the current token balances for this wallet across all active chains.
+     *
+     * @returns A {@link BalanceResponse} with per-chain, per-token balances and
+     *   a total USD value.
+     *
+     * @example
+     * ```typescript
+     * const balance = await wallet.balance()
+     * console.log(`Total: $${balance.totalUsdValue}`)
+     * ```
+     */
+    balance(): Promise<BalanceResponse>;
+    /**
+     * Perform an HTTP request with automatic x402 payment handling.
+     *
+     * If the target URL returns `HTTP 402 Payment Required`, the SDK
+     * automatically negotiates and submits a micro-payment from this wallet
+     * and retries the request — no manual intervention needed.
+     *
+     * @param url - The URL to fetch.
+     * @param init - Optional fetch `RequestInit` options.
+     * @returns An {@link X402FetchResult} with the final Response.
+     *
+     * @example
+     * ```typescript
+     * const { response } = await wallet.fetch("https://api.service.com/data")
+     * const json = await response.json()
+     * ```
+     */
+    fetch(url: string, init?: RequestInit): Promise<X402FetchResult>;
+}
+//# sourceMappingURL=agent-wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-wallet.d.ts","sourceRoot":"","sources":["../../src/modules/agent-wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW;IACtB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAE3B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEtC;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU;IAqB9C;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IActD;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAarE;;;;;;;;;;;OAWG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAQzC;;;;;;;;;;;;;;;;OAgBG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAGvE"}

package/dist/modules/agent-wallet.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentWallet = void 0;
+const policy_js_1 = require("./policy.js");
+const x402_js_1 = require("./x402.js");
+/**
+ * Represents a live agent wallet instance.
+ *
+ * Returned by `orb.wallet.create()`, `orb.wallet.get()`, and `orb.wallet.list()`.
+ * Provides direct methods for sending funds, querying history/balance, and
+ * managing the wallet's spending policy.
+ *
+ * @example
+ * ```typescript
+ * const wallet = await orb.wallet.create({ name: "my-agent", chains: ["solana", "base"] })
+ *
+ * wallet.solana.address  // Sol address
+ * wallet.evm.address     // 0x address
+ *
+ * await wallet.send({ to: "0xRecipient", amount: 5, token: "USDC", chain: "base" })
+ * ```
+ */
+class AgentWallet {
+    constructor(data, http) {
+        this.id = data.id;
+        this.name = data.name;
+        this.createdAt = data.createdAt;
+        this.status = data.status;
+        // Provide safe defaults so that callers using TypeScript strict mode can
+        // rely on these being defined — the API always returns addresses for the
+        // chains that were activated at creation time.
+        this.solana = data.solana ?? { address: "", chain: "solana" };
+        this.evm = data.evm ?? { address: "", chain: "base" };
+        this.http = http;
+        this.policy = new policy_js_1.PolicyModule(http, data.id);
+        this.x402Module = new x402_js_1.X402Module(http);
+    }
+    // -------------------------------------------------------------------------
+    // Funds
+    // -------------------------------------------------------------------------
+    /**
+     * Send tokens from this wallet to another address.
+     *
+     * @param options - Transfer parameters including recipient, amount, token, chain,
+     *   and optional ZK-shielding via `privacy: true`.
+     * @returns The resulting {@link Transaction} record.
+     *
+     * @example
+     * ```typescript
+     * await wallet.send({
+     *   to: "0xRecipient",
+     *   amount: 5,
+     *   token: "USDC",
+     *   chain: "base",
+     *   privacy: true
+     * })
+     * ```
+     */
+    async send(options) {
+        return this.http.post(`/wallets/${this.id}/send`, {
+            to: options.to,
+            amount: options.amount,
+            token: options.token ?? "USDC",
+            chain: options.chain,
+            privacy: options.privacy ?? false,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // History & balance
+    // -------------------------------------------------------------------------
+    /**
+     * Retrieve paginated transaction history for this wallet.
+     *
+     * @param options - Optional filters and pagination parameters.
+     * @returns A {@link HistoryResponse} containing transactions and cursor.
+     *
+     * @example
+     * ```typescript
+     * const history = await wallet.history({ limit: 20 })
+     * history.transactions.forEach(tx => console.log(tx.txHash))
+     * ```
+     */
+    async history(options = {}) {
+        const params = new URLSearchParams();
+        if (options.limit !== undefined)
+            params.set("limit", String(options.limit));
+        if (options.cursor)
+            params.set("cursor", options.cursor);
+        if (options.chain)
+            params.set("chain", options.chain);
+        if (options.token)
+            params.set("token", options.token);
+        const query = params.toString();
+        return this.http.get(`/wallets/${this.id}/history${query ? `?${query}` : ""}`);
+    }
+    /**
+     * Get the current token balances for this wallet across all active chains.
+     *
+     * @returns A {@link BalanceResponse} with per-chain, per-token balances and
+     *   a total USD value.
+     *
+     * @example
+     * ```typescript
+     * const balance = await wallet.balance()
+     * console.log(`Total: $${balance.totalUsdValue}`)
+     * ```
+     */
+    async balance() {
+        return this.http.get(`/wallets/${this.id}/balance`);
+    }
+    // -------------------------------------------------------------------------
+    // x402 auto-pay
+    // -------------------------------------------------------------------------
+    /**
+     * Perform an HTTP request with automatic x402 payment handling.
+     *
+     * If the target URL returns `HTTP 402 Payment Required`, the SDK
+     * automatically negotiates and submits a micro-payment from this wallet
+     * and retries the request — no manual intervention needed.
+     *
+     * @param url - The URL to fetch.
+     * @param init - Optional fetch `RequestInit` options.
+     * @returns An {@link X402FetchResult} with the final Response.
+     *
+     * @example
+     * ```typescript
+     * const { response } = await wallet.fetch("https://api.service.com/data")
+     * const json = await response.json()
+     * ```
+     */
+    async fetch(url, init) {
+        return this.x402Module.fetch(this.id, url, init);
+    }
+}
+exports.AgentWallet = AgentWallet;
+//# sourceMappingURL=agent-wallet.js.map

package/dist/modules/agent-wallet.js.map

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