xian-node
Set up and manage Xian blockchain nodes. Use when deploying a Xian node to join mainnet/testnet, creating a new Xian network, or managing running nodes. Covers Docker-based setup via xian-stack, CometBFT configuration, and node monitoring.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/endogen/xian-node-skillXian Node Skill
Deploy and manage Xian blockchain nodes — an L1 with native Python smart contracts on CometBFT.
Quick Reference
| Task | Command |
|---|---|
| Join mainnet | make setup && make core-build && make core-up && make init && make configure CONFIGURE_ARGS='--genesis-file-name genesis-mainnet.json --seed-node-address <seed> --copy-genesis' |
| Start node | make core-shell then make up inside container |
| View logs | pm2 logs --lines 100 (inside container) |
| Stop node | make down (inside container) or make core-down (stop container) |
| Check sync | curl -s localhost:26657/status | jq '.result.sync_info' |
Setup: Join Existing Network
1. Clone and Build
git clone https://github.com/xian-network/xian-stack.git
cd xian-stack
make setup CORE_BRANCH=mainnet CONTRACTING_BRANCH=mainnet
make core-build
make core-up
2. Initialize CometBFT
make init
3. Configure Node
Mainnet:
make configure CONFIGURE_ARGS='--moniker "my-node" --genesis-file-name "genesis-mainnet.json" --seed-node-address "[email protected]" --copy-genesis'
Testnet:
make configure CONFIGURE_ARGS='--moniker "my-node" --genesis-file-name "genesis-testnet.json" --seed-node-address "<testnet-seed>" --copy-genesis'
Validator node (add private key):
make configure CONFIGURE_ARGS='--moniker "my-validator" --genesis-file-name "genesis-mainnet.json" --validator-privkey "<your-privkey>" --seed-node-address "..." --copy-genesis'
Service node (with BDS - Blockchain Data Service):
make configure CONFIGURE_ARGS='--moniker "my-service" --genesis-file-name "genesis-mainnet.json" --seed-node-address "..." --copy-genesis --service-node'
4. Start Node
make core-shell # Enter container
make up # Start pm2 processes
pm2 logs # Watch sync progress
exit # Leave shell (node keeps running)
Setup: Create New Network
1. Build Stack
git clone https://github.com/xian-network/xian-stack.git
cd xian-stack
make setup CORE_BRANCH=mainnet CONTRACTING_BRANCH=mainnet
make core-build
make core-up
make init
2. Generate Validator Keys
Inside container (make core-shell):
# Generate new validator key
python -c "
from nacl.signing import SigningKey
import secrets
sk = SigningKey(secrets.token_bytes(32))
print(f'Private key: {sk.encode().hex()}')
print(f'Public key: {sk.verify_key.encode().hex()}')
"
3. Create Genesis File
Create genesis.json with initial validators and state. See references/genesis-template.md.
4. Configure as Genesis Validator
make configure CONFIGURE_ARGS='--moniker "genesis-validator" --genesis-file-name "genesis-custom.json" --validator-privkey "<privkey>"'
5. Start Network
make core-shell
make up
Other nodes join using your node as seed.
Node Management
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-endogen-xian-node-skill": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
xian-sdk
Build applications on the Xian blockchain using the xian-py Python SDK. Use when developing apps that interact with Xian — wallets, transactions, smart contracts, state queries, token transfers. Covers sync and async patterns.
ralph-loop
Generate copy-paste bash scripts for Ralph Wiggum/AI agent loops (Codex, Claude Code, OpenCode, Goose). Use when asked for a "Ralph loop", "Ralph Wiggum loop", or an AI loop to plan/build code via PROMPT.md + AGENTS.md, SPECS, and IMPLEMENTATION_PLAN.md, including PLANNING vs BUILDING modes, backpressure, sandboxing, and completion conditions.