Building with RLUSD
Learning Objectives
Understand RLUSD technical structure on both XRPL and Ethereum
Explain trust line requirements and their implications
Describe transaction mechanics for sending and receiving RLUSD
Outline DEX and AMM integration patterns
Assess technical integration complexity for enterprise use cases
Even non-developers benefit from technical understanding:
1. Investment Assessment
1. Use Case Evaluation
1. Risk Understanding
---
How RLUSD Works on XRPL:
Issued currencies are built into XRPL
No smart contracts needed
Trust lines create relationships
Issuer controls supply
Issuer: Standard Custody & Trust Company
Currency code: "USD" or "524C555344" (hex for RLUSD)
Precision: Up to 15 significant digits
Transfer: Peer-to-peer via ledger
What Is a Trust Line?
A trust line is a credit relationship on XRPL
User authorizes issuer to extend credit
Sets maximum balance user will accept
Requires small XRP reserve (~0.2 XRP)
User creates trust line to RLUSD issuer
Specifies limit (e.g., 1,000,000 RLUSD)
Once created, can receive RLUSD
Without trust line, CANNOT receive RLUSD
Trust Line Creation:
// Conceptual example (simplified)
{
"TransactionType": "TrustSet",
"Account": "rUserAccountAddress",
"LimitAmount": {
"currency": "RLUSD",
"issuer": "rStandardCustodyAddress",
"value": "1000000" // Max 1M RLUSD
}
}Implications:
| Factor | Impact |
|---|---|
| User onboarding | Extra step required |
| First-time friction | Must create trust line before receiving |
| Reserve cost | ~0.2 XRP locked per trust line |
| Control | User chooses maximum exposure |
| Spam prevention | Can't receive unwanted tokens |
Payment Transaction:
// Conceptual example (simplified)
{
"TransactionType": "Payment",
"Account": "rSenderAddress",
"Destination": "rRecipientAddress",
"Amount": {
"currency": "RLUSD",
"issuer": "rStandardCustodyAddress",
"value": "100.00"
}
}Transaction Flow:
1. Sender initiates payment
2. XRPL verifies:
- Sender has sufficient RLUSD balance
- Recipient has trust line to issuer
- Transaction fee available (in XRP)
3. Ledger updates balances
4. Confirmation in 3-5 secondsCost Structure:
| Component | Cost |
|---|---|
| Transaction fee | |
| Trust line reserve | ~0.2 XRP (one-time, refundable) |
| RLUSD transfer | No fee (beyond XRP transaction fee) |
Native DEX Integration:
// Creating an offer to sell RLUSD for XRP
{
"TransactionType": "OfferCreate",
"Account": "rTraderAddress",
"TakerGets": {
"currency": "RLUSD",
"issuer": "rStandardCustodyAddress",
"value": "100"
},
"TakerPays": "50000000" // 50 XRP in drops
}Trading Mechanics:
Native to XRPL protocol
No external DEX needed
Automatic matching
Immediate settlement
Primary trading pair
Price discovery on-chain
Liquidity in order book
XRPL Native AMM:
// Depositing to RLUSD/XRP AMM pool (conceptual)
{
"TransactionType": "AMMDeposit",
"Account": "rLPAddress",
"Asset": {
"currency": "RLUSD",
"issuer": "rStandardCustodyAddress"
},
"Asset2": { "currency": "XRP" },
"Amount": { "value": "1000", "currency": "RLUSD", ... },
"Amount2": "500000000" // 500 XRP
}AMM Mechanics:
Deposit RLUSD + XRP to pool
Receive LP tokens
Earn trading fees
Face impermanent loss risk
Send one asset
Receive other asset
Price set by pool ratio
Slippage based on size vs. liquidity
Smart Contract Implementation:
// Standard ERC-20 interface (conceptual)
interface IRLUSD {
function totalSupply() external view returns (uint256);
function balanceOf(address account) external view returns (uint256);
function transfer(address to, uint256 amount) external returns (bool);
function approve(address spender, uint256 amount) external returns (bool);
function transferFrom(address from, address to, uint256 amount) external returns (bool);
}Key Characteristics:
| Feature | Implementation |
|---|---|
| Standard | ERC-20 |
| Decimals | 18 (typical) or 6 (USDC-style) |
| Minting | Controlled by authorized addresses |
| Burning | Controlled by authorized addresses |
| Transfers | Standard ERC-20 transfers |
Transfer Transaction:
// Using ethers.js (conceptual)
const rlusdContract = new ethers.Contract(RLUSD_ADDRESS, ERC20_ABI, signer);
// Simple transfer
await rlusdContract.transfer(recipientAddress, ethers.parseUnits("100", 18));
// Or with approval for third-party spending
await rlusdContract.approve(spenderAddress, ethers.parseUnits("100", 18));
Cost Structure:
| Component | Cost |
|---|---|
| Gas fee | Variable ($1-20+ typical) |
| RLUSD transfer | No fee beyond gas |
| Approval | Separate gas cost |
Uniswap/DEX Integration:
// Swapping RLUSD for ETH via Uniswap (conceptual)
// First: Approve Uniswap router to spend RLUSD
await rlusdContract.approve(uniswapRouterAddress, amount);
// Then: Execute swap
await uniswapRouter.swapExactTokensForETH(
amountIn,
amountOutMin,
[RLUSD_ADDRESS, WETH_ADDRESS],
recipientAddress,
deadline
);
Lending Protocol Integration:
// Depositing RLUSD to Aave (conceptual)
// If RLUSD were supported
await rlusdContract.approve(aavePoolAddress, amount);
await aavePool.supply(RLUSD_ADDRESS, amount, onBehalfOf, referralCode);| Factor | XRPL | Ethereum |
|---|---|---|
| Transaction fee | ~$0.0001 | $1-20+ |
| Settlement time | 3-5 seconds | 15-30 seconds |
| First-time setup | Trust line required | None |
| Smart contracts | Not required | Standard ERC-20 |
| DEX integration | Native | External protocols |
| DeFi ecosystem | Nascent | Extensive |
| Complexity | Lower | Higher |
Approach 1: Direct Integration
Company → XRPL/Ethereum nodes → RLUSD
- Technical expertise
- Node infrastructure (or API provider)
- Key management
- Transaction monitoring
- Crypto-native companies
- Technical teams
- High-volume use cases
Approach 2: Ripple Services
Company → Ripple APIs/Services → RLUSD
- Ripple partnership
- API integration
- Compliance alignment
- Ripple partners
- ODL users
- Enterprise customers
Approach 3: Exchange/Custodian
Company → Exchange/Custodian → RLUSD
- Exchange account
- Custody relationship
- Withdrawal/deposit flows
- Non-technical companies
- Custody requirements
- Regulatory needs
Security Considerations:
Account keys control funds
Multi-signing available
Regular key rotation possible
Hardware security modules recommended
Private keys control funds
Multi-sig wallets (e.g., Gnosis Safe)
Hardware wallets for individuals
Institutional custody solutions
Never store keys in code
Use HSMs for production
Implement multi-sig for large holdings
Regular security audits
Required Capabilities:
Transaction Monitoring
Address Screening
Reporting
KYC/KYB Integration
Pre-Integration:
□ Determine chain (XRPL, Ethereum, or both)
□ Choose integration approach
□ Establish custody solution
□ Define compliance requirements
□ Assess technical resourcesIntegration:
□ Set up infrastructure (nodes/APIs)
□ Implement key management
□ Build transaction handling
□ Create monitoring systems
□ Test thoroughlyPost-Integration:
□ Establish operational procedures
□ Define incident response
□ Create backup/recovery plans
□ Ongoing security audits
□ Performance monitoringDocumentation:
XRPL.org: Primary documentation
Issued currencies guide
Trust line documentation
DEX/AMM specifications
xrpl.js (JavaScript)
xrpl-py (Python)
xrpl4j (Java)
XRPL Explorer (livenet.xrpl.org)
Testnet faucet
Transaction decoder
Documentation:
Ethereum.org developer docs
ERC-20 standard specification
OpenZeppelin contracts reference
ethers.js
web3.js
web3.py
Etherscan (block explorer)
Remix (IDE)
Hardhat (development framework)
Expected Resources:
RLUSD integration guide
API documentation
Issuer address information
Support channels
Example implementations
Integration tutorials
Best practices guides
XRPL Integration:
| Factor | Complexity | Notes |
|---|---|---|
| Basic transfers | Low | Standard transactions |
| Trust line setup | Low-Medium | Extra step, user education |
| DEX trading | Low | Native feature |
| AMM integration | Low-Medium | Newer feature |
| Enterprise scale | Medium | Infrastructure needs |
Ethereum Integration:
| Factor | Complexity | Notes |
|---|---|---|
| Basic transfers | Low | Standard ERC-20 |
| DeFi integration | Medium | Protocol-specific |
| Gas management | Medium | Cost optimization |
| Smart contract | Medium-High | If custom needed |
| Enterprise scale | Medium-High | Gas costs at scale |
XRPL Barriers:
Trust Line Requirement
Ecosystem Size
DeFi Maturity
Ethereum Barriers:
Gas Costs
Competition
Smart Contract Risk
What Technical Analysis Reveals:
Positive Indicators:
✅ XRPL integration is straightforward
✅ Native DEX/AMM reduces barriers
✅ Low costs enable more use cases
✅ Dual-chain provides flexibility
Concerns:
⚠️ Trust lines add friction
⚠️ XRPL ecosystem smaller
⚠️ Ethereum faces USDC competition
⚠️ Enterprise integration still complex
✅ XRPL native features reduce smart contract risk
✅ Low transaction costs enable micro-transactions
✅ Built-in DEX/AMM simplifies DeFi integration
✅ Standard ERC-20 ensures Ethereum compatibility
⚠️ Trust line friction may slow XRPL adoption
⚠️ Ecosystem size limits developer resources
⚠️ Enterprise integration still requires significant effort
⚠️ Dual-chain management adds operational complexity
Technically, RLUSD is well-designed. XRPL integration leverages native features with low costs and fast settlement. Ethereum integration follows industry standards. However, technical quality doesn't guarantee adoption—the challenges are primarily market-related (competition, network effects), not technical. For investors, the technical architecture is sound; the questions are about market dynamics, not implementation quality.
Assignment: Create technical evaluation of RLUSD integration requirements.
Requirements:
Part 1: Chain Comparison
| Factor | XRPL | Ethereum | Your Assessment |
|---|---|---|---|
| Transaction cost | Which is better for your use case? | ||
| Settlement time | |||
| Setup complexity | |||
| DeFi ecosystem | |||
| Enterprise readiness |
Part 2: Integration Complexity
Individual trader wanting RLUSD exposure
Payment company integrating RLUSD
DeFi protocol adding RLUSD support
Steps required
Technical resources needed
Time estimate
Key challenges
Part 3: Trust Line Analysis
- Advantages (2-3 points)
- Disadvantages (2-3 points)
- Impact on adoption (your assessment)
- Comparison to ERC-20 model
Part 4: Investment Implications
How does technical analysis affect your view of RLUSD?
What technical factors matter most for adoption?
Are there technical red flags?
Technical accuracy (30%)
Analytical depth (25%)
Practical application (25%)
Investment relevance (20%)
Time Investment: 2 hours
Value: Technical foundation for informed assessment
1. Trust Line Question:
What is required before a user can receive RLUSD on XRPL?
A) Nothing—any account can receive RLUSD
B) Creating a trust line to the RLUSD issuer—specifying maximum amount willing to accept, requiring small XRP reserve
C) Paying a one-time fee to Standard Custody
D) Completing KYC with Ripple
Correct Answer: B
Explanation: XRPL requires trust lines for issued currencies. User must create trust line to RLUSD issuer address, specify limit, and lock small XRP reserve (~0.2 XRP). This is built-in XRPL security feature, not RLUSD-specific requirement.
2. Cost Comparison Question:
How do RLUSD transaction costs compare between XRPL and Ethereum?
A) Both are approximately the same
B) Ethereum is significantly cheaper
C) XRPL is dramatically cheaper—~$0.0001 vs. $1-20+ on Ethereum
D) Costs are unpredictable on both
Correct Answer: C
Explanation: XRPL transaction fees are approximately 0.00001 XRP (~$0.0001 at typical prices). Ethereum gas fees for ERC-20 transfers typically range from $1-20+ depending on network congestion. XRPL is 10,000-100,000× cheaper per transaction.
3. Integration Approach Question:
For a non-technical company wanting to hold RLUSD for treasury, what is the most appropriate integration approach?
A) Direct XRPL node integration
B) Custom smart contract deployment
C) Exchange or custodian relationship—provides custody, compliance, and access without requiring technical expertise
D) Running Ethereum validators
Correct Answer: C
Explanation: Non-technical companies should use exchange or custodian services for RLUSD. This provides custody (security), compliance (regulatory), and access (trading/transfers) without requiring in-house blockchain expertise. Direct integration (A, D) requires significant technical resources.
4. DEX Integration Question:
How does RLUSD trade on the XRPL DEX compared to Ethereum DEXs?
A) XRPL requires external smart contracts like Ethereum
B) XRPL has native DEX built into protocol—no external DEX needed; Ethereum requires protocols like Uniswap
C) Neither chain has DEX capability
D) Ethereum has native DEX, XRPL requires external
Correct Answer: B
Explanation: XRPL has native DEX functionality built into the protocol. Trading RLUSD/XRP happens directly on-ledger without external smart contracts. Ethereum requires external DEX protocols (Uniswap, Curve, etc.) for trading, adding complexity and gas costs.
5. Technical Assessment Question:
Based on technical analysis, what is the PRIMARY barrier to RLUSD adoption?
A) Smart contract vulnerabilities
B) Transaction costs too high
C) Market dynamics and competition—technical architecture is sound; challenges are network effects, USDC competition, and ecosystem size, not technical limitations
D) Settlement too slow
Correct Answer: C
Explanation: Technical analysis reveals solid architecture: XRPL is fast/cheap with native features; Ethereum follows standards. The barriers are market-related: USDC is established, network effects favor incumbents, XRPL ecosystem is smaller. Technical quality is sufficient; adoption challenges are competitive, not technical.
- xrpl.org documentation
- Issued currencies tutorials
- AMM implementation guides
- Ethereum.org developer resources
- OpenZeppelin ERC-20 guides
- DeFi integration patterns
- Custody solution comparisons
- Compliance framework guides
- Key management best practices
For Next Lesson:
Prepare for course synthesis—Lesson 15 brings together all analysis into complete framework and personal thesis.
End of Lesson 14
Total words: ~4,400
Estimated completion time: 50 minutes reading + 2 hours for deliverable
Key Takeaways
XRPL integration uses native issued currency features
: No smart contracts needed, trust lines create relationships, native DEX/AMM available, ~$0.0001 transaction costs enable high-frequency use cases.
Trust lines create adoption friction
: Users must create trust line before receiving RLUSD, requires ~0.2 XRP reserve, extra step in onboarding—this is security feature and barrier simultaneously.
Ethereum follows standard ERC-20
: Compatible with existing infrastructure, DeFi integration possible but faces USDC competition, gas costs are significant consideration.
Enterprise integration requires infrastructure
: Direct integration needs technical expertise, Ripple services available for partners, exchange/custodian option for non-technical companies.
Technical quality is sound; challenges are market-related
: Architecture is well-designed on both chains, but adoption barriers are competition and network effects, not technical limitations. ---