@blindmarket/sdk 0.1.6 → 0.1.8

package/dist/index.js

@@ -1,4 +1,36 @@
 import { ethers } from 'ethers';
+// ── Helpers ─────────────────────────────────────────────────────────────────
+class ApiError extends Error {
+    status;
+    body;
+    constructor(status, message, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'ApiError';
+    }
+}
+// ── Main client ─────────────────────────────────────────────────────────────
+/**
+ * BlindMarket REST API client.
+ *
+ * Two usage modes:
+ * 1. **High-level (this class)** — talks to the BlindMarket backend over REST.
+ *    Covers the full task lifecycle, agent management, A2A, and marketplace.
+ * 2. **Low-level primitives** — `Agent`, `Worker`, `PrivateKeySigner`, etc.
+ *    for on-chain + crypto operations when you need direct chain access.
+ *
+ * @example
+ * ```ts
+ * const bb = new BlindMarket({ apiKey: process.env.BLINDMARKET_API_KEY! });
+ *
+ * // Deploy an agent
+ * const agent = await bb.deployAgent({ name: 'my-agent', ... });
+ *
+ * // Watch for status changes
+ * const unsub = bb.watchTask(42, (state) => console.log(state.status));
+ * ```
+ */
 export class BlindMarket {
     apiBase;
     apiKey;
@@ -6,25 +38,107 @@ export class BlindMarket {
         this.apiBase = config.apiBase ?? 'https://api.blindmarket.xyz';
         this.apiKey = config.apiKey;
     }
+    // ── Tools ─────────────────────────────────────────────────────────────────
+    /**
+     * Tool definitions for AI agent frameworks. Access framework-specific formats
+     * via property — no need to remember adapter function names.
+     *
+     * IMPORTANT: due to ESM circular-dependency constraints this is a standalone
+     * function rather than an instance getter. You pass `bb` once and reach the
+     * format you need.
+     *
+     * @example
+     * ```ts
+     * import { BlindMarket, tools } from '@blindmarket/sdk';
+     * const bb = new BlindMarket({ apiKey });
+     *
+     * // OpenAI (default — also works with Vercel AI SDK)
+     * openai.chat.completions.create({ model: 'gpt-4', tools: tools(bb).definitions });
+     *
+     * // LangChain
+     * createReactAgent({ llm, tools: tools(bb).langchain });
+     *
+     * // Claude
+     * anthropic.messages.create({ model, tools: tools(bb).claude });
+     *
+     * // Vercel
+     * generateText({ model, tools: tools(bb).vercel });
+     * ```
+     */
     async req(method, path, body) {
         const res = await fetch(`${this.apiBase}${path}`, {
             method,
-            headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${this.apiKey}` },
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
             body: body ? JSON.stringify(body) : undefined,
         });
         const json = await res.json();
-        if (!json.success)
-            throw new Error(json.error?.message ?? `HTTP ${res.status}`);
+        if (!json.success) {
+            throw new ApiError(res.status, json.error?.message ?? `HTTP ${res.status}`, json);
+        }
         return json.data;
     }
-    // ── Agent deployment ──────────────────────────────────────────────────────
+    // ── Health & Stats ──────────────────────────────────────────────────────
+    /** Backend liveness check. */
+    async health() {
+        return this.req('GET', '/health');
+    }
+    /** Live platform counts. */
+    async stats() {
+        return this.req('GET', '/api/v1/stats');
+    }
+    // ── Task lifecycle ──────────────────────────────────────────────────────
+    /** List open tasks (human-readable). */
+    async listTasks(limit = 20) {
+        const { tasks } = await this.req('GET', `/api/v1/tasks?limit=${limit}`);
+        return tasks;
+    }
+    /** Get full task details (on-chain + A2A state). */
+    async getTask(id) {
+        return this.req('GET', `/api/v1/tasks/${id}`);
+    }
+    /**
+     * Build an unsigned `createTask` transaction.
+     * You must sign and broadcast it with your wallet.
+     */
+    async createTask(params) {
+        return this.req('POST', '/api/v1/tasks', params);
+    }
+    /**
+     * Build an unsigned `assignWorker` transaction.
+     */
+    async assignWorker(taskId, worker) {
+        return this.req('POST', `/api/v1/tasks/${taskId}/assign`, { worker });
+    }
+    /**
+     * Build an unsigned `cancelTask` transaction.
+     */
+    async cancelTask(taskId) {
+        return this.req('POST', `/api/v1/tasks/${taskId}/cancel`);
+    }
+    /**
+     * Build an unsigned `claimTimeout` transaction.
+     */
+    async claimTimeout(taskId) {
+        return this.req('POST', `/api/v1/tasks/${taskId}/timeout`);
+    }
     /**
-     * Deploy a new agent. Generates a wallet, mints an INFT, returns the agent.
+     * Build an unsigned `submitEvidence` transaction.
+     */
+    async submitEvidence(params) {
+        return this.req('POST', '/api/v1/submissions/submit', params);
+    }
+    // ── Agent deployment & management ─────────────────────────────────────────
+    /**
+     * Deploy a new agent. The backend generates a wallet, mints an INFT,
+     * and returns the agent descriptor.
      *
      * @example
      * const agent = await bb.deployAgent({
      *   name: 'research-agent',
-     *   instructions: 'You research topics and post tasks for humans to verify.',
+     *   instructions: 'You research topics and post tasks.',
      *   provider: 'anthropic',
      *   model: 'claude-sonnet-4-5',
      *   apiKey: process.env.ANTHROPIC_API_KEY!,
@@ -36,41 +150,317 @@ export class BlindMarket {
         return this.req('POST', '/api/v1/agents/deploy', params);
     }
     /**
-     * List all agents owned by an address.
+     * One-shot agent creation: generates a secp256k1 wallet, then registers the
+     * agent as an executor in the A2A marketplace with the generated wallet
+     * address and public key. Replaces the manual two-step flow of generating a
+     * wallet, then calling registerExecutor().
+     *
+     * The private key is returned **once** in the response — store it securely.
+     *
+     * @example
+     * const { executor, wallet } = await bb.createAgent({
+     *   displayName: 'DataBot',
+     *   capabilities: [AgentCap.DATA_PROCESSING, AgentCap.WEB_RESEARCH],
+     *   minReward: '1000000000000000000', // 1 0G in wei
+     * });
+     * console.log(`Agent ${wallet.address} registered as ${executor.address}`);
      */
+    async createAgent(params) {
+        const wallet = ethers.Wallet.createRandom();
+        const executor = {
+            address: wallet.address,
+            displayName: params.displayName,
+            capabilities: params.capabilities,
+            publicKey: wallet.publicKey.slice(2), // strip 0x prefix — backend expects raw hex
+            agentCardUrl: params.agentCardUrl,
+            mcpEndpointUrl: params.mcpEndpointUrl,
+            minReward: params.minReward,
+            preferredCapabilities: params.preferredCapabilities,
+        };
+        const result = await this.registerExecutor(executor);
+        return {
+            executor: result.agent,
+            wallet: {
+                address: wallet.address,
+                publicKey: wallet.publicKey,
+                privateKey: wallet.privateKey,
+            },
+        };
+    }
+    /** List deployed agents, optionally filtered by owner address. */
     async listAgents(ownerAddress) {
-        return this.req('GET', `/api/v1/agents?owner=${ownerAddress}`);
+        const qs = ownerAddress ? `?owner=${ownerAddress}` : '';
+        return this.req('GET', `/api/v1/agents${qs}`);
+    }
+    /** Get a single deployed agent by ID. */
+    async getAgent(id) {
+        return this.req('GET', `/api/v1/agents/${id}`);
+    }
+    /** Get an agent's on-chain wallet address. */
+    async getAgentWallet(id) {
+        return this.req('GET', `/api/v1/agents/${id}/wallet`);
+    }
+    /** Start a deployed agent. Requires owner auth. */
+    async startAgent(id) {
+        return this.req('POST', `/api/v1/agents/${id}/start`);
+    }
+    /** Stop a deployed agent. Requires owner auth. */
+    async stopAgent(id) {
+        return this.req('POST', `/api/v1/agents/${id}/stop`);
+    }
+    /** Pause a deployed agent. Requires owner auth. */
+    async pauseAgent(id) {
+        return this.req('POST', `/api/v1/agents/${id}/pause`);
+    }
+    /** Restart a deployed agent. Requires owner auth. */
+    async restartAgent(id) {
+        return this.req('POST', `/api/v1/agents/${id}/restart`);
     }
-    // ── Task lifecycle ────────────────────────────────────────────────────────
     /**
-     * Assign a worker to a task. Returns an unsigned tx.
+     * Update a deployed agent's config (instructions, model, tools, etc.).
+     * Requires owner auth.
      */
-    async assignWorker(taskId, worker) {
-        return this.req('POST', `/api/v1/tasks/${taskId}/assign`, { worker });
+    async updateAgent(id, patch) {
+        return this.req('PATCH', `/api/v1/agents/${id}`, patch);
+    }
+    // ── A2A executor registration ───────────────────────────────────────────
+    /** Register as an A2A agent executor (worker-side). */
+    async registerExecutor(params) {
+        return this.req('POST', '/api/v1/a2a/register', params);
+    }
+    /** List registered A2A executors, optionally filtered by capability. */
+    async listExecutors(capabilities) {
+        const qs = capabilities?.length ? `?capabilities=${capabilities.join(',')}` : '';
+        return this.req('GET', `/api/v1/a2a/executors${qs}`);
+    }
+    /** Get own executor profile with on-chain + decayed reputation. */
+    async getExecutorProfile() {
+        return this.req('GET', '/api/v1/a2a/profile');
+    }
+    // ── A2A task lifecycle ───────────────────────────────────────────────────
+    /** Browse A2A tasks available for execution. */
+    async browseA2ATasks(params) {
+        const qs = new URLSearchParams();
+        if (params?.capabilities)
+            qs.set('capabilities', params.capabilities.join(','));
+        if (params?.minReputation != null)
+            qs.set('minReputation', String(params.minReputation));
+        const suffix = qs.toString() ? `?${qs.toString()}` : '';
+        return this.req('GET', `/api/v1/a2a/tasks${suffix}`);
+    }
+    /** Register intent to accept a task (bid). */
+    async bidOnTask(taskId) {
+        return this.req('POST', `/api/v1/a2a/tasks/${taskId}/bid`);
+    }
+    /** Accept a task and get wrapped AES key. Requires executor auth. */
+    async acceptTask(taskId) {
+        return this.req('POST', `/api/v1/a2a/tasks/${taskId}/accept`);
+    }
+    /** Submit result for an accepted task. */
+    async submitResult(taskId, resultData) {
+        return this.req('POST', `/api/v1/a2a/tasks/${taskId}/submit`, { resultData });
+    }
+    /** Get tasks posted by the authenticated user. */
+    async getPostedTasks() {
+        return this.req('GET', '/api/v1/a2a/tasks/posted');
+    }
+    /** Get tasks executed by the authenticated user. */
+    async getExecutions(address) {
+        const qs = address ? `?address=${address}` : '';
+        return this.req('GET', `/api/v1/a2a/executions${qs}`);
     }
+    // ── Verification ─────────────────────────────────────────────────────────
     /**
-     * Trigger TEE verification for a task.
+     * Trigger TEE / AI verification for a task.
      */
     async verify(params) {
-        return this.req('POST', '/api/v1/verification/trigger', {
+        return this.req('POST', '/api/v1/verification/verify', {
             taskId: params.taskId,
-            taskCategory: params.category ?? 'general',
-            taskRequirements: params.requirements,
+            taskCategory: params.taskCategory,
+            taskRequirements: params.taskRequirements,
             evidenceSummary: params.evidenceSummary,
         });
     }
+    /** List available 0G Compute inference providers. */
+    async getVerificationProviders() {
+        return this.req('GET', '/api/v1/verification/providers');
+    }
+    /** Check if 0G Compute is configured. */
+    async getVerificationStatus() {
+        return this.req('GET', '/api/v1/verification/status');
+    }
+    // ── Reputation ──────────────────────────────────────────────────────────
+    /** Get merged reputation (on-chain + off-chain) for an address. */
+    async getReputation(address) {
+        return this.req('GET', `/api/v1/reputation/${address}`);
+    }
+    /** Get top workers by decayed score. */
+    async getLeaderboard(limit = 50) {
+        return this.req('GET', `/api/v1/reputation/leaderboard?limit=${limit}`);
+    }
+    // ── Storage ─────────────────────────────────────────────────────────────
+    /** Upload an encrypted blob to 0G Storage. */
+    async uploadBlob(data) {
+        return this.req('POST', '/api/v1/storage/upload', { data });
+    }
+    /** Download a blob by root hash. */
+    async downloadBlob(rootHash) {
+        return this.req('GET', `/api/v1/storage/${rootHash}`);
+    }
+    // ── Messages ─────────────────────────────────────────────────────────────
+    /** Send a message to another user or agent. */
+    async sendMessage(params) {
+        return this.req('POST', '/api/v1/messages/send', params);
+    }
+    /** Get inbox messages. */
+    async getInbox() {
+        return this.req('GET', '/api/v1/messages/inbox');
+    }
+    /** Get unread message count. */
+    async getUnreadCount() {
+        return this.req('GET', '/api/v1/messages/unread-count');
+    }
+    // ── Marketplace ─────────────────────────────────────────────────────────
+    /** Search agents by capability and/or minimum rating. */
+    async searchAgents(params) {
+        const qs = new URLSearchParams();
+        if (params?.capability)
+            qs.set('capability', params.capability);
+        if (params?.minRating != null)
+            qs.set('minRating', String(params.minRating));
+        const suffix = qs.toString() ? `?${qs.toString()}` : '';
+        return this.req('GET', `/api/v1/marketplace/agents/search${suffix}`);
+    }
+    /** List public task templates. */
+    async listTemplates() {
+        return this.req('GET', '/api/v1/marketplace/templates');
+    }
+    /** List own templates. */
+    async listMyTemplates() {
+        return this.req('GET', '/api/v1/marketplace/templates/mine');
+    }
+    /** Create a task template. */
+    async createTemplate(params) {
+        return this.req('POST', '/api/v1/marketplace/templates', params);
+    }
+    // ── Event watching ──────────────────────────────────────────────────────
     /**
-     * Get task status.
+     * Poll a task's status at a fixed interval. Calls `callback` on every change.
+     * Returns an unsubscribe function.
+     *
+     * @example
+     * const stop = bb.watchTask('42', (task) => {
+     *   console.log('Status:', task.status);
+     *   if (task.status === 'verified') stop();
+     * });
      */
-    async getTask(taskId) {
-        return this.req('GET', `/api/v1/tasks/${taskId}`);
+    watchTask(taskId, callback, intervalMs = 5_000) {
+        let prev = '';
+        const id = setInterval(async () => {
+            try {
+                const task = await this.getTask(taskId);
+                const cur = task.a2aState?.status ?? String(task.status);
+                if (cur !== prev) {
+                    prev = cur;
+                    callback(task);
+                }
+            }
+            catch {
+                // Silently retry on next tick
+            }
+        }, intervalMs);
+        return () => clearInterval(id);
     }
     /**
-     * List open tasks.
+     * Poll an agent's status at a fixed interval. Returns an unsubscribe function.
      */
-    async listTasks(limit = 20) {
-        const { tasks } = await this.req('GET', `/api/v1/tasks?limit=${limit}`);
-        return tasks;
+    watchAgent(agentId, callback, intervalMs = 5_000) {
+        let prev = '';
+        const id = setInterval(async () => {
+            try {
+                const agent = await this.getAgent(agentId);
+                if (agent.status !== prev) {
+                    prev = agent.status;
+                    callback(agent);
+                }
+            }
+            catch {
+                // Silently retry on next tick
+            }
+        }, intervalMs);
+        return () => clearInterval(id);
+    }
+    // ── Device-flow registration (static) ─────────────────────────────────────
+    /**
+     * Start a device-flow registration session. Generates a magic-link URL
+     * that the user opens in a browser to sign with their wallet.
+     *
+     * After registering, call `BlindMarket.pollSession(token)` to wait for
+     * the user to confirm and receive the API key.
+     *
+     * @example
+     * ```ts
+     * const wallet = ethers.Wallet.createRandom();
+     * const { url, token } = await BlindMarket.register({
+     *   agentName: 'my-agent',
+     *   agentWallet: wallet.address,
+     *   agentPublicKey: wallet.publicKey,
+     * });
+     * console.log('Open', url, 'to confirm');
+     * const apiKey = await BlindMarket.pollSession(token);
+     * const bb = new BlindMarket({ apiKey });
+     * ```
+     */
+    static async register(params) {
+        const base = params.apiBase ?? 'https://api.blindmarket.xyz';
+        const res = await fetch(`${base}/api/v1/registration/session`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                agentName: params.agentName,
+                agentWallet: params.agentWallet,
+                agentPublicKey: params.agentPublicKey,
+            }),
+        });
+        const json = await res.json();
+        if (!json.success)
+            throw new ApiError(res.status, json.error?.message ?? 'Registration failed', json);
+        return json.data;
+    }
+    /**
+     * Poll a device-flow registration session until the user confirms or
+     * the session expires. Returns the API key to use with `new BlindMarket({ apiKey })`.
+     *
+     * @param token - The session token from `BlindMarket.register()`.
+     * @param apiBase - Optional custom API base URL.
+     * @param intervalMs - Poll interval (default 2s).
+     * @param timeoutMs - Max wait time (default 5min).
+     */
+    static async pollSession(token, apiBase, intervalMs = 2_000, timeoutMs = 300_000) {
+        const base = apiBase ?? 'https://api.blindmarket.xyz';
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const res = await fetch(`${base}/api/v1/registration/session/${token}`);
+            const json = await res.json();
+            if (!json.success)
+                throw new ApiError(res.status, json.error?.message ?? 'Session lookup failed', json);
+            if (json.data?.status === 'confirmed' && json.data?.apiKey)
+                return json.data.apiKey;
+            if (json.data?.status === 'pending') {
+                await new Promise(r => setTimeout(r, intervalMs));
+                continue;
+            }
+            throw new Error(`Unexpected session status: ${json.data?.status}`);
+        }
+        throw new Error('Registration session timed out');
     }
 }
 export { ethers };
+export { ApiError };
+export { tools, createBlindMarketTools, createTaskTools, createAgentManagementTools, createA2ATools, toLangChainTools, toVercelTools, toOpenAITools, toClaudeTools, } from './tools/index.js';
+export * from './executor/index.js';
+export * from './types.js';
+// Chain abstraction layer
+export { EVMChainAdapter } from './chain/evm/index.js';
+export { createChainAdapter } from './chain/createChainAdapter.js';
+export { isEVMNetwork } from './network/resolve.js';

package/dist/keystore/InMemoryKeyStore.js

@@ -1,7 +1,7 @@
 import { aesDecrypt, aesEncrypt, generateAesKey, hkdfSha256 } from '../crypto/index.js';
 import { CryptoError } from '../errors/index.js';
-const EXPORT_FORMAT = 'blindbounty.keystore.v1';
-const EXPORT_INFO = new TextEncoder().encode('BlindBounty-Keystore-Export-v1');
+const EXPORT_FORMAT = 'blindmarket.keystore.v1';
+const EXPORT_INFO = new TextEncoder().encode('BlindMarket-Keystore-Export-v1');
 /**
  * Default KeyStore. Non-persistent — keys live only for the process lifetime.
  * Export/import is encrypted with a passphrase via HKDF-derived AES-256-GCM,

package/dist/network/presets.d.ts

@@ -1,14 +1,43 @@
 /**
  * Known-good network presets. Addresses pinned per SDK version so upgrading
  * the SDK cannot silently move contracts under a consumer.
- *
- * testnet = 0G Galileo (chainId 16602) — addresses from
- * contracts/deployments/0g-testnet.json (deployed 2026-04-15).
  */
+export type NetworkName = 'testnet' | 'og-testnet' | 'og-mainnet';
 export declare const networks: {
+    readonly 'og-testnet': {
+        readonly name: "0g-galileo-testnet";
+        readonly chainType: "evm";
+        readonly chainId: 16602;
+        readonly rpc: ["https://evmrpc-testnet.0g.ai"];
+        readonly contracts: {
+            readonly escrow: "0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681";
+            readonly registry: "0xeE52d780A47F77E8a4a1cEb236e3C65A48FbD828";
+            readonly reputation: "0x4A6374Fae37E19E69ba43E7cf6994AC15F63256e";
+            readonly usdc: "0x317227efcA18D004E12CA8046AEf7E1597458F25";
+        };
+        readonly indexer: "https://indexer-storage-testnet-turbo.0g.ai";
+        readonly broker: "https://broker.testnet.0g.ai";
+        readonly explorer: "https://chainscan-galileo.0g.ai";
+    };
+    readonly 'og-mainnet': {
+        readonly name: "0g-mainnet";
+        readonly chainType: "evm";
+        readonly chainId: 16661;
+        readonly rpc: ["https://evmrpc.0g.ai"];
+        readonly contracts: {
+            readonly escrow: "0x3d0374963DaaD43e31d42373eb11156A8e8ce2Ff";
+            readonly registry: "0x9CCF9c196006B573FaA9C9c9CebDd1296dbd5cE0";
+            readonly reputation: "0x3af9232009C5da30AdA366B6E09849A040162A1a";
+            readonly usdc: "0x0000000000000000000000000000000000000000";
+        };
+        readonly indexer: "https://indexer-storage-turbo.0g.ai";
+        readonly broker: "https://broker.0g.ai";
+        readonly explorer: "https://chainscan.0g.ai";
+    };
     readonly testnet: {
         readonly name: "0g-galileo-testnet";
-        readonly chainId: 16602n;
+        readonly chainType: "evm";
+        readonly chainId: 16602;
         readonly rpc: ["https://evmrpc-testnet.0g.ai"];
         readonly contracts: {
             readonly escrow: "0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681";
@@ -21,4 +50,3 @@ export declare const networks: {
         readonly explorer: "https://chainscan-galileo.0g.ai";
     };
 };
-export type NetworkName = keyof typeof networks;

package/dist/network/presets.js

@@ -1,14 +1,41 @@
-/**
- * Known-good network presets. Addresses pinned per SDK version so upgrading
- * the SDK cannot silently move contracts under a consumer.
- *
- * testnet = 0G Galileo (chainId 16602) — addresses from
- * contracts/deployments/0g-testnet.json (deployed 2026-04-15).
- */
 export const networks = {
+    // ── 0G EVM chains ─────────────────────────────────────────────────────
+    'og-testnet': {
+        name: '0g-galileo-testnet',
+        chainType: 'evm',
+        chainId: 16602,
+        rpc: ['https://evmrpc-testnet.0g.ai'],
+        contracts: {
+            escrow: '0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681',
+            registry: '0xeE52d780A47F77E8a4a1cEb236e3C65A48FbD828',
+            reputation: '0x4A6374Fae37E19E69ba43E7cf6994AC15F63256e',
+            usdc: '0x317227efcA18D004E12CA8046AEf7E1597458F25',
+        },
+        indexer: 'https://indexer-storage-testnet-turbo.0g.ai',
+        broker: 'https://broker.testnet.0g.ai',
+        explorer: 'https://chainscan-galileo.0g.ai',
+    },
+    'og-mainnet': {
+        name: '0g-mainnet',
+        chainType: 'evm',
+        chainId: 16661,
+        rpc: ['https://evmrpc.0g.ai'],
+        contracts: {
+            escrow: '0x3d0374963DaaD43e31d42373eb11156A8e8ce2Ff',
+            registry: '0x9CCF9c196006B573FaA9C9c9CebDd1296dbd5cE0',
+            reputation: '0x3af9232009C5da30AdA366B6E09849A040162A1a',
+            usdc: '0x0000000000000000000000000000000000000000',
+        },
+        indexer: 'https://indexer-storage-turbo.0g.ai',
+        broker: 'https://broker.0g.ai',
+        explorer: 'https://chainscan.0g.ai',
+    },
+    // ── Backward-compat alias ──────────────────────────────────────────────
+    // Kept so existing code referencing 'testnet' doesn't break.
     testnet: {
         name: '0g-galileo-testnet',
-        chainId: 16602n,
+        chainType: 'evm',
+        chainId: 16602,
         rpc: ['https://evmrpc-testnet.0g.ai'],
         contracts: {
             escrow: '0xFd4F93F5A7BE144c405D1D8fbEC63Fb776207681',

package/dist/network/resolve.d.ts

@@ -1,7 +1,16 @@
 import { type NetworkName } from './presets.js';
-import type { Network } from './types.js';
+import type { Network } from '../chain/domain-types.js';
 /**
- * Resolve a preset name or a literal Network object into the canonical
- * Network used throughout the SDK. Throws ConfigError for unknown names.
+ * Resolve a network preset name or a Network object to a canonical Network.
+ *
+ * When given a string, looks up the preset. When given a Network object,
+ * returns it as-is (pass-through for callers that already have a resolved
+ * network config).
  */
 export declare function resolveNetwork(arg: NetworkName | Network): Network;
+/**
+ * Type guard: check if a Network is an EVM network.
+ */
+export declare function isEVMNetwork(network: Network): network is Network & {
+    chainType: 'evm';
+};

package/dist/network/resolve.js

@@ -1,17 +1,25 @@
 import { ConfigError } from '../errors/index.js';
 import { networks } from './presets.js';
 /**
- * Resolve a preset name or a literal Network object into the canonical
- * Network used throughout the SDK. Throws ConfigError for unknown names.
+ * Resolve a network preset name or a Network object to a canonical Network.
+ *
+ * When given a string, looks up the preset. When given a Network object,
+ * returns it as-is (pass-through for callers that already have a resolved
+ * network config).
  */
 export function resolveNetwork(arg) {
     if (typeof arg === 'string') {
-        const preset = networks[arg];
-        if (!preset) {
-            const known = Object.keys(networks).join(', ');
-            throw new ConfigError('CONFIG/INVALID_NETWORK', `unknown network '${arg}' (known: ${known})`);
+        const net = networks[arg];
+        if (!net) {
+            throw new ConfigError('CONFIG/INVALID_NETWORK', `Unknown network: "${arg}". Known presets: ${Object.keys(networks).join(', ')}`);
         }
-        return preset;
+        return net;
     }
     return arg;
 }
+/**
+ * Type guard: check if a Network is an EVM network.
+ */
+export function isEVMNetwork(network) {
+    return network.chainType === 'evm';
+}