Day 1 环境搭建与 Aeternity 基础

• 理解 Aeternity 区块链的核心特性和应用场景
• 完成 Python 开发环境配置和 SDK 安装
• 掌握节点连接和基本查询操作
• 熟悉 SDK 的模块结构和文档使用

# 检查 Python 版本
import sys
print(f"Python 版本: {sys.version}")
assert sys.version_info >= (3, 7), "需要 Python 3.7+"

# 安装 SDK（在命令行执行）
# pip install aeternity

# 验证安装
import aeternity
print(f"✅ Aeternity SDK 安装成功")

# 查看可用模块
modules = [m for m in dir(aeternity) if not m.startswith('_')]
print(f"可用模块: {modules}")

from aeternity.node import NodeClient, Config

# 创建测试网配置
config = Config(
    external_url='https://testnet.aeternity.io',
    network_id='ae_uat'
)

# 创建节点客户端
client = NodeClient(config)

# 获取节点状态
status = client.get_status()
print(f"节点版本: {status.node_version}")
print(f"网络 ID: {status.network_id}")
print(f"对等节点数: {status.peer_count}")

# 获取协议信息
for protocol in status.protocols:
    print(f"协议版本 {protocol.version}, 生效高度: {protocol.effective_at_height}")

from aeternity.node import NodeClient, Config

client = NodeClient(Config(external_url='https://testnet.aeternity.io'))

# 1. 获取当前区块高度
height = client.get_current_key_block_height()
print(f"当前区块高度: {height}")

# 2. 获取顶部区块
top_block = client.get_top_block()
print(f"\n顶部区块:")
print(f"  哈希: {top_block.hash}")
print(f"  高度: {top_block.height}")
print(f"  时间: {top_block.time}")

# 3. 获取指定高度的关键块
if height > 0:
    key_block = client.get_key_block_by_height(height=height)
    print(f"\n关键块 {height}:")
    print(f"  哈希: {key_block.hash}")
    print(f"  前一块: {key_block.prev_key_hash}")
    print(f"  矿工: {key_block.miner}")

from aeternity.compiler import CompilerClient

# 创建编译器客户端
compiler = CompilerClient(compiler_url='https://v8.compiler.aepps.com')

# 获取编译器版本
version = compiler.api_version()
print(f"编译器版本: {version}")

# 测试简单合约编译
simple_contract = '''
@compiler >= 6

contract HelloWorld =
    entrypoint hello() : string = "Hello, Aeternity!"
    
    entrypoint add(a : int, b : int) : int = a + b
'''

try:
    # 编译合约
    bytecode = compiler.compile(simple_contract)
    print(f"\n✅ 编译成功！")
    print(f"字节码长度: {len(bytecode)} 字符")
    
    # 生成 ACI
    aci = compiler.generate_aci(simple_contract)
    print(f"\n合约接口 (ACI):")
    for func in aci.get('contract', {}).get('functions', []):
        print(f"  - {func.get('name')}()")

except Exception as e:
    print(f"❌ 编译失败: {e}")

from aeternity.node import NodeClient, Config
from aeternity.utils import format_amount

client = NodeClient(Config(external_url='https://testnet.aeternity.io'))

# 使用一个已知的测试网账户
test_account = "ak_2swhLkgBPeeADxVTAVCJnZLY5NZtCFiM93JxsEaMuC59euuFRQ"

try:
    # 获取账户信息
    account = client.get_account(test_account)
    
    print(f"账户信息:")
    print(f"  地址: {account.address}")
    print(f"  余额: {account.balance} aettos")
    print(f"  余额: {format_amount(account.balance)}")
    print(f"  Nonce: {account.nonce}")
    print(f"  类型: {account.kind}")
    
except Exception as e:
    print(f"查询失败: {e}")
    print("提示: 新账户在链上没有交易记录时会返回 404")