@blockrun/elizaos-plugin 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 BlockRun
+
+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,102 @@
+# @elizaos/plugin-blockrun
+
+Pay-per-request AI for ElizaOS agents via x402 micropayments on Base.
+
+## Overview
+
+This plugin enables ElizaOS agents to make LLM API calls using the [x402 protocol](https://x402.org), paying with USDC micropayments on Base chain. No API keys required - just a wallet with USDC.
+
+**Supported Models:**
+- OpenAI: gpt-4o, gpt-4o-mini
+- Anthropic: claude-sonnet-4, claude-3.5-haiku
+- Google: gemini-2.0-flash
+- And more via BlockRun gateway
+
+## Installation
+
+```bash
+npm install @elizaos/plugin-blockrun
+# or
+pnpm add @elizaos/plugin-blockrun
+```
+
+## Configuration
+
+Set your Base chain wallet private key:
+
+```env
+BASE_CHAIN_WALLET_KEY=0x...
+```
+
+Or in agent settings:
+
+```typescript
+const agent = new Agent({
+  plugins: [blockrunPlugin],
+  settings: {
+    BASE_CHAIN_WALLET_KEY: '0x...',
+  },
+});
+```
+
+## Usage
+
+### Plugin Registration
+
+```typescript
+import { blockrunPlugin } from '@elizaos/plugin-blockrun';
+
+const agent = new Agent({
+  plugins: [blockrunPlugin],
+});
+```
+
+### Available Actions
+
+#### BLOCKRUN_CHAT
+
+Make a pay-per-request AI call:
+
+```typescript
+// The action is triggered when the agent needs to query an AI model
+// Payments are handled automatically via x402
+```
+
+### Available Providers
+
+#### BLOCKRUN_WALLET
+
+Provides wallet context to the agent:
+
+```typescript
+// Returns wallet address and USDC balance on Base
+// Useful for agents to understand their payment capacity
+```
+
+## How It Works
+
+1. Agent makes an AI request via BLOCKRUN_CHAT action
+2. BlockRun gateway returns 402 Payment Required with price
+3. Plugin automatically signs USDC payment (EIP-712)
+4. Request is retried with payment signature
+5. AI response is returned to the agent
+
+All payments use USDC on Base chain. Typical cost: $0.001-0.01 per request.
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `BASE_CHAIN_WALLET_KEY` | Private key for Base chain wallet | Yes |
+| `BLOCKRUN_API_URL` | Custom API URL (default: https://blockrun.ai/api) | No |
+| `BLOCKRUN_DEFAULT_MODEL` | Default model (default: openai/gpt-4o-mini) | No |
+
+## Links
+
+- [BlockRun](https://blockrun.ai) - Pay-per-request AI gateway
+- [x402 Protocol](https://x402.org) - HTTP 402 micropayment standard
+- [ElizaOS](https://elizaos.ai) - AI agent framework
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { Action, Provider, Plugin } from '@elizaos/core';
+
+declare const blockrunChatAction: Action;
+
+/**
+ * BlockRun Wallet Provider - Provides wallet address and USDC balance on Base.
+ *
+ * This provider gives the agent context about its payment wallet,
+ * including address and available USDC balance for x402 micropayments.
+ */
+declare const blockrunWalletProvider: Provider;
+
+/**
+ * @elizaos/plugin-blockrun
+ *
+ * BlockRun x402 pay-per-request AI plugin for ElizaOS.
+ *
+ * This plugin enables ElizaOS agents to make LLM API calls using the x402 protocol,
+ * paying with USDC micropayments on Base chain. No API keys required - just a wallet.
+ *
+ * Features:
+ * - Pay-per-request AI access (OpenAI, Anthropic, Google, etc.)
+ * - Automatic x402 micropayment handling
+ * - USDC payments on Base chain
+ * - Wallet balance provider for agent context
+ *
+ * Configuration:
+ * Set BASE_CHAIN_WALLET_KEY in your agent settings or environment.
+ *
+ * @example
+ * ```typescript
+ * import { blockrunPlugin } from '@elizaos/plugin-blockrun';
+ *
+ * const agent = new Agent({
+ *   plugins: [blockrunPlugin],
+ *   settings: {
+ *     BASE_CHAIN_WALLET_KEY: '0x...',
+ *   },
+ * });
+ * ```
+ *
+ * @see https://blockrun.ai
+ * @see https://x402.org
+ */
+
+/**
+ * BlockRun Plugin for ElizaOS
+ *
+ * Enables pay-per-request AI via x402 micropayments on Base.
+ */
+declare const blockrunPlugin: Plugin;
+
+export { blockrunChatAction, blockrunPlugin, blockrunWalletProvider, blockrunPlugin as default };

package/dist/index.js

@@ -0,0 +1,282 @@
+// src/actions/chat.ts
+import {
+  logger
+} from "@elizaos/core";
+import { LLMClient } from "@blockrun/llm";
+var clientCache = /* @__PURE__ */ new Map();
+function getClient(runtime) {
+  const agentId = runtime.agentId;
+  if (clientCache.has(agentId)) {
+    return clientCache.get(agentId);
+  }
+  const privateKey = runtime.getSetting("BASE_CHAIN_WALLET_KEY") || runtime.getSetting("BLOCKRUN_WALLET_KEY") || process.env.BASE_CHAIN_WALLET_KEY;
+  if (!privateKey) {
+    throw new Error(
+      "BlockRun requires a wallet private key. Set BASE_CHAIN_WALLET_KEY in agent settings or environment."
+    );
+  }
+  const apiUrl = runtime.getSetting("BLOCKRUN_API_URL") || "https://blockrun.ai/api";
+  const client = new LLMClient({
+    privateKey,
+    apiUrl
+  });
+  clientCache.set(agentId, client);
+  return client;
+}
+var blockrunChatAction = {
+  name: "BLOCKRUN_CHAT",
+  similes: ["BLOCKRUN_AI", "PAY_PER_REQUEST", "X402_CHAT", "MICROPAY_AI"],
+  description: "Make a pay-per-request AI call using BlockRun x402 protocol. Automatically handles micropayments in USDC on Base chain. Supports multiple AI providers: OpenAI (gpt-4o, gpt-4o-mini), Anthropic (claude-sonnet-4, claude-3.5-haiku), Google (gemini-2.0-flash), and more.",
+  validate: async (runtime) => {
+    try {
+      const privateKey = runtime.getSetting("BASE_CHAIN_WALLET_KEY") || runtime.getSetting("BLOCKRUN_WALLET_KEY") || process.env.BASE_CHAIN_WALLET_KEY;
+      if (!privateKey) {
+        logger.warn({
+          src: "plugin:blockrun:action:chat",
+          agentId: runtime.agentId
+        }, "BlockRun wallet key not configured");
+        return false;
+      }
+      return true;
+    } catch (error) {
+      logger.error({
+        src: "plugin:blockrun:action:chat",
+        error: error instanceof Error ? error.message : String(error)
+      }, "Error validating BlockRun action");
+      return false;
+    }
+  },
+  handler: async (runtime, message, _state, options, callback) => {
+    const startTime = Date.now();
+    try {
+      const client = getClient(runtime);
+      const prompt = message.content?.text || "";
+      if (!prompt) {
+        return {
+          text: "No prompt provided for BlockRun chat",
+          values: { success: false, error: "No prompt" },
+          data: { actionName: "BLOCKRUN_CHAT" },
+          success: false
+        };
+      }
+      const model = options?.model || runtime.getSetting("BLOCKRUN_DEFAULT_MODEL") || "openai/gpt-4o-mini";
+      const systemPrompt = options?.system || runtime.character?.system || void 0;
+      const chatOptions = {
+        system: systemPrompt,
+        maxTokens: options?.maxTokens || 1024,
+        temperature: options?.temperature
+      };
+      logger.info({
+        src: "plugin:blockrun:action:chat",
+        agentId: runtime.agentId,
+        model,
+        promptLength: prompt.length
+      }, "Making BlockRun API call");
+      const response = await client.chat(model, prompt, chatOptions);
+      const latency = Date.now() - startTime;
+      logger.info({
+        src: "plugin:blockrun:action:chat",
+        agentId: runtime.agentId,
+        model,
+        responseLength: response.length,
+        latencyMs: latency
+      }, "BlockRun call completed");
+      if (callback) {
+        await callback({
+          text: response,
+          actions: ["BLOCKRUN_CHAT"]
+        });
+      }
+      return {
+        text: response,
+        values: {
+          success: true,
+          model,
+          responseLength: response.length,
+          latencyMs: latency,
+          walletAddress: client.getWalletAddress()
+        },
+        data: {
+          actionName: "BLOCKRUN_CHAT",
+          model,
+          prompt,
+          response,
+          latencyMs: latency
+        },
+        success: true
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logger.error({
+        src: "plugin:blockrun:action:chat",
+        agentId: runtime.agentId,
+        error: errorMessage
+      }, "BlockRun chat failed");
+      return {
+        text: `BlockRun error: ${errorMessage}`,
+        values: {
+          success: false,
+          error: errorMessage
+        },
+        data: {
+          actionName: "BLOCKRUN_CHAT",
+          error: errorMessage
+        },
+        success: false,
+        error: error instanceof Error ? error : new Error(errorMessage)
+      };
+    }
+  },
+  examples: [
+    [
+      {
+        name: "{{name1}}",
+        content: {
+          text: "Ask BlockRun AI: What is the capital of France?"
+        }
+      },
+      {
+        name: "{{name2}}",
+        content: {
+          text: "The capital of France is Paris.",
+          actions: ["BLOCKRUN_CHAT"]
+        }
+      }
+    ],
+    [
+      {
+        name: "{{name1}}",
+        content: {
+          text: "Use x402 to query: Explain smart contracts in one sentence."
+        }
+      },
+      {
+        name: "{{name2}}",
+        content: {
+          text: "Smart contracts are self-executing programs on a blockchain that automatically enforce agreement terms when conditions are met.",
+          actions: ["BLOCKRUN_CHAT"]
+        }
+      }
+    ],
+    [
+      {
+        name: "{{name1}}",
+        content: {
+          text: "Pay-per-request: Generate a haiku about crypto payments."
+        }
+      },
+      {
+        name: "{{name2}}",
+        content: {
+          text: "Digital coins flow\nMicropayments stream like rain\nValue finds its way",
+          actions: ["BLOCKRUN_CHAT"]
+        }
+      }
+    ]
+  ]
+};
+
+// src/providers/wallet.ts
+import { privateKeyToAccount } from "viem/accounts";
+import { createPublicClient, http, formatUnits } from "viem";
+import { base } from "viem/chains";
+var USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var ERC20_ABI = [
+  {
+    constant: true,
+    inputs: [{ name: "_owner", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ name: "balance", type: "uint256" }],
+    type: "function"
+  }
+];
+var blockrunWalletProvider = {
+  name: "BLOCKRUN_WALLET",
+  get: async (runtime, _message) => {
+    try {
+      const privateKey = runtime.getSetting("BASE_CHAIN_WALLET_KEY") || runtime.getSetting("BLOCKRUN_WALLET_KEY") || process.env.BASE_CHAIN_WALLET_KEY;
+      if (!privateKey) {
+        return {
+          data: {
+            configured: false
+          },
+          values: {
+            walletConfigured: "false"
+          },
+          text: "BlockRun wallet is not configured. Set BASE_CHAIN_WALLET_KEY to enable x402 micropayments."
+        };
+      }
+      const account = privateKeyToAccount(privateKey);
+      const address = account.address;
+      const publicClient = createPublicClient({
+        chain: base,
+        transport: http()
+      });
+      let usdcBalance = "0";
+      let usdcBalanceRaw = BigInt(0);
+      try {
+        usdcBalanceRaw = await publicClient.readContract({
+          address: USDC_BASE,
+          abi: ERC20_ABI,
+          functionName: "balanceOf",
+          args: [address]
+        });
+        usdcBalance = formatUnits(usdcBalanceRaw, 6);
+      } catch {
+      }
+      let ethBalance = "0";
+      try {
+        const ethBalanceRaw = await publicClient.getBalance({ address });
+        ethBalance = formatUnits(ethBalanceRaw, 18);
+      } catch {
+      }
+      return {
+        data: {
+          configured: true,
+          address,
+          usdcBalance: usdcBalanceRaw.toString(),
+          ethBalance,
+          chain: "base",
+          chainId: 8453
+        },
+        values: {
+          walletConfigured: "true",
+          walletAddress: address,
+          usdcBalance: `${usdcBalance} USDC`,
+          ethBalance: `${ethBalance} ETH`
+        },
+        text: `BlockRun wallet is configured. Address: ${address}. USDC balance: ${usdcBalance} USDC on Base. This wallet is used for x402 micropayments when making AI API calls.`
+      };
+    } catch (error) {
+      return {
+        data: {
+          configured: false,
+          error: error instanceof Error ? error.message : String(error)
+        },
+        values: {
+          walletConfigured: "false",
+          error: error instanceof Error ? error.message : "Unknown error"
+        },
+        text: "Failed to get BlockRun wallet information."
+      };
+    }
+  }
+};
+
+// src/index.ts
+var blockrunPlugin = {
+  name: "blockrun",
+  description: "Pay-per-request AI via x402 micropayments on Base. Access OpenAI, Anthropic, Google, and more without API keys.",
+  actions: [blockrunChatAction],
+  providers: [blockrunWalletProvider],
+  evaluators: [],
+  services: []
+};
+var index_default = blockrunPlugin;
+export {
+  blockrunChatAction,
+  blockrunPlugin,
+  blockrunWalletProvider,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/actions/chat.ts","../src/providers/wallet.ts","../src/index.ts"],"sourcesContent":["import {\n  type Action,\n  type ActionExample,\n  type ActionResult,\n  type HandlerCallback,\n  type HandlerOptions,\n  type IAgentRuntime,\n  type Memory,\n  type State,\n  logger,\n} from '@elizaos/core';\nimport { LLMClient, type ChatOptions } from '@blockrun/llm';\n\n/**\n * BlockRun Chat Action - Pay-per-request AI via x402 micropayments on Base.\n *\n * This action enables ElizaOS agents to make LLM API calls using the x402 protocol,\n * paying with USDC on Base chain. Supports OpenAI, Anthropic, Google, and other models.\n */\n\n// Cache client instances per agent to avoid recreating\nconst clientCache = new Map<string, LLMClient>();\n\nfunction getClient(runtime: IAgentRuntime): LLMClient {\n  const agentId = runtime.agentId;\n\n  if (clientCache.has(agentId)) {\n    return clientCache.get(agentId)!;\n  }\n\n  // Get private key from runtime settings or environment\n  const privateKey = runtime.getSetting('BASE_CHAIN_WALLET_KEY') ||\n    runtime.getSetting('BLOCKRUN_WALLET_KEY') ||\n    process.env.BASE_CHAIN_WALLET_KEY;\n\n  if (!privateKey) {\n    throw new Error(\n      'BlockRun requires a wallet private key. Set BASE_CHAIN_WALLET_KEY in agent settings or environment.'\n    );\n  }\n\n  const apiUrl = runtime.getSetting('BLOCKRUN_API_URL') as string | undefined || 'https://blockrun.ai/api';\n\n  const client = new LLMClient({\n    privateKey: privateKey as `0x${string}`,\n    apiUrl: apiUrl as string,\n  });\n\n  clientCache.set(agentId, client);\n  return client;\n}\n\nexport const blockrunChatAction: Action = {\n  name: 'BLOCKRUN_CHAT',\n  similes: ['BLOCKRUN_AI', 'PAY_PER_REQUEST', 'X402_CHAT', 'MICROPAY_AI'],\n  description:\n    'Make a pay-per-request AI call using BlockRun x402 protocol. ' +\n    'Automatically handles micropayments in USDC on Base chain. ' +\n    'Supports multiple AI providers: OpenAI (gpt-4o, gpt-4o-mini), Anthropic (claude-sonnet-4, claude-3.5-haiku), Google (gemini-2.0-flash), and more.',\n\n  validate: async (runtime: IAgentRuntime): Promise<boolean> => {\n    try {\n      const privateKey = runtime.getSetting('BASE_CHAIN_WALLET_KEY') ||\n        runtime.getSetting('BLOCKRUN_WALLET_KEY') ||\n        process.env.BASE_CHAIN_WALLET_KEY;\n\n      if (!privateKey) {\n        logger.warn({\n          src: 'plugin:blockrun:action:chat',\n          agentId: runtime.agentId,\n        }, 'BlockRun wallet key not configured');\n        return false;\n      }\n\n      return true;\n    } catch (error) {\n      logger.error({\n        src: 'plugin:blockrun:action:chat',\n        error: error instanceof Error ? error.message : String(error),\n      }, 'Error validating BlockRun action');\n      return false;\n    }\n  },\n\n  handler: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state?: State,\n    options?: HandlerOptions,\n    callback?: HandlerCallback\n  ): Promise<ActionResult> => {\n    const startTime = Date.now();\n\n    try {\n      const client = getClient(runtime);\n\n      // Extract the prompt from the message\n      const prompt = message.content?.text || '';\n      if (!prompt) {\n        return {\n          text: 'No prompt provided for BlockRun chat',\n          values: { success: false, error: 'No prompt' },\n          data: { actionName: 'BLOCKRUN_CHAT' },\n          success: false,\n        };\n      }\n\n      // Get model from options or use default\n      const model = ((options as Record<string, unknown>)?.model as string) ||\n        (runtime.getSetting('BLOCKRUN_DEFAULT_MODEL') as string) ||\n        'openai/gpt-4o-mini';\n\n      // Get system prompt from character or options\n      const systemPrompt = (options as Record<string, unknown>)?.system as string ||\n        runtime.character?.system ||\n        undefined;\n\n      // Build chat options\n      const chatOptions: ChatOptions = {\n        system: systemPrompt,\n        maxTokens: (options as Record<string, unknown>)?.maxTokens as number || 1024,\n        temperature: (options as Record<string, unknown>)?.temperature as number,\n      };\n\n      logger.info({\n        src: 'plugin:blockrun:action:chat',\n        agentId: runtime.agentId,\n        model,\n        promptLength: prompt.length,\n      }, 'Making BlockRun API call');\n\n      // Make the pay-per-request call\n      const response = await client.chat(model, prompt, chatOptions);\n\n      const latency = Date.now() - startTime;\n\n      logger.info({\n        src: 'plugin:blockrun:action:chat',\n        agentId: runtime.agentId,\n        model,\n        responseLength: response.length,\n        latencyMs: latency,\n      }, 'BlockRun call completed');\n\n      // Send response via callback if provided\n      if (callback) {\n        await callback({\n          text: response,\n          actions: ['BLOCKRUN_CHAT'],\n        });\n      }\n\n      return {\n        text: response,\n        values: {\n          success: true,\n          model,\n          responseLength: response.length,\n          latencyMs: latency,\n          walletAddress: client.getWalletAddress(),\n        },\n        data: {\n          actionName: 'BLOCKRUN_CHAT',\n          model,\n          prompt,\n          response,\n          latencyMs: latency,\n        },\n        success: true,\n      };\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n\n      logger.error({\n        src: 'plugin:blockrun:action:chat',\n        agentId: runtime.agentId,\n        error: errorMessage,\n      }, 'BlockRun chat failed');\n\n      return {\n        text: `BlockRun error: ${errorMessage}`,\n        values: {\n          success: false,\n          error: errorMessage,\n        },\n        data: {\n          actionName: 'BLOCKRUN_CHAT',\n          error: errorMessage,\n        },\n        success: false,\n        error: error instanceof Error ? error : new Error(errorMessage),\n      };\n    }\n  },\n\n  examples: [\n    [\n      {\n        name: '{{name1}}',\n        content: {\n          text: 'Ask BlockRun AI: What is the capital of France?',\n        },\n      },\n      {\n        name: '{{name2}}',\n        content: {\n          text: 'The capital of France is Paris.',\n          actions: ['BLOCKRUN_CHAT'],\n        },\n      },\n    ],\n    [\n      {\n        name: '{{name1}}',\n        content: {\n          text: 'Use x402 to query: Explain smart contracts in one sentence.',\n        },\n      },\n      {\n        name: '{{name2}}',\n        content: {\n          text: 'Smart contracts are self-executing programs on a blockchain that automatically enforce agreement terms when conditions are met.',\n          actions: ['BLOCKRUN_CHAT'],\n        },\n      },\n    ],\n    [\n      {\n        name: '{{name1}}',\n        content: {\n          text: 'Pay-per-request: Generate a haiku about crypto payments.',\n        },\n      },\n      {\n        name: '{{name2}}',\n        content: {\n          text: 'Digital coins flow\\nMicropayments stream like rain\\nValue finds its way',\n          actions: ['BLOCKRUN_CHAT'],\n        },\n      },\n    ],\n  ] as ActionExample[][],\n};\n\nexport default blockrunChatAction;\n","import type { IAgentRuntime, Memory, Provider } from '@elizaos/core';\nimport { privateKeyToAccount } from 'viem/accounts';\nimport { createPublicClient, http, formatUnits } from 'viem';\nimport { base } from 'viem/chains';\n\n// USDC contract on Base\nconst USDC_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' as const;\n\n// Minimal ERC-20 ABI for balance check\nconst ERC20_ABI = [\n  {\n    constant: true,\n    inputs: [{ name: '_owner', type: 'address' }],\n    name: 'balanceOf',\n    outputs: [{ name: 'balance', type: 'uint256' }],\n    type: 'function',\n  },\n] as const;\n\n/**\n * BlockRun Wallet Provider - Provides wallet address and USDC balance on Base.\n *\n * This provider gives the agent context about its payment wallet,\n * including address and available USDC balance for x402 micropayments.\n */\nexport const blockrunWalletProvider: Provider = {\n  name: 'BLOCKRUN_WALLET',\n  get: async (runtime: IAgentRuntime, _message: Memory) => {\n    try {\n      // Get private key from settings\n      const privateKey = runtime.getSetting('BASE_CHAIN_WALLET_KEY') ||\n        runtime.getSetting('BLOCKRUN_WALLET_KEY') ||\n        process.env.BASE_CHAIN_WALLET_KEY;\n\n      if (!privateKey) {\n        return {\n          data: {\n            configured: false,\n          },\n          values: {\n            walletConfigured: 'false',\n          },\n          text: 'BlockRun wallet is not configured. Set BASE_CHAIN_WALLET_KEY to enable x402 micropayments.',\n        };\n      }\n\n      // Derive address from private key\n      const account = privateKeyToAccount(privateKey as `0x${string}`);\n      const address = account.address;\n\n      // Create public client for balance query\n      const publicClient = createPublicClient({\n        chain: base,\n        transport: http(),\n      });\n\n      // Get USDC balance\n      let usdcBalance = '0';\n      let usdcBalanceRaw = BigInt(0);\n\n      try {\n        usdcBalanceRaw = await publicClient.readContract({\n          address: USDC_BASE,\n          abi: ERC20_ABI,\n          functionName: 'balanceOf',\n          args: [address],\n        }) as bigint;\n        usdcBalance = formatUnits(usdcBalanceRaw, 6); // USDC has 6 decimals\n      } catch {\n        // Balance check failed, continue with 0\n      }\n\n      // Get ETH balance for gas\n      let ethBalance = '0';\n      try {\n        const ethBalanceRaw = await publicClient.getBalance({ address });\n        ethBalance = formatUnits(ethBalanceRaw, 18);\n      } catch {\n        // ETH balance check failed\n      }\n\n      return {\n        data: {\n          configured: true,\n          address,\n          usdcBalance: usdcBalanceRaw.toString(),\n          ethBalance,\n          chain: 'base',\n          chainId: 8453,\n        },\n        values: {\n          walletConfigured: 'true',\n          walletAddress: address,\n          usdcBalance: `${usdcBalance} USDC`,\n          ethBalance: `${ethBalance} ETH`,\n        },\n        text: `BlockRun wallet is configured. Address: ${address}. USDC balance: ${usdcBalance} USDC on Base. This wallet is used for x402 micropayments when making AI API calls.`,\n      };\n    } catch (error) {\n      return {\n        data: {\n          configured: false,\n          error: error instanceof Error ? error.message : String(error),\n        },\n        values: {\n          walletConfigured: 'false',\n          error: error instanceof Error ? error.message : 'Unknown error',\n        },\n        text: 'Failed to get BlockRun wallet information.',\n      };\n    }\n  },\n};\n\nexport default blockrunWalletProvider;\n","/**\n * @elizaos/plugin-blockrun\n *\n * BlockRun x402 pay-per-request AI plugin for ElizaOS.\n *\n * This plugin enables ElizaOS agents to make LLM API calls using the x402 protocol,\n * paying with USDC micropayments on Base chain. No API keys required - just a wallet.\n *\n * Features:\n * - Pay-per-request AI access (OpenAI, Anthropic, Google, etc.)\n * - Automatic x402 micropayment handling\n * - USDC payments on Base chain\n * - Wallet balance provider for agent context\n *\n * Configuration:\n * Set BASE_CHAIN_WALLET_KEY in your agent settings or environment.\n *\n * @example\n * ```typescript\n * import { blockrunPlugin } from '@elizaos/plugin-blockrun';\n *\n * const agent = new Agent({\n *   plugins: [blockrunPlugin],\n *   settings: {\n *     BASE_CHAIN_WALLET_KEY: '0x...',\n *   },\n * });\n * ```\n *\n * @see https://blockrun.ai\n * @see https://x402.org\n */\n\nimport type { Plugin } from '@elizaos/core';\nimport { blockrunChatAction } from './actions/chat';\nimport { blockrunWalletProvider } from './providers/wallet';\n\n// Re-export individual components\nexport * from './actions';\nexport * from './providers';\n\n/**\n * BlockRun Plugin for ElizaOS\n *\n * Enables pay-per-request AI via x402 micropayments on Base.\n */\nexport const blockrunPlugin: Plugin = {\n  name: 'blockrun',\n  description: 'Pay-per-request AI via x402 micropayments on Base. Access OpenAI, Anthropic, Google, and more without API keys.',\n  actions: [blockrunChatAction],\n  providers: [blockrunWalletProvider],\n  evaluators: [],\n  services: [],\n};\n\nexport default blockrunPlugin;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@blockrun/elizaos-plugin",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "description": "BlockRun x402 pay-per-request AI plugin for ElizaOS - enables agents to make micropayments for AI API calls on Base",
+  "keywords": [
+    "elizaos",
+    "plugin",
+    "blockrun",
+    "x402",
+    "micropayments",
+    "ai",
+    "base",
+    "usdc"
+  ],
+  "author": "BlockRun <hello@blockrun.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blockrunai/elizaos-plugin-blockrun"
+  },
+  "homepage": "https://blockrun.ai",
+  "bugs": {
+    "url": "https://github.com/blockrunai/elizaos-plugin-blockrun/issues"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@blockrun/llm": "^0.1.1",
+    "viem": "^2.21.0"
+  },
+  "peerDependencies": {
+    "@elizaos/core": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@elizaos/core": "^1.0.0",
+    "@types/node": "^22.10.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist node_modules",
+    "prepublishOnly": "npm run build",
+    "test": "bun test",
+    "test:e2e": "bun run test-e2e.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}