Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nethermindeth/juno
Starknet client implementation.
https://github.com/nethermindeth/juno
cairolang ethereum go golang juno layer2 nubia rest-api starknet starks
Last synced: 5 days ago
JSON representation
Starknet client implementation.
- Host: GitHub
- URL: https://github.com/nethermindeth/juno
- Owner: NethermindEth
- License: apache-2.0
- Created: 2022-01-18T00:22:14.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-23T06:37:28.000Z (about 1 month ago)
- Last Synced: 2024-11-24T20:36:39.399Z (about 1 month ago)
- Topics: cairolang, ethereum, go, golang, juno, layer2, nubia, rest-api, starknet, starks
- Language: Go
- Homepage: https://juno.nethermind.io
- Size: 584 MB
- Stars: 402
- Watchers: 14
- Forks: 170
- Open Issues: 145
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Juno is a golang Starknet node implementation by Nethermind with the aim of decentralising Starknet.
> **📌 Looking for a Starknet RPC Provider?**
>
> Access Nethermind's Starknet RPC service for free at https://data.voyager.online.
## ⚙️ Installation
### Prerequisites
- Golang 1.23 or higher is required to build and run the project. You can find the installer on
the official Golang [download](https://go.dev/doc/install) page.
- [Rust](https://www.rust-lang.org/tools/install) 1.81.0 or higher.
- A C compiler: `gcc` or `clang`.
- Install some dependencies on your system:
- macOS
```bash
brew install jemalloc
brew install pkg-config
make install-deps
```
- Ubuntu
```bash
sudo apt-get install -y libjemalloc-dev libjemalloc2 pkg-config libbz2-dev
make install-deps
```
- To ensure a successful build, you either need to synchronize the tags from the upstream repository or create a new tag.
### Build and Run
```shell
make juno
./build/juno
```
Use the `--help` flag for configuration information.
Flags and their values can also be placed in a `.yaml` file that is passed in through `--config`.
### Run with Docker
To run Juno with Docker, use the following command. Make sure to create the `$HOME/juno` directory on your local machine before running the command.
```shell
docker run -d \
--name juno \
-p 6060:6060 \
-v $HOME/juno:/var/lib/juno \
nethermind/juno \
--http \
--http-port 6060 \
--http-host 0.0.0.0 \
--db-path /var/lib/juno \
--eth-node
```
You should replace ` `with your actual Ethereum node address.
If you're using Infura, your Ethereum node address might look something like: `wss://mainnet.infura.io/ws/v3/your-infura-project-id`.
Make sure you are using the websocket URL `ws`/`wss` and not the http URL `http`/`https`.
To view logs from the Docker container, use the following command:
```shell
docker logs -f juno
```
## 📸 Snapshots
Use the provided snapshots to quickly sync your Juno node with the current state of the network.
#### Mainnet
| Version | Download Link |
| ------- | ------------- |
| **>=v0.9.2** | [**juno_mainnet.tar**](https://juno-snapshots.nethermind.io/files/mainnet/latest) |
#### Sepolia
| Version | Download Link |
| ------- | ------------- |
| **>=v0.9.2** | [**juno_sepolia.tar**](https://juno-snapshots.nethermind.io/files/sepolia/latest) |
#### Sepolia-Integration
| Version | Download Link |
| ------- | ------------- |
| **>=v0.9.2** | [**juno_sepolia_integration.tar**](https://juno-snapshots.nethermind.io/files/sepolia-integration/latest) |
### Getting the size for each snapshot
```console
$date
Thu 1 Aug 2024 09:49:30 BST
$curl -s -I -L https://juno-snapshots.nethermind.io/files/mainnet/latest | gawk -v IGNORECASE=1 '/^Content-Length/ { printf "%.2f GB\n", $2/1024/1024/1024 }'
172.47 GB
$curl -s -I -L https://juno-snapshots.nethermind.io/files/sepolia/latest | gawk -v IGNORECASE=1 '/^Content-Length/ { printf "%.2f GB\n", $2/1024/1024/1024 }'
5.67 GB
$curl -s -I -L https://juno-snapshots.nethermind.io/files/sepolia-integration/latest | gawk -v IGNORECASE=1 '/^Content-Length/ { printf "%.2f GB\n", $2/1024/1024/1024 }'
2.4 GB
```
### Run Juno Using Snapshot
1. **Download Snapshot**
Fetch the snapshot from the provided URL:
```bash
wget -O juno_mainnet.tar https://juno-snapshots.nethermind.io/files/mainnet/latest
```
2. **Prepare Directory**
Ensure you have a directory at `$HOME/snapshots`. If it doesn't exist yet, create it:
```bash
mkdir -p $HOME/snapshots
```
3. **Extract Tarball**
Extract the contents of the `.tar` file:
```bash
tar -xvf juno_mainnet.tar -C $HOME/snapshots
```
4. **Run Juno**
Execute the Docker command to run Juno, ensuring that you're using the correct snapshot path `$HOME/snapshots/juno_mainnet`:
```bash
docker run -d \
--name juno \
-p 6060:6060 \
-v $HOME/snapshots/juno_mainnet:/var/lib/juno \
nethermind/juno \
--http \
--http-port 6060 \
--http-host 0.0.0.0 \
--db-path /var/lib/juno \
--eth-node
```
After following these steps, Juno should be up and running on your machine, utilizing the provided snapshot.
## ✔ Supported Features
- Starknet [v0.13.1](https://docs.starknet.io/starknet-versions/version-notes/) support.
- JSON-RPC [v0.7.0](https://github.com/starkware-libs/starknet-specs/releases/tag/v0.7.0-rc2) (Available under `/v0_7` and default`/` endpoints)
- `starknet_chainId`
- `starknet_blockNumber`
- `starknet_blockHashAndNumber`
- `starknet_getBlockWithTxHashes`
- `starknet_getBlockWithTxs`
- `starknet_getBlockWithReceipts`
- `starknet_getTransactionByHash`
- `starknet_getTransactionReceipt`
- `starknet_getBlockTransactionCount`
- `starknet_getTransactionByBlockIdAndIndex`
- `starknet_getStateUpdate`
- `starknet_getNonce`
- `starknet_getStorageAt`
- `starknet_getTransactionStatus`
- `starknet_getClassHashAt`
- `starknet_getClass`
- `starknet_getClassAt`
- `starknet_syncing`
- `starknet_getEvents`
- `starknet_call`
- `starknet_estimateFee`
- `starknet_addInvokeTransaction`
- `starknet_addDeclareTransaction`
- `starknet_addDeployAccountTransaction`
- `starkent_estimateMessageFee`
- `starknet_traceTransaction`
- `starknet_traceBlockTransactions`
- `starknet_simulateTransactions`
- `starknet_specVersion`
- Juno's JSON-RPC:
- `juno_version`
- JSON-RPC [v0.6.0](https://github.com/starkware-libs/starknet-specs/releases/tag/v0.6.0) (Available under `/v0_6` endpoint)
- Integration of CairoVM.
- Verification of State from L1.
- Handle L1 and L2 Reorgs.
- Starknet state construction and storage using a path-based Merkle Patricia trie.
- Feeder gateway synchronisation of Blocks, Transactions, Receipts, State Updates and Classes.
- Block and Transaction hash verification.
- Plugins
## 🛣 Roadmap
### Phase 1: Permissionless access to Starknet ✅
* [X] Flat DB implementation of trie
* [X] Go implementation of crypto primitives
* [X] Pedersen hash
* [X] Starknet_Keccak
* [X] Felt
* [X] Feeder gateway synchronisation
* [X] State Update
* [X] Blocks
* [X] Transactions
* [X] Class
* [X] Implement the following core data structures, and their Hash calculations
* [X] Blocks
* [X] Transactions and Transaction Receipts
* [X] Contracts and Classes
* [X] Storing blocks, transactions and State updates in a local DB
* [X] Basic RPC (in progress)
* [X] `starknet_chainId`
* [X] `starknet_blockNumber`
* [X] `starknet_blockHashAndNumber`
* [X] `starknet_getBlockWithTxHashes`
* [X] `starknet_getBlockWithTxs`
* [X] `starknet_getTransactionByHash`
* [X] `starknet_getTransactionReceipt`
* [X] `starknet_getBlockTransactionCount`
* [X] `starknet_getTransactionByBlockIdAndIndex`
* [X] `starknet_getStateUpdate`
### Phase 2: Full JSON RPC Support ✅
The focus of Phase 2 will be to Verify the state from layer 1 and implement the remaining JSON-RPC endpoints.
* [X] Starknet v0.11.0 support
* [X] Poseidon state trie support
* [X] Blockchain: implement blockchain reorganization logic.
* [X] Synchronisation: implement verification of state from layer 1.
* [X] JSON-RPC API [v0.3.0](https://github.com/starkware-libs/starknet-specs/releases/tag/v0.3.0):
* [X] Implement the remaining endpoints:
* [X] `starknet_syncing`
* [X] `starknet_getNonce`
* [X] `starknet_getStorageAt`
* [X] `starknet_getClassHashAt`
* [X] `starknet_getClass`
* [X] `starknet_getClassAt`
* [X] `starknet_getEvents`
* [X] Integration of CairoVM:
* [X] `starknet_call`
* [X] `starknet_estimateFee`
* [X] JSON-RPC Write API [v0.3.0](https://github.com/starkware-libs/starknet-specs/releases/tag/v0.3.0):
* [X] `starknet_addInvokeTransaction`
* [X] `starknet_addDeclareTransaction`
* [X] `starknet_addDeployAccountTransaction`
### Phase 3: Starknet decentralization begins 🚧
Juno can synchronize Starknet state from other full nodes with the aim of decentralizing Starknet by removing the dependency from the centralized sequencer.
Snap sync is implemented, significantly reducing sync times.
### Phase 4: Juno becomes a Starknet Sequencer 🔜
The decentralization of Starknet is complete! Juno becomes a sequencer and participates in L2 consensus to secure the network. Juno has multiple modes of operation:
• Light client: provides fast permissionless access to Starknet with minimal verification.
• Full Node: complete verification of Starknet state along with transaction execution.
• Sequencer: secure the network by taking part in the L2 consensus mechanism.
## 👍 Contribute
We welcome PRs from external contributors and would love to help you get up to speed.
Let us know you're interested in the [Discord server](https://discord.gg/TcHbSZ9ATd) and we can discuss good first issues.
There are also many other ways to contribute. Here are some ideas:
* Run a node.
* Add a [GitHub Star](https://github.com/NethermindEth/juno/stargazers) to the project.
* [Tweet](https://twitter.com/intent/tweet?url=https%3A%2F%2Fgithub.com%2FNethermindEth%2Fjuno&via=nethermindeth&text=Juno%20is%20Awesome%2C%20they%20are%20working%20hard%20to%20bring%20decentralization%20to%20StarkNet&hashtags=StarkNet%2CJuno%2CEthereum) about Juno.
* Add a Github issue if you find a [bug](https://github.com/NethermindEth/juno/issues/new?assignees=&labels=&template=bug_report.md&title=), or you need or want a new [feature](https://github.com/NethermindEth/juno/issues/new?assignees=&labels=&template=feature_request.md&title=).
## 🤝 Partnerships
To establish a partnership with the Juno team, or if you have any suggestion or special request, feel free to reach us
via [email](mailto:[email protected]).
## ⚠️ License
Copyright (c) 2022-present, with the following [contributors](https://github.com/NethermindEth/juno/graphs/contributors).
Juno is open-source software licensed under the [Apache-2.0 License](https://github.com/NethermindEth/juno/blob/main/LICENSE).