Installation & Build

How to build and install the paxd node binary.

Source: paxeer-network/Makefile and paxeer-network/README.md

Prerequisites

Go: 1.25.6 or the toolchain required by the selected revision
Make: Standard build tool
Git: For cloning the repository
Native toolchain: GCC and the native libraries required by the selected build. Use LEDGER_ENABLED=false to disable the optional Ledger build tag.

Repository Location

Paxeer Network lives in the Sidiora-Labs/LayerX-Network monorepo under paxeer-network/.

git clone https://github.com/Sidiora-Labs/LayerX-Network.git
cd LayerX-Network/paxeer-network

Build from Monorepo Root

From the monorepo root, use these namespaced targets:

make paxeer-build    # Build paxd binary to paxeer-network/build/paxd
make paxeer-lint     # Run linters
make paxeer-test     # Run tests
make paxeer-ci       # Lint + test (CI gate)

make monorepo-ci at the repository root composes the LayerX Network gate with make paxeer-ci.

Build from paxeer-network/ Directory

From within paxeer-network/:

make build    # Build to ./build/paxd
make install  # Install with go install ./daemon/paxd
make lint     # Run linters
make test     # Run tests
make ci       # Lint + test

Build Output

The paxd binary is written to:

./build/paxd when using make build
$GOBIN/paxd when GOBIN is set, otherwise $(go env GOPATH)/bin/paxd, when using make install

Build Tags and Flags

Ledger Support

Ledger hardware wallet support is enabled by default. To build without ledger:

make build LEDGER_ENABLED=false

Mock Balances (Testing)

For testing with mock balances:

make install-mock-balances

Benchmark Build

For benchmark runs:

make install-bench

Version Information

The Makefile resolves version from Git tags or branch names. Paxeer releases use namespaced tags:

paxeer-network/vX.Y.Z

Version information is embedded in the binary at build time via linker flags:

Name: paxeer
AppName: paxd
Version: Resolved from tag/branch
Commit: Git commit SHA

Check version:

paxd version

Static Linking

To build a statically-linked binary:

make build LINK_STATICALLY=true

Go Module

Paxeer is a separate Go module:

module github.com/sidiora-labs/paxeer-network

go 1.25.6

Note: Paxeer maintains its own go.mod, go.sum, and dependency tree separate from the LayerX monorepo root.

Foundry (Contracts)

Paxeer-native contracts use Foundry:

# From the monorepo root
cd paxeer-network
forge install
forge build

See paxeer-network/contracts/README.md for contract-specific instructions.

Important: paxeer-network/contracts/ contains Paxeer-native contracts (WPAX, pointers, precompile interfaces). LayerX settlement contracts are at contracts/ in the repository root.

Docker

Local Docker cluster targets are available. See Docker documentation for:

make docker-cluster-start
make run-local-node
Compose configurations in docker/

Choose a Node Configuration

Use the local Docker configuration to try the built binary, or initialize a node with the genesis, peers, and mode for your chosen network. For an existing network, select the binary revision specified by its upgrade plan.

Next Steps

Network Parameters

Run a Node