https://github.com/pushchain/push-chain-node
https://github.com/pushchain/push-chain-node
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/pushchain/push-chain-node
- Owner: pushchain
- License: mit
- Created: 2025-01-29T09:49:20.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-21T09:57:06.000Z (5 months ago)
- Last Synced: 2026-01-21T15:23:32.461Z (5 months ago)
- Language: Go
- Size: 82.2 MB
- Stars: 3
- Watchers: 4
- Forks: 4
- Open Issues: 11
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
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](#prerequisites)
- [Running Localnet](#running-localnet)
- [Directory Structure](#directory-structure)
- [Contributing](#contributing)
## Prerequisites
Before you begin, ensure you have the following installed:
- [Go 1.23+](https://golang.org/dl/)
- [Docker](https://www.docker.com/)
- [jq](https://stedolan.github.io/jq/download/) (for scripts)
## Running Localnet
Locknet is the local testnet environment for Push Chain. To spin up Locknet, use the following command:
```sh
git clone https://github.com/pushchain/push-chain-node.git
cd push-chain-node
make sh-testnet
```
## Directory Structure
- `app/` – Core application logic and configuration
- `x/` – Cosmos SDK modules (UExecutor, UTxVerifier, etc.)
- `precompiles/` – EVM precompiles for universal verification
- `proto/` – Protobuf definitions
- `cmd/` – CLI entrypoints
- `deploy/` – Deployment scripts and testnet configs
- `interchaintest/` – E2E and integration tests
- `utils/` – 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.