Hello World — 在 Savitri 上发送您的第一笔交易

本教程将引导您从零开始在 Savitri 测试网上发送第一笔交易。请选择符合您情况的路径。

路径	适合人群	时长	前提条件
A. 浏览器钱包	加密用户	2 分钟	Chrome/Brave
B. 移动应用	移动用户	3 分钟	iOS 或 Android
C. 桌面安装程序	非技术用户	5 分钟	Windows 或 macOS
D. Docker (开发者)	开发者	5 分钟	已安装 Docker
E. 从源码构建	Rust 开发者	15 分钟	Rust 1.82+

---

A. 浏览器钱包

时长：2 分钟

1. 从 Chrome 网上应用店安装 Savitri Wallet 扩展

2. 打开扩展，点击 创建钱包

3. 记录您的 12 个词的助记词并安全存储

4. 您的钱包自动连接到 Savitri 测试网

5. 从水龙头获取测试网代币：

   • 打开钱包
   • 点击 请求测试网代币
   • 等待 10 秒确认

6. 发送您的第一笔交易：

   • 点击 发送
   • 输入任意测试网地址（或使用钱包中显示的示例地址）
   • 输入金额（例如 10 SAVI）
   • 点击 确认

7. 在钱包的 历史 选项卡中查看交易

完成。您已在 Savitri 上创建钱包、接收代币并发送交易。

---

B. 移动应用

时长：3 分钟

1. 下载 Savitri 应用：

   • iOS（App Store）
   • Android（Play Store）

2. 打开应用，点击 创建新钱包

3. 安全保存您的助记词

4. 应用连接到测试网并在后台启动轻节点

5. 点击 接收 查看您的钱包地址

6. 点击 水龙头 接收免费测试网 SAVI

7. 点击 发送 → 输入接收地址 → 输入金额 → 确认

8. 在 活动 中查看交易

额外功能：进入 节点 选项卡查看您的轻节点状态、已连接的对等节点和 PoU 分数。

---

C. 桌面安装程序

时长：5 分钟

1. 下载安装程序：

   • Windows（.exe）
   • macOS（.dmg）

2. 运行安装程序并按照设置向导操作（共 15 步，有引导）

3. 选择您的节点类型：

   • 轻节点（首次使用推荐）— 资源占用最小
   • 主节点 — 完整验证者（需要 8GB+ 内存）

4. 安装程序下载节点二进制文件、生成密钥并完成所有配置

5. 点击 启动节点 — 您的节点连接到测试网

6. 打开 钱包 选项卡 → 创建钱包 → 保存您的助记词

7. 点击 水龙头 → 接收测试网代币

8. 点击 发送 → 输入接收地址 → 输入金额 → 确认

9. 在 仪表盘 选项卡查看实时指标：区块高度、对等节点、PoU 分数

---

D. Docker (开发者)

时长：5 分钟

前提条件

• 已安装 Docker（获取 Docker）

步骤 1：启动轻节点

docker run -d --name savitri-node \
  -p 4001:4001 -p 8545:8545 -p 9090:9090 \
  savitri/lightnode:testnet

步骤 2：验证是否运行

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"chain_getBlockHeight","params":[],"id":1}'

预期响应：

{"jsonrpc":"2.0","result":{"height":12345},"id":1}

步骤 3：创建钱包

# Generate a new keypair
curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"wallet_create","params":[],"id":2}'

保存返回的地址和私钥。

步骤 4：获取测试网代币

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"faucet_request","params":["YOUR_ADDRESS"],"id":3}'

步骤 5：查询余额

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"account_getBalance","params":["YOUR_ADDRESS"],"id":4}'

步骤 6：发送交易

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "method":"tx_send",
    "params":{
      "from":"YOUR_ADDRESS",
      "to":"RECIPIENT_ADDRESS",
      "amount":"1000000000000000000",
      "private_key":"YOUR_PRIVATE_KEY"
    },
    "id":5
  }'

金额以 wei 为单位（18 位小数）。1000000000000000000 = 1 SAVI。

步骤 7：运行完整本地测试网（可选）

git clone --recurse-submodules https://github.com/Savitri-Network/savitri-network.git
cd savitri-network/savitri-testnet
docker-compose up -d

这将启动：2 个主节点、1 个轻节点、1 个守护节点、Prometheus 和 Grafana。

• Grafana 仪表盘： http://localhost:3000
• Prometheus 指标： http://localhost:9090
• RPC（主节点 1）： http://localhost:8545
• RPC（主节点 2）： http://localhost:8546
• RPC（轻节点）： http://localhost:8547

---

E. 从源码构建

时长：15 分钟

前提条件

# macOS
brew install rustup cmake ninja llvm openssl zstd lz4 ccache protobuf
rustup install stable

# Ubuntu / Debian
sudo apt install build-essential pkg-config clang llvm-dev libclang-dev \
  cmake ninja-build libssl-dev zlib1g-dev liblz4-dev libzstd-dev
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Windows — install Visual Studio Build Tools with C++ workload + Windows SDK

步骤 1：克隆并构建

git clone --recurse-submodules https://github.com/Savitri-Network/savitri-network.git
cd savitri-network

# Build a lightnode
cargo build --release -p savitri-lightnode

步骤 2：启动节点

./target/release/lightnode \
  --listen-port 4001 \
  --tx-interval-secs 2 \
  --block-interval-secs 10 \
  --max-block-txs 32 \
  --bootstrap <PEER_ID>@/ip4/<TESTNET_IP>/tcp/4002

从 测试网配置 获取当前测试网引导地址。

步骤 3：生成密钥

cargo build --release -p savitri-sdk
./target/release/key_generator

这将输出您的公钥（地址）和私钥。

步骤 4：通过 RPC 发送交易

curl -s http://localhost:8545 -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "method":"tx_send",
    "params":{
      "from":"YOUR_ADDRESS",
      "to":"RECIPIENT_ADDRESS",
      "amount":"1000000000000000000",
      "private_key":"YOUR_PRIVATE_KEY"
    },
    "id":1
  }'

步骤 5：部署代币（可选）

参见完整教程：部署 SAVITRI-20 代币

---

后续步骤

目标	资源
了解架构	架构概述
部署代币	代币部署教程
运行验证者（主节点）	节点类型
使用 SDK 构建	SDK 概述
探索 RPC API	RPC 方法参考
加入社区	Discord
阅读代币经济学	代币分配
完整文档	docs.savitrinetwork.com