XRPL Token Issuance & AMM Training App

An interactive web application for learning token issuance and liquidity provisioning on the XRP Ledger. This project is the companion application to the XRPL Commons Token Issuance and Liquidity training workshop.

Overview

This training application guides participants through the complete lifecycle of token deployment and liquidity management on the XRP Ledger:

1. Creating Accounts - Set up issuer and receiver wallets
2. Issuing Tokens - Create fungible tokens with trust lines and rippling
3. Creating AMM Pools - Build automated market maker pools for liquidity

Participants connect via Xaman wallet and interact with the XRP Ledger testnet to gain hands-on experience with:

• Token creation and transfers
• Trust line establishment
• AMM pool creation and management
• Asset swapping through liquidity pools

Documentation

Follow along with the full training documentation:

• Token Issuance and Liquidity Overview
• Creating Accounts
• Issuing Tokens
• Creating an AMM Pool

Prerequisites

• Node.js 20.x or higher
• Xaman Wallet installed on your mobile device
• Xaman Developer Account for API credentials

Installation

1. Clone the repository:

git clone https://github.com/xrpl-commons/xrpl-amm-workflow.git
cd xrpl-amm-workflow

2. Install dependencies:

npm install

3. Create a .env file in the root directory with the following variables:

# Xaman API credentials (get from https://apps.xumm.dev/)
XAMAN_API_KEY=
XAMAN_SECRET_KEY=

# XRPL Commons account (create from https://xrpl.org/resources/dev-tools/xrp-faucets)
XRPL_COMMONS_ADDRESS=
XRPL_COMMONS_SECRET=

# Network configuration
WSS_EXPLORER=wss://s.altnet.rippletest.net:51233
NETWORK=TESTNET

Note: For production use, set NETWORK=MAINNET and update WSS_EXPLORER to a mainnet WebSocket endpoint.

Development

Start the development server:

npm run dev

The application will be available at http://localhost:3000.

Tech Stack

• Nuxt 3 - Vue.js framework
• Nuxt UI - UI component library
• xrpl.js - XRP Ledger JavaScript library
• Xaman SDK - Wallet integration
• Tailwind CSS - Styling

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Resources

• XRP Ledger Documentation
• XRPL Commons
• Xaman Developer Docs
• XRP Testnet Faucet

License

This project is open source and available under the MIT License.

---

Built with love by XRPL Commons