digicatapult/sqnc-node

Sequence (SQNC) Substrate节点镜像

镜像概述和主要用途

本镜像为Sequence (SQNC) 网络的官方Substrate节点实现，基于Substrate框架构建。主要用于运行Sequence网络全节点，支持***数据同步、共识协议参与、P2P网络通信及区块验证等核心功能，适用于节点运营、网络维护及开发测试场景。

核心功能和特性

• ***数据同步：实时同步Sequence网络完整账本数据，支持从创世区块到最新区块的全量数据同步
• 共识参与：兼容Sequence网络共识机制，支持作为全节点参与区块验证，或配置为验证节点参与区块生产
• P2P网络通信：通过libp2p协议与网络中其他节点建立安全连接，维护分布式网络拓扑
• 节点监控：内置节点状态指标暴露功能，支持通过RPC接口查询节点健康状态、同步进度及网络连接信息
• 数据持久化：支持***状态数据、节点配置及密钥的持久化存储，确保节点重启后数据不丢失

使用场景和适用范围

• 全节点运营：个人或机构运行Sequence网络全节点，参与网络数据同步和验证
• 开发测试：***应用开发者在本地或测试环境部署节点，进行智能合约测试和链上交互验证
• 网络维护：网络维护者监控Sequence网络状态，分析区块数据和节点性能
• 生态参与：为Sequence生态提供基础设施支持，如RPC服务节点、数据索引节点等

使用方法和配置说明

基本部署（Docker Run）

主网节点部署

bash
docker run -d \
  --name sqnc-node \
  --restart unless-stopped \
  -p 30333:30333 \  # P2P网络端口
  -p 9933:9933 \    # HTTP RPC端口
  -p 9944:9944 \    # WebSocket RPC端口
  -v /var/sqnc-node/data:/data \  # 数据持久化目录
  sequence/substrate-node:latest \
  --chain=sqnc-mainnet \
  --name="MySQNCNode" \
  --base-path=/data \
  --rpc-external \
  --ws-external \
  --rpc-cors=all

测试网节点部署

bash
docker run -d \
  --name sqnc-testnet-node \
  --restart unless-stopped \
  -p 30334:30333 \  # 测试网P2P端口（避免与主网冲突）
  -p 9934:9933 \    # 测试网HTTP RPC端口
  -p 9945:9944 \    # 测试网WebSocket RPC端口
  -v /var/sqnc-node/testnet-data:/data \
  sequence/substrate-node:latest \
  --chain=sqnc-testnet \
  --name="MySQNCTestNode" \
  --base-path=/data \
  --rpc-external \
  --ws-external \
  --rpc-cors=all

配置参数说明

核心启动参数

端口映射说明

高级配置

环境变量配置

支持通过环境变量注入部分启动参数（优先级低于命令行参数）：

• NODE_NAME：节点名称，对应--name参数
• CHAIN_SPEC：***规范，对应--chain参数
• LOG_LEVEL：日志输出级别（如info、debug、warn），默认info

示例：

bash
docker run -d \
  -e NODE_NAME="EnvConfiguredNode" \
  -e CHAIN_SPEC="sqnc-testnet" \
  -e LOG_LEVEL="debug" \
  ...（其他参数同上）

自定义链规范

若需使用自定义链规范文件，可通过卷挂载方式传入：

bash
docker run -d \
  -v /local/custom-spec.json:/config/custom-spec.json \
  ... \
  sequence/substrate-node:latest \
  --chain=/config/custom-spec.json \
  ...

数据持久化

节点数据（***状态、密钥、配置）需通过卷挂载实现持久化，建议挂载路径：

• 主目录：/data（通过--base-path指定）
• 链规范文件：/config（如需自定义规范）

示例持久化配置：

bash
# 创建本地数据目录
mkdir -p /var/sqnc-node/data

# 带数据持久化的启动命令
docker run -d \
  -v /var/sqnc-node/data:/data \
  ...（其他参数）

节点状态检查

通过RPC接口查询节点状态：

bash
# 查询同步状态
curl http://localhost:9933 -H "Content-Type: application/json" -d '{"id":1,"jsonrpc":"2.0","method":"system_syncState"}'

# 查询节点信息
curl http://localhost:9933 -H "Content-Type: application/json" -d '{"id":1,"jsonrpc":"2.0","method":"system_nodeName"}'