github.com/shardeum/shardeum @ITN3.1 sqlite

An EVM-based autoscaling blockchain platform

Table of Contents

• Introduction
• Features
• Getting Started
• Prerequisites
• Installation
• Running the Network Locally
• Running the JSON-RPC Server
• Testing with MetaMask
• Stopping and Cleaning Up
• Health Checks
• Contributing
• Community
• License

Introduction

Shardeum is an innovative EVM-compliant blockchain platform that leverages dynamic state sharding to achieve unprecedented scalability. By implementing a sharding model, Shardeum ensures faster processing times and lower transaction costs without compromising security or decentralization.

Features

• Scalability: Horizontal scalability through sharding
• High Performance: Low latency and high throughput
• Security: Advanced cryptographic techniques and robust consensus protocols
• Decentralization: Truly decentralized network with no single point of failure
• Interoperability: EVM compatibility for existing DApps and smart contracts

Getting Started

Prerequisites

• Node.js (v18.16.1)
• npm (v9.5.1)
• Rust (v1.74.1)
• Docker (optional, for containerized deployment)

Setting Up Your Environment

Shardeum requires specific versions of Nodejs, Rust and other build tools to run.

We have detailed setup instructions in this page

[!IMPORTANT] This is a crucial step, ensure your local environment is correctly set up before proceeding with the next steps

Installation

1. Clone the repository:

git clone https://github.com/shardeum/shardeum.git
cd shardeum

1. Install dependencies:

npm ci

1. Network Configuration:

git apply debug-10-nodes.patch

Learn more about the different config options here

1. Compile project

npm run prepare

1. Install the Shardus CLI:

npm install -g shardus
npm update @shardus/archiver

Running the Network Locally

To start a local Shardeum network with 10 nodes, run:

shardus start 10

Running the JSON-RPC Server

1. Clone the JSON-RPC server repository:

git clone https://github.com/shardeum/json-rpc-server.git
cd json-rpc-server
npm install

1. Start the server:

npm run start

The default RPC URL is http://localhost:8080.

Testing with MetaMask

To test your local Shardeum network using MetaMask:

1. Install the MetaMask extension.

2. Add the Shardeum network to MetaMask:

3. Network Name: Shardeum

4. RPC URL: http://localhost:8080
5. Chain ID: 8082
6. Currency Symbol: SHM

7. Block Explorer URL: http://localhost:6001/

8. Obtaining Test Tokens and Configuring the Genesis File: To receive SHM tokens for testing on your local Shardeum network, you need to add your wallet address to the src/config/genesis.json file. Open this file in a text editor and add an entry for your wallet address with the desired SHM balance like this:

"YOUR-WALLET-ADDRESS": {
    "wei": "200000000000000000000000000"
},

Stopping and Cleaning Up

To stop the network and clean up resources:

shardus stop && shardus clean && rm -rf instances

Health Checks

Diagnostic endpoints to check the health of the node

• GET /is-alive this endpoint returns 200 if the server is running.
• GET /is-healthy currently the same as /is-alive but will be expanded.

Contributing

We welcome contributions! Please see our Contribution Guidelines for more information. All contributors are expected to adhere to our Code of Conduct.

Community

• GitHub Discussions
• Discord
• Twitter

License

This project is licensed under the MIT License. See the LICENSE file for details.