使用主流语言轻松发送 XRP：完整开发教程

在本教程中，你将学会如何仅用 7 个步骤就通过 XRP Ledger（瑞波账本）完成一次直接付款（Direct XRP Payment）。示例覆盖 JavaScript (xrpl.js)、Python (xrpl-py)、Java (xrpl4j) 与 PHP (XRPL_PHP)，先从 Testnet（测试网） 开始，再衍伸至主网（Production Network）。阅读 10 分钟即可上手，写一段最小可运行代码立刻体验实时转账。

一、开发环境速查清单

1. 必备依赖

语言	官方库	延伸阅读（可选）
JS/TS	`xrpl.js`	📘 十分钟理解 XRPL JavaScript SDK
Python	`xrpl-py`	📘 用 Python 操作链上资产
Java	`xrpl4j`	📘 Java SDK 开发笔记
PHP	`XRPL_PHP`	📘 PHP 与区块链支付

二、从测试网到主网：关键差异速览

测试网：免费 faucet 给 XRP，网络可重置。
主网：必须转入真实 XRP、连接主节点、注意私钥安全（冷钱包或硬件钱包）。
一致性：除了账户资金与服务器地址，其余指令、字段、费率逻辑完全一致。

👉 立刻探秘主网节点最佳接入方案，一文打通连接细节

三、7 步完成一次 XRP 支付

Step 1：拿到一对凭据（地址 + 私钥）

// 示例代码使用测试网 faucet
const wallet = xrpl.Wallet.fromSeed("sn3nxi...yourSeed");
console.log(wallet.address); // rMCcNu...

注意：测试网的 Secret 每几小时清空一次，别把同一地址同时用于主网！
生成新钱包：wallet = new xrpl.Wallet(); → wallet.address / wallet.seed 即时输出。

Step 2：连接测试网节点

const client = new xrpl.Client("wss://s.altnet.rippletest.net:51233");
await client.connect();
// 完成后务必 await client.disconnect();

Step 3：拼装交易对象

最小字段：

TransactionType 固定 "Payment"
Account 发送者
Destination 接收者（不可与发送者相同）
DeliverMax 以“drops”为单位（1 XRP = 1,000,000 drops）

const prepared = await client.autofill({
  TransactionType: "Payment",
  Account: wallet.address,
  DeliverMax: xrpl.xpToDrops("22"),
  Destination: "rPT1S..."
});

Step 4：本地签名

const signed = wallet.sign(prepared);
console.log("TX Hash:", signed.hash); // 唯一 64 位十六进制
console.log("Blob:", signed.tx_blob); // 可直接广播

Step 5：提交至网络

const tx = await client.submitAndWait(signed.tx_blob);

返回初步结果 tesSUCCESS 便可在下一笔账本中敲定（4–7 秒）。若看到其他代码，请按错误码自查：

是否余额不足？
Destination 地址正确？
是否连接到了测试网？

Step 6：等待账本最终确认

测试网通常 4–7 秒；主网在高 TPS 轮换时也大致如此。
关注返回对象中的 validated: true。

Step 7：查询交易详情

JavaScript 终极体检：

console.log("Result", tx.result.meta.TransactionResult);
console.log("Balance Changes", xrpl.getBalanceChanges(tx.result.meta));

四、FAQ：开发者常见疑惑一次解答

Q1：为什么我在主网生成了地址却没有余额？
A：新建地址只是一个随机私钥，没有 XRP。请通过交易所购买后 提现到该地址 才可进行任何转账。

Q2：主网节点超时，如何提高成功率？

优先用多节点 Clusters（wss://xrplcluster.com）。
自托管 rippled：本地私有节点降低网络抖动。

👉 查看最稳主网节点管理配置示例

Q3：测试币用完怎么办？
A：Devnet/Testnet faucet 每地址每 24 小时可领 1,000 XRP，代码中重试即可。

Q4：同一私钥能不能既在测试网又用主网？
A：技术上可行，但强烈不建议！非对称交易同参数同时提交可能引发资金风险。始终隔离网络。

Q5：如何设置更低手续费？
A：主网当前最低费率为 0.00001 XRP，使用 Fee 字段自定义即可，低费率在网络拥堵时存在排队风险。

Q6：“Client.autofill()”自动填充哪些字段？
A：Fee、Sequence、LastLedgerSequence、SigningPublicKey 以及 Flags。完整键值可在 Transaction Format 文档查询。

五、主网迁移细节攻防

场景	测试网做法	主网必改选项
充值 XRP	Faucet	交易所提现 → 自托管地址
服务器 URI	Testnet 公网	主网公网或自托管节点
安全签名	简易本地钱包	冷钱包、硬件签或 KMS 签
重复交易保护	LastLedgerSequence 校准	LastLedgerSequence 轻量递增策略

六、写出你的首个可复用函数

以下 JS 模板可直接复用生产环境，已封装 7 步流程：

async function sendXrp(destination, amountXrp, memo = "") {
  const wallet = xrpl.Wallet.fromSeed(process.env.XRP_SECRET);
  const client = new xrpl.Client("wss://xrplcluster.com");
  await client.connect();

  const prepared = await client.autofill({
    TransactionType: "Payment",
    Account: wallet.address,
    Destination: destination,
    DeliverMax: xrpl.xpToDrops(amountXrp),
    Memos: [{ Memo: { MemoData: Buffer.from(memo).toString("hex") } }]
  });

  const signed = wallet.sign(prepared);
  const tx    = await client.submitAndWait(signed.tx_blob);

  await client.disconnect();
  return tx.result.hash; // 返回交易哈希
}

七、下一步探索

发布代币：在测试网中体验发行资产
跨链支付：举 1 个 Escrow 锁仓保险 场景案例
可靠重试：让 批量支付脚本 在 1 秒内回调成功或失败
深入交易元数据（Metadata）：分析网关充值与提现轨迹

用最小代码承载最大价值 —— XRP Ledger 现已零起草成本接入，祝你送币顺利！