C# 跨平台 Algorand 钱包手把手开发指南

关键词：C# 跨平台钱包、Algorand SDK、Avalonia GUI、私钥加密、ASA 创建、跨链转账

项目概述

本文直面「想用 C# 开发一款能在 Windows / macOS / Linux 同时运行的 Algorand 轻钱包」这一需求，用不到 2000 字的篇幅给出最小可运行的技术路线。它不会罗列全部源码，而把连接网络、构建 GUI、加密私钥、签名转账、发行 ASA 五大模块抽丝剥茧，帮助你在最短时间跑通原型。

如果你觉得阅读吃力，可随时收藏这份 👉 跨平台钱包模板快速上手，边对照边实践。

环境与依赖

组件	用途
Visual Studio 2019+	主 IDE，Windows 10 亦可兼容 macOS、Linux
dotnet-algorand-sdk（NuGet 名：`Algorand`）	访问全节点 API 与构造交易
Avalonia（稳定 0.x 或 11.x 均可）	跨平台 GUI 框架，语法类似 WPF
BouncyCastle	私钥 AES-GCM 与 Scrypt 加密

安装命令：

dotnet add package Algorand
dotnet add package Avalonia
dotnet add package BouncyCastle

第一步：极简连接 Algorand

无论接入自托管节点还是 PureStake，只需两步：

var algod = new AlgodApi("https://testnet-api.algonode.cloud", "");
var supply = await algod.GetSupplyAsync();
Console.WriteLine($"总量：{supply.TotalMoney}");

若使用需要 API Key 的提供商，直接把 token 参数换成你的 key。

👉 立即在线测试 Algorand 节点连接，可避免本地同步节点的繁琐耗时。

第二步：转账 & 签名核心代码

从助记词恢复账户
构造 Transaction
签名 & 广播

var src = new Account("your 25-word mnemonic ...");
var txParams = await algod.TransactionParamsAsync();

var tx = new Transaction(
    src.Address,
    Address.FromString("收款地址"),
    Utils.AlgosToMicroalgos(0.1m), // 0.1 ALGO
    txParams.LastRound,
    txParams.LastRound + 1000,
    txParams.GenesisID,
    txParams.GenesisHash);

var signed = src.SignTransaction(tx);
var id = await Utils.SubmitTransactionAsync(algod, signed);
Console.WriteLine($"交易已提交，Id={id}");

第三步：创建（或转账）ASA

一次发币及转账仅需两行配置差异：

// 1) 创建资产
var createTx = Utils.GetCreateAssetTransaction(
    src.Address, "MyToken", "MTK", 0, 10000, txParams);
// 2) 转账资产
var xferTx = Utils.GetTransferAssetTransaction(
    src.Address, destAddress, assetId, 1000, txParams);

签名流程同上。完整代码可参考官方教程 “ASA 创建与管理”。

第四步：用 Avalonia 3 分钟撸出 GUI

1. 新建项目

打开 VS → Avalonia Application → 起名 MyAlgoWallet。模板自带基础 Style，无须额外引用。

2. Xaml 小试牛刀

<Window xmlns="https://github.com/avaloniaui"
        Width="400" Height="300">
  <StackPanel>
    <TextBox Name="AddressTb" Watermark="输入收款地址"/>
    <NumericUpDown Name="AmountNud" Value="0.1" />
    <Button Name="SendBtn" Content="转账"/>
  </StackPanel>
</Window>

3. 绑定事件（code-behind 最快）

SendBtn.Click += async (_, __) =>
{
    var txId = await TransferAsync(
        AddressTb.Text!, 
        Utils.AlgosToMicroalgos((decimal)AmountNud.Value));
    await MessageBox.Show("转账成功: " + txId);
};

若项目复杂度提升，可走 MVVM；入门阶段 code-behind 足以。

第五步：把私钥“锁”起来

钱包的核心除了网络能力，还有本地化密钥托管。

需求提炼

本地禁止明文保存私钥
加密方案需支持跨设备迁移（或不迁移）
必须凭用户密码才能解密

存储流程概览

私钥  →  AES-GCM 加密  →  存磁盘
密码  →  Scrypt 48 字节派生 →  256-bit AES key

我们复用 BouncyCastle 的 API，将详细示范浓缩为两段关键代码：

CryptoUtils.cs（抽取片段）

public static byte[] Encrypt(byte[] plainKey, string password)
{
    var salt = new byte[16];
    new SecureRandom().NextBytes(salt);
    var hash = SCrypt.Generate(Encoding.UTF8.GetBytes(password), salt,
        262144, 8, 1, 48);
    var key = Arrays.CopyOfRange(hash, 16, 48); // 后 32bytes 用于 AES
    var nonce = Encoding.UTF8.GetBytes("algo--wallet");
    var cipher = new GcmBlockCipher(new AesEngine());
    cipher.Init(true, new AeadParameters(new KeyParameter(key), 128, nonce));
    // ... 省略 return 结果：cipherText + authTag + salt
}

解密就是逆运算，核心在验证密码前后 16 字节（checkSalt）是否匹配。

完整示例可到 gist 搜索 RileyGe/crypto-demo，再补 Controller 调用即可完成本地钱包文件的生成与加载。

常见问题 FAQ

Q1：为什么选用 Avalonia 而不是 MAUI？
A：Avalonia 0.x 已经跑通三大桌面平台，且 xaml 语法与 WPF 一致，可复用大量控件经验；MAUI 跨桌面仍是预览阶段。

Q2：Algorand 手续费如何预估？
A：GetTransactionParamsAsync() 返回的 Fee 字段即为节点建议值（千分之一 ALGO）。若希望快速上链，可调高 1.5-2 倍。

Q3：助记词丢了一次还能恢复吗？
A：钱包目前只持久化 加密后的私钥，真正的助记词不会二次保存。一旦遗失，只能通过之前抄写的助记词重新导入。

Q4：移动端会打包成 APK 吗？
A：用 Avalonia .NET 7 Mobile 模板即可从同一套代码同时输出 iOS/Android；编译体积 15 MB 起，具体看链接引用。

Q5：创建 ASA 需要额外费用吗？
A：链上创建一次资产须支付 0.001 ALGO，另加 0.1 ALGO 作为最小余额，保持 100K microAlgo 以上账户可通用。

Q6：钱包解锁密码能重置吗？
A：本质是本地加密 key，抱歉无法找回，只能重新生成钱包并导入助记词后设新密码。

结语

上述五步跑道足够让你从 0 到 1 拥有第一个「C# 跨平台 Algorand 钱包」：

充值节点 API 凭证 → 跑通连接
封装钥匙库 → 本地安全
搭 Avalonia → 日志、UI 可实时调试
Transfer & ASA 复用 → 价值层跑通

下一步可在 MVVM、一键批量转账、行情显示等方向继续深掘。祝你开发顺利！