flare-smart-accounts

Encode and decode 32-byte XRPL payment references for Flare Smart Accounts.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/mashharuki/flare-sample --skill flare-smart-accounts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flare-smart-accounts
Source: https://github.com/mashharuki/flare-sample/tree/main/.claude/skills/flare-smart-accounts
Command: npx skills add https://github.com/mashharuki/flare-sample --skill flare-smart-accounts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Flare Smart Accounts remove the requirement for end users to hold FLR by encoding XRPL-side instructions into 32-byte payment references that relayers can verify and execute on Flare, simplifying XRPL-to-Flare interactions and onboarding for non-EVM users.

Core Features & Use Cases

  • Instruction Encoding & Decoding: Precise 32-byte payment reference formats for FXRP, Firelight, Upshift, and custom contract calls.
  • Vault & FAssets Workflows: Support for minting FXRP, depositing to vaults, requesting and claiming withdrawals, and redeeming back to XRP.
  • Custom Instruction Registration: Register arbitrary CustomCall arrays via MasterAccountController, produce the 30-byte call hash, and embed it in XRPL payments for on-chain execution.
  • Developer Tooling: CLI and TypeScript (Viem) guidance for building, encoding, submitting, and decoding instructions in end-to-end workflows.
  • Use Case: Build a relayer that accepts XRPL payments with memo instructions to mint FXRP, deposit into an Upshift vault, and later process a timed claim without requiring users to manage FLR.

Quick Start

Use the skill to encode a 0x01 FXRP transfer payment reference that sends 10 FXRP from wallet-id 0 to 0xf5488132432118596fa13800b68df4c0ff25131d.

Frequently Asked Questions about flare-smart-accounts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I encode XRPL payment references for Flare Smart Accounts?▼

To encode XRPL payment references for Flare Smart Accounts, format 32-byte instruction payloads for FXRP, Firelight, or Upshift operations, embedding wallet IDs and contract call hashes. This allows relayers to verify and execute XRPL-originated actions on Flare without requiring FLR.

What are Flare Smart Accounts and how do they work with XRPL?▼

Flare Smart Accounts enable XRPL users to interact with Flare without holding FLR by encoding XRPL-side instructions into 32-byte payment references. Relayers verify these references and execute the corresponding actions on Flare, simplifying XRPL-to-Flare onboarding for non-EVM users.

How do I register a custom contract call for Flare via XRPL payments?▼

Register custom contract calls by submitting a CustomCall array via the MasterAccountController to produce a 30-byte call hash. Embed this hash into a 32-byte XRPL payment reference, allowing relayers to verify and execute the arbitrary on-chain contract call on Flare.

Can I mint FXRP and deposit to Upshift vaults without holding FLR?▼

Yes, you can mint FXRP, deposit to vaults, and perform Upshift or Firelight operations without holding FLR. Encode the specific workflow instructions into the 32-byte XRPL payment reference, letting relayers handle the execution and verification on Flare.

Does this skill support decoding 32-byte XRPL payment references?▼

Yes, the skill supports both constructing and decoding 32-byte XRPL payment references. Decoding allows developers and relayer operators to parse instruction formats for FXRP, Firelight, Upshift, and custom contract calls to verify intended on-chain actions.

What is the best way to build a relayer for XRPL to Flare FXRP transfers?▼

Build a relayer by using the CLI and TypeScript (Viem) guidance to construct, encode, and decode 32-byte payment references. The relayer accepts XRPL payments with memo instructions, verifies the encoded format, and executes the minting or vault deposit on Flare.