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.