ElizaOS Integration

Use BlockRun as an LLM provider in ElizaOS agents.

ElizaOS is an open-source agent framework. The BlockRun plugin gives your ElizaOS agents access to 30+ AI models via x402 micropayments.

Installation

npm install elizaos-plugin-blockrun

Configuration

Environment Variables

export BLOCKRUN_WALLET_KEY=0x...your_private_key...

Agent Configuration

import { BlockRunProvider } from 'elizaos-plugin-blockrun';

const agent = new ElizaAgent({
  // ... other config
  providers: [
    new BlockRunProvider({
      defaultModel: 'openai/gpt-4o',
      sessionBudget: 10.00  // Optional: max spend per session
    })
  ]
});

Usage

Basic Chat

const response = await agent.chat({
  model: 'openai/gpt-4o',
  messages: [
    { role: 'user', content: 'Hello!' }
  ]
});

Model Selection

// Use specific model
const response = await agent.chat({
  model: 'anthropic/claude-sonnet-4',
  messages: [...]
});

// Use cheap model for bulk tasks
const response = await agent.chat({
  model: 'deepseek/deepseek-v3',
  messages: [...]
});

Image Generation

const image = await agent.generateImage({
  prompt: 'A futuristic AI agent',
  model: 'dall-e-3',
  size: '1024x1024'
});

Available Models

All BlockRun models are available:

Provider	Models
OpenAI	gpt-5.2, gpt-4o, o1, o1-mini
Anthropic	claude-opus-4, claude-sonnet-4, claude-haiku-4.5
Google	gemini-3-pro, gemini-2.5-flash
DeepSeek	deepseek-v3, deepseek-r1
xAI	grok-4-fast
Meta	llama-3.3-70b, llama-3.1-405b

See Models Reference for full list.

Pricing

Same as BlockRun: provider cost + 5%.

Your agent pays per request via x402. No API keys needed for individual providers.

See Intelligence Pricing.

Wallet Setup

Create New Wallet

import { createWallet } from 'elizaos-plugin-blockrun';

const wallet = await createWallet();
console.log('Address:', wallet.address);
// Fund this address with USDC on Base

Use Existing Wallet

export BLOCKRUN_WALLET_KEY=0x...

Check Balance

import { getBalance } from 'elizaos-plugin-blockrun';

const balance = await getBalance();
console.log(`Balance: $${balance} USDC`);

Example Agent

import { ElizaAgent } from 'elizaos';
import { BlockRunProvider } from 'elizaos-plugin-blockrun';

const agent = new ElizaAgent({
  name: 'TradingBot',
  description: 'An AI trading assistant',
  providers: [
    new BlockRunProvider({
      defaultModel: 'openai/gpt-4o'
    })
  ],
  actions: [
    // Your agent actions
  ]
});

// Agent now has access to 30+ models via BlockRun
await agent.start();

Error Handling

try {
  const response = await agent.chat({
    model: 'openai/gpt-4o',
    messages: [...]
  });
} catch (error) {
  if (error.code === 'INSUFFICIENT_BALANCE') {
    console.log('Need to fund wallet');
  } else if (error.code === 'MODEL_NOT_FOUND') {
    console.log('Invalid model specified');
  } else {
    throw error;
  }
}

Best Practices

Cost Optimization

// Use cheap models for routine tasks
const cheapProvider = new BlockRunProvider({
  defaultModel: 'deepseek/deepseek-v3'  // 50x cheaper than GPT-4o
});

// Use premium models for important decisions
const premiumProvider = new BlockRunProvider({
  defaultModel: 'openai/gpt-4o'
});

Session Budgets

new BlockRunProvider({
  sessionBudget: 5.00  // Max $5 per session
});

Fallback Models

new BlockRunProvider({
  defaultModel: 'openai/gpt-4o',
  fallbackModel: 'deepseek/deepseek-v3'  // Use if primary fails
});