The XRP Ledger offers three primary account configurations tailored to different use cases. Whether you're holding XRP, exchanging tokens, or issuing new assets, understanding these setups ensures optimal security and functionality. Below, we explore each configuration in detail, including flags, fields, and practical steps for implementation.
Core Account Types
Holder
A Holder account is designed for users who primarily hold and spend XRP. No special configuration is required—default settings suffice.
👉 Learn more about basic XRP account setup
Exchanger
Exchanger accounts facilitate value exchange between third parties. Key settings include:
| Flag | Purpose |
|---|---|
defaultRipple | Enables rippling on trust lines for token trading. |
disallowIncomingNFTokenOffer | Blocks unsolicited NFT offers. |
disallowIncomingPayChan | Prevents unwanted payment channels. |
requireDestinationTag | Mandates destination tags for incoming payments. |
Issuer
Issuer accounts require detailed configuration to support token creation:
Issuer Fields
| Field | Description |
|---|---|
Domain | URL hosting the xrp-ledger.toml file for identity verification. |
TransferRate | Fee percentage applied to token transfers (e.g., 20% = 1200000000). |
TickSize | Truncates exchange rate precision in order books. |
Signers
Multi-signing enhances security by requiring approvals from multiple keys. Configure:
- Signer accounts with assigned weights.
- Quorum: Minimum total weight to authorize transactions.
Issuer Flags
| Flag | Function |
|---|---|
depositAuth | Restricts unauthorized deposits. |
globalFreeze | Freezes all issued tokens. |
Advanced Configuration Flags
Additional flags address niche requirements:
| Flag | Use Case |
|---|---|
allowTrustLineClawback | Recalls issued tokens. |
noFreeze | Permanently disables freezes. |
requireAuthorization | Enforces authorized trust lines. |
Practical Setup Guide
Using the Account Configurator
Download the Account Configurator to simulate settings on Testnet/Devnet or inspect Mainnet accounts.
Steps:
New Account Creation:
- Select Testnet_/_Devnet → Click Get New Account.
Exchanger Setup:
- Apply the 4 standard flags via the Exchanger template.
Issuer Customization:
- Enter
Domain,TransferRate, andTickSize. - Add signers and quorum for multi-signing.
- Enter
👉 Explore advanced account security options
FAQs
What’s the difference between Holder and Exchanger accounts?
- Holder: Basic XRP storage/spending (default settings).
- Exchanger: Optimized for trading with rippling and payment controls.
Can I reconfigure an existing account?
Yes. Use the Configure Account button in the Account Configurator to update flags or fields.
Why require destination tags for Exchangers?
Tags route payments to specific users at a shared address, simplifying operations for exchanges.
Summary
Configuring XRP Ledger accounts involves:
- Holder: Zero setup.
- Exchanger: Four key flags for trading.
- Issuer: Detailed fields and flags for token issuance.
Leverage the Account Configurator for risk-free testing before deploying on Mainnet.