Skip to content
TakoAPI
Back to skills

xian-node-skill

by endogen

DevOps & Cloud
821Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Set up and manage Xian blockchain nodes.

Description

What This Skill Does

Deploys and manages Xian blockchain nodes using Docker-based tooling (xian-stack). Covers joining mainnet or testnet, running validator or service nodes, and monitoring sync status via CometBFT RPC endpoints.

The xian-stack Makefile abstraction reduces multi-step Docker and CometBFT configuration to single commands, avoiding manual container and process management.

When to Use It

  • Joining Xian mainnet as a full node
  • Running a validator node with a private key
  • Setting up a private Xian test network from genesis
  • Monitoring block sync progress and peer connections
  • Querying node state and balances via xian-py SDK

Example Workflow

INPUT

User asks: Set up a Xian mainnet node on my server

AGENT
  1. 1

    Clone xian-stack and run make setup CORE_BRANCH=mainnet CONTRACTING_BRANCH=mainnet

  2. 2

    Build the Docker image with make core-build and start the container with make core-up

  3. 3

    Initialize CometBFT state with make init

  4. 4

    Configure the node for mainnet using make configure with the genesis file and seed node address

  5. 5

    Enter the container with make core-shell, start processes with make up, and verify sync with curl -s localhost:26657/status | jq '.result.sync_info'

OUTPUT

Node running inside Docker container, syncing blocks from mainnet, sync_info showing catching_up: true until fully caught up

Requirements

  • Docker installed and running
  • Validator private key (only for validator nodes)

Installation

clawhub install endogen/xian-node-skill

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links