zilliqa/zilliqa-isolated-server

Docker化的Zilliqa隔离服务器

镜像概述和主要用途

本镜像提供了Zilliqa隔离服务器的Docker化部署方案，用于在本地环境中搭建独立的Zilliqa***测试环境。适用于开发者进行智能合约开发、***应用调试及交易流程测试，支持数据持久化和灵活的运行参数配置。

核心功能和特性

• 本地构建支持：可通过Docker命令本地构建隔离服务器镜像
• 灵活运行模式：支持默认临时存储模式和持久化存储模式
• 环境变量配置：可自定义区块生成间隔时间、UUID验证信息等参数
• 丰富API接口：提供交易创建、区块管理、智能合约查询等多种接口
• 状态管理：支持服务器暂停/恢复状态切换及验证

使用场景和适用范围

• Zilliqa智能合约本地开发与测试
• ***应用功能调试
• 交易流程和区块生成逻辑验证
• 智能合约状态查询与交互测试
• 无需连接主网的独立***环境搭建

使用方法和配置说明

前提条件

本地构建

需安装Docker环境，安装步骤参考https://docs.docker.com/get-docker/%E3%80%82

镜像构建

本地构建

通过以下命令在本地构建隔离服务器镜像： docker build -t isolated-server:1.0 . 构建完成后将生成名为isolated-server:1.0的镜像。

容器运行

本地运行

可通过多种方式配置和运行隔离服务器，均需通过docker run命令进行参数调整。

基本运行（临时存储模式）

docker run -d -p 5555:5555 \
  --name isolated-server \
  isolated-server:1.0

API服务将在http://localhost:5555可用。此命令将启动一个干净状态的隔离服务器，使用临时存储，并通过boot.json初始化默认账户。

持久化存储模式运行

通过挂载卷实现数据持久化，需添加-v $(pwd)/persistence:/zilliqa/persistence参数。注意：持久化模式下首次启动和后续启动命令不同。

首次启动：

docker run -d -p 5555:5555 \
  -v $(pwd)/persistence:/zilliqa/persistence \
  --name isolated-server \
  isolated-server:1.0

后续启动： 需添加环境变量MODE="load"，强制服务器从持久化目录加载数据：

docker run -d -p 5555:5555 \
  -v $(pwd)/persistence:/zilliqa/persistence \
  --env MODE="load" \
  --name isolated-server \
  isolated-server:1.0

自定义运行参数

隔离服务器支持通过环境变量修改以下参数：

• T：区块生成间隔时间（毫秒），默认值："5000"
• UUID：用于暂停/恢复验证的UUID，默认值："uuid"

示例：覆盖默认参数

docker run -d -p 5555:5555 \
  --env T="2000" \
  --env UUID="randomstring" \
  --name isolated-server \
  isolated-server:1.0

容器管理

停止隔离服务器

docker stop isolated-server

移除已停止的容器

docker rm isolated-server

可用API接口

• CreateTransaction：提交交易JSON payload
• IncreaseBlocknum：按指定数量增加区块号
• GetSmartContractSubState：获取智能合约状态
• GetSmartContractCode：获取指定地址的合约代码
• GetMinimumGasPrice：获取最低 gas 价格
• SetMinimumGasPrice：设置最低 gas 价格
• GetBalance：获取账户余额和nonce
• GetSmartContracts：获取指定地址的智能合约
• GetNetworkID：获取网络ID
• GetSmartContractInit：获取智能合约初始化JSON
• GetTransaction：通过哈希获取交易信息
• CheckPause：检查服务器是否暂停（需UUID验证）
• TogglePause：切换服务器暂停/恢复状态（需UUID验证）