环境搭建与节点连接

创建项目

# 创建项目目录
mkdir ae-tutorial && cd ae-tutorial

# 初始化 Go module
go mod init ae-tutorial

# 安装 Aeternity SDK
go get github.com/aeternity/aepp-sdk-go/v9

SDK 核心包

基础连接示例

创建 main.go 文件：

package main

import (
    "fmt"
    "log"

    "github.com/aeternity/aepp-sdk-go/v9/naet"
)

func main() {
    // Aeternity Testnet URL
    nodeURL := "https://testnet.aeternity.io"

    // 创建节点实例
    // 第二个参数 debug: true 会打印 HTTP 请求/响应
    node := naet.NewNode(nodeURL, false)

    if node == nil {
        log.Fatal("无法创建节点客户端")
    }

    fmt.Printf("✅ 成功连接到 %s\n", nodeURL)
    
    // 获取区块高度验证连接
    height, err := node.GetHeight()
    if err != nil {
        log.Fatal("获取区块高度失败:", err)
    }
    fmt.Printf("📦 当前区块高度: %d\n", height)
}

运行代码

go run main.go

# 预期输出:
# ✅ 成功连接到 https://testnet.aeternity.io
# 📦 当前区块高度: 123456

SDK 使用 config 包管理网络设置。Network ID 在签名交易时非常重要，必须与目标网络匹配。

设置 Network ID

import "github.com/aeternity/aepp-sdk-go/v9/config"

func main() {
    // 设置为测试网
    config.Node.NetworkID = "ae_uat"
    
    // 创建节点连接
    node := naet.NewNode("https://testnet.aeternity.io", false)
    
    // 现在可以安全地签名和广播交易了
}

package main

import (
    "fmt"
    "log"

    "github.com/aeternity/aepp-sdk-go/v9/config"
    "github.com/aeternity/aepp-sdk-go/v9/naet"
)

func main() {
    // 1. 配置网络
    config.Node.NetworkID = "ae_uat"
    nodeURL := "https://testnet.aeternity.io"

    // 2. 创建节点客户端
    node := naet.NewNode(nodeURL, false)
    if node == nil {
        log.Fatal("无法创建节点客户端")
    }

    // 3. 获取链状态
    height, err := node.GetHeight()
    if err != nil {
        log.Fatal("获取区块高度失败:", err)
    }

    // 4. 显示信息
    fmt.Println("=== Aeternity Go SDK 教程 ===")
    fmt.Printf("节点: %s\n", nodeURL)
    fmt.Printf("网络: %s\n", config.Node.NetworkID)
    fmt.Printf("区块高度: %d\n", height)
    fmt.Println("✅ 环境配置完成!")
}