> For the complete documentation index, see [llms.txt](https://snap-docs.xrplevm.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://snap-docs.xrplevm.org/basics/publish-your-docs.md).

# Usage guide

## **Authentication**

To start using the XRP Ledger Snap, you must first authenticate with your MetaMask wallet. Upon selecting the XRPL Snap, MetaMask will prompt you to authenticate. Approve the connection request to start using the Snap with your XRP Ledger account.

<figure><img src="https://2787008926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRQO0ygTHdp4vVqUyBXrk%2Fuploads%2FnIHzoybygVkOgPNsQfEq%2FSCR-20240925-tdjz.png?alt=media&amp;token=e4aec7ef-a413-4bb3-9487-25e588729406" alt="" width="362"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Security Reminder** Always ensure that you’re connecting to trusted sites and never share your private keys or mnemonic phrase with anyone.
{% endhint %}

### **Getting Your Account's Information**

Once authenticated, you can easily access detailed information about your XRP Ledger account:

1. **Access account information:**\
   Click into the info icon in the sidebar. Then click into the account details option and a modal with your account's information will be shown.

<figure><img src="https://2787008926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRQO0ygTHdp4vVqUyBXrk%2Fuploads%2FGGKiHcfya4lk06ztOqb3%2FSCR-20240925-tgkj.png?alt=media&amp;token=42d7d7fb-2153-4db6-ae74-ba6887d0eab3" alt="" width="375"><figcaption></figcaption></figure>

2. **View balance and transactions:**\
   Here, you can view your XRP balance, any issued tokens, and your transaction history.&#x20;

<figure><img src="https://2787008926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRQO0ygTHdp4vVqUyBXrk%2Fuploads%2Fq4nc9gRlSbKb70NSfP6w%2Fimage.png?alt=media&amp;token=85fd5e87-09dc-46e0-bb8f-00e603e1c9ec" alt="" width="336"><figcaption></figcaption></figure>

### **Signing transactions**

The XRP Ledger Snap allows you to securely sign transactions directly within MetaMask:

1. **Initiate a Transaction:**\
   Start by creating a transaction either within the Snap interface or on a DApp that supports the XRP Ledger.
2. **Review Transaction Details:**\
   MetaMask will display the transaction details. Carefully review the recipient address, amount, and any associated fees.
3. **Sign the Transaction:**\
   Once you’ve verified the transaction details, click on the "Sign" button. MetaMask will prompt you to confirm the action. After confirmation, the transaction will be signed using your XRP Ledger private key stored within the Snap.
4. **Broadcast the Transaction:**\
   After signing, the transaction will be broadcast to the XRP Ledger network. You can track its status in the transaction history section.

<figure><img src="https://2787008926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRQO0ygTHdp4vVqUyBXrk%2Fuploads%2FaHNWWDo2zhuyHrKFi9jQ%2FSCR-20240925-tofc.png?alt=media&amp;token=8f9641b9-0919-4471-8dbc-9626d58603d3" alt="" width="362"><figcaption></figcaption></figure>

{% hint style="warning" %}
Always verify that all the transaction details are correct. Once the transaction is signed and submitted can not be reverted.
{% endhint %}

### **Connect to multiple networks**

The XRP Ledger Snap supports connecting to multiple networks.

**Switch Networks**\
Within the Snap settings, you can switch between different XRP Ledger networks, such as the mainnet, testnet, or devnet.

<figure><img src="https://2787008926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRQO0ygTHdp4vVqUyBXrk%2Fuploads%2FmyWJRgDmpYShGk0kIPWO%2FSCR-20240925-thxh.png?alt=media&amp;token=2bf2fc38-9d23-48a0-b0c3-cf89e57a903f" alt="" width="362"><figcaption></figcaption></figure>

### **Export your account**

{% content-ref url="/pages/SdmJ2PssGyGtoUqlx8rJ" %}
[Backup your account](/basics/backup-your-account.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://snap-docs.xrplevm.org/basics/publish-your-docs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
