npm - @smartagentkit/langchain - Versions diffs - 0.1.1 → 0.1.3 - Mend

@smartagentkit/langchain 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -16,6 +16,11 @@ import { ISmartAgentKitClient } from '@smartagentkit/sdk';
  * @param client - An initialized SmartAgentKitClient
  * @param walletAddress - The smart wallet address to operate on
  * @param sessionKey - Optional session key private key for signing transactions
+ * @param options - Optional configuration
+ * @param options.confirmBeforeExecute - Async callback invoked before executing any
+ *   transaction (send_transaction or send_batch_transaction). Receives the transaction
+ *   parameters and must return `true` to proceed or `false` to reject the transaction.
+ *   Useful for adding human-in-the-loop approval, logging, or rate-limiting.
  * @returns Array of DynamicStructuredTool instances for use with LangChain agents
  *
  * @example
@@ -23,10 +28,21 @@ import { ISmartAgentKitClient } from '@smartagentkit/sdk';
  * import { createSmartAgentKitTools } from "@smartagentkit/langchain";
  * import { createReactAgent } from "@langchain/langgraph/prebuilt";
  *
- * const tools = createSmartAgentKitTools(client, wallet.address, sessionKey);
+ * const tools = createSmartAgentKitTools(client, wallet.address, sessionKey, {
+ *   confirmBeforeExecute: async ({ target, value, data }) => {
+ *     console.log(`Transaction to ${target} for ${value ?? "0"} wei`);
+ *     return true; // or false to reject
+ *   },
+ * });
  * const agent = createReactAgent({ llm: chatModel, tools });
  * ```
  */
-declare function createSmartAgentKitTools(client: ISmartAgentKitClient, walletAddress: string, sessionKey?: string): DynamicStructuredTool[];
+declare function createSmartAgentKitTools(client: ISmartAgentKitClient, walletAddress: string, sessionKey?: string, options?: {
+    confirmBeforeExecute?: (params: {
+        target: string;
+        value?: string;
+        data?: string;
+    }) => Promise<boolean>;
+}): DynamicStructuredTool[];
 export { createSmartAgentKitTools };

package/dist/index.d.ts CHANGED Viewed

@@ -16,6 +16,11 @@ import { ISmartAgentKitClient } from '@smartagentkit/sdk';
  * @param client - An initialized SmartAgentKitClient
  * @param walletAddress - The smart wallet address to operate on
  * @param sessionKey - Optional session key private key for signing transactions
+ * @param options - Optional configuration
+ * @param options.confirmBeforeExecute - Async callback invoked before executing any
+ *   transaction (send_transaction or send_batch_transaction). Receives the transaction
+ *   parameters and must return `true` to proceed or `false` to reject the transaction.
+ *   Useful for adding human-in-the-loop approval, logging, or rate-limiting.
  * @returns Array of DynamicStructuredTool instances for use with LangChain agents
  *
  * @example
@@ -23,10 +28,21 @@ import { ISmartAgentKitClient } from '@smartagentkit/sdk';
  * import { createSmartAgentKitTools } from "@smartagentkit/langchain";
  * import { createReactAgent } from "@langchain/langgraph/prebuilt";
  *
- * const tools = createSmartAgentKitTools(client, wallet.address, sessionKey);
+ * const tools = createSmartAgentKitTools(client, wallet.address, sessionKey, {
+ *   confirmBeforeExecute: async ({ target, value, data }) => {
+ *     console.log(`Transaction to ${target} for ${value ?? "0"} wei`);
+ *     return true; // or false to reject
+ *   },
+ * });
  * const agent = createReactAgent({ llm: chatModel, tools });
  * ```
  */
-declare function createSmartAgentKitTools(client: ISmartAgentKitClient, walletAddress: string, sessionKey?: string): DynamicStructuredTool[];
+declare function createSmartAgentKitTools(client: ISmartAgentKitClient, walletAddress: string, sessionKey?: string, options?: {
+    confirmBeforeExecute?: (params: {
+        target: string;
+        value?: string;
+        data?: string;
+    }) => Promise<boolean>;
+}): DynamicStructuredTool[];
 export { createSmartAgentKitTools };

package/dist/index.js CHANGED Viewed

@@ -27,10 +27,11 @@ module.exports = __toCommonJS(index_exports);
 // src/tools.ts
 var import_tools = require("@langchain/core/tools");
 var import_zod = require("zod");
+var import_viem = require("viem");
 var addressSchema = import_zod.z.string().regex(/^0x[0-9a-fA-F]{40}$/, "Must be a 0x-prefixed 20-byte hex address");
 var weiValueSchema = import_zod.z.string().regex(/^\d+$/, "Must be a non-negative integer string (wei)");
 var calldataSchema = import_zod.z.string().regex(/^0x([0-9a-fA-F]{2})*$/, "Must be 0x-prefixed hex calldata (even length)");
-function createSmartAgentKitTools(client, walletAddress, sessionKey) {
+function createSmartAgentKitTools(client, walletAddress, sessionKey, options) {
   const address = walletAddress;
   const checkWalletBalance = new import_tools.DynamicStructuredTool({
     name: "check_wallet_balance",
@@ -39,10 +40,10 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
     func: async () => {
       try {
         const balances = await client.getBalances(address);
-        const ethBalance = Number(balances.eth) / 1e18;
+        const ethBalance = (0, import_viem.formatEther)(balances.eth);
         return JSON.stringify({
           wallet: walletAddress,
-          eth: ethBalance.toString(),
+          eth: ethBalance,
           ethWei: balances.eth.toString()
         });
       } catch (error) {
@@ -54,7 +55,7 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
   });
   const checkSpendingAllowance = new import_tools.DynamicStructuredTool({
     name: "check_spending_allowance",
-    description: 'Check how much spending allowance remains for a token on the wallet. The wallet has policy-enforced spending limits per token per time window. Use this to verify you can spend a certain amount before sending a transaction. Use "0x0000000000000000000000000000000000000000" for native ETH.',
+    description: `Check how much spending allowance remains for a token on the wallet. The wallet has policy-enforced spending limits per token per time window. Use this to verify you can spend a certain amount before sending a transaction. Use "0x0000000000000000000000000000000000000000" for native ETH. The 'remaining' field assumes 18 decimals (ETH). For non-ETH tokens, use the 'remainingWei' field and divide by the token's actual decimals.`,
     schema: import_zod.z.object({
       token: addressSchema.describe(
         "Token contract address. Use 0x0000000000000000000000000000000000000000 for native ETH."
@@ -66,12 +67,12 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
           address,
           token
         );
-        const remainingEth = Number(remaining) / 1e18;
+        const remainingFormatted = (0, import_viem.formatEther)(remaining);
         return JSON.stringify({
           wallet: walletAddress,
           token,
           remainingWei: remaining.toString(),
-          remaining: remainingEth.toString()
+          remaining: remainingFormatted
         });
       } catch (error) {
         return JSON.stringify({
@@ -96,6 +97,19 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
     }),
     func: async ({ target, value, data }) => {
       try {
+        if (options?.confirmBeforeExecute) {
+          const confirmed = await options.confirmBeforeExecute({
+            target,
+            value,
+            data
+          });
+          if (!confirmed) {
+            return JSON.stringify({
+              success: false,
+              error: "Transaction rejected by confirmation callback"
+            });
+          }
+        }
         const wallet = {
           address,
           owner: address,
@@ -134,12 +148,27 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
             "Target contract address (0x-prefixed 20-byte hex)"
           ),
           value: weiValueSchema.optional().describe("ETH value in wei (as string). Defaults to '0'."),
-          data: import_zod.z.string().optional().describe("Calldata (0x-prefixed hex). Defaults to '0x'.")
+          data: calldataSchema.optional().describe("Calldata (0x-prefixed hex). Defaults to '0x'.")
         })
       ).min(1).describe("Array of calls to execute atomically")
     }),
     func: async ({ calls }) => {
       try {
+        if (options?.confirmBeforeExecute) {
+          for (const call of calls) {
+            const confirmed = await options.confirmBeforeExecute({
+              target: call.target,
+              value: call.value,
+              data: call.data
+            });
+            if (!confirmed) {
+              return JSON.stringify({
+                success: false,
+                error: "Transaction rejected by confirmation callback"
+              });
+            }
+          }
+        }
         const wallet = {
           address,
           owner: address,
@@ -200,4 +229,3 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
 0 && (module.exports = {
   createSmartAgentKitTools
 });
-//# sourceMappingURL=index.js.map

package/dist/index.mjs CHANGED Viewed

@@ -1,10 +1,11 @@
 // src/tools.ts
 import { DynamicStructuredTool } from "@langchain/core/tools";
 import { z } from "zod";
+import { formatEther } from "viem";
 var addressSchema = z.string().regex(/^0x[0-9a-fA-F]{40}$/, "Must be a 0x-prefixed 20-byte hex address");
 var weiValueSchema = z.string().regex(/^\d+$/, "Must be a non-negative integer string (wei)");
 var calldataSchema = z.string().regex(/^0x([0-9a-fA-F]{2})*$/, "Must be 0x-prefixed hex calldata (even length)");
-function createSmartAgentKitTools(client, walletAddress, sessionKey) {
+function createSmartAgentKitTools(client, walletAddress, sessionKey, options) {
   const address = walletAddress;
   const checkWalletBalance = new DynamicStructuredTool({
     name: "check_wallet_balance",
@@ -13,10 +14,10 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
     func: async () => {
       try {
         const balances = await client.getBalances(address);
-        const ethBalance = Number(balances.eth) / 1e18;
+        const ethBalance = formatEther(balances.eth);
         return JSON.stringify({
           wallet: walletAddress,
-          eth: ethBalance.toString(),
+          eth: ethBalance,
           ethWei: balances.eth.toString()
         });
       } catch (error) {
@@ -28,7 +29,7 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
   });
   const checkSpendingAllowance = new DynamicStructuredTool({
     name: "check_spending_allowance",
-    description: 'Check how much spending allowance remains for a token on the wallet. The wallet has policy-enforced spending limits per token per time window. Use this to verify you can spend a certain amount before sending a transaction. Use "0x0000000000000000000000000000000000000000" for native ETH.',
+    description: `Check how much spending allowance remains for a token on the wallet. The wallet has policy-enforced spending limits per token per time window. Use this to verify you can spend a certain amount before sending a transaction. Use "0x0000000000000000000000000000000000000000" for native ETH. The 'remaining' field assumes 18 decimals (ETH). For non-ETH tokens, use the 'remainingWei' field and divide by the token's actual decimals.`,
     schema: z.object({
       token: addressSchema.describe(
         "Token contract address. Use 0x0000000000000000000000000000000000000000 for native ETH."
@@ -40,12 +41,12 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
           address,
           token
         );
-        const remainingEth = Number(remaining) / 1e18;
+        const remainingFormatted = formatEther(remaining);
         return JSON.stringify({
           wallet: walletAddress,
           token,
           remainingWei: remaining.toString(),
-          remaining: remainingEth.toString()
+          remaining: remainingFormatted
         });
       } catch (error) {
         return JSON.stringify({
@@ -70,6 +71,19 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
     }),
     func: async ({ target, value, data }) => {
       try {
+        if (options?.confirmBeforeExecute) {
+          const confirmed = await options.confirmBeforeExecute({
+            target,
+            value,
+            data
+          });
+          if (!confirmed) {
+            return JSON.stringify({
+              success: false,
+              error: "Transaction rejected by confirmation callback"
+            });
+          }
+        }
         const wallet = {
           address,
           owner: address,
@@ -108,12 +122,27 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
             "Target contract address (0x-prefixed 20-byte hex)"
           ),
           value: weiValueSchema.optional().describe("ETH value in wei (as string). Defaults to '0'."),
-          data: z.string().optional().describe("Calldata (0x-prefixed hex). Defaults to '0x'.")
+          data: calldataSchema.optional().describe("Calldata (0x-prefixed hex). Defaults to '0x'.")
         })
       ).min(1).describe("Array of calls to execute atomically")
     }),
     func: async ({ calls }) => {
       try {
+        if (options?.confirmBeforeExecute) {
+          for (const call of calls) {
+            const confirmed = await options.confirmBeforeExecute({
+              target: call.target,
+              value: call.value,
+              data: call.data
+            });
+            if (!confirmed) {
+              return JSON.stringify({
+                success: false,
+                error: "Transaction rejected by confirmation callback"
+              });
+            }
+          }
+        }
         const wallet = {
           address,
           owner: address,
@@ -173,4 +202,3 @@ function createSmartAgentKitTools(client, walletAddress, sessionKey) {
 export {
   createSmartAgentKitTools
 };
-//# sourceMappingURL=index.mjs.map

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@smartagentkit/langchain",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "LangChain integration for SmartAgentKit — AI agent smart wallet tools",
   "license": "MIT",
   "author": "SmartAgentKit Contributors",
@@ -40,8 +40,9 @@
     "access": "public"
   },
   "dependencies": {
+    "viem": "^2.46.0",
     "zod": "^3.24.0",
-    "@smartagentkit/sdk": "0.1.1"
+    "@smartagentkit/sdk": "0.1.3"
   },
   "peerDependencies": {
     "@langchain/core": ">=0.3.0"

package/dist/index.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"sources":["../src/index.ts","../src/tools.ts"],"sourcesContent":["export { createSmartAgentKitTools } from \"./tools.js\";\n","import { DynamicStructuredTool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\nimport type { ISmartAgentKitClient } from \"@smartagentkit/sdk\";\n\n// Reusable Zod pattern for 0x-prefixed Ethereum addresses (20 bytes)\nconst addressSchema = z\n .string()\n .regex(/^0x[0-9a-fA-F]{40}$/, \"Must be a 0x-prefixed 20-byte hex address\");\n\n// Reusable Zod pattern for non-negative integer strings (wei values)\nconst weiValueSchema = z\n .string()\n .regex(/^\\d+$/, \"Must be a non-negative integer string (wei)\");\n\n// Reusable Zod pattern for 0x-prefixed hex calldata (even-length)\nconst calldataSchema = z\n .string()\n .regex(/^0x([0-9a-fA-F]{2})*$/, \"Must be 0x-prefixed hex calldata (even length)\");\n\n/**\n * Creates LangChain tools for interacting with a SmartAgentKit wallet.\n *\n * Returns 5 tools that an LLM agent can use to manage and transact\n * from a policy-governed smart wallet:\n *\n * - **check_wallet_balance** — Get ETH balance\n * - **check_spending_allowance** — Query remaining spending limit for a token\n * - **send_transaction** — Execute an on-chain transaction\n * - **send_batch_transaction** — Execute multiple calls atomically\n * - **check_wallet_status** — Check if wallet is paused\n *\n * @param client - An initialized SmartAgentKitClient\n * @param walletAddress - The smart wallet address to operate on\n * @param sessionKey - Optional session key private key for signing transactions\n * @returns Array of DynamicStructuredTool instances for use with LangChain agents\n *\n * @example\n * ```ts\n * import { createSmartAgentKitTools } from \"@smartagentkit/langchain\";\n * import { createReactAgent } from \"@langchain/langgraph/prebuilt\";\n *\n * const tools = createSmartAgentKitTools(client, wallet.address, sessionKey);\n * const agent = createReactAgent({ llm: chatModel, tools });\n * ```\n */\nexport function createSmartAgentKitTools(\n client: ISmartAgentKitClient,\n walletAddress: string,\n sessionKey?: string,\n): DynamicStructuredTool[] {\n const address = walletAddress as `0x${string}`;\n\n // ─── check_wallet_balance ─────────────────────────────────────\n\n const checkWalletBalance = new DynamicStructuredTool({\n name: \"check_wallet_balance\",\n description:\n \"Check the ETH balance of the agent's smart wallet. \" +\n \"Returns the balance in ETH (assuming 18 decimals). \" +\n \"The raw wei value is also returned for precision. \" +\n \"Use this before sending transactions to ensure sufficient funds.\",\n schema: z.object({}),\n func: async () => {\n try {\n const balances = await client.getBalances(address);\n // Note: Division by 1e18 assumes 18 decimals (correct for native ETH).\n // For ERC-20 tokens, use the raw wei value and the token's actual decimals.\n const ethBalance = Number(balances.eth) / 1e18;\n return JSON.stringify({\n wallet: walletAddress,\n eth: ethBalance.toString(),\n ethWei: balances.eth.toString(),\n });\n } catch (error) {\n return JSON.stringify({\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n // ─── check_spending_allowance ────────────────────────────────\n\n const checkSpendingAllowance = new DynamicStructuredTool({\n name: \"check_spending_allowance\",\n description:\n \"Check how much spending allowance remains for a token on the wallet. \" +\n \"The wallet has policy-enforced spending limits per token per time window. \" +\n \"Use this to verify you can spend a certain amount before sending a transaction. \" +\n 'Use \"0x0000000000000000000000000000000000000000\" for native ETH.',\n schema: z.object({\n token: addressSchema.describe(\n \"Token contract address. Use 0x0000000000000000000000000000000000000000 for native ETH.\",\n ),\n }),\n func: async ({ token }) => {\n try {\n const remaining = await client.getRemainingAllowance(\n address,\n token as `0x${string}`,\n );\n // Note: Division by 1e18 assumes 18 decimals (correct for native ETH).\n // For tokens with different decimals (e.g., USDC = 6), use remainingWei\n // and divide by the token's actual decimal factor.\n const remainingEth = Number(remaining) / 1e18;\n return JSON.stringify({\n wallet: walletAddress,\n token,\n remainingWei: remaining.toString(),\n remaining: remainingEth.toString(),\n });\n } catch (error) {\n return JSON.stringify({\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n // ─── send_transaction ─────────────────────────────────────────\n\n const sendTransaction = new DynamicStructuredTool({\n name: \"send_transaction\",\n description:\n \"Send a transaction from the agent's smart wallet. \" +\n \"The transaction is executed as a UserOperation through ERC-4337 \" +\n \"and is subject to the wallet's policy constraints (spending limits, \" +\n \"allowlist, pause state). All values are in wei (1 ETH = 1e18 wei). \" +\n \"Returns the transaction hash on success.\",\n schema: z.object({\n target: addressSchema.describe(\n \"Target contract address to call (0x-prefixed 20-byte hex)\",\n ),\n value: weiValueSchema\n .optional()\n .describe(\n \"ETH value to send in wei (as string). Defaults to '0'. Example: '1000000000000000' for 0.001 ETH.\",\n ),\n data: calldataSchema\n .optional()\n .describe(\n \"Calldata for the transaction (0x-prefixed hex). Defaults to '0x' for simple ETH transfer.\",\n ),\n }),\n func: async ({ target, value, data }) => {\n try {\n const wallet = {\n address,\n owner: address, // Resolved from connected wallet\n chain: {} as never, // Not used in execute\n isDeployed: true,\n policies: [],\n sessions: [],\n };\n\n const txHash = await client.execute(wallet, {\n target: target as `0x${string}`,\n value: value ? BigInt(value) : 0n,\n data: (data as `0x${string}`) ?? \"0x\",\n sessionKey: sessionKey as `0x${string}` | undefined,\n });\n\n return JSON.stringify({\n success: true,\n transactionHash: txHash,\n });\n } catch (error) {\n return JSON.stringify({\n success: false,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n // ─── send_batch_transaction ───────────────────────────────────\n\n const sendBatchTransaction = new DynamicStructuredTool({\n name: \"send_batch_transaction\",\n description:\n \"Send multiple transactions atomically from the agent's smart wallet. \" +\n \"All calls are bundled into a single UserOperation and either all succeed or all revert. \" +\n \"Useful for approve+swap, multi-transfer, or any multi-step operation. \" +\n \"Subject to the wallet's policy constraints. All values are in wei.\",\n schema: z.object({\n calls: z\n .array(\n z.object({\n target: addressSchema.describe(\n \"Target contract address (0x-prefixed 20-byte hex)\",\n ),\n value: weiValueSchema\n .optional()\n .describe(\"ETH value in wei (as string). Defaults to '0'.\"),\n data: z\n .string()\n .optional()\n .describe(\"Calldata (0x-prefixed hex). Defaults to '0x'.\"),\n }),\n )\n .min(1)\n .describe(\"Array of calls to execute atomically\"),\n }),\n func: async ({ calls }) => {\n try {\n const wallet = {\n address,\n owner: address,\n chain: {} as never,\n isDeployed: true,\n policies: [],\n sessions: [],\n };\n\n const txHash = await client.executeBatch(wallet, {\n calls: calls.map((c) => ({\n target: c.target as `0x${string}`,\n value: c.value ? BigInt(c.value) : 0n,\n data: (c.data as `0x${string}`) ?? \"0x\",\n })),\n sessionKey: sessionKey as `0x${string}` | undefined,\n });\n\n return JSON.stringify({\n success: true,\n transactionHash: txHash,\n callCount: calls.length,\n });\n } catch (error) {\n return JSON.stringify({\n success: false,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n // ─── check_wallet_status ─────────────────────────────────────\n\n const checkWalletStatus = new DynamicStructuredTool({\n name: \"check_wallet_status\",\n description:\n \"Check if the agent's smart wallet is currently paused. \" +\n \"A paused wallet cannot execute any transactions. \" +\n \"The guardian can pause the wallet in emergencies.\",\n schema: z.object({}),\n func: async () => {\n try {\n const paused = await client.isPaused(address);\n return JSON.stringify({\n wallet: walletAddress,\n paused,\n status: paused ? \"paused\" : \"active\",\n });\n } catch (error) {\n return JSON.stringify({\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n return [\n checkWalletBalance,\n checkSpendingAllowance,\n sendTransaction,\n sendBatchTransaction,\n checkWalletStatus,\n ];\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"sources":["../src/tools.ts"],"sourcesContent":["import { DynamicStructuredTool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\nimport type { ISmartAgentKitClient } from \"@smartagentkit/sdk\";\n\n// Reusable Zod pattern for 0x-prefixed Ethereum addresses (20 bytes)\nconst addressSchema = z\n .string()\n .regex(/^0x[0-9a-fA-F]{40}$/, \"Must be a 0x-prefixed 20-byte hex address\");\n\n// Reusable Zod pattern for non-negative integer strings (wei values)\nconst weiValueSchema = z\n .string()\n .regex(/^\\d+$/, \"Must be a non-negative integer string (wei)\");\n\n// Reusable Zod pattern for 0x-prefixed hex calldata (even-length)\nconst calldataSchema = z\n .string()\n .regex(/^0x([0-9a-fA-F]{2})*$/, \"Must be 0x-prefixed hex calldata (even length)\");\n\n/**\n * Creates LangChain tools for interacting with a SmartAgentKit wallet.\n *\n * Returns 5 tools that an LLM agent can use to manage and transact\n * from a policy-governed smart wallet:\n *\n * - **check_wallet_balance** — Get ETH balance\n * - **check_spending_allowance** — Query remaining spending limit for a token\n * - **send_transaction** — Execute an on-chain transaction\n * - **send_batch_transaction** — Execute multiple calls atomically\n * - **check_wallet_status** — Check if wallet is paused\n *\n * @param client - An initialized SmartAgentKitClient\n * @param walletAddress - The smart wallet address to operate on\n * @param sessionKey - Optional session key private key for signing transactions\n * @returns Array of DynamicStructuredTool instances for use with LangChain agents\n *\n * @example\n * ```ts\n * import { createSmartAgentKitTools } from \"@smartagentkit/langchain\";\n * import { createReactAgent } from \"@langchain/langgraph/prebuilt\";\n *\n * const tools = createSmartAgentKitTools(client, wallet.address, sessionKey);\n * const agent = createReactAgent({ llm: chatModel, tools });\n * ```\n */\nexport function createSmartAgentKitTools(\n client: ISmartAgentKitClient,\n walletAddress: string,\n sessionKey?: string,\n): DynamicStructuredTool[] {\n const address = walletAddress as `0x${string}`;\n\n // ─── check_wallet_balance ─────────────────────────────────────\n\n const checkWalletBalance = new DynamicStructuredTool({\n name: \"check_wallet_balance\",\n description:\n \"Check the ETH balance of the agent's smart wallet. \" +\n \"Returns the balance in ETH (assuming 18 decimals). \" +\n \"The raw wei value is also returned for precision. \" +\n \"Use this before sending transactions to ensure sufficient funds.\",\n schema: z.object({}),\n func: async () => {\n try {\n const balances = await client.getBalances(address);\n // Note: Division by 1e18 assumes 18 decimals (correct for native ETH).\n // For ERC-20 tokens, use the raw wei value and the token's actual decimals.\n const ethBalance = Number(balances.eth) / 1e18;\n return JSON.stringify({\n wallet: walletAddress,\n eth: ethBalance.toString(),\n ethWei: balances.eth.toString(),\n });\n } catch (error) {\n return JSON.stringify({\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n // ─── check_spending_allowance ────────────────────────────────\n\n const checkSpendingAllowance = new DynamicStructuredTool({\n name: \"check_spending_allowance\",\n description:\n \"Check how much spending allowance remains for a token on the wallet. \" +\n \"The wallet has policy-enforced spending limits per token per time window. \" +\n \"Use this to verify you can spend a certain amount before sending a transaction. \" +\n 'Use \"0x0000000000000000000000000000000000000000\" for native ETH.',\n schema: z.object({\n token: addressSchema.describe(\n \"Token contract address. Use 0x0000000000000000000000000000000000000000 for native ETH.\",\n ),\n }),\n func: async ({ token }) => {\n try {\n const remaining = await client.getRemainingAllowance(\n address,\n token as `0x${string}`,\n );\n // Note: Division by 1e18 assumes 18 decimals (correct for native ETH).\n // For tokens with different decimals (e.g., USDC = 6), use remainingWei\n // and divide by the token's actual decimal factor.\n const remainingEth = Number(remaining) / 1e18;\n return JSON.stringify({\n wallet: walletAddress,\n token,\n remainingWei: remaining.toString(),\n remaining: remainingEth.toString(),\n });\n } catch (error) {\n return JSON.stringify({\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n // ─── send_transaction ─────────────────────────────────────────\n\n const sendTransaction = new DynamicStructuredTool({\n name: \"send_transaction\",\n description:\n \"Send a transaction from the agent's smart wallet. \" +\n \"The transaction is executed as a UserOperation through ERC-4337 \" +\n \"and is subject to the wallet's policy constraints (spending limits, \" +\n \"allowlist, pause state). All values are in wei (1 ETH = 1e18 wei). \" +\n \"Returns the transaction hash on success.\",\n schema: z.object({\n target: addressSchema.describe(\n \"Target contract address to call (0x-prefixed 20-byte hex)\",\n ),\n value: weiValueSchema\n .optional()\n .describe(\n \"ETH value to send in wei (as string). Defaults to '0'. Example: '1000000000000000' for 0.001 ETH.\",\n ),\n data: calldataSchema\n .optional()\n .describe(\n \"Calldata for the transaction (0x-prefixed hex). Defaults to '0x' for simple ETH transfer.\",\n ),\n }),\n func: async ({ target, value, data }) => {\n try {\n const wallet = {\n address,\n owner: address, // Resolved from connected wallet\n chain: {} as never, // Not used in execute\n isDeployed: true,\n policies: [],\n sessions: [],\n };\n\n const txHash = await client.execute(wallet, {\n target: target as `0x${string}`,\n value: value ? BigInt(value) : 0n,\n data: (data as `0x${string}`) ?? \"0x\",\n sessionKey: sessionKey as `0x${string}` | undefined,\n });\n\n return JSON.stringify({\n success: true,\n transactionHash: txHash,\n });\n } catch (error) {\n return JSON.stringify({\n success: false,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n // ─── send_batch_transaction ───────────────────────────────────\n\n const sendBatchTransaction = new DynamicStructuredTool({\n name: \"send_batch_transaction\",\n description:\n \"Send multiple transactions atomically from the agent's smart wallet. \" +\n \"All calls are bundled into a single UserOperation and either all succeed or all revert. \" +\n \"Useful for approve+swap, multi-transfer, or any multi-step operation. \" +\n \"Subject to the wallet's policy constraints. All values are in wei.\",\n schema: z.object({\n calls: z\n .array(\n z.object({\n target: addressSchema.describe(\n \"Target contract address (0x-prefixed 20-byte hex)\",\n ),\n value: weiValueSchema\n .optional()\n .describe(\"ETH value in wei (as string). Defaults to '0'.\"),\n data: z\n .string()\n .optional()\n .describe(\"Calldata (0x-prefixed hex). Defaults to '0x'.\"),\n }),\n )\n .min(1)\n .describe(\"Array of calls to execute atomically\"),\n }),\n func: async ({ calls }) => {\n try {\n const wallet = {\n address,\n owner: address,\n chain: {} as never,\n isDeployed: true,\n policies: [],\n sessions: [],\n };\n\n const txHash = await client.executeBatch(wallet, {\n calls: calls.map((c) => ({\n target: c.target as `0x${string}`,\n value: c.value ? BigInt(c.value) : 0n,\n data: (c.data as `0x${string}`) ?? \"0x\",\n })),\n sessionKey: sessionKey as `0x${string}` | undefined,\n });\n\n return JSON.stringify({\n success: true,\n transactionHash: txHash,\n callCount: calls.length,\n });\n } catch (error) {\n return JSON.stringify({\n success: false,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n // ─── check_wallet_status ─────────────────────────────────────\n\n const checkWalletStatus = new DynamicStructuredTool({\n name: \"check_wallet_status\",\n description:\n \"Check if the agent's smart wallet is currently paused. \" +\n \"A paused wallet cannot execute any transactions. \" +\n \"The guardian can pause the wallet in emergencies.\",\n schema: z.object({}),\n func: async () => {\n try {\n const paused = await client.isPaused(address);\n return JSON.stringify({\n wallet: walletAddress,\n paused,\n status: paused ? \"paused\" : \"active\",\n });\n } catch (error) {\n return JSON.stringify({\n error: error instanceof Error ? error.message : String(error),\n });\n }\n },\n });\n\n return [\n checkWalletBalance,\n checkSpendingAllowance,\n sendTransaction,\n sendBatchTransaction,\n checkWalletStatus,\n ];\n}\n"],"mappings":"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","names":[]}