<aside> 💡 This document is a guidebook for utilizing Herodotus's storage proof API. General documentation is this one. **** It aims to provide a practical, hands-on approach to using the API effectively and to assist builders in understanding and leveraging its capabilities, particularly in hackathons.
</aside>
Welcome to the Herodotus Builder guide! This page will show you how to use Herodotus step by step. You'll learn what you can do with Herodotus and how to actually use its API. Our API allows you to generate storage proofs. If you want to know more about storage proofs, check out this article.
Are you interested in accessing historical data from one chain and using it in another? Would you like to retrieve the balance of a specific account on one chain and utilize it on another chain?
With the help of storage proofs, you can achieve this without the need for an external bridge. Storage proofs allow you to access data across different chains and even retrieve information from older blocks.
Currently, the Herodotus API supports the following environments. For more details on available API methods, refer to this documentation.
On-chain Data available:
Features:
HEADER_ACCESS
[
"blockNumber",
"blockHash",
"parentHash",
"timestamp",
"proposer",
"stateRoot",
"transactionsRoot",
"receiptsRoot"
]
ACCOUNT_ACCESS
{
"account": "0x0000000000000000000000000000000000000000",
"properties": ["nonce", "balance", "codeHash", "storageHash"]
}
To learn more about what you can do with Herodotus, check out the examples we've provided using real-world projects like StarkSight and MAID, which demonstrate how to use storage proofs to achieve specific use cases.
| Project | Description | GitHub | Project Page | Herodotus Features |
|---|---|---|---|---|
| StarkSight | Use Worldcoin (Polygon) on Starknet. | https://github.com/HerodotusDev/starksight-zkhack | https://devfolio.co/projects/starksight-5d82 | Storage proof of storage slot |
| MAID | Proof of OG (Are you a long-time holder of this coin?) | https://github.com/ETH-TOKYO-2023 | https://ethglobal.com/showcase/maid-multi-access-incentive-distribution-9fh5s | Historical storage proof of storage slot |
| Login with Lens | Use Lens (Polygon) on Starknet. | N/A | N/A | Use storage proof of storage slot |
| Merge Swap | Use storage proof on PoW to PoS chain. | UI - ‣ | ||
| Contracts - ‣ | https://www.mergeswap.xyz/ | Use storage proof of storage slot | ||
| Inactivity proof | Inactivity proof / Inactivity inheritance. | ‣ | https://inactivity-proof.herodotus.vercel.app/ | Historical storage proof of nonce |
| zkSync tutorial | Use Everai on ZK-sync | ‣ | N/A | Use storage proof of storage slot |
How to get started building on storage proofs and using the Herodotus API