Files
RogueWave 00f9a96286 feat(phase2): close-empty-ATA flow — build/decode/preview/sign/confirm/receipt
- @pyre/solana: buildCloseEmptyAccountsTx (UNSIGNED v0 tx; re-validates each
  account on-chain — owner==wallet, balance==0, correct program, not
  frozen/delegated, Token-2022 EMPTY_CLOSE_ONLY via §7.1; rejects whole build on
  any ineligible account), simulateTransaction, decodeTransaction. Rent
  destination + close authority + fee payer all pinned to the wallet.
- @pyre/api: POST /api/build/close-empty (server re-validates, 400 on ineligible)
  and POST /api/receipt (on-chain verified: meta.err==null, signer==wallet, rent
  from balance delta; lists only closes whose destination==wallet).
- @pyre/web: select empty accounts → build → CLIENT-SIDE decode+match (7 checks:
  feePayer/all-closeAccount/dest==wallet/closed-set==selected==preview) gates
  signing → sign in wallet → send → confirm → on-chain receipt w/ explorer link.

Built by 3 agents, reviewed by 2 audits (security: SOUND — no critical/high;
integration: SHIP). Applied audit fixes: receipt destination check, doc/lint
cleanup. typecheck 8/8, core 85, solana 19, web build green. Live-verified: the
API refuses to build a close tx for a non-empty account (400). buildBurnTx
remains a Phase-3 stub.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-05-31 04:49:30 +00:00
..

@pyre/solana

Solana transaction helpers for PYRE.

Purpose

Token-account reading and unsigned transaction construction for the burner flow. Per §13 its responsibilities are:

  • Token-account parsing.
  • Close-account transaction builder.
  • Burn transaction builder.
  • Simulation helpers.
  • Transaction decoder (for preview matching).

Trust rules (load-bearing)

  • PYRE never holds private keys — this package builds unsigned transactions; signing happens client-side in the user's wallet.
  • Recovered ATA rent defaults to the user's own wallet.
  • Always simulate, then decode and match against the user-facing preview before requesting a signature.
  • Classic SPL only in the MVP. Skip Token-2022, NFTs, and unsupported layouts.

Status

Stubs only. Every exported function throws Error("not implemented").

TODO

  • Implement parseTokenAccounts, buildCloseEmptyAccountsTx, buildBurnTx, simulateTransaction, and decodeTransaction.
  • Wire classification through @pyre/core.