Ripple XRP 钱包对接教程：服务端直连 API 完整指南

瑞波币（XRP）、Ripple API、钱包、测试网、私钥、交易分析、节点、测试币水龙头——想要把这些关键词串联在一起，却只看到零散代码？本文用通俗步骤 + 实战案例，带你 15 分钟完成 Ripple XRP 服务端钱包集成，没有本地节点，不写前端，全程 Node.js 打天下。

准备工作：30 秒搞定环境

项目	需求说明
Node.js	≥14 版本，建议 LTS
包管理工具	推荐 `yarn`，亦可 `npm`

一条命令安装 Ripple API：

yarn add ripple-lib
# 或
npm install ripple-lib

一、顶格直连：Ripple API 初始化

const RippleAPI = require('ripple-lib').RippleAPI;

const api = new RippleAPI({
  server: 'wss://s.altnet.rippletest.net:51233' // 测试网
  // server: 'wss://s2.ripple.com' // 主网
});

api.connect().then(() => {
  console.log('已连接 Ripple 节点');
}).catch(console.error);

关键词自然融入：Ripple API 是官方 SDK，支持 测试网与主网一键切换。
🎯 如果你准备探索真实交易场景，👉新手也能快速上手的在线节点服务可直接可视化操作。

二、接口全景图：钱包常用 7 大方法

把官方上百行文档浓缩成这 7 个核心动作，90% 场景够用：

connect
getFee → 获取网络手续费
generateAddress → 生成 钱包地址 + 私钥
getBalances → 查看地址 XRP 资产
preparePayment → 构造未签名交易
sign → 私钥签名
submit → 广播交易上链

(1) 查询余额与手续费

async function getAccountInfo(addr) {
  await api.connect();
  const [balanceObj] = await api.getBalances(addr);
  console.log('余额', balanceObj.value, balanceObj.currency);

  const fee = await api.getFee();
  console.log('当前手续费', fee, 'XRP');
}

(2) 生成全新地址

const { address, secret } = api.generateAddress();
console.log('地址', address);
console.log('保管好私钥', secret);   // 仅本地可见

安全提示：私钥千万别写进代码，可使用环境变量或加密 KeyStore。

(3) 发送 XRP：三步曲 prepare → sign → submit

async function sendXRP(srcAddr, dstAddr, amountInXRP, secret) {
  await api.connect();

  const payment = {
    source: {
      address: srcAddr,
      maxAmount: { value: amountInXRP, currency: 'XRP' }
    },
    destination: {
      address: dstAddr,
      amount:   { value: amountInXRP, currency: 'XRP' }
    }
  };

  const prepared = await api.preparePayment(srcAddr, payment);
  const signed   = api.sign(prepared.txJSON, secret);
  const result   = await api.submit(signed.signedTransaction);

  console.log('交易哈希', result.tx_json.hash);
  return result;
}

三、免费领测试币：10000 个 XRP 不花一分钱

Ripple 官方提供 XRP Testnet Faucet（水龙头）。步骤如下：

浏览器打开：官方测试网水龙头
点击 Generate credentials
得到：
- 钱包地址 (r...)
- 私钥（s... 开头）
- 10000 XRP 测试币，自动到帐

此时地址已可在上述 getAccountInfo 中运行验证。

四、常见 FAQ：别再翻 20 页论坛了

Q1：必须本地跑节点吗？
A：不需要。本文示例使用官方远程 WebSocket，延迟极低，且 free。

Q2：测试网转主网如何改一行代码？
A：把 server: 'wss://s.altnet.rippletest.net:51233' 替换为 server: 'wss://s2.ripple.com'，并确保：主网地址必须持有真实 XRP，测试网地址无效。

Q3：手续费为什么显示小数？
A：getFee 单位是 XRP，如返回 0.00001 即 10 drops；正常交易一般 <0.0002 XRP。

Q4：交易一直 pending？
A：Ripple 共识 3–5 秒即可确认。若长时间未了结，可在 Ripple 区块链浏览器输入交易哈希定位状态。

Q5：如何批量生成地址？
A：循环调用 api.generateAddress()，将生成的 address 与 secret 写入加密文件，再用 getAccountInfo 轮流检测。

五、进阶场景：二级验签 + 交易分析

实际业务中，你可能需要：

冷热钱包分离：将 sign 步骤放在离线机器，防止私钥泄露
交易标记（memo）：在 preparePayment 里加 memos 字段，用于订单映射
事件监听：使用 api.connection.on('transaction', handler) 做实时风控

把这些模块拼装后，即可完成一套可商用的 Ripple 支付网关或交易对账系统。

六、小结：Ripple XRP 集成 5 步法

安装 ripple-lib
选测试网/主网节点，直连 connect
领取或转入 XRP
完整调用 7 个核心 API
上链后二次确认并关闭连接 api.disconnect()

掌握这 5 步，剩下的就是业务层逻辑了，祝开发顺利！

下次再遇到 Ripple API、钱包对接、瑞波节点 相关搜索词，请直接来此文对照实践。