# Helix × Coinbase

Self-Healing Payment Infrastructure for CDP, Paymaster, and x402

32 error patterns 9 cross-platform immunities 5 MCP tools

## Error Wall

Every failure Helix recognises across the Coinbase stack.

CDP API
rate_limit_exceeded
faucet_limit
timed_out
internal_server_error
transfer_quote_expired
transfer_amount_out_of_bounds
malformed_transaction
idempotency_error
Paymaster / ERC-4337
GAS_ESTIMATION_ERROR
AA25 Invalid nonce
EXECUTION_REVERTED
AA21 prefund
AA13 initCode
max per user op limit
max monthly org limit
SHORT_DEADLINE
x402 Protocol
insufficient USDC
wrong network
scheme not registered
version mismatch
RPC rate limited

## PCEC Pipeline

Six-stage self-healing loop for every failure.

PERCEIVE
Detect + classify
→
CONSTRUCT
Build strategy
→
EVALUATE
Zod validate
→
COMMIT
Execute repair
→
VERIFY
Confirm on-chain
→
GENE
Learn + store

## Cross-Platform Immunity

Genes learned from Tempo and Privy protect Coinbase workflows automatically.

Tempo Gene | Coinbase Scenario | Category | Q-Value
--- | --- | --- | ---
nonce_desync | AA25 Invalid nonce (Paymaster) | B - nonce_refresh | 0.88
rate_limit_429 | rate_limit_exceeded (CDP) | A - retry_backoff | 0.92
gas_estimation | GAS_ESTIMATION_ERROR (Paymaster) | B - gas_bump | 0.85
insufficient_funds | insufficient USDC (x402) | C - topup | 0.79
rpc_timeout | timed_out (CDP) | B - rpc_switch | 0.91

## Safety Modes

Three execution tiers. Default is observe (zero risk).

observe (default)
Diagnose only. Zero execution. Zero risk. Perfect for CI and monitoring.
auto
Execute Category A+B (retry, nonce refresh, network switch). No fund movement.
full
Execute Category C (swap, split, topup). Requires cost ceiling. Fund movement enabled.

## MCP + API Integration

Connect Helix to Coinbase AgentKit via 5 MCP tools.

AgentKit Integration
import { Helix } from '@helix-agent/core'; import { CdpAgentkit } from '@coinbase/cdp-agentkit-core'; const helix = new Helix({ mode: 'auto' }); const kit = await CdpAgentkit.configureWithWallet(); // Wrap any AgentKit call try { await kit.transfer({ to, amount }); } catch (err) { const result = await helix.diagnose(err); // result.strategy, result.gene, result.reasoning }
Live API
Production endpoint:
GET https://helix-production-e110.up.railway.app/api/helix/status GET https://helix-production-e110.up.railway.app/api/helix/stream
MCP Tools
`helix_diagnose` - Classify + recommend
`helix_repair` - Execute strategy
`helix_explain` - Gene Map reasoning
`helix_status` - System health
`helix_simulate` - Dry-run diagnosis