@thewarp/xrpl-snap v1.0.5
Before Your Start
Overview
The Warp is a modified version of XRPL Ledger for MetaMask originally created by Peersyst.
The XRP Ledger for MetaMask is an extension that allows users to interact with the XRP Ledger (XRPL) directly from their MetaMask wallet. This Snap introduces support for XRPL, enabling users to manage XRP and other tokens on the XRPL, perform transactions, and interact with XRPL-based decentralized applications (DApps).
XRPL for MetaMask Original Features
- XRPL Integration: Manage XRP and XRPL tokens within MetaMask. (limitted
- Transaction Support: Send and receive XRP and other XRPL tokens.
- DApp Interaction: Use XRPL-based DApps seamlessly.
- Account Management: View account balances, transaction history, and other details.
Secure and User-Controlled: Full control over your XRPL keys and permissions.
The Warp Expanded Features
Multiple XRPL Wallet Support: Import and manage mutltiple XRPL wallets from family seeds.
Site Feature Expansion: Memo transactions, Import Wallet, Switch Wallet, Trust Lines.
Usage
To use the XRP Ledger, first install it by following these steps:
- Open MetaMask: Ensure you have the latest version of the MetaMask extension installed in your browser.
- Navigate to Settings: Click on the MetaMask icon, go to settings, and look for the Snaps section.
- Add XRP Ledger: In the Snaps section, add the XRP Ledger by providing its URL or selecting it from the Snap store.
- Install Snap: Click on the XRP Ledger and follow the prompts to add it to your MetaMask wallet.
- Enable Snap: Once installed, enable the Snap and grant necessary permissions.
Development
Here’s a basic guide to get started:
Prerequisites
- Node.js
- MetaMask Flask
Installation
yarn
Running
yarn start
- To only start the UI, navigate to
packages/site
and start from there. The same applies to the snap inpackages/snap
. - If you make changes to the snap, first remove the previously installed version to see the changes.
- Enable the MetaMask Flask in your extensions.
API
Installation
Use the following request to install the Snap:
provider.request({
method: 'wallet_requestSnaps',
params: {
['npm:xrpl-snap']: {},
},
});
For developing the snap, change the request to:
params: {
["local:http://localhost:8080"]: {},
},
Interact with the Snap
To make requests using the RPC, use the following code:
provider.request({
method: 'wallet_invokeSnap',
params: {
snapId: 'npm:xrpl-snap',
request: {
method: 'xrpl_request',
params: { command: 'account_info', account: 'rBg...' },
},
},
});
Account
Get current account:
provider.request({
method: 'wallet_invokeSnap',
params: {
snapId: 'npm:xrpl-snap',
request: {
method: 'xrpl_getAccount',
},
},
});
Network
- Get supported networks:
provider.request({
method: 'wallet_invokeSnap',
params: {
snapId: 'npm:xrpl-snap',
request: {
method: 'xrpl_getStoredNetworks',
},
},
});
- Get current network:
provider.request({
method: 'wallet_invokeSnap',
params: {
snapId: 'npm:xrpl-snap',
request: {
method: 'xrpl_getActiveNetwork',
},
},
});
- Change the selected network:
provider.request({
method: 'wallet_invokeSnap',
params: {
snapId: 'npm:xrpl-snap',
request: {
method: 'xrpl_changeNetwork',
params: { chainId: 1 }, // Example chainId
},
},
});
Signing and submitting transactions
To sign and submit transactions
provider.request({
method: 'wallet_invokeSnap',
params: {
snapId: 'npm:xrpl-snap',
request: {
method: 'xrpl_signAndSubmit',
params: {
TransactionType: 'Payment',
Account: 'rBg...',
Destination: 'rPT...',
Amount: '1000000', // Amount in drops
},
},
},
});
- If you only want to sign the transaction use
xrpl_sign
.
Support
For support and further information, refer to the following resources:
- Documentation: https://docs.xrplsnap.com/
- XRPL Documentation: XRPL.org
- MetaMask Snaps Documentation: MetaMask Snaps
Contributing
We welcome contributions to the XRP Ledger project. To contribute, please follow these steps:
- Fork the Repository: Fork the XRP Ledger repository on GitHub.
- Create a Branch: Create a new branch for your feature or bugfix.
- Submit a Pull Request: Submit a pull request with a detailed description of your changes.
License
This project is licensed under the MIT License. See the LICENSE file for details.