Skip to content

Conversation

@1bcMax
Copy link

@1bcMax 1bcMax commented Jan 10, 2026

Summary

Add BlockRun action provider enabling AI agents to access multiple LLM providers (OpenAI, Anthropic, Google, DeepSeek) using pay-per-request USDC micropayments on Base chain via the x402 protocol.

Why BlockRun?

  • Multi-provider access: GPT-4o, Claude, Gemini, DeepSeek via single integration
  • Pay-per-request: No monthly subscriptions - pay only for what you use in USDC
  • Secure: Private key never leaves your machine (local EIP-712 signing)
  • Native x402: Built on Coinbase's x402 protocol - a natural fit for AgentKit

Changes

  • Added BlockrunActionProvider with chat_completion and list_models actions
  • Added blockrun-llm as optional dependency (pip install coinbase-agentkit[blockrun])
  • Updated action providers exports
  • Added documentation and changelog entry

Actions Provided

Action Description
chat_completion Send chat completion requests to LLMs via x402 micropayments
list_models List available models (GPT-4o, Claude, Gemini, DeepSeek)

Usage Example

from coinbase_agentkit import (
    AgentKit,
    AgentKitConfig,
    blockrun_action_provider,
)

agentkit = AgentKit(AgentKitConfig(
    wallet_provider=wallet_provider,
    action_providers=[blockrun_action_provider()],
))

Testing

  • Syntax validation passes
  • Ruff linting passes
  • Code follows existing action provider patterns (similar to hyperbolic_action_provider)

Links

Add BlockRun action provider enabling AI agents to access multiple LLM
providers (OpenAI, Anthropic, Google, DeepSeek) using pay-per-request
USDC micropayments on Base chain via the x402 protocol.

Features:
- chat_completion action for LLM inference
- list_models action to discover available models
- Supports Base Mainnet and Sepolia networks
- Uses blockrun-llm SDK for x402 payment handling

Install with: pip install coinbase-agentkit[blockrun]
@1bcMax 1bcMax requested a review from murrlincoln as a code owner January 10, 2026 16:46
@cb-heimdall
Copy link

cb-heimdall commented Jan 10, 2026

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@github-actions github-actions bot added documentation Improvements or additions to documentation action provider New action provider python labels Jan 10, 2026
- Add conftest.py with mock fixtures for wallet_key, wallet_provider, and llm_client
- Add test_blockrun_action_provider.py: 10 tests for initialization, network support, factory
- Add test_chat_completion.py: 7 tests for chat completion action
- Add test_list_models.py: 5 tests for list models action
- Add e2e tests for real API testing (requires BLOCKRUN_WALLET_KEY env var)

All 22 unit tests pass. E2e tests require funded wallet on Base.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation python

Development

Successfully merging this pull request may close these issues.

2 participants