AI Agents & API Config
Secure private key management, CLI scripts, and programmatic trading integrations.
Rapid Error-Code & Symptom Lookup Matrix
Cross-reference your runtime error string or hardware symptom with verified recovery protocols and client-side debuggers.
| Error / Exception | Diagnostic Symptom | Verified Resolution Guide | Interactive Sandbox |
|---|---|---|---|
| TypeError: basex is not a function | ElizaOS CJS require encountering base-x v5 ESM default export | ElizaOS basex is not a function: ESM CJS Dependency Fix → | 🛠️ ERC-4337 Calldata Decoder |
| SQLITE_BUSY | Database is locked during parallel multi-agent swarm execution | ElizaOS SQLITE_BUSY: Database Locked Swarm Fix → | 🛠️ ERC-4337 Calldata Decoder |
| -32007 Rate Limit | Viem shouldRetry ignoring custom QuickNode rate limit errors | Viem shouldRetry QuickNode -32007 Rate-Limit Fix → | 🛠️ ERC-4337 Calldata Decoder |
| -32603 BlockOverrides | Geth eth_simulateV1 BlockOverrides.Difficulty crash on post-merge PoS chains | Geth eth_simulateV1 BlockOverrides -32603 Crash Fix → | 🛠️ ERC-4337 Calldata Decoder |
| 403 WAF Preflight Drop | ElizaOS plugin-prflght Cloudflare bot challenge block | ElizaOS Plugin-Prflght 403 Forbidden & Cloudflare WAF Fix → | 🛠️ ERC-4337 Calldata Decoder |
| Docker Compose Hex Crash | Coinbase API key and hex private key interpolation truncation | ElizaOS Docker Compose Env Variable Crash & Coinbase Fix → | 🛠️ ERC-4337 Calldata Decoder |
| EIP-712 Struct Mismatch | Viem/Wagmi nested struct signing hash mismatch and invalid signature | Viem EIP-712 Nested Struct Hash Mismatch Fix → | 🛠️ ERC-4337 Calldata Decoder |
| intrinsic gas too low | Arbitrum Orbit & Nitro L2 gas estimation deficit on L1 poster fee | Arbitrum Orbit & Nitro Intrinsic Gas Too Low Fix → | 🛠️ ERC-4337 Calldata Decoder |
All Guides in this Silo
Sorted by DateElizaOS plugin-form Control-Type Registry Desynchronization Bug
Resolve ElizaOS @elizaos/plugin-form validation bypass and UTC date shifting defects. Fix dual registry architecture between FormService and typeHandlers.
Arbitrum Orbit & Nitro Intrinsic Gas Too Low Estimation Fix
Resolve Arbitrum Nitro and Orbit transaction reverts with 'intrinsic gas too low'. Calculate NodeInterface L1 poster calldata fees and calibrate gas buffers.
ElizaOS SQLITE_BUSY: Database is Locked in Agent Swarms Fix
Eliminate SQLITE_BUSY: database is locked in multi-agent ElizaOS swarms. Configure SQLite Write-Ahead Logging (WAL), busy timeouts, and serialized writes.
Geth eth_simulateV1 BlockOverrides.Difficulty Crash Fix
Fix Geth eth_simulateV1 error -32603 crashes caused by BlockOverrides.Difficulty on post-merge PoS chains. Configure random TTD parameters and fix simulations.
Viem EIP-712 Nested Struct Hash Mismatch Revert Fix
Fix signature verification reverts in Viem when encoding nested EIP-712 structs. Re-align type hashes, match primaryType definitions, and fix domain separators.
Viem shouldRetry QuickNode -32007 Rate-Limit Error Fix
Fix unhandled JSON-RPC error -32007 in Viem with QuickNode RPCs. Custom retry handlers for rate-limit codes prevent agent execution loop crashes.
ElizaOS SKILL.md Frontmatter Parse Failure on CRLF Line Endings
Resolve ElizaOS SKILL.md frontmatter parsing errors on Windows and CRLF checkouts. Fix loadSkillFromStorage null returns, MISSING_METADATA failures, and parser regex bugs.
Geth BlobPool.Cache Nil Pointer Dereference Panic (p.store Race Fix)
Resolve Geth daemon crash with 'panic: runtime error: invalid memory address or nil pointer dereference' in BlobPool.Cache on p.store. Fix backend initialization race.
Geth debug_getModifiedAccounts Omits Deleted Accounts (Trie Diff Fix)
Why debug_getModifiedAccountsByHash and debug_getModifiedAccountsByNumber omit deleted accounts. Fix directional trie iterator reconciliation in indexers and subgraphs.
Geth admin_exportChain Silent Gzip Corruption & Backup Failure
Diagnose silent chain dump truncation in Ethereum Go-Ethereum (Geth) nodes. Learn why admin_exportChain returns true despite gzip Close errors and how to verify export integrity.
Geth eth_simulateV1 EIP-7825 Gas Limit Bypass Revert [2026 Resolved]
Resolve transaction simulation failures where eth_simulateV1 with validation:true skips EIP-7825 transaction gas caps, causing mainnet broadcast reverts. Learn how to align gas estimation.
Geth TrieDB StateReader Account Panic
Resolve Geth archive node TrieDB StateReader panics and database corruption. Rebuild state snapshots and recover historical block execution.
WalletConnect Crypto.decode Silent Decryption Failure
Fix WalletConnect v2 silent decryption failures where crypto.decode returns undefined. Resolve corrupted session storage and re-initialize symmetric encryption keys.
WalletConnect Relay WebSocket Stalls & Ping Timeouts in Headless AI Agents
Fix WalletConnect v2 relay WebSocket stalls, ping timeouts, and dropped session pairing in headless AI agents, background workers, and NodeJS daemons.
Wagmi reconnect() Stuck at 'reconnecting' Error Fix
Fix Wagmi reconnect() permanently hanging in 'reconnecting' status when isAuthorized() rejects in Next.js, React Native, and mobile Web3 dApps.
Geth Mempool Reorg Transaction Gapping and Stuck Nonce Stalls Fix
Fix Geth mempool transaction gapping, stuck nonces, and dropped transactions during L1/L2 blockchain reorgs. Resync transaction pool queues safely.
Geth eth_getLogs Matcher Goroutine Leak and Head Livelock
Diagnose and resolve Ethereum node livelocks where eth_getLogs matcher goroutines leak after client disconnects, causing 15s+ RPC latency spikes near the block head.
Geth admin_startWS Socket Leak and WebSocket Port Collision
Resolve go-ethereum admin_startWS failures where dynamic WebSocket re-initialization leaks socket file descriptors, causing 'bind: address already in use' port collisions.
ElizaOS Vision Service Boolean Setting Bug
Resolve ElizaOS Vision Service startup crashes caused by boolean environment setting desynchronization. Step-by-step fix for autonomous agent pipelines.
ElizaOS V8 Heap Out of Memory during PGVector RAG Ingestion Fix
Fix ElizaOS NodeJS V8 JavaScript Heap Out of Memory crashes during large document RAG ingestion and batch pgvector embeddings. Configure backpressure.
ElizaOS Twitter Client 429 Rate Limits and Cookie Invalidation
Resolve ElizaOS Twitter client crashes caused by 429 Too Many Requests, Cloudflare challenges, and expired auth_token/ct0 session cookies in agent swarms.
ElizaOS Solana Blockhash Not Found and Jito MEV Reverts
Resolve Solana transaction drops in ElizaOS agent trading plugins. Fix 'Blockhash not found' errors and configure dynamic compute unit limits with Jito MEV tip bundles.
ElizaOS AgentSkillsService 'SKILLS_AUTO_LOAD' Boolean Setting Bug
Resolve ElizaOS AgentSkillsService bug where SKILLS_AUTO_LOAD and CLAWHUB_AUTO_LOAD ignore boolean character settings, causing unauthorized skill downloads.
ElizaOS pgvector Dimension Mismatch Embedding Crash Fix
Fix ElizaOS pgvector dimension mismatch (1536 vs 768 / 384) database crashes when switching embedding models from OpenAI to Ollama, BGE, or Voyage AI.
ElizaOS JS Runtime Bridge False '[cycle]' Serialization Bug
Resolve ElizaOS JS runtime bridge bug where shared DAG object references are serialized as '[cycle]', corrupting agent memory, token balances, and action parameters.
ElizaOS Federation Transport Loop & Memory Leak
Stop ElizaOS multi-agent federation memory leaks. Resolve Redis transport circular event loops and Node.js process death with cleanup middleware.
Wagmi Foundry Plugin ABI Mismatch & ERESOLVE Error Fix
Resolve Wagmi Foundry plugin ABI mismatches and ERESOLVE errors. Learn to fix overloaded functions and legacy tuple crashes in your Web3 build pipeline.
Wagmi CLI Foundry Plugin Multiple Addresses with Same ABI
Resolve duplicate ABI compilation issues in Wagmi CLI. Learn how to map multiple addresses to a single ABI contract deployment using shared aliases and dynamic runtime addresses.
Geth Node Upgrade Chain Gap & State Sync Freeze
Resolve Ethereum Go-Ethereum (Geth) post-upgrade chain gap errors, database head mismatch, and state sync freezes in Web3 RPC node infrastructure.
MetaMask SDK React Native Storage Crash in Next.js
Resolve @react-native-async-storage errors in Next.js with MetaMask SDK. Implement SSR isolation and transpilePackages for Web3 recovery.
Wagmi Core Accounts Peer Dependency Conflict ERESOLVE
Resolve npm v7+ ERESOLVE errors in Wagmi Core. Learn to configure overrides, resolutions, and fix strict peer dependency crashes in Web3 apps.
ElizaOS Runtime Loop Nested Arrays Crash & Memory Leak Fix
Fix ElizaOS runtime loop crash caused by double-nested JSON arrays. Prevent V8 heap exhaustion with memory limits and sanitize recursive agent schemas.
Wagmi Next.js Webpack Build Connector Failure
Debug Wagmi connector failures in Next.js App Router. Master Webpack alias stubbing and next.config.mjs optimizations for Web3 builds.
Tealstreet Hyperliquid Vault Zero Balance Error
Resolve Tealstreet Hyperliquid vault balance errors. Correct API wallet derivation mismatches between master EOA keys and counterfactual vault subaccounts.
Format WIF Base58 Private Key for ElizaOS EVM & Viem Fix
Convert WIF Base58 private keys to 32-byte 0x-prefixed hex format for ElizaOS EVM plugins and Viem. Strip version bytes and checksums securely.
ElizaOS Docker Compose Env Variable & Coinbase Plugin Fix
Fix ElizaOS Docker Compose environment variable parsing crashes. Correct raw hex quoting, escape dollar sign interpolation, and stabilize container boots.
ElizaOS Maximum Notional USDC Limits Security Config
Secure your ElizaOS agent wallet with max notional USDC spending limits. Enforce runtime balance checks and plugin-prflght policies before signing transactions.
ElizaOS TypeError basex is not a function Startup Fix
Resolve ElizaOS TypeError: basex is not a function on agent startup. Fix CommonJS and ESM export conflicts by locking base-x and @noble/curves packages.
ElizaOS Solana Agent Kit Public Key Not Found
Resolve the Solana public key not found error in ElizaOS. Correct environment variable flags, parse base58 keypairs into Uint8Array, and fix container paths.
Configure ElizaOS Plugin-Prflght for DeFi Slippage & Spending Limits
Configure the ElizaOS plugin-prflght deterministic middleware for DeFi transaction policies, slippage guards, TVL verification, and automated wallet limits.
ElizaOS Plugin-Prflght WAF 403 Blocks & Preflight Drops Fix
Fix ElizaOS plugin-prflght 403 Forbidden drops and Cloudflare WAF blocks. Route agent egress via HttpsProxyAgent and configure custom bypass headers.
ElizaOS Plugin-EVM Invalid Private Key Hex Error
Resolve the ElizaOS invalid private key hex error. Convert WIF and Base58 strings to 32-byte hexadecimal format for @noble/curves secp256k1 validation.
ElizaOS Failed to Parse JSON From OpenAI Response
Resolve ElizaOS JSON parsing errors from OpenAI models. Strip markdown code fence tags, enforce strict JSON schemas, and prevent runtime agent aborts.
ElizaOS AI16z Migration Tangem Wallet Snapshot Bug
Resolve ElizaOS AI16z token migration Tangem hardware wallet snapshot errors. Bypass non-exportable hardware private key restrictions with signing bridges.
ElizaOS Action Triggers Return AI Model Responses
Resolve ElizaOS action triggers returning raw LLM responses instead of handler callbacks. Fix runtime schema validation breaks and enforce handler routing.