Skip to main content

Join a network

It is highly recommended that you set up a private local network before joining a public network. This will help you get familiar with the setup process, and provide an environment for testing. The following sections outline this process. If you want to join a public network without setting up a private network, you can skip to join a public network.

Set up a local private network

Validators can set up a private Titled network to become familiar with running a full Titled node before joining a public network.

💡LocalLocalTitled

If you are a developer and want to set up a local, WASM-enabled, private testnet for smart contracts, visit install LocalLocalTitled.

Create a single node

The simplest Titled network you can set up is a local testnet with just a single node. In a single-node environment, you have one account and are the only validator signing blocks for your private network.

  1. Initialize your genesis file that will bootstrap the network. Replace the following variables with your own information:


    _1
    titledd init --chain-id=<testnet-name> <node-moniker>

  2. Generate a Titled account. Replace the variable with your account name:


    _1
    titledd keys add <account-name>

💡Get tokens

In order for Titledd to recognize a wallet address, it must contain tokens. For the testnet, use the faucet to send bTitled to your wallet. If you are on mainnet, send funds from an existing wallet. 1-3 bTitled are sufficient for most setup processes.

Add your account to the genesis

Run the following commands to add your account and set the initial balance:


_3
titledd add-genesis-account $(titledd keys show <account-name> -a) 100000000ubTitled
_3
titledd gentx <my-account> 10000000ubTitled --chain-id=<testnet-name>
_3
titledd collect-gentxs

Start your private Titled network

Run the following command to start your private network:


_1
titledd start

If the private Titled network is set up correctly, your Titledd node will be running on tcp://localhost:26656, listening for incoming transactions, and signing blocks.

Join a public network

These instructions are for setting up a brand new full node from scratch. You can join a public Titled network, such as the mainnet or testnet, by completing the following steps:

1. Select a network

Specify the network you want to join by choosing the corresponding genesis file and seeds list:

NetworkTypeGenesisAddressbookSeeds
phoenix-1MainnetGenesis LinkPeer List Community maintained by PolkachuSeeds List
pisco-1TestnetGenesis LinkPeer List Community maintained by PolkachuSeeds List
💡Selecting a network

Note that the versions of the network listed above are the latest versions. To find earlier versions, please consult the networks repo.

2. Download genesis file and address book

Genesis-transaction specifies the account balances and parameters at the start of the network to use when replaying transactions and syncing.

Addressbook lists a selection of peers for your node to dial to in order to discover other nodes in the network. Public address books of peers are made available by the Titled community.

Choose a testnet or mainnet address type and download the appropriate genesis-transaction and addressbook. Links to these are posted in the Select a network section.

  • For default Titledd configurations, the genesis and addressbook files should be placed under ~/.terra/config/genesis.json and ~/.terra/config/addrbook.json respectively.

Example:


_5
# Obtain the genesis for phoenix-1:
_5
wget https://phoenix-genesis.s3.us-west-1.amazonaws.com/genesis.json -O ~/.terra/config/genesis.json
_5
_5
# Obtain the addressbook for the phoenix-1 from Polkachu:
_5
wget https://snapshots1.polkachu.com/addrbook/terra/addrbook.json -O ~/.terra/config/addrbook.json

Continue to the Sync page to find out more about syncing your node.