Error codes
Every error 0gkit-* throws carries a stable code from this list plus a helpUrl that links back here. Click a code for cause, fix, and a minimal example.
CONFIG
CONFIG_MISSING_ENV— Missing required environment variableCONFIG_INVALID_NETWORK— Unknown network nameCONFIG_INVALID_ADDRESS— Not a valid 0x addressCONFIG_INVALID_ARGUMENT— Invalid argument passed to a primitive
WALLET
WALLET_NO_PRIVATE_KEY— No private key derived from mnemonicWALLET_KMS_SIGN_FAILED— AWS KMS Sign returned no signatureWALLET_KMS_PUBKEY_FAILED— AWS KMS GetPublicKey failedWALLET_BAD_DER_SIGNATURE— Malformed DER signature from KMSWALLET_NO_CONNECTOR— No wagmi connector availableWALLET_CHAIN_MISMATCH— Signer chainId doesn't match active chain
CHAIN
CHAIN_RPC_UNREACHABLE— RPC endpoint unreachableCHAIN_RPC_TIMEOUT— RPC call timed outCHAIN_TX_REVERTED— Transaction reverted on-chainCHAIN_TX_TIMEOUT— Transaction did not confirm in timeCHAIN_INSUFFICIENT_FUNDS— Account has insufficient fundsCHAIN_NONCE_TOO_LOW— Nonce already used
STORAGE
STORAGE_QUOTA_EXCEEDED— Storage quota exceededSTORAGE_UPLOAD_FAILED— Upload to 0G storage failedSTORAGE_DOWNLOAD_FAILED— Download from 0G storage failedSTORAGE_ROOT_NOT_FOUND— Storage root not found on networkSTORAGE_ROOT_MISMATCH— Computed root doesn't match expectedSTORAGE_INVALID_BYTES— Storage input bytes empty or invalid
COMPUTE
COMPUTE_PROVIDER_UNREACHABLE— 0G Compute provider unreachableCOMPUTE_NO_PROVIDER— No provider serving the requested modelCOMPUTE_INFERENCE_FAILED— Inference call returned an errorCOMPUTE_BAD_ATTESTATION— TEE attestation verification failedCOMPUTE_BUDGET_EXCEEDED— Inference cost exceeded budget
DA
DA_PUBLISH_FAILED— DA publish failedDA_VERIFY_FAILED— DA proof verification failedDA_INVALID_PAYLOAD— DA payload empty or oversized
ATTESTATION
ATTESTATION_BAD_SIGNATURE— Attestation signature did not recoverATTESTATION_BAD_PAYLOAD— Attestation envelope malformedATTESTATION_EXPIRED— Attestation is too old
CONTRACTS
CONTRACTS_REVERTED— Typed contract write revertedCONTRACTS_NO_ADDRESS— Standard contract has no known addressCONTRACTS_ABI_MISMATCH— ABI doesn't match deployed contractCONTRACTS_CODEGEN_FAILED— 0g contracts generate failed
INDEXER
INDEXER_REORG_LIMIT_EXCEEDED— Reorg depth exceeded configured limitINDEXER_CURSOR_BACKEND_UNREACHABLE— Cursor backend unreachableINDEXER_EVENT_DECODE_FAILED— Log topic doesn't match any ABI event
JOBS
JOBS_BACKEND_UNREACHABLE— Jobs backend unreachableJOBS_JOB_NOT_FOUND— Job ID not foundJOBS_HANDLER_THREW— Job handler threw an exceptionJOBS_WEBHOOK_BAD_SIGNATURE— Webhook HMAC signature invalid
OBSERVABILITY
OBSERVABILITY_EXPORTER_FAILED— OTel exporter rejected the export