Which env var does the plugin read?

BASE_CHAIN_WALLET_KEY — from the character's settings first, then the environment.

Can I set a default model?

Yes, BLOCKRUN_DEFAULT_MODEL in the character settings; any catalog id works.

Add the BlockRun plugin to an ElizaOS character

@blockrun/elizaos-plugin gives ElizaOS agents every BlockRun model through one plugin entry, paid per request in USDC over x402 with no per-provider API keys.

Get your agent on BlockRun Read the docs

How it works

ElizaOS agents are configured as characters with a plugins array. The BlockRun plugin exports one object to add there; it reads the wallet key from the character's settings or the environment and pays for each model call over x402 on Base. A default model is a setting, and any catalog id overrides it per call.

The plugin is community-maintained and published on npm with a peer dependency on ElizaOS core. It removes the per-lab key sprawl a multi-model character otherwise carries: one wallet, one setting, every model.

Behind it is the BlockRun catalog: 78 chat models plus image, video, music and speech generation, search, market data and multi-chain RPC, priced per call. 6 open-weight models are free and need no wallet.

Setup

1. Install

npm install @blockrun/elizaos-plugin

2. Wallet key

export BASE_CHAIN_WALLET_KEY=0x<your private key>

3. Register the plugin

import { blockrunPlugin } from '@blockrun/elizaos-plugin';
export const character = {
  name: 'MyAgent',
  plugins: [blockrunPlugin],
  settings: { BASE_CHAIN_WALLET_KEY: process.env.BASE_CHAIN_WALLET_KEY },
};

Questions

Which env var does the plugin read?: BASE_CHAIN_WALLET_KEY — from the character's settings first, then the environment.
Can I set a default model?: Yes, BLOCKRUN_DEFAULT_MODEL in the character settings; any catalog id works.