# shardeum/shardeum

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/shardeum-shardeum).**

31,393 stars · 703 forks · TypeScript · MIT

## Links

- GitHub: https://github.com/shardeum/shardeum
- Homepage: https://shardeum.org/
- awesome-repositories: https://awesome-repositories.com/repository/shardeum-shardeum.md

## Topics

`blockchain` `dapp` `ethereum` `evm` `evm-blockchain` `payments` `sharding` `typescript`

## Description

Shardeum is an autoscaling blockchain infrastructure designed to distribute network workloads across multiple shards to increase throughput. It uses a dynamic-sharding architecture that horizontally scales node capacity and adjusts the number of active shards based on real-time network demand.

The system features an execution environment compatible with the Ethereum Virtual Machine, allowing it to run smart contracts and decentralized applications. It maintains network agreement and security through consensus-group partitioning, which organizes validator nodes into discrete groups.

The platform covers blockchain node operation and state management, including peer-to-peer state synchronization, persisted storage for account balances, and remote procedure call interfaces for external state exposure. It also includes tools for network orchestration, such as genesis configuration, node reward management, and the ability to deploy multi-node environments.

The project provides a development environment bootstrap process and supports containerized node deployment.

## Tags

### Data & Databases

- [State Sharding Architectures](https://awesome-repositories.com/f/data-databases/state-sharding-architectures.md) — Utilizes a dynamic state sharding architecture to distribute workloads and increase network throughput.
- [Ledger State Management](https://awesome-repositories.com/f/data-databases/blockchain-state-snapshots/ledger-state-management.md) — Manages the global state of the distributed ledger, tracking account balances and transaction history through persisted storage.
- [Data Storage Layers](https://awesome-repositories.com/f/data-databases/data-engineering-infrastructure/data-persistence-storage/data-storage-layers.md) — Implements a durable storage layer with an integrated cache to track account balances and transaction history.
- [Horizontal Scaling](https://awesome-repositories.com/f/data-databases/horizontal-scaling.md) — Increases network throughput by distributing workloads across multiple shards using a horizontally scalable architecture. ([source](https://github.com/shardeum/shardeum#readme))

### DevOps & Infrastructure

- [Blockchain Autoscaling Systems](https://awesome-repositories.com/f/devops-infrastructure/blockchain-autoscaling-systems.md) — Implements a dynamic-sharding architecture that horizontally scales node capacity and adjusts active shards based on real-time demand. ([source](https://github.com/shardeum/shardeum/blob/dev/package.json))
- [Autoscaling Blockchain Infrastructure](https://awesome-repositories.com/f/devops-infrastructure/autoscaling-blockchain-infrastructure.md) — Provides an autoscaling blockchain infrastructure that distributes network workloads across multiple shards to increase throughput.
- [Blockchain Nodes](https://awesome-repositories.com/f/devops-infrastructure/blockchain-nodes.md) — Facilitates the operation of validator nodes, including P2P connectivity and reward configuration.
- [Capacity Scaling](https://awesome-repositories.com/f/devops-infrastructure/cluster-node-management/capacity-scaling.md) — Implements automatic scaling of shards and node distributions to meet real-time network demand.
- [Consensus Group Partitioning](https://awesome-repositories.com/f/devops-infrastructure/environment-grouping/consensus-group-partitioning.md) — Organizes validator nodes into discrete groups to maintain network agreement and security across scaled shards.
- [Capacity Scaling Configurations](https://awesome-repositories.com/f/devops-infrastructure/network-configurations/capacity-scaling-configurations.md) — Allows configuration of minimum and maximum active node counts to manage network capacity and autoscaling. ([source](https://github.com/shardeum/shardeum/blob/dev/debug-10-nodes.config.json))
- [Local Testnet Deployers](https://awesome-repositories.com/f/devops-infrastructure/deployment-management-strategies/execution-platforms-and-targets/deployment-environments/private-cloud-deployments/local-testnet-deployers.md) — Launches multi-node environments on a single machine for testing applications and network configurations. ([source](https://github.com/shardeum/shardeum#readme))
- [Environment Configurations](https://awesome-repositories.com/f/devops-infrastructure/environment-configurations.md) — Enables switching between local, development, testnet, and mainnet environments using predefined configuration sets. ([source](https://github.com/shardeum/shardeum/tree/dev/environments))
- [Network Orchestration](https://awesome-repositories.com/f/devops-infrastructure/network-orchestration.md) — Provides tools for defining genesis states and deploying multi-node environments for network testing.

### Networking & Communication

- [Consensus Group Management](https://awesome-repositories.com/f/networking-communication/consensus-group-management.md) — Organizes validator nodes into discrete consensus groups to maintain network security and agreement. ([source](https://github.com/shardeum/shardeum/blob/dev/debug-10-nodes.config.json))
- [State Synchronization](https://awesome-repositories.com/f/networking-communication/distributed-systems-p2p/peer-to-peer-networking/state-synchronization.md) — Uses a peer-to-peer communication layer to propagate blockchain state and transactions across distributed nodes.
- [Peer-to-Peer Networking](https://awesome-repositories.com/f/networking-communication/peer-to-peer-networking.md) — Manages peer-to-peer network communication by defining internal and external IP addresses and ports. ([source](https://github.com/shardeum/shardeum/blob/dev/config.json))
- [Blockchain RPC Interfaces](https://awesome-repositories.com/f/networking-communication/distributed-systems-p2p/decentralized-blockchain-technologies/blockchain-rpc-interfaces.md) — Provides standardized remote procedure call interfaces for external clients to query state and submit transactions.
- [State Synchronization Tuning](https://awesome-repositories.com/f/networking-communication/distributed-systems-p2p/peer-to-peer-networking/state-synchronization-tuning.md) — Provides controls for peer counts and recovery settings to synchronize blockchain state efficiently. ([source](https://github.com/shardeum/shardeum/blob/dev/debug-25-nodes.config.json))
- [Blockchain Transaction Executors](https://awesome-repositories.com/f/networking-communication/transaction-subscriptions/blockchain-transaction-executors.md) — Handles specialized blockchain operations such as staking and reward claims through a dedicated execution pipeline. ([source](https://github.com/shardeum/shardeum/blob/dev/CLAUDE.md))

### Programming Languages & Runtimes

- [EVM Implementations](https://awesome-repositories.com/f/programming-languages-runtimes/programming-language-varieties/programming-languages/systems-languages/rust/evm-implementations.md) — Provides a runtime environment that implements the Ethereum Virtual Machine for executing smart contracts.

### Security & Cryptography

- [Account Management](https://awesome-repositories.com/f/security-cryptography/account-management.md) — Manages cryptographic identities for standard users, system operations, and validator nodes. ([source](https://github.com/shardeum/shardeum/blob/dev/CLAUDE.md))

### Web Development

- [Smart Contract Environments](https://awesome-repositories.com/f/web-development/smart-contract-environments.md) — Offers a runtime environment capable of executing smart contract logic on-chain. ([source](https://github.com/shardeum/shardeum#readme))

### Software Engineering & Architecture

- [Genesis Configuration](https://awesome-repositories.com/f/software-engineering-architecture/genesis-configuration.md) — Allows defining the initial state and starting parameters required to launch a new blockchain network. ([source](https://github.com/shardeum/shardeum/blob/dev/src/config/genesis.json))
