rlusd-transfer

name	rlusd-transfer
description	Execute an explicit RLUSD transfer or payment workflow using the external rlusd-cli runtime with prepare, review, execute, and receipt steps.
user-invocable	true

Purpose

Use this skill when the user explicitly wants to move RLUSD and is ready to go through the action workflow rather than just inspect metadata or balances.

When To Use This Skill

• The user says to send, transfer, pay, or move RLUSD.
• The user wants to prepare or execute an Ethereum RLUSD transfer or approval.
• The user wants to prepare or execute an XRPL RLUSD payment.

Do Not Use This Skill When

• The task is only about balances, allowances, trust-line status, or other read-only checks.
• The task is specifically about XRPL trust-line creation or updates; use rlusd-trustline.
• The task is specifically about DeFi venue discovery, previews, or Aave supply; use rlusd-defi-action.

Decision Guide

• On Ethereum, use evm transfer ... for token transfers and evm approve ...
• On XRPL, use xrpl payment ...
• Before any command that uses --from-wallet, --owner-wallet, or --wallet, load rlusd-wallets to confirm the local wallet alias or provision one with explicit user approval.
• Always start with prepare, review the resulting plan_id and plan_path, then call execute with a matching --confirm-plan-id.
• After submit, use the chain-specific wait or receipt commands instead of guessing whether the action finalized.

Current Command Sequence

rlusd evm transfer prepare --chain ethereum-mainnet --from-wallet ops --to 0x... --amount 25.5 --json
rlusd evm transfer execute --plan <plan_path_from_prepare> --confirm-plan-id <plan_id_from_prepare> --password "$RLUSD_WALLET_PASSWORD" --json
rlusd evm tx wait --chain ethereum-mainnet --hash 0x... --json

rlusd evm approve prepare --chain ethereum-mainnet --owner-wallet ops --spender 0x... --amount 1000 --json
rlusd evm approve execute --plan <plan_path_from_prepare> --confirm-plan-id <plan_id_from_prepare> --password "$RLUSD_WALLET_PASSWORD" --json
rlusd evm tx receipt --chain ethereum-mainnet --hash 0x... --json

rlusd xrpl payment prepare --chain xrpl-mainnet --from-wallet treasury-xrpl --to r... --amount 250 --json
rlusd xrpl payment execute --plan <plan_path_from_prepare> --confirm-plan-id <plan_id_from_prepare> --wallet treasury-xrpl --password "$RLUSD_WALLET_PASSWORD" --json
rlusd xrpl tx wait --chain xrpl-mainnet --hash ABCD... --json
rlusd xrpl payment receipt --chain xrpl-mainnet --hash ABCD... --json

Common Warnings

• Use the exact plan_path and plan_id returned by prepare.
• Ethereum and XRPL mainnet execution requires explicit confirmation.
• Do not assume example wallet aliases like ops or treasury-xrpl already exist locally; use rlusd-wallets before wallet-backed transfer steps.
• Execute examples pass --password "$RLUSD_WALLET_PASSWORD" explicitly for predictability; the CLI can also read RLUSD_WALLET_PASSWORD from the environment.
• XRPL payment execution depends on the destination account already having a trust line when RLUSD is required there. The RLUSD issuer account does not require an inbound trust line.
• Follow wait/receipt commands after execution instead of assuming submission equals success.

Examples

• "Send 25.5 RLUSD on Ethereum." -> run evm transfer prepare
• "Send 25.5 RLUSD on Ethereum from my wallet." -> use rlusd-wallets, then run evm transfer prepare
• "Approve RLUSD for this spender." -> run evm approve prepare
• "Pay 250 RLUSD on XRPL." -> run xrpl payment prepare