10分钟上手XuperChain：从环境搭建到部署第一条联盟链的完整指南
项目地址: https://gitcode.com/gh_mirrors/xu/xuperchain XuperChain是一款高性能、高灵活性的区块链架构，专为企业级联盟链场景设计。本指南将帮助您在10分钟内完成从环境搭建到成功部署第一条联盟链的全过程，即使是区块链新手也能轻松上手。
一、环境准备：快速安装必要依赖
在开始前，请确保您的系统已安装以下工具：
- Git（用于代码克隆）
- Go 1.13+（XuperChain的开发语言）
- 编译工具链（如GCC）
1.1 克隆代码仓库
首先通过Git获取XuperChain源码：
git clone https://gitcode.com/gh_mirrors/xu/xuperchain
cd xuperchain
1.2 一键编译项目
项目根目录下的Makefile提供了便捷的编译脚本，执行以下命令即可完成编译：
make build
编译完成后，可执行文件将生成在./bin目录下。
二、部署联盟链：3步启动本地测试网络
2.1 生成节点配置
XuperChain提供了自动化部署脚本，位于auto/deploy_testnet.sh。执行该脚本生成测试网络配置：
cd auto
bash deploy_testnet.sh
脚本会自动创建3个节点的配置文件和密钥对，存储在./testnet目录下。
2.2 启动区块链节点
进入生成的测试网络目录，启动所有节点：
cd testnet
bash start_all.sh
节点启动后，可通过日志文件node*/logs/xchain.log查看运行状态。
2.3 验证网络状态
使用XuperChain命令行工具验证节点是否正常运行：
./bin/xchain-cli status -H 127.0.0.1:37101
若返回包含"blockHeight": "1"的JSON结果，说明联盟链已成功启动。
三、链上交互：发送您的第一笔交易
3.1 创建账户
使用命令行工具生成新账户：
./bin/xchain-cli account new --name myaccount
保存输出的地址和私钥信息，这将用于后续交易签名。
3.2 查询账户余额
新创建的账户初始余额为0，可通过以下命令查询：
./bin/xchain-cli account balance <your_address> -H 127.0.0.1:37101
3.3 发起转账交易
从默认的创世账户向新账户转账：
./bin/xchain-cli transfer --to <your_address> --amount 1000000000 --keys data/keys -H 127.0.0.1:37101
交易成功后，再次查询余额即可看到到账记录。
四、进阶操作：部署智能合约
4.1 编译WASM合约
XuperChain支持WASM合约，示例合约位于auto/counter.wasm。使用以下命令部署计数器合约：
./bin/xchain-cli wasm deploy --account XC1111111111111111@xuper --cname counter auto/counter.wasm -H 127.0.0.1:37101
4.2 调用合约方法
调用合约的increase方法增加计数器值：
./bin/xchain-cli wasm invoke --method increase counter -H 127.0.0.1:37101
查询当前计数值：
./bin/xchain-cli wasm query --method get counter -H 127.0.0.1:37101
五、常见问题解决
5.1 节点启动失败
检查端口是否被占用：
netstat -tulpn | grep 37101
若端口冲突，可修改conf/server.yaml中的端口配置。
5.2 交易发送超时
确保节点间网络连通，可通过cmd/xchain/cmd/startup.go中的日志输出排查连接问题。
六、学习资源推荐
- 官方文档：docs/zh_cn/SUMMARY.md
- 配置文件说明：conf/目录下包含所有节点配置模板
- 命令行工具源码：cmd/client/
通过本指南，您已成功搭建XuperChain联盟链并完成基础操作。XuperChain的灵活架构支持多种共识算法和合约引擎，更多高级功能等待您探索！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
