Ripple XRPL Integration

Agent Wallet
    ↓
Aegis Integrations (@aegis-ows/integrations)
    ↓
xrpl npm package (WebSocket Client)
    ↓
wss://xrplcluster.com/
    ├── account_info     → Native XRP balance (drops)
    └── account_lines    → Trust line token balances
    ↓
XRP Ledger (Validated)

import { getXrpBalances } from "@aegis-ows/integrations";

const balances = await getXrpBalances("rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh");

// Returns:
// [
//   { chain: "XRP Ledger", chainId: "ripple:0", token: "XRP",
//     balance: "100.000000", usdValue: "250.00", source: "xrpl-rpc" },
//   { chain: "XRP Ledger", chainId: "ripple:0", token: "USD",
//     balance: "50.000000", usdValue: "50.00", source: "xrpl-rpc" }
// ]

// Each trust line from account_lines:
{
  account: "rIssuerAddress...",
  balance: "50.00",         // Amount held
  currency: "USD",          // ISO 4217 or custom code
  limit: "1000000",         // Maximum trust amount
  quality_in: 0,
  quality_out: 0
}

// Use case: Agent holds USDC + EUR + custom tokens
// All queryable via getXrpBalances()

import { Client } from "xrpl";

const client = new Client("wss://xrplcluster.com/");
await client.connect();

// Query native XRP balance
const response = await client.request({
  command: "account_info",
  account: "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  ledger_index: "validated"
});

const drops = parseInt(response.result.account_data.Balance, 10);
const xrpBalance = drops / 1_000_000;
console.log(`XRP Balance: ${xrpBalance}`);

// Query trust line tokens
const lines = await client.request({
  command: "account_lines",
  account: "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  ledger_index: "validated"
});

for (const line of lines.result.lines) {
  console.log(`${line.currency}: ${line.balance}`);
}

await client.disconnect();

npm install xrpl