关键词：Crypto Wallet API、Alpaca、GoerliETH、测试网、区块链钱包、充值教程、开发者测试、Web3 集成
1. 为什么要用测试网
开发者在正式环境调用 Crypto Wallet API 之前，务必在 测试网 完成所有流程验证：
- 零成本上手，无需真实资金
- 验证链上交互流程，避免常见坑点
- Alpaca 仅在沙盒提供 GoerliETH 兼容，正适合作为测试场景
在开始任何步骤前，需向你的 客户成功经理 或 销售代表 申请开通 Crypto Wallet API 权限。权限生效后即可正式进入沙盒。
2. 1 分钟创建你的 Metamask Goerli 钱包
2.1 安装并创建钱包
若你尚未拥有 Metamask：
1) 浏览器扩展或手机应用商店搜索 Metamask
2) 按提示创建新钱包、保存助记词
3) 进入主界面后，联网默认已展示 Goerli Test Network；若未出现，点击“添加网络”，填入：
- 网络名称：
Goerli Test Network - RPC URL：
https://api.infura.io/v1/jsonrpc/goerli - 链 ID：
5 - 货币符号：
ETH - 区块浏览器：
https://goerli.etherscan.io
2.2 GoerliETH 领取
使用 Goerli 水龙头 获得测试币：
- 访问信任度较高的官方渠道（搜索 “Goerli Faucet”）
- 复制当前钱包地址（在 Metamask 点地址即可复制）
- 粘贴至水龙头并点击 “Send Me ETH”，通常一次领取 0.2 ETH；每日上限请留意官方说明
- 回到 Metamask，若看到余额变 0.2，即代表获取成功
👉 想要更高限额领取？这里给你快速获取额外 GoerliETH 的小技巧。
3. 使用 Alpaca API 创建 ETH 钱包
确认 Crypto Wallet API 权限已开通后，调用：
GET /v1/accounts/:account_id/wallets?asset=ETH接口会返回已为你预生成的 Alpaca 钱包地址。记下该地址，准备下一步链上转账。
4. 从 Metamask 把 GoerliETH 发送到 Alpaca 钱包
4.1 Metamask 发送流程
1) 点击 发送（Send）
2) 收款地址粘贴 Alpaca 刚刚给出的地址
3) 网络务必选择 Goerli Test Network
4) 金额0.01 ETH 即可（多转几次实验）
5) 调整合理 矿工费，确认交易
🚧 再次提醒：确保来源是 Goerli 钱包，绝不要拿主网 ETH 转进测试地址，以免造成资产永久损失。
4.2 验证到账
大约 5-10 秒区块确认后，调用 Alpaca 接口：
GET /v1/accounts/:account_id/wallets/transfers在返回值中搜索 status: COMPLETE，确认你的 GoerliETH 已经成功转入 Alpaca 钱包，至此测试充值流程完成。
5. 常见问题与解答（FAQ）
Q1：水龙头提示领取额度用尽，怎么办？
答：可注册 GitHub + Alchemy 的额外水龙头服务，24 小时再领一次；或使用其他社区共享水龙头，注意核对域名真伪，避免钓鱼。
Q2：Alpaca 钱包地址为何与 Metamask 不同？
答：API 创建的是托管型地址，技术层面可通过 HD Wallet 派生，多层隔离保障安全，与自建钱包并不冲突。
Q3：测试完成后如何迁移到主网？
答：只需把 asset 换成 ETH（主网）并重置请求，无需额外代码改动。但务必将 RPC 与链 ID 改为主网配置。
Q4：区块一直未确认？
答：Goerli 网络偶发拥堵，确认 矿工费 设置正确即可；必要时查看区块浏览器或提高 gas 值重发交易。
Q5：能否批量生成测试地址？
答：可通过 Crypto Wallet API 的批量端点 /wallets/generate 自动生成多个测试网地址，供团队协作压测。
Q6：还有哪些资产支持测试？
答：现阶段 Alpaca 测试网支持 ETH、USDC、USDT 等三条链，所有资产均基于 Goerli。更多资产需关注官方公告。
6. 测试场景扩展
借助 Crypto Wallet API，你可以在测试阶段完成：
- 批量转账性能测试
- 回调验证 检查
webhook状态 - 充值-提币 闭环流程演练
👉 学完上面步骤，创建你自己的 Web3 应用只需几个请求。
完成充值后，你已具备正式对接 Crypto Wallet API 的全部试验数据。将测试网凭证替换为主网参数，保持同样逻辑即可无缝迁移。愿每位开发者都能安心跑通全程，把精力投入到真正的产品创新中！