{"id":27146093,"url":"https://github.com/heimdahl-xyz/heimdahl-cli","last_synced_at":"2025-04-08T10:08:08.392Z","repository":{"id":256280550,"uuid":"854783559","full_name":"heimdahl-xyz/heimdahl-cli","owner":"heimdahl-xyz","description":"Zero configuration blockchain data aggregator ","archived":false,"fork":false,"pushed_at":"2025-03-29T11:51:40.000Z","size":1096,"stargazers_count":8,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-29T12:28:48.802Z","etag":null,"topics":["arbitrum","ethereum","evm","indexing","solana","solidity","solidity-contracts","solidity-smart-contract"],"latest_commit_sha":null,"homepage":"https://heimdahl.xyz","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heimdahl-xyz.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-09T19:14:00.000Z","updated_at":"2025-03-29T11:50:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"156f5e1a-1580-4683-a799-e5f231e396a0","html_url":"https://github.com/heimdahl-xyz/heimdahl-cli","commit_stats":null,"previous_names":["heimdahl-xyz/heimdahl-cli"],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimdahl-xyz%2Fheimdahl-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimdahl-xyz%2Fheimdahl-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimdahl-xyz%2Fheimdahl-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimdahl-xyz%2Fheimdahl-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heimdahl-xyz","download_url":"https://codeload.github.com/heimdahl-xyz/heimdahl-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247819948,"owners_count":21001394,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arbitrum","ethereum","evm","indexing","solana","solidity","solidity-contracts","solidity-smart-contract"],"created_at":"2025-04-08T10:08:07.835Z","updated_at":"2025-04-08T10:08:08.385Z","avatar_url":"https://github.com/heimdahl-xyz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Heimdahl cli: Blockchain data aggregator command line \n\n![Heimdahl-logo](https://github.com/heimdahl-xyz/heimdahl-cli/blob/572e8557e1dc6181443db5a21123a295b365fb51/static/heimdahl-logo.png?raw=true)\n\n**Heimdahl CLI**\nis a general purpose command line tool that aims to provide convenient way to access blockchain data.\n\n## Features\n\n- **Unified access to data across EVM, Solana and Tron**: Realtime and historic data across major EVM, Solana and Tron.\n- **Query Indexed Blockchain Events via REST API**: Retrieve smart contracts events data already pre-indexed on backend.\n- **Direct sourcing from in-house Ethereum nodes**: Get data directly from blockchain without any middlemen (Alchemy,\n Infura etc) with more nodes to come. \n- **Unpacked data** : Get decoded data from events decoded and typed based on contract's ABI.\n- **Zero Configuration**: No need to run your own infrastructure or indexers.\n- **REST API**: Access blockchain data via REST API to eliminate need for complex GraphQL querying\n- **Built with Go**: Fast, portable, and efficient CLI with zero configuration and underlying dependency.\n- **Simple Commands**: Get started with simple commands powered by [Cobra](https://github.com/spf13/cobra).\n\n### Features in development\n\n- **Fully in-house Solana node**: Access Solana data with same ease.\n- **Listen to Realtime Events**: Listen to events via Websocket API.\n- **Multiple Blockchain Support**: Supports for Arbitrum and more(in development).\n- **Advanced filtering** Filter events by block number, timestamp, and more.\n- **Block, Transactions and Receipts Indexing** Indexing of blocks, transactions and receipts for advanced analytics.\n- **Realtime Websocket API**: Listen to events in real-time via Websocket API.\n\n- and many more to come ;)\n\n## Installation\n\nYou can pick pre-build binaries from the [releases](https://github.com/heimdahl-xyz/heimdahl-cli/releases) page.\n\n```bash\n$ wget https://github.com/heimdahl-xyz/heimdahl-cli/releases/download/heimdahl-cli-{latest-release}/heimdahl-cli-linux-amd64.tar.gz\n$ tar -xzvf heimdahl-linux-amd64.tar.gz \n$ mv heimdahl-linux-amd64 heimdahl\n$ ./heimdahl\n\nHeimdahl CLI - Blockchain Data Access Without Infrastructure\n\nFast access to blockchain events and analytics across multiple chains through simple commands.\nInstead of spending months building indexers, start exploring blockchain data in minutes:\n\nExamples:\n heimdahl event list 0xb47e...BBB PunkOffered # Get specific events\n heimdahl contract show 0x060...6d # View contract details\n\nBuilt for developers who need reliable blockchain data without infrastructure overhead.\n\n```\n\nor you can ...\n\n## Build from source\n\n### Prerequisites\n\n- **Go**: Ensure Go is installed (version 1.21+).\n- **Make**: GNU Make 3.81(optional)\n\n### Clone the Repository\n\n```bash\ngit clone git@github.com:heimdahl-xyz/heimdahl-cli.git\ncd heimdahl-cli\n```\n\n## Build\n\n```bash\ngo build -o bin/heimdahl main.go\nor\nmake build \n```\n\n## Quickstart\n\n### List available chains\n\n```bash\n$ heimdahl chain list \n\nCHAIN NETWORK CHAIN ID\n--------------------------------\nethereum mainnet 1 \nethereum sepolia 11155111\nbase mainnet 8453 \npolygon mainnet 137 \narbitrum mainnet 42161 \noptimism mainnet 10 \nbinance mainnet 56 \n\n```\n\n### List indexed contracts across chains\n\n```\n$ heimdahl contract list \n\nChain: ethereum \nNetwork: mainnet \nContract Name: Ethena USD \nContract Address: 0x4c9edd5852cd905f086c759e8383e09bff1e68b3 \nEvents: \n - EIP712DomainChanged \n - MinterUpdated \n - OwnershipTransferStarted \n - OwnershipTransferred \n - Transfer \n - Approval \n-------------------------------------------------------------------------------- \nChain: ethereum\nNetwork: mainnet\nContract Name: Pudgy Penguins ETH\nContract Address: 0xBd3531dA5CF5857e7CfAA92426877b022e612cf8\nEvents:\n - OwnershipTransferred\n - Paused\n - Transfer\n - Unpaused\n - Approval\n - ApprovalForAll\n - CreatePenguin\n--------------------------------------------------------------------------------\nChain: ethereum\nNetwork: mainnet\nContract Name: USDD\nContract Address: 0x0C10bF8FcB7Bf5412187A595ab97a3609160b5c6\nEvents:\n - Approval\n - MetaTransactionExecuted\n - RoleAdminChanged\n - RoleGranted\n - RoleRevoked\n - Transfer\n\n```\n\n### List events\n\n#### List Uniswap V3 Mint events on Ethereum mainnet\n\n```bash\n$ heimdahl event list 0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640 Mint # Uniswap \nV3 Mint on ethereum\n \nBLOCK# | TIMESTAMP | TRANSACTION_HASH | EVENT_DATA \n---------------------------------------------------------------------------------------------------- 21446044 | 2025-01-17T18:54:55Z | 0xb88af7b04df4d1d7a7fd777bcc31060ad0346a0da3706a32d15d4ddcf296e334 | amount: 393581927855607704795, amount1: 361788791691837\n3918, tickLower: 194800, amount0: 11576768988867, owner: 0xA69babEF1cA67A37Ffaf7a485DfFF3382056e78C, sender: 1.4024810831325053e48, tickUpper: 194810 21446018 | 2025-01-17T18:54:55Z | 0x91fb7b4208e216dda90c6f83d042b528d4208a86e7bddf8e1b99e473d19f6c1e | amount0: 145884955, tickLower: 193890, tickUpper: 19808\n0, amount: 16340383564036, owner: 0xC36442b4a4522E871399CD717aBDD847Ab11FE88, sender: 1.1154890857106194e48, amount1: 12253693449477527 21445992 | 2025-01-17T18:54:55Z | 0x72de3607664cab8ab4179b4b1f581cfd8b1b219944b705e9ff7ce8248ae545a4 | sender: 1.1154890857106194e48, tickUpper: 198080, amoun\nt: 51397277183042, amount0: 458518761, owner: 0xC36442b4a4522E871399CD717aBDD847Ab11FE88, tickLower: 193890, amount1: 38643713455569501 21445953 | 2025-01-17T18:54:55Z | 0x9d12b2d2b68c7bc0a920d1d950639f11f940af43ab711d5266dc7c3cf6efe0d7 | amount0: 601856883798, amount1: 0, amount: 204088654544\n29306880, owner: 0x1f2F10D1C40777AE1Da742455c65828FF36Df387, sender: 1.7802831409602703e47, tickLower: 194770, tickUpper: 194780 \n...\n```\n\n#### List WETH Transfers on Ethereum mainnet\n\n```bash\n$ heimdahl event list 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 Transfer \n\nBLOCK# | TIMESTAMP | TRANSACTION_HASH | EVENT_DATA ---------------------------------------------------------------------------------------------------- \n21679357 | 2025-01-22T10:13:38Z | 0x2b1cbb5891849ae99a1436451add7c2212b0b782c8b95259d52b515f20afef9f | dst: 0xB86E490E72F050c424383d514362Dc61DaBB1Cc3, src: 0xdad17D7E3Abbebe1ea5782962398113422F10EE0, wad: 300852659872045380 \n21679357 | 2025-01-22T10:13:38Z | 0x318a0434558e1c6b70c3b60eb58f74751ac8559b7dca4aa3c351166e75f57bff | dst: 0x95190AaF90dd499E87068C68b90352526993c1A7, src: 0\nx7a250d5630B4cF539739dF2C5dAcb4c659F2488D, wad: 200000000000000000\n21679357 | 2025-01-22T10:13:38Z | 0xe3157a424eb975be6d25376f2021cdbcc0d3ec370d2c8d93a81fa12928e1f8c3 | dst: 0x000000fee13a103A10D593b9AE06b3e05F2E7E1c, src: 0\nx3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD, wad: 73468283229723\n21679357 | 2025-01-22T10:13:38Z | 0xcc60fbf73b6b999efa3efabcae87a18a3b1499c2f70a4dcf6dc3ad7db9d252bf | dst: 0x468795E031c173942C9387AEd0a302E26bDD0460, src: 0\nx7D0CcAa3Fac1e5A943c5168b6CEd828691b46B36, wad: 10074112441007251\n21679357 | 2025-01-22T10:13:38Z | 0xa161fcaac3f5d1b90f8b95fdf1e86baac469fe9fad877690e668efc7a858b6e4 | dst: 0x468795E031c173942C9387AEd0a302E26bDD0460, src: 0\nx3b4c1914CCbb2ADb030a58A2cC378b7016C9d5E8, wad: 53024641812615367\n\n```\n\n### How to start?\n\nWe're actively working on enabling users to obtain their API keys independently. In the meantime, you can gain early\naccess by joining our [Discord Server](https://discord.gg/kZKA977B).\n\nYou can also follow us on [LinkedIn](https://www.linkedin.com/company/heimdahl-xyz/?viewAsMember=true) to stay updated.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheimdahl-xyz%2Fheimdahl-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheimdahl-xyz%2Fheimdahl-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheimdahl-xyz%2Fheimdahl-cli/lists"}