@x1scroll/node-cli

CLI for registering X1 validators as storage nodes in the x1scroll network.

Installation

npm install -g @x1scroll/node-cli

Usage

Register your validator as a storage node

x1scroll-node register \
  --keypair ~/.config/solana/identity.json \
  --ipfs-peer 12D3KooW... \
  --endpoint https://your-node.com/api/ipfs/upload

Update node info

x1scroll-node update \
  --keypair ~/.config/solana/identity.json \
  --ipfs-peer 12D3KooW... \
  --endpoint https://your-node.com/api/ipfs/upload

Deregister your node

x1scroll-node deregister --keypair ~/.config/solana/identity.json

⏳ Note: Deregistration starts a 2-day cooldown before it is finalized on-chain.

Check status

x1scroll-node status --keypair ~/.config/solana/identity.json

List all registered nodes

x1scroll-node list

Options

All commands accept an optional --rpc <url> flag to override the default RPC endpoint (https://rpc.x1.xyz).

x1scroll-node list --rpc https://my-custom-rpc.example.com

Details

• Network: X1 (SVM-compatible)
• Program ID: GqzvCjz8nzxWxH39twk4oPfFaHXeyVDty9oJ6F4UcfF5
• Registration fee: 0.01 XNT
• PDA seeds: ["storage_node", validator_pubkey]

Requirements

• Node.js >= 16
• A funded X1 validator identity keypair (at least 0.01 XNT for registration)

License

MIT