-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
ebcc2b9
commit c57f816
Showing
1 changed file
with
3 additions
and
99 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,101 +1,5 @@ | ||
| # [Athena](https://github.com/BlocSoc-iitr/Athena/tree/main/athena) | ||
| # Athena | ||
|
|
||
| Go package for interacting with starknet. It is a tool which can be used in cli for the following tasks | ||
| > ⚠️ This project is undergoing heavy development and is still on its early stages. There will be constant breaking changes. | ||
| This is inspired from nethermind/entro but implemented in GoLang and is therefore much faster than Entro. | ||
| Unlike entro which is limited to being a cli tool , We have implemented frontend as well for Athena(Currently limited to backfilling ) | ||
| We plan to make the frontend fully functional soon. | ||
|
|
||
| The below graph compares the backfilling time taken by Athena and Entro . | ||
|
|
||
|
|
||
|
|
||
|
|
||
|  | ||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
| ## Tasks it can perform | ||
|
|
||
| - Backfill full blocks including events , tx & receipts | ||
| - Get implementation history | ||
| - ABI Decoding | ||
| - Decoding of functions & events from a transaction | ||
|
|
||
|
|
||
|
|
||
| # Usage/Examples | ||
|
|
||
| ## Specify this in the following fields | ||
| from :- block number | ||
|
|
||
| to :- block number | ||
|
|
||
| jsonRpcUrl - https://rpc.nethermind.io/mainnet-juno?x-apikey=YOUR_API_KEY | ||
|
|
||
| output :- your_file_name.csv | ||
|
|
||
|
|
||
| ## [ ABI Decoder](https://github.com/BlocSoc-iitr/Athena/blob/main/athena/decoder/abi_decoder.go) | ||
| abi parser , to parse each event and function ie to get its name and parameters and their datatype to help us in decoding | ||
|
|
||
| ```bash | ||
| go run cli/get/starknet.go --classHash 0x01a736d6ed154502257f02b1ccdf4d9d1089f80811cd6acad48e6b6a9d1f2003 --jsonRpcUrl "https://rpc.nethermind.io/mainnet-juno?x-apikey=MIkLH4AOTdTH9uqu8PqvSHUBNnAnMU1fXdROa3qc1DsSVxvOcGRrwr6kSj1zsNjT" --decode | ||
| ``` | ||
| Result - list of functions and events decoded in that ABI to your console. | ||
|  | ||
|
|
||
|
|
||
| ## [ Event Decoder](https://github.com/BlocSoc-iitr/Athena/blob/main/athena/decoder/event_decoder.go) | ||
| To decode an event , user provides the contract hash and the name of the event and block range , firstly the abi is fetched and parsed and the data for the particular event and block range is fetched | ||
| The data fetched contains the keys and data required to decode the event , the decoder then initiates a new decoder class for that particular event and the event’s data is decoded with the provided inputs of hash,block range and event name | ||
|
|
||
|
|
||
| ```bash | ||
| go run cli/get/dispatcher.go -event TransactionExecuted -contract 0x005a708f9c84bc709e967086572c6655e2b85eaf5a2ef752d92e24e64c5e392c_1 -from 691000 -to 692000 | ||
| ``` | ||
| Result - | ||
|
|
||
|
|
||
| ## [Function Decoder](https://github.com/BlocSoc-iitr/Athena/blob/main/athena/decoder/function_decoder.go) | ||
| Similar as above but instead of keys and data pairs we give call data as input that we will fetch in the provided blockrange | ||
|
|
||
|
|
||
|
|
||
| ## [Backfill Events](https://github.com/BlocSoc-iitr/Athena/tree/main/athena/backfill/importers) | ||
|
|
||
| From - Block Number | ||
|
|
||
| To - Block Number | ||
|
|
||
|
|
||
| ```bash | ||
| go run cli/backfill/starknet_events.go --from 67800 --to 67801 --rpc-url https://starknet-mainnet.public.blastapi.io/rpc/v0_7 --output events.csv --chunk-size 100 | ||
| ``` | ||
|
|
||
| [With Filters](https://github.com/BlocSoc-iitr/Athena/blob/main/athena/backfill/filters.go) | ||
| ```bash | ||
| go run cli/backfill/starknet_filters.go -rpc-url "https://rpc.nethermind.io/mainnet-juno?x-apikey=MIkLH4AOTdTH9uqu8PqvSHUBNnAnMU1fXdROa3qc1DsSVxvOcGRrwr6kSj1zsNjT" -contract-address "0x01a736d6ed154502257f02b1ccdf4d9d1089f80811cd6acad48e6b6a9d1f2003" -from 100000 -to 200000 -output "filtered_events.csv" | ||
| ``` | ||
|
|
||
| Result - all events decoded in your excel file | ||
|
|
||
|  | ||
|
|
||
|
|
||
| ## [Backfill full blocks](https://github.com/BlocSoc-iitr/Athena/blob/main/athena/backfill/importers/starknet.go) | ||
|
|
||
| ```bash | ||
| go run starknet.go --from 110 --to 130 --rpc-url https://rpc.nethermind.io/mainnet-juno?x-apikey=MIkLH4AOTdTH9uqu8PqvSHUBNnAnMU1fXdROa3qc1DsSVxvOcGRrwr6kSj1zsNjT --output blocks_details.csv --transactionhash (for block data) | ||
| ``` | ||
| Result - all blocks , transaction hashes , receipts & events of that txns data in your csv files. | ||
|
|
||
| ## [Backfill with filters](https://github.com/BlocSoc-iitr/Athena/blob/main/athena/backfill/filters.go) | ||
|
|
||
|
|
||
|
|
||
|  | ||
| This project aims to implement a blockchain data decoder using Go. This is one of the [other](https://github.com/NethermindEth/entro) implementations that are being developed in python. |