Keep the wallet boundary small

Sat, 26 Sep 2026 09:00:00 +0000

A wallet interface has two very different jobs: helping someone understand a transaction, and authorising that transaction. Treat them as separate parts of the application.

Separate the states

A transaction preview should describe what the user is about to do without needing access to secret material. The signing layer should receive a clearly defined request only after confirmation.

typescript

// Illustrative UI model; not a QRL signing API.
type TransactionReview = {
  recipient: string;
  amountDisplay: string;
  feeDisplay: string;
};

type ReviewState =
  | { status: 'editing' }
  | { status: 'reviewing'; transaction: TransactionReview }
  | { status: 'submitted'; transactionHash: string };

Keep display formatting separate from the integer amounts used by the underlying protocol. A human-readable amount is not a validated transaction value.

Web Wallet on QRL.dev

Keep the wallet boundary small

Separate the states