XRPNames: Documentation & Information

XRPNames provides a unified, user-friendly naming system for the XRP Ledger (XRPL). Instead of dealing with complex XRPL addresses, you can register and use human-readable.xrp names. Our goal: Simplify interactions on XRPL for users, developers, and businesses alike.

Table of Contents

About XRPNames

XRPNames is a US-based company dedicated to making the XRPL ecosystem more accessible. Each .xrp name is a unique NFT on the XRPL, ensuring:

  • Single Issuer: All names come from a single XRPL issuer rEgDY1ncKfxVpXr53e42y8ckjKcBeyAAzp.
  • No Duplicates: A name like xrpnames.xrp can only exist once.
  • On-Ledger Verification: Ownership and transfers are transparent on XRPL.

Our platform is at https://www.xrpnames.com, where users can register names, manage addresses, and secure their XRPL identity.

For End Users

Tired of copying long addresses? With XRPNames:

  • Easy Payments: Send XRP to xrpnames.xrp instead of a random address.
  • User Control: You own the NFT (the name). Transfer it, assign it to another address, or sell it.
  • Simple Setup: Create an account, buy a name, map it to your XRPL address—all on www.xrpnames.com.

Choosing custodial mode? Your keys are AES-256-GCM encrypted and stored on Firebase. This approach balances convenience and security. Prefer full control? Non-custodial options let you manage your own keys.

For Developers & Technical Teams

Integrate XRPNames easily:

  • Resolve Names to Addresses: Use our API to fetch the XRPL address for a given name.
  • Verify Authenticity: Check that the NFT’s issuer matches rEgDY1ncKfxVpXr53e42y8ckjKcBeyAAzp.
  • Improve UX: Replace r... addresses with friendly .xrp names in your UI.

See the API section below for integration details. Contact us if you need further guidance.

For Businesses & Non-Technical Leaders

XRPNames enhances the XRPL experience for your customers:

  • Branding & Identity: Users pick memorable names (e.g. mybrand.xrp) that reflect their identity or your brand.
  • Customer Trust: Names reduce errors and build confidence in transactions.
  • Interoperability: Our system is open. Any wallet or DApp can support name resolution, fostering a naming standard on XRPL.

Security & Infrastructure

We prioritize security and reliability:

  • Encryption: Custodial secrets encrypted with AES-256-GCM, stored in Firebase.
  • Uptime & Redundancy: Cloud-based hosting ensures minimal downtime.
  • Continuous Monitoring: Regular audits and updates to maintain trust and safety.

Public Resolve API

The Resolve API maps a .xrp name to its associated XRPL address and optional metadata.

Endpoint

GET https://www.xrpnames.com/api/resolveName?name=xrpnames.xrp

Parameters

ParameterRequiredDescription
nameYesThe .xrp name, e.g. xrpnames.xrp.

Responses

Success Example:

{
  "address": "rExampleOwnerXRPAddress",
  "ownerEmail": "e*****@example.com",
  "ownerFirstName": "A***",
  "ownerLastName": "L***",
  "issuer": "rEgDY1ncKfxVpXr53e42y8ckjKcBeyAAzp"
}

Error Examples:

{ "error": "Invalid name" }
{ "error": "Name not found" }
{ "error": "This name is not assigned to any wallet" }

Integration Example

fetch('https://www.xrpnames.com/api/resolveName?name=xrpnames.xrp')
  .then(response => response.json())
  .then(data => {
    if (data.error) {
      console.error('Resolve error:', data.error);
    } else {
      console.log('Mapped address:', data.address);
      // Use xrpnames.xrp as a friendly alias in your UI
    }
  })
  .catch(err => console.error('Network error:', err));

Best Practices

  • Verify the NFT issuer (rEgDY1ncKfxVpXr53e42y8ckjKcBeyAAzp) to confirm authenticity.
  • Cache results to reduce network calls and re-check periodically for ownership changes.
  • Owner details (email, names) are masked and optional. The address is the authoritative data.
  • Encourage users to set a default address for stable, predictable resolution.

Contact & Support

Need help or have requests? Email us at dev@xrpnames.com.

Check out our FAQ for more common questions.