Xaman Wallet Integration
Skill by harleyscodes
Why use this skill?
Seamlessly integrate Xaman (formerly Xumm) wallet into your web applications for XRPL authentication, payment requests, and secure transaction signing using the official PKCE SDK.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/harleyscodes/xaman-wallet-integrationWhat This Skill Does
The Xaman Wallet Integration skill, developed by harleyscodes, allows developers to seamlessly integrate the Xaman (formerly Xumm) wallet ecosystem into their applications. By leveraging the XummPkce SDK, this tool enables XRPL-based authentication, wallet connection, and secure transaction signing. It facilitates 'Sign-in with Xaman' functionality, which is the standard for non-custodial XRP Ledger web applications. The skill handles the OAuth2 PKCE flow, allowing your application to securely request user signatures for transactions or verify user identities via their Xaman wallet without exposing private keys.
Installation
To install this skill, use the ClawHub CLI: clawhub install openclaw/skills/skills/harleyscodes/xaman-wallet-integration. Once installed, add the SDK to your project via the Xaman CDN provided in the documentation. Ensure you have obtained your API Key from the Xaman Developer Dashboard and stored it in your environment variables as NEXT_PUBLIC_XAMAN_API_KEY. Initialize the SDK in your main layout or authentication context to ensure the event listeners for successful authentication and errors are active before the user triggers the authorization flow.
Use Cases
- Web3 Authentication: Implementing a secure 'Connect Wallet' button that verifies user ownership of an XRPL address.
- Payment Requests: Requesting specific XRP payments or token transfers from users by generating QR codes or deep links through the Xaman app.
- Decentralized Identity: Using the user's wallet address as a unique identifier for user profiles, dashboards, or premium service access within your application.
- Transaction Signing: Allowing users to sign smart contract interactions or escrow creations directly on the XRP Ledger using their mobile device.
Example Prompts
- 'OpenClaw, help me implement a login button that triggers the Xaman authorization flow and logs the user's public address to the console.'
- 'Generate a function that requests a 10 XRP payment from the currently connected Xaman wallet user using the installed integration skill.'
- 'How do I handle session persistence when using the Xaman SDK in my React dashboard to ensure the user stays logged in after a page refresh?'
Tips & Limitations
Always trigger xumm.authorize() from an explicit user-initiated event like a button click to avoid browser popup blockers. If you encounter issues with the account showing as undefined, ensure you are accessing the state via xumm.state() inside or after the 'success' event listener. Remember that Xaman is for non-custodial signing; the app never gains access to the user's secret keys. Always test your implementation against the Xaman Testnet first, and verify that your redirectUrl exactly matches the configured domain in the Xaman developer portal to avoid CORS or origin mismatch errors.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-harleyscodes-xaman-wallet-integration": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: external-api