A comprehensive integration skill for adding Xaman wallet authentication and XRP Ledger transaction capabilities to modern web applications.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install xaman-wallet-integration
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install xaman-wallet-integration using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Xaman Wallet?
The Xaman Wallet skill enables developers to seamlessly bridge their web applications with the XRP Ledger using the Xaman (formerly Xumm) ecosystem. By leveraging the XummPkce SDK, this Openclaw Skills integration provides a secure, developer-friendly way to handle user authentication, account verification, and transaction signing. It is designed to work efficiently with modern frontend frameworks, ensuring that decentralized identity management is both robust and easy to implement.
This skill focuses on the Proof Key for Code Exchange (PKCE) flow, which is the industry standard for secure OAuth2 authentication in public clients like single-page applications. By using this Openclaw Skills component, you can offload the complexities of XRPL interactions to a proven, mobile-first wallet solution while maintaining a smooth user experience through popups or redirects.
Xaman Wallet Use Cases
- Implementing Sign-in with Xaman for secure Web3 user authentication.
- Requesting XRP Ledger transaction signatures for payments or smart contract interactions.
- Building decentralized dashboards that require real-time access to XRPL account data.
- Managing persistent user sessions in decentralized applications (dApps) without storing private keys.
How Xaman Wallet Works
- The application loads the XummPkce SDK from the official CDN to access the necessary XRPL communication protocols.
- The developer initializes the SDK with a unique API key obtained from the Xaman Developer Dashboard.
- When a user triggers an authentication action, the skill invokes the authorize method to open the Xaman mobile app or a secure popup.
- Upon successful user approval, the skill captures the session state, including the user's public XRP address.
- The application uses the returned JWT and account information to facilitate authorized transactions on the XRP Ledger.
Xaman Wallet Setup
To integrate this functionality into your application using Openclaw Skills, follow these steps:
- Include the SDK in your project's HTML head or main layout:
<script src="https://xumm.app/assets/cdn/xumm-oauth2-pkce.min.js"></script>
- Configure your Xaman API key in your environment variables:
NEXT_PUBLIC_XAMAN_API_KEY=your_api_key_here
- Initialize the wallet connection in your application logic:
const xumm = new XummPkce(process.env.NEXT_PUBLIC_XAMAN_API_KEY, {
redirectUrl: window.location.origin + "/dashboard"
});
- Trigger the authorization flow:
await xumm.authorize();
Xaman Wallet Data Schema & Taxonomy
The Xaman Wallet skill utilizes a specific data structure to manage XRPL sessions and metadata:
| Attribute | Type | Description |
|---|---|---|
account |
string | The public XRP Ledger address of the connected user. |
jwt |
string | The JSON Web Token used to maintain the authenticated session. |
redirectUrl |
string | The URL to which the user is returned after the OAuth2 flow. |
rememberJwt |
boolean | Determines if the session should persist in localStorage (default: true). |
storage |
Storage | The interface used for session persistence (default: localStorage). |
Xaman Wallet Advanced Features
- Session Auto-Recovery: Automatically restores previous sessions on page reload to improve user retention.
- Custom Storage Support: Allows developers to define custom storage interfaces beyond the standard localStorage.
- Event-Driven Architecture: Provides built-in hooks for success and error events to handle complex UI state changes.
- Implicit Flow Support: Optional configuration for environments requiring legacy OAuth2 implicit flows.
- Secure PKCE Implementation: Ensures high-level security by preventing authorization code injection attacks.
SKILL.md
Loading
Related Openclaw Skills
SaucerSwap Arbitrage
A high-performance triangular arbitrage skill for executing multi-hop token swaps on Hedera's premier DEX, SaucerSwap.
KyberSwap Arbitrage
A sophisticated automated trading skill for executing triangular arbitrage on the Base network through KyberSwap liquidity pools.
Hedera Transaction Builder
A comprehensive toolkit for building, signing, and executing HBAR transfers and token operations on the Hedera network.
Hedera Token Minting (HTS)
A comprehensive technical skill for programmatically creating, minting, and managing fungible and non-fungible tokens on the Hedera network.
XRPL Token & NFT Minting Skill
A comprehensive automation skill for creating, issuing, and managing fungible tokens and NFTs on the XRP Ledger.
FirstLedger Snipe
A high-speed XRPL token sniper that monitors new issuances and executes automated purchases via FirstLedger.
Featured*
