Nillion Validator Tools & Infrastructure Documentation
Complete infrastructure toolkit for Nillion validators and developers. Access our professional-grade services including RPC nodes, API endpoints, daily snapshots, and real-time metrics. Our nillion infrastructure features optimized pruning configurations, automated backups, and comprehensive monitoring solutions. Supporting both mainnet and testnet environments with dedicated endpoints, state-sync services, and detailed technical documentation for seamless network participation and development.
With our state sync services you will be able to catch up latest chain block in matter of minutes
ⓘ  Â
State Sync allows a new node to join the network by fetching a snapshot of the application state
at a recent height instead of fetching and replaying all historical blocks. Since the
application state is generally much smaller than the blocks, and restoring it is much
faster than replaying blocks, this can reduce the time to sync with the network from days to minutes.
#Instructions
#Stop nilchaind and reset database
sudo systemctl stop nilchaind
cp $HOME/.nilchaind/data/priv_validator_state.json $HOME/.nilchaind/priv_validator_state.json.backup
nilchaind tendermint unsafe-reset-all --home $HOME/.nilchaind --keep-addr-book
#Get and configure the state sync information
STATE_SYNC_RPC=https://rpc.cosmos.directory:443/nillion
BACKUP_RPC=https://testnet-rpc.lavenderfive.com:443/nillion/
LATEST_HEIGHT=$(curl -s $STATE_SYNC_RPC/block | jq -r .result.block.header.height)
BLOCK_HEIGHT=$(echo LATEST_HEIGHT | awk '{print $1 - ($1 % 6000)}'); \
TRUST_HASH=$(curl -s "$STATE_SYNC_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)
SEEDS="20e1000e88125698264454a884812746c2eb4807@testnet-seeds.lavenderfive.com:28156"
echo -e "Modifying $HOME/.nilchaind/config/config.toml based on the following values:"
echo -e "RPC Address: $STATE_SYNC_RPC"
echo -e "Latest Block Height: $LATEST_HEIGHT"
echo -e "Sync Block Height: $BLOCK_HEIGHT"
echo -e "Trust Hash: $TRUST_HASH"
sed -i \
-e "s|^enable *=.*|enable = true|" \
-e "s|^rpc_servers *=.*|rpc_servers = \"$STATE_SYNC_RPC,$BACKUP_RPC\"|" \
-e "s|^trust_height *=.*|trust_height = $BLOCK_HEIGHT|" \
-e "s|^trust_hash *=.*|trust_hash = \"$TRUST_HASH\"|" \
-e "s|^seeds *=.*|seeds = \"$SEEDS\"|" \
$HOME/.nilchaind/config/config.toml
mv $HOME/.nilchaind/priv_validator_state.json.backup $HOME/.nilchaind/data/priv_validator_state.json
#Download latest wasm
ⓘ  Â
Currently state sync does not support copy of the `wasm` folder. Therefore, you will have to download it manually.
curl -L https://snapshots.lavenderfive.com/wasm/nillion/wasmonly.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.nilchaind
#Restart nilchaind and check the log
sudo systemctl restart nilchaind && sudo journalctl -u nilchaind -f --no-hostname -o cat
Chain ID:
The unique identifier for the blockchain network.
nillion-chain-testnet-1Latest Version:
The latest version of the chain software.
v0.2.2Github:
The Github repository hosting the code for the network in question.
Public endpoints
Public endpoints are rate limited but can be used for basic CLI usage, node syncing or testing environments. Request an API key for enhanced access limits, we offer free trial periods of 14 days and cheap shared access plans from $50 a month.
REST/LCD
REST endpoint for querying blockchain data through the REST framework. Often available for Cosmos chains but also the main framework for Aleo as an example.
testnet-rest.lavenderfive.com:443/nillion
RPC
Remote Procedure Call endpoint for the consensus client of a blockchain. This is not an EVM endpoint (we call this json RPC) but the main framework for blockchain frameworks like Cosmos, Aptos, Sui and Near.
testnet-rpc.lavenderfive.com:443/nillion
gRPC
High-performance RPC endpoint for blockchain communication using the Google gRPC framework. This is often standard gRPC and not the "WEB" framework which is sometimes also accesible.
testnet-nillion.lavenderfive.com:443
WebSocket
WebSocket endpoint for real-time blockchain updates of the consensus client. This is not the EVM websocket integration, we name and expose that separately. WS is commonly available for Cosmos and Move networks that also expose a REST endpoint.
wss://testnet-rpc.lavenderfive.com:443/nillion/ws
© 2022 Lavender.Five Nodes. All rights reserved.