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>
This commit is contained in:
2026-05-31 04:49:30 +00:00
parent 18ecbe471b
commit 00f9a96286
12 changed files with 1725 additions and 61 deletions

View File

@@ -147,10 +147,10 @@
<section class="overall">
<div class="overall-head">
<h2>Overall MVP Progress</h2>
<span class="overall-pct">29%</span>
<span class="overall-pct">40%</span>
</div>
<div class="bar"><span style="width: 29%"></span></div>
<p class="count">15 of 51 phase deliverables complete</p>
<div class="bar"><span style="width: 40%"></span></div>
<p class="count">21 of 52 phase deliverables complete</p>
</section>
<h2 class="section">Development Phases</h2>
@@ -188,19 +188,20 @@
<li class="item done"><span class="mark"></span><span>Deployed live at feedthepyre.com + scan verified e2e</span></li>
</ul>
</article>
<article class="card todo">
<article class="card in_progress">
<header class="card-head">
<h3><span class="phase-id">Phase 2</span> Close Empty ATAs</h3>
<span class="badge todo">TODO</span>
<span class="badge in_progress">IN PROGRESS</span>
</header>
<p class="count">0 / 6 complete</p>
<p class="count">6 / 7 complete</p>
<ul class="checklist">
<li class="item"><span class="mark"></span><span>Identify empty token accounts</span></li>
<li class="item"><span class="mark"></span><span>Build close-account tx</span></li>
<li class="item"><span class="mark"></span><span>Decode tx preview</span></li>
<li class="item"><span class="mark"></span><span>Wallet signing</span></li>
<li class="item"><span class="mark"></span><span>Confirmation tracking</span></li>
<li class="item"><span class="mark"></span><span>Receipt page</span></li>
<li class="item done"><span class="mark"></span><span>Identify empty token accounts (server re-validated)</span></li>
<li class="item done"><span class="mark"></span><span>Build close-account tx (unsigned; classic SPL + Token-2022)</span></li>
<li class="item done"><span class="mark"></span><span>Decode tx + preview match (rent → your wallet)</span></li>
<li class="item done"><span class="mark"></span><span>Wallet signing (client-side, adapter only)</span></li>
<li class="item done"><span class="mark"></span><span>Confirmation tracking</span></li>
<li class="item done"><span class="mark"></span><span>Receipt page (on-chain verified)</span></li>
<li class="item"><span class="mark"></span><span>Live signed close verified e2e (needs an empty ATA)</span></li>
</ul>
</article>
<article class="card todo">