Push protocol is evolving to Push Chain, a shared-state L1 designed to deliver universal app experiences (Any Chain. Any User. Any App). 🚀

Push Chain Node

Push Chain Node is the core implementation of Push Chain, a next-generation, shared-state Layer 1 blockchain. It powers universal app experiences by enabling seamless interoperability, universal execution, and a frictionless developer experience. The node software allows anyone to participate in the Push Chain network - running core validators, universal validators, or full nodes to help secure and operate the chain. Built for extensibility and performance, Push Chain Node is designed to connect any chain, any user, and any app, making cross-chain and cross-ecosystem applications possible out of the box.

Table of Contents

• Prerequisites
• Running Localnet
• Directory Structure
• Contributing

Prerequisites

Before you begin, ensure you have the following installed:

• Go 1.23+
• Docker
• jq (for scripts)

Running Localnet

Locknet is the local testnet environment for Push Chain. To spin up Locknet, use the following command:

git clone https://github.com/pushchain/push-chain-node.git
cd push-chain-node
make sh-testnet

Directory Structure

• app/ – Core validator application wiring (pchaind). See app/README.md for what Push Chain adds on top of cosmos-evm.
• x/ – Push Chain custom Cosmos SDK modules:
  • uexecutor – Universal transaction execution layer
  • uregistry – Chain & token registry
  • uvalidator – Universal validator set, ballot voting & UV reward boost
  • utss – Threshold signature scheme coordination
• precompiles/ – Custom EVM precompiles (usigverifier — Ed25519 signature verification)
• universalClient/ – The Universal Validator binary (puniversald). See universalClient/README.md.
• proto/ – Protobuf definitions for the four custom modules
• cmd/ – CLI entrypoints (pchaind, puniversald)
• config/ – Per-chain JSON registry configs (mainnet, testnet)
• testnet/ – Validator setup scripts (core + universal)
• interchaintest/ – E2E and integration tests
• utils/ – Shared utility functions

Contributing

We welcome contributions from the community! To get started:

• Fork this repository and create a new branch for your feature or bugfix.
• Make your changes and ensure all tests pass (go test ./... -v).
• Open a pull request with a clear description of your changes.
• For major changes, please open an issue first to discuss what you would like to change.