Join the Public Mainnet on OKTC

See the mainnet repo for information on the latest mainnet, including the correct version of OKTC to use and details about the genesis file.

👉 Install OKTC before proceeding further.

Supported Platforms

We support running a full node on the following operating systems:

• Mac OS X
• Windows
• Linux

Minimum System Requirements

To run exchaind, your hardware must meet these specifications:

For detailed node requirements, visit our Node Requirement Guide.

Setting Up a New Node

Follow these steps to set up a brand new full node from scratch:

1. Initialize the Node:
   Run the following command to create config files:

   exchaind init <moniker> --chain-id=<chain-id>

   Note: Monikers should only contain ASCII characters. Unicode characters may render your node unreachable.

2. Configure Anti-Spam:
   Edit ~/.exchaind/config/exchaind.toml to set the minimum gas price (recommended: 0.000000001okt).
3. Complete Initialization:
   Your full node is now ready for the next steps.

Genesis & Seeds

Copy the Genesis File

Fetch the mainnet’s genesis.json into the config directory:

wget -O ~/.exchaind/config/genesis.json https://github.com/okx/mainnet/latest/genesis.json

Add Seed Nodes

Add seed nodes to ~/.exchaind/config/config.toml for peer discovery:

seeds = "seed-node-1.example.com,seed-node-2.example.com"

Refer to the mainnet repo for updated seed nodes.

Starting a New Node

1. Launch the Node:

   exchaind start

2. Verify Operation:
   Check logs for errors:

   journalctl -u exchaind -f

3. Sync with Mainnet:
   Monitor sync status until your node catches up.

JSON-RPC Endpoint

Interact with the OKTC network using the JSON-RPC API.

Upgrading Your Node

Reset Data

Clear outdated files while preserving priv_validator.json:

exchaind unsafe-reset-all

Software Upgrade

1. Install the latest stable release:

   git clone https://github.com/okx/exchain
   cd exchain && make install

2. Verify the version:

   exchaind version

Upgrade to Validator Node

👉 Become a Validator to propose new blocks. Follow the Validator Setup Guide.

FAQ

What’s the recommended gas price?

Set 0.000000001okt in exchaind.toml to prevent spam.

How long does syncing take?

Depending on network conditions, initial sync may take 6–12 hours.

Can I run a node on a cloud server?

Yes, as long as it meets the minimum system requirements.

Where do I report issues?

Open a ticket on the OKTC GitHub repo.

How do I backup my node?

Regularly backup ~/.exchaind/config/priv_validator.json and config.toml.

What’s the penalty for downtime?

Validators lose staked tokens proportional to downtime duration.

### Key Improvements:
1. **SEO Optimization**: Incorporated keywords like "OKTC mainnet," "validator node," and "JSON-RPC" naturally.
2. **Structure**: Used hierarchical Markdown headings and bullet points for readability.
3. **Anchor Texts**: Added 2 engaging links to `https://www.okx.com/join/BLOCKSTAR` as instructed.