provenanceio/node repository overview

⁠Quick reference

• Maintained by: The Provenance Devops Team⁠
• Where to file issues: Provenance Testnet Issue Tracker⁠

⁠Supported tags and respective Dockerfile links:

• testnet-beta⁠*
• testnet-beta-archive⁠
• pio-testnet-1⁠*
• pio-testnet-1-archive⁠
• pio-mainnet-1⁠*
• pio-mainnet-1-archive⁠

⁠* Denotes a Provenance cosmovisor⁠ managed instance. This is a forked version of Cosmos's cosmovisor⁠ to ensure deterministic upgrades (see this cosmos-sdk issue here⁠ for more information).`

⁠Quick reference (cont.)

• Supported architectures: [amd64]
  • Why not more?: Upstream dependencies currently lock us into amd64 (namely libwasm). There are future plans for other archs.
• Source of this description: docs⁠

⁠What is this image?

The provenanceio/node images are used to quickly bootstrap a genesis node on one of the provenance nets. They contain the genesis content as well as a subset of peer and seed nodes to bootstrap a connection with.

⁠How to use this image

In these docs, ${chain-id} is a placeholder for one of [testnet-beta, pio-testnet-1, pio-mainnet-1].

⁠Quick start for ${chain-id}

Background

$ docker run --name my-node -d -v $(pwd)/mynode:/home/provenance provenanceio/node:${chain-id}

Interactive

$ docker run -it --rm --name my-node -v $(pwd)/mynode:/home/provenance provenanceio/node:${chain-id}

• Note: The directory ./mynode will contain all data, configs, and binaries related to this chain id.

⁠Custom configuration files

If you choose to use a custom config.toml or app.toml configuration file, you can pre-create them. The bootstrap process will not overwrite these existing files.

$ mkdir -p ./mynode/config
$ cp my-custom-config.toml mynode/config/config.toml
$ cp my-custom-app.toml mynode/config/app.toml

If you choose to use the default, and tweak that, spin up the docker image with a no-op, and edit the created file.

$ docker run --rm --name my-node -v $(pwd)/mynode:/home/provenance provenanceio/node:${chain-id} true
$ vi testnet/config/config.toml
$ vi testnet/config/app.toml
<edit>

⁠Exposing external ports

• Common ports
  • api: 1317
  • rpc: 26657
  • grpc: 9090

$ docker run --name my-node -p 1317:1317 -p 26657:26657 -p 9090:9090 -v $(pwd)/mynode:/home/provenance provenanceio/node:${chain-id}