@provablehq/aleo-bridge-sdk 0.8.0-rc.0 → 0.11.0

package/dist/agent/index.d.ts

@@ -1,18 +1,19 @@
 import { AgentTool } from '@provablehq/veil-core/agent';
 export { AgentTool, AgentToolHandler, AgentToolSchema } from '@provablehq/veil-core/agent';
-import { y as BridgeClient } from '../createBridgeClient-CjHY-JvW.js';
+import { K as BridgeClient } from '../createBridgeClient-DzmEyXfG.js';
 import '@provablehq/veil-core';
+import '../solana-D5Qr6SLa.js';
 import 'viem';
 
 /**
- * Builds read-only discovery and non-fund-moving planning tools.
+ * Creates tools an agent can use to discover and describe cross-chain transfers.
  *
- * The current tool set cannot sign or submit transactions. A later execution
- * phase adds privileged tools only after xReserve and Hyperlane adapters expose
- * inspectable transaction plans.
+ * The tools list supported assets and routes, validate an amount and recipient,
+ * and quote current costs when the selected route exposes them. They cannot
+ * request a signature, submit a transaction, or move funds.
  *
- * @param client Protocol bridge client supplying registry-bound actions.
- * @returns Agent tools for asset discovery, route discovery, and transfer planning.
+ * @param client Bridge client supplying the supported asset and route catalog.
+ * @returns Non-fund-moving agent tools for discovering and describing transfers.
  *
  * @example
  * const tools = createBridgeAgentTools(createBridgeClient())

package/dist/agent/index.js

@@ -1,6 +1,6 @@
 import {
   createBridgeAgentTools
-} from "../chunk-KG3LFIU5.js";
+} from "../chunk-NTWXJE7R.js";
 export {
   createBridgeAgentTools
 };

package/dist/chunk-NTWXJE7R.js

@@ -0,0 +1,93 @@
+// src/agent/tools.ts
+function createBridgeAgentTools(client) {
+  return [
+    {
+      schema: {
+        name: "bridge_list_assets",
+        description: "List assets available for cross-chain transfers. Returns each chain representation, symbol, decimal precision, and public token identifier without contacting a chain or wallet.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            environment: { type: "string", enum: ["mainnet", "testnet"] },
+            chainId: { type: "string" },
+            symbol: { type: "string" }
+          }
+        }
+      },
+      handler: async (params) => {
+        const filters = params;
+        return client.registry.getAssets({
+          ...filters,
+          environment: filters.environment ?? client.environment
+        });
+      }
+    },
+    {
+      schema: {
+        name: "bridge_list_routes",
+        description: "List supported ways to move assets between chains and the provider responsible for each direction. A metadata-required route is recognized but cannot move funds until its deployed contracts or programs are reviewed.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            environment: { type: "string", enum: ["mainnet", "testnet"] },
+            protocol: { type: "string", enum: ["xreserve", "hyperlane"] },
+            sourceChainId: { type: "string" },
+            destinationChainId: { type: "string" },
+            symbol: { type: "string" },
+            includeUnavailable: { type: "boolean" }
+          }
+        }
+      },
+      handler: async (params) => {
+        const filters = params;
+        return client.registry.getRoutes({
+          ...filters,
+          environment: filters.environment ?? client.environment
+        });
+      }
+    },
+    {
+      schema: {
+        name: "bridge_quote_transfer",
+        description: "Validate and price an intended transfer between two chains through xReserve or Hyperlane. This tool reads current chain or provider state where the selected route exposes live costs, but does not request a wallet signature or move funds.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            source: {
+              type: "object",
+              properties: { chain: { type: "string" }, asset: { type: "string" } },
+              required: ["chain", "asset"]
+            },
+            destination: {
+              type: "object",
+              properties: { chain: { type: "string" }, asset: { type: "string" } },
+              required: ["chain", "asset"]
+            },
+            bridgeProtocol: { type: "string", enum: ["xreserve", "hyperlane"] },
+            amount: { type: "string", description: "Positive decimal amount in source-asset display units." },
+            recipient: { type: "string" },
+            sender: { type: "string" },
+            mintMode: { type: "string", enum: ["public", "record", "private"] }
+          },
+          required: ["source", "destination", "amount", "recipient"]
+        }
+      },
+      handler: async (params) => jsonSafe(await client.quote(params))
+    }
+  ];
+}
+function jsonSafe(value) {
+  if (typeof value === "bigint") return value.toString();
+  if (Array.isArray(value)) return value.map(jsonSafe);
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, entry]) => [key, jsonSafe(entry)])
+    );
+  }
+  return value;
+}
+
+export {
+  createBridgeAgentTools
+};
+//# sourceMappingURL=chunk-NTWXJE7R.js.map

package/dist/chunk-NTWXJE7R.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/tools.ts"],"sourcesContent":["import type { AgentTool } from '@provablehq/veil-core/agent'\nimport type { BridgeClient } from '../clients/createBridgeClient.js'\nimport type { GetAssetsParameters, GetRoutesParameters } from '../types/protocol.js'\n\n/**\n * Creates tools an agent can use to discover and describe cross-chain transfers.\n *\n * The tools list supported assets and routes, validate an amount and recipient,\n * and quote current costs when the selected route exposes them. They cannot\n * request a signature, submit a transaction, or move funds.\n *\n * @param client Bridge client supplying the supported asset and route catalog.\n * @returns Non-fund-moving agent tools for discovering and describing transfers.\n *\n * @example\n * const tools = createBridgeAgentTools(createBridgeClient())\n */\nexport function createBridgeAgentTools(client: BridgeClient): AgentTool[] {\n  return [\n    {\n      schema: {\n        name: 'bridge_list_assets',\n        description: 'List assets available for cross-chain transfers. Returns each chain representation, symbol, decimal precision, and public token identifier without contacting a chain or wallet.',\n        inputSchema: {\n          type: 'object',\n          properties: {\n            environment: { type: 'string', enum: ['mainnet', 'testnet'] },\n            chainId: { type: 'string' },\n            symbol: { type: 'string' },\n          },\n        },\n      },\n      handler: async (params) => {\n        const filters = params as GetAssetsParameters\n        return client.registry.getAssets({\n          ...filters,\n          environment: filters.environment ?? client.environment,\n        })\n      },\n    },\n    {\n      schema: {\n        name: 'bridge_list_routes',\n        description: 'List supported ways to move assets between chains and the provider responsible for each direction. A metadata-required route is recognized but cannot move funds until its deployed contracts or programs are reviewed.',\n        inputSchema: {\n          type: 'object',\n          properties: {\n            environment: { type: 'string', enum: ['mainnet', 'testnet'] },\n            protocol: { type: 'string', enum: ['xreserve', 'hyperlane'] },\n            sourceChainId: { type: 'string' },\n            destinationChainId: { type: 'string' },\n            symbol: { type: 'string' },\n            includeUnavailable: { type: 'boolean' },\n          },\n        },\n      },\n      handler: async (params) => {\n        const filters = params as GetRoutesParameters\n        return client.registry.getRoutes({\n          ...filters,\n          environment: filters.environment ?? client.environment,\n        })\n      },\n    },\n    {\n      schema: {\n        name: 'bridge_quote_transfer',\n        description: 'Validate and price an intended transfer between two chains through xReserve or Hyperlane. This tool reads current chain or provider state where the selected route exposes live costs, but does not request a wallet signature or move funds.',\n        inputSchema: {\n          type: 'object',\n          properties: {\n            source: {\n              type: 'object',\n              properties: { chain: { type: 'string' }, asset: { type: 'string' } },\n              required: ['chain', 'asset'],\n            },\n            destination: {\n              type: 'object',\n              properties: { chain: { type: 'string' }, asset: { type: 'string' } },\n              required: ['chain', 'asset'],\n            },\n            bridgeProtocol: { type: 'string', enum: ['xreserve', 'hyperlane'] },\n            amount: { type: 'string', description: 'Positive decimal amount in source-asset display units.' },\n            recipient: { type: 'string' },\n            sender: { type: 'string' },\n            mintMode: { type: 'string', enum: ['public', 'record', 'private'] },\n          },\n          required: ['source', 'destination', 'amount', 'recipient'],\n        },\n      },\n      handler: async (params) => jsonSafe(await client.quote(params as Parameters<BridgeClient['quote']>[0])),\n    },\n  ]\n}\n\n/** Converts atomic bigint amounts into decimal strings accepted by JSON-based agent transports. */\nfunction jsonSafe(value: unknown): unknown {\n  if (typeof value === 'bigint') return value.toString()\n  if (Array.isArray(value)) return value.map(jsonSafe)\n  if (value && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, entry]) => [key, jsonSafe(entry)]),\n    )\n  }\n  return value\n}\n"],"mappings":";AAiBO,SAAS,uBAAuB,QAAmC;AACxE,SAAO;AAAA,IACL;AAAA,MACE,QAAQ;AAAA,QACN,MAAM;AAAA,QACN,aAAa;AAAA,QACb,aAAa;AAAA,UACX,MAAM;AAAA,UACN,YAAY;AAAA,YACV,aAAa,EAAE,MAAM,UAAU,MAAM,CAAC,WAAW,SAAS,EAAE;AAAA,YAC5D,SAAS,EAAE,MAAM,SAAS;AAAA,YAC1B,QAAQ,EAAE,MAAM,SAAS;AAAA,UAC3B;AAAA,QACF;AAAA,MACF;AAAA,MACA,SAAS,OAAO,WAAW;AACzB,cAAM,UAAU;AAChB,eAAO,OAAO,SAAS,UAAU;AAAA,UAC/B,GAAG;AAAA,UACH,aAAa,QAAQ,eAAe,OAAO;AAAA,QAC7C,CAAC;AAAA,MACH;AAAA,IACF;AAAA,IACA;AAAA,MACE,QAAQ;AAAA,QACN,MAAM;AAAA,QACN,aAAa;AAAA,QACb,aAAa;AAAA,UACX,MAAM;AAAA,UACN,YAAY;AAAA,YACV,aAAa,EAAE,MAAM,UAAU,MAAM,CAAC,WAAW,SAAS,EAAE;AAAA,YAC5D,UAAU,EAAE,MAAM,UAAU,MAAM,CAAC,YAAY,WAAW,EAAE;AAAA,YAC5D,eAAe,EAAE,MAAM,SAAS;AAAA,YAChC,oBAAoB,EAAE,MAAM,SAAS;AAAA,YACrC,QAAQ,EAAE,MAAM,SAAS;AAAA,YACzB,oBAAoB,EAAE,MAAM,UAAU;AAAA,UACxC;AAAA,QACF;AAAA,MACF;AAAA,MACA,SAAS,OAAO,WAAW;AACzB,cAAM,UAAU;AAChB,eAAO,OAAO,SAAS,UAAU;AAAA,UAC/B,GAAG;AAAA,UACH,aAAa,QAAQ,eAAe,OAAO;AAAA,QAC7C,CAAC;AAAA,MACH;AAAA,IACF;AAAA,IACA;AAAA,MACE,QAAQ;AAAA,QACN,MAAM;AAAA,QACN,aAAa;AAAA,QACb,aAAa;AAAA,UACX,MAAM;AAAA,UACN,YAAY;AAAA,YACV,QAAQ;AAAA,cACN,MAAM;AAAA,cACN,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,GAAG,OAAO,EAAE,MAAM,SAAS,EAAE;AAAA,cACnE,UAAU,CAAC,SAAS,OAAO;AAAA,YAC7B;AAAA,YACA,aAAa;AAAA,cACX,MAAM;AAAA,cACN,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,GAAG,OAAO,EAAE,MAAM,SAAS,EAAE;AAAA,cACnE,UAAU,CAAC,SAAS,OAAO;AAAA,YAC7B;AAAA,YACA,gBAAgB,EAAE,MAAM,UAAU,MAAM,CAAC,YAAY,WAAW,EAAE;AAAA,YAClE,QAAQ,EAAE,MAAM,UAAU,aAAa,yDAAyD;AAAA,YAChG,WAAW,EAAE,MAAM,SAAS;AAAA,YAC5B,QAAQ,EAAE,MAAM,SAAS;AAAA,YACzB,UAAU,EAAE,MAAM,UAAU,MAAM,CAAC,UAAU,UAAU,SAAS,EAAE;AAAA,UACpE;AAAA,UACA,UAAU,CAAC,UAAU,eAAe,UAAU,WAAW;AAAA,QAC3D;AAAA,MACF;AAAA,MACA,SAAS,OAAO,WAAW,SAAS,MAAM,OAAO,MAAM,MAA8C,CAAC;AAAA,IACxG;AAAA,EACF;AACF;AAGA,SAAS,SAAS,OAAyB;AACzC,MAAI,OAAO,UAAU,SAAU,QAAO,MAAM,SAAS;AACrD,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,QAAQ;AACnD,MAAI,SAAS,OAAO,UAAU,UAAU;AACtC,WAAO,OAAO;AAAA,MACZ,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,SAAS,KAAK,CAAC,CAAC;AAAA,IACpE;AAAA,EACF;AACA,SAAO;AACT;","names":[]}