TypeScript + Viem

These guides walk through Flare Smart Accounts flows with Viem and the xrpl library on Coston2 network. Each guide includes a runnable script from the flare-viem-starter repository.

Start with State Lookup to derive your personal account address from an XRPL wallet, then follow the custom-instruction or cross-chain guides depending on your integration.

Getting Started

Read the on-chain smart-account state before sending XRPL payments.

State Lookup

Reading the smart-accounts-related states from the Flare chain using Viem.

Custom Instructions

Mint FXRP and dispatch user operations through XRPL memo opcodes (0xFE, 0xFF), recover when a direct mint fails (0xE0), and fast-forward a stuck memo-instruction nonce (0xE1).

Custom Instruction

Sending custom smart account instructions via XRPL using Viem and an off-chain executor.

Memo Field Custom Instruction

Sending the full PackedUserOperation in an XRPL memo with Viem (0xFF flow).

Recover Stuck Mint Transaction

Recover FXRP when a smart-account direct mint reverted or was never finalized, using the 0xE0 skip-memo flow with Viem.

Fast-Forward Nonce

Advance a personal account's memo-instruction nonce when it is stuck after a partial or abandoned direct-mint flow, using the 0xE1 opcode with Viem.

Cross-Chain

Bridge FXRP between Flare and Sepolia with LayerZero OFT adapters, combining mint or redeem with a cross-chain transfer in one flow.

Cross-Chain Mint

Mint FXRP from XRP and bridge it to Sepolia in a single flow using Viem and LayerZero.

Cross-Chain Redeem

Send FXRP from Sepolia back to Flare and auto-redeem it to XRP on the XRPL using Viem and LayerZero.

Cross-Chain Redeem to Tag

Send FXRP from Sepolia back to Flare and auto-redeem to an XRPL address with a destination tag.

Protocol reference

For opcode layouts and failure handling without code, see Custom Instruction, Memo Field Custom Instruction, and Custom Instruction Comparison.