Quick Start Guide

Proving Account Balance

Visit the Herodotus Cloud Console.
Sign in using your Wallet or Github.
Once logged in, access your API key from the console.

Step 2: Prepare Your Storage Proof Request

Construct a POST request to the Storage Proof API (Mission Control). Here’s a basic example:

{
  "destination_chain_id": "11155111",
  "data": {
    "11155111": {
      "block:5150551": {
        "accounts": {
          "0x17C2D875CB397D813eAE817DaFD25807E348Df07": {
            "props": ["BALANCE"]
          }
        }
      }
    }
  }
}

This request proves the balance of a specific account on Ethereum Sepolia. Header and account field enums accept SCREAMING_SNAKE values such as BALANCE and STATE_ROOT (normalized internally). Optional settings may include max_cost, optimize (Cost or Time), and related fields. When omitted, defaults apply (max_cost 10.0, optimize Cost, allow_offchain_growing false).

Step 3: Submit Your Request

Send a POST request to Mission Control:

curl -X POST https://mission-control.api.herodotus.cloud/submit-request \
  -H 'Content-Type: application/json' \
  -H 'api-key: YOUR_API_KEY_HERE' \
  -d '{
    "destination_chain_id": "11155111",
    "data": {
      "11155111": {
        "block:5150551": {
          "accounts": {
            "0x17C2D875CB397D813eAE817DaFD25807E348Df07": {
              "props": ["BALANCE"]
            }
          }
        }
      }
    }
  }'

A successful response looks like:

{
  "status": "success",
  "request_id": "01J2V235ABJY55JS2MY051ZJFJ"
}

Step 4: Check Query Status

Use the returned request_id to list queries for that request:

curl -X GET "https://mission-control.api.herodotus.cloud/get_queries/YOUR_REQUEST_ID" \
  -H 'api-key: YOUR_API_KEY_HERE'

Example response:

{
  "queries": [
    {
      "internal_id": "01J2V235ABJY55JS2MY051ZJFJ",
      "status": "IN_PROGRESS",
      "typ": {},
      "created_at": "2026-01-01T00:00:00Z",
      "completed_at": null
    }
  ]
}

Poll until each query reaches a terminal status such as COMPLETED or FAILED. Optionally inspect execution steps with GET /get_actions/{query_id}.

Step 5: Access Proven Data

Once queries complete, access proven data through the Satellite contract on the destination chain. For Ethereum Sepolia:

Go to the Satellite contract on Etherscan.
Use the accountField function to retrieve the proven data.
- chainId: 11155111
- blockNumber: 5150551
- account: 0x17C2D875CB397D813eAE817DaFD25807E348Df07
- field: 0

See Accessing Data for Satellite read patterns.

Next Steps

Explore the interactive Swagger UI and the OpenAPI-backed endpoint docs in this section.
Use Satellite contracts to consume proven values on-chain.
Try header fields, storage slots, and cross-chain destination chain IDs.

You’ve now used Storage Proofs to verify blockchain data. As you become more familiar with the system, you can create more complex proofs and integrate them into your applications.

Getting Started

AI Skill

Contracts

Actions

Queries

Grow Orders

Health Check

Submit Request

Proving Account Balance

Step 2: Prepare Your Storage Proof Request

Step 3: Submit Your Request

Step 4: Check Query Status

Step 5: Access Proven Data

Next Steps

​Proving Account Balance

​Step 1: Sign Up for an API Key

​Step 2: Prepare Your Storage Proof Request

​Step 3: Submit Your Request

​Step 4: Check Query Status

​Step 5: Access Proven Data

​Next Steps

Proving Account Balance

Step 1: Sign Up for an API Key

Step 2: Prepare Your Storage Proof Request

Step 3: Submit Your Request

Step 4: Check Query Status

Step 5: Access Proven Data

Next Steps