# README
ONEX Consumer Chain
Hybrid AMM + On-chain Orderbook DEX
The onex-mainnet-1 chain will be launched as a consumer chain secured by the Onomy Network.
- Network information: https://github.com/onomyprotocol/validator/tree/main/testnet
- Chain ID:
onex-mainnet-1
- Spawn time:
March 4th, 2024(Will be updated soon) - Genesis file (without CCV): https://raw.githubusercontent.com/onomyprotocol/validator/main/testnet/onex-mainnet-1/genesis-without-ccv.json
- Genesis with CCV: Available soon
- Current version:
v1.0.3-onex
- Binary:
- Version: v1.0.3-onex
- SHA256:
e719ac86618953dee759e111c414cded126d54b8b8ae4f9f8b21015b06c1d91c
- Onex GitHub repository: https://github.com/onomyprotocol/onex
- Peers: ``
- Endpoints:
- RPC: ``
- API: ``
- gRPC: ``
- Block Explorer: ``
IBC detail
| onex-mainnet-1 | onomy-mainnet-1 | |
|---|---|---|
| Client | Available soon | Available soon |
| Connections | Available soon | Available soon |
| Channels | transfer: Available soon consumer: Available soon | transfer: Available soon consumer: Available soon |
Setup Instruction
1. Joining Onomy provider chain (onomy-mainnet-1) as a validator
First, validators need to run the Onomy provider chain. To set up the node and join the network, please follow the instructions in mainnet documentation.
Here is the detail of the Onomy provider chain:
- Chain ID:
onomy-mainnet-1 - Version: v1.1.4
- Genesis: https://raw.githubusercontent.com/onomyprotocol/validator/main/mainnet/genesis/genesis-mainnet-1.json
- Seeds:
[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:52756
- Persistent Peers:
[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:52756,[email protected]:26656
4. Setup Onex consumer chain
The validators also need to set up the onex-mainnet-1 consumer chain. Here are the commands to install the binary and set up the new chain.
# detail of setup will appear here
cd $HOME/go/bin
wget -O onexd https://github.com/onomyprotocol/onex/releases/download/v1.0.3-onex/onexd && chmod +x onexd
onexd version # v1.0.3-onex
onexd init <moniker> --chain-id onex-mainnet-1
cd $HOME/.onex/
wget -O config/genesis.json https://raw.githubusercontent.com/onomyprotocol/validator/main/testnet/onex-mainnet-1/genesis-without-ccv.json
The validators MUST NOT run the node but wait until the new genesis is published on the Onomy repository, which will be detailed in step 5. Vote the consumer-addition proposal.
5. Vote on the consumer-addition proposal
The proposal to launch onex-mainnet-1 as a consumer chain will be submitted on the Onomy provider mainnet and the validators should participate in voting for the proposal. After the proposal is passed, the validators should wait until the spawn_time and replace the old genesis file with the new genesis-with-ccv.json file from the Onomy repository.
wget -O /$HOME/.onex/config/genesis.json https://raw.githubusercontent.com/onomyprotocol/validator/main/testnet/onex-mainnet-1/genesis.json
6. Wait for genesis and run
At the genesis time, validators can start the consumer chain by running
onexd start
Launch Stages
| Step | When? | What do you need to do? | What is happening? |
|---|---|---|---|
| 1 | ASAP | Join the Onomy mainnet onomy-mainnet-1 as a full node and sync to the tip of the chain. | Validator machines getting caught up on existing Composable chain's history |
| 2 | Consumer Addition proposal on provider chain | [PROVIDER] Optional: Vote for the consumer-addition proposal. | The proposals that provide new details for the launch. |
| 3 | The proposals passed | Nothing | The proposals passed, spawn_time is set. After spawn_time is reached, the ccv.json file containing ccv state will be provided from the provider chain. |
| 4 | spawn_time reached | The genesis-with-ccv.json file will be provided in the testnets repo. Replace the old genesis.json in the $HOME/.onex/config directory with the new genesis-with-ccv.json. The new genesis-with-ccv.json file with ccv data will be published in onomyprotocol/valiadtor | |
| 5 | Genesis reached | Start your node with the consumer binary | onex-mainnet-1 chain will start and become a consumer chain. |
| 6 | 3 blocks after upgrade height | Celebrate! :tada: 🥂 | blocks are now produced by the provider validator set |