Fix copy voice: replace "we/our" with "TxFix" throughout

SHAcollision · claude · SHAcollision · commit 4833f94c19f5 · 2026-02-09T12:28:47.000+01:00
Rewrite readme to match V1 implementation, use "I" for personal
opinion/direction and "TxFix" or "this tool" for the product. Updated
roadmap checkboxes, tech stack, pricing, and removed stale references
(Alby NWC, Vercel, Framer Motion). Fixed PsbtDelivery and plan.md.

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/plan.md b/plan.md
@@ -14,7 +14,7 @@ The entire app is client-side JavaScript. There are zero server dependencies:
 - **Build output**: `next build` with `output: 'export'` produces a plain `out/` folder of HTML/JS/CSS
 - **No API routes, no SSR, no middleware** — just static files served by GitHub Pages
 
-The only technical consideration is **browser polyfills for bitcoinjs-lib** (it uses Node.js `Buffer`). We handle this with explicit imports (`import { Buffer } from 'buffer'`) rather than webpack global polyfills, ensuring compatibility with both Turbopack (dev) and webpack (build).
+The only technical consideration is **browser polyfills for bitcoinjs-lib** (it uses Node.js `Buffer`). TxFix handles this with explicit imports (`import { Buffer } from 'buffer'`) rather than webpack global polyfills, ensuring compatibility with both Turbopack (dev) and webpack (build).
 
 ---
 
@@ -31,7 +31,7 @@ User pastes TXID → Client fetches from mempool.space + Esplora APIs
   → User signs in own wallet → Broadcast → Live tracker → Rescue receipt
 ```
 
-**No keys ever touch our code.** PSBTs are unsigned templates the user signs in their own wallet.
+**No keys ever touch TxFix.** PSBTs are unsigned templates the user signs in their own wallet.
 
 ---
 
@@ -148,7 +148,7 @@ public/
 > Config, theme, layout, network infrastructure
 
 **Modify:**
-- `next.config.ts` — Add `output: 'export'`, `trailingSlash: true`, `images: { unoptimized: true }`. **No webpack polyfills needed** — we use explicit `buffer` imports instead of global polyfills, which works with both Turbopack (dev) and webpack (build).
+- `next.config.ts` — Add `output: 'export'`, `trailingSlash: true`, `images: { unoptimized: true }`. **No webpack polyfills needed** — TxFix uses explicit `buffer` imports instead of global polyfills, which works with both Turbopack (dev) and webpack (build).
 - `src/app/globals.css` — Dark-only theme with CSS custom properties: `--background: #0a0a0a`, `--card-bg: #18181b`, `--card-border: #27272a`, `--bitcoin: #F7931A`, `--success: #22c55e`, `--warning: #eab308`, `--danger: #ef4444`, `--muted: #71717a`
 - `src/app/layout.tsx` — Update metadata (title: "TxFix — Fix Stuck Bitcoin Transactions"), wrap children in `<Suspense>` + `<NetworkProvider>`, keep Geist + Geist Mono fonts
 - `package.json` — Add all dependencies up-front
@@ -171,7 +171,7 @@ public/
 ```bash
 pnpm add motion bitcoinjs-lib ecpair @bitcoinerlab/secp256k1 buffer bbqr qrcode.react
 ```
-Note: No `crypto-browserify` or `stream-browserify` needed — bitcoinjs-lib v7 with `@bitcoinerlab/secp256k1` handles crypto internally, and we use explicit `Buffer` imports instead of webpack shims.
+Note: No `crypto-browserify` or `stream-browserify` needed — bitcoinjs-lib v7 with `@bitcoinerlab/secp256k1` handles crypto internally, and TxFix uses explicit `Buffer` imports instead of webpack shims.
 
 **Verify:** `pnpm build` produces `out/` directory successfully. Dev server shows dark themed page with header + network selector.
 
@@ -454,7 +454,7 @@ Driven by `useDiagnosis` phase + local UI state. `useUrlState` syncs TXID and ne
 ### RBF Logic
 
 - BIP125 rules: replacement must pay strictly higher absolute fee + sufficient fee rate
-- We keep same inputs, same outputs, only reduce change output value
+- TxFix keeps same inputs, same outputs, only reduces change output value
 - Change output identification: heuristic (match input address type → non-round amount → last output)
 - If change too small after fee increase → error, suggest CPFP instead
 - Full-RBF era (Bitcoin Core 28+): replacement works even without explicit RBF signal in most cases
@@ -469,7 +469,7 @@ Driven by `useDiagnosis` phase + local UI state. `useUrlState` syncs TXID and ne
 
 ### Browser Polyfill Strategy (No Webpack Hacks)
 
-bitcoinjs-lib needs Node.js `Buffer` in the browser. Instead of fragile webpack `resolve.fallback` polyfills (which break with Turbopack in dev), we use **explicit imports**:
+bitcoinjs-lib needs Node.js `Buffer` in the browser. Instead of fragile webpack `resolve.fallback` polyfills (which break with Turbopack in dev), TxFix uses **explicit imports**:
 
 ```ts
 // src/lib/bitcoin/polyfills.ts — imported once before any bitcoinjs-lib usage
diff --git a/readme.md b/readme.md
@@ -1,12 +1,12 @@
 # TxFix
 
-**Transaction Stuck? Fix it.** -> [txfix.it](https://txfix.it)
+**Transaction Stuck? Fix it.** &rarr; [txfix.it](https://txfix.it)
 
-Free Bitcoin transaction diagnosis. 30-second rescue. Free and Open Source. No keys required.
+Free Bitcoin transaction diagnosis. 30-second rescue. No keys required.
 
 ---
 
-TxFix is the first diagnostic-first rescue tool for stuck Bitcoin transactions. Every other tool — accelerators, rebroadcasters, wallet bump buttons — assumes you already know what's wrong and jumps straight to the most expensive fix. txfix tells you what's actually happening, for free, then walks you to the cheapest resolution in 3 clicks.
+TxFix is the first diagnostic-first rescue tool for stuck Bitcoin transactions. Every other tool — accelerators, rebroadcasters, wallet bump buttons — assumes you already know what's wrong and jumps straight to the most expensive fix. TxFix tells you what's actually happening, for free, then walks you to the cheapest resolution in 3 clicks.
 
 Paste a TXID. Get a diagnosis in 3 seconds. Fix it in 30.
 
@@ -22,8 +22,6 @@ When a Bitcoin transaction gets stuck, the user experience is broken:
 
 The entire existing toolkit — mempool.space Accelerator, ViaBTC, BitAccelerate, wallet-integrated bump buttons — skips the most important step: **diagnosis**. Nobody checks whether a simple $0.50 RBF bump would work before charging $40 for an out-of-band miner bribe.
 
-Samourai's Afterburner was the closest thing to a standalone rescue tool, and it's dead (founders arrested April 2024, convicted November 2025).
-
 The diagnostic layer doesn't exist. Until now.
 
 ## How It Works
@@ -32,7 +30,7 @@ The diagnostic layer doesn't exist. Until now.
 
 One input field. Center screen. Nothing else. No signup, no wallet connect, no noise.
 
-### 2. Watch the diagnosis (2–3 seconds)
+### 2. Watch the diagnosis (2-3 seconds)
 
 An animated diagnostic sequence fires in real-time:
 
@@ -48,11 +46,11 @@ An animated diagnostic sequence fires in real-time:
 
 ### 3. Get the verdict
 
-A crystal-clear recommendation card tells you exactly what's happening and what to do:
+A clear recommendation card tells you exactly what's happening and what to do:
 
 ```
 ┌─────────────────────────────────────────────────┐
-│  🔴 STUCK — ~14 hours at current fee rate       │
+│  STUCK — ~14 hours at current fee rate          │
 │                                                  │
 │  Your tx pays 4 sat/vB but the mempool needs    │
 │  18 sat/vB for next-block confirmation.          │
@@ -64,64 +62,63 @@ A crystal-clear recommendation card tells you exactly what's happening and what
 └─────────────────────────────────────────────────┘
 ```
 
-Sometimes the verdict is: **"Relax. Your tx will confirm in ~45 minutes. Do nothing."** This tool belong to the users, it must stay honest.
+Sometimes the verdict is: **"Relax. Your tx will confirm in ~45 minutes. Do nothing."** I built this tool to be honest, not to upsell.
 
 ### 4. Fix it
 
-Click "Fix it" → txfix constructs the exact replacement transaction → presents it as a PSBT (QR code for hardware wallets, raw hex for Sparrow/Electrum). You sign in your own wallet. **We never touch your keys.** After broadcast, a live tracker shows confirmation in real-time.
+Click "Fix it" &rarr; TxFix constructs the exact replacement transaction &rarr; presents it as a PSBT (QR code for hardware wallets, .psbt file for Sparrow/Electrum, raw hex for everything else). You sign in your own wallet. **TxFix never touches your keys.** After broadcast, a live tracker shows confirmation in real-time.
 
 ### 5. Share
 
-After confirmation, get a shareable rescue receipt: what went wrong, what was done, how much it cost vs. how much an accelerator would have charged.
+After confirmation, you get a shareable rescue receipt: what went wrong, what was done, how much it cost vs. how much an accelerator would have charged.
 
-> *"Rescued by txfix — saved $37.30 vs. mempool.space Accelerator."*
+> *"Rescued by TxFix — saved $37.30 vs. mempool.space Accelerator."*
 
-## What Makes txfix Different
+## What Makes TxFix Different
 
-| | txfix | mempool.space Accelerator | ViaBTC | BitAccelerate | Wallet RBF |
+| | TxFix | mempool.space Accelerator | ViaBTC | BitAccelerate | Wallet RBF |
 |---|---|---|---|---|---|
-| **Diagnoses the problem** | ✅ Free, always | ❌ | ❌ | ❌ | ❌ |
-| **Checks RBF/CPFP options** | ✅ Automatic | ❌ | ❌ | ❌ | Partial |
-| **Recommends cheapest fix** | ✅ With exact cost | ❌ | ❌ | ❌ | ❌ |
-| **Generates PSBT** | ✅ Sign in your wallet | ❌ | ❌ | ❌ | Own txs only |
-| **Works with any wallet** | ✅ Wallet-agnostic | ✅ | ✅ | ✅ | ❌ Own wallet only |
-| **Typical cost** | 500–5,000 sats | $30–50+ | Free (limited) | Free (placebo) | Varies |
-| **Touches your keys** | ❌ Never | ❌ | ❌ | ❌ | ✅ |
+| **Diagnoses the problem** | Free, always | No | No | No | No |
+| **Checks RBF/CPFP options** | Automatic | No | No | No | Partial |
+| **Recommends cheapest fix** | With exact cost | No | No | No | No |
+| **Generates PSBT** | Sign in your wallet | No | No | No | Own txs only |
+| **Works with any wallet** | Wallet-agnostic | Yes | Yes | Yes | Own wallet only |
+| **Typical cost** | 500-5,000 sats | $30-50+ | Free (limited) | Free (placebo) | Varies |
+| **Touches your keys** | Never | No | No | No | Yes |
 
-**The core insight:** Existing tools charge $40 without telling you a $0.50 RBF bump would work. txfix tells you for free.
+**The core insight:** Existing tools charge $40 without telling you a $0.50 RBF bump would work. TxFix tells you for free.
 
 ## Features
 
-**V1 — The Unstuck Machin**
+**V1 — The Unstuck Machine**
 
-- 🔍 **Instant diagnosis** — RBF signaling, CPFP feasibility, fee analysis, mempool position, estimated wait time
-- 📊 **Verdict card** — Plain-English explanation with screenshot-worthy recommendation
-- 🔧 **PSBT generation** — Auto-constructed RBF bump or CPFP child transaction
-- 📱 **QR code signing** — Scan with hardware wallet or import into Sparrow/Electrum
-- 📡 **Live tracker** — Watch your replacement tx propagate and confirm
-- 🧾 **Rescue receipt** — Shareable card showing what you saved vs. alternatives
-- 🔗 **Accelerator fallback** — Links to mempool.space and ViaBTC when RBF/CPFP aren't possible
+- Instant diagnosis — RBF signaling, CPFP feasibility, fee analysis, mempool position, estimated wait time
+- Verdict card — Plain-English explanation with clear recommendation
+- PSBT generation — Auto-constructed RBF bump or CPFP child transaction
+- Three delivery methods — BBQr animated QR, .psbt file download, raw hex copy
+- Live tracker — Watch your replacement tx propagate and confirm
+- Rescue receipt — Shareable card showing what you saved vs. alternatives
+- Accelerator fallback — Links to mempool.space and ViaBTC when RBF/CPFP aren't possible
+- Network support — Mainnet, testnet4, signet
 
-**V2 — The Copilot**
+**V2 — The Copilot** (planned)
 
-- 👁️ **Watchlist** — Monitor multiple pending transactions with push alerts
-- ⏰ **Send Time Advisor** — "Fees will likely drop 40% in ~3 hours"
-- 🛫 **Pre-Flight Check** — Paste a raw tx before broadcasting to get a risk score
-- 🔔 **Fee Alerts** — "Notify me when next-block fee drops below 10 sat/vB"
+- Watchlist — Monitor multiple pending transactions with push alerts
+- Send Time Advisor — "Fees will likely drop 40% in ~3 hours"
+- Pre-Flight Check — Paste a raw tx before broadcasting to get a risk score
+- Fee Alerts — "Notify me when next-block fee drops below 10 sat/vB"
 
 ## Tech Stack
 
 ```
-Frontend        Next.js 15 + TypeScript + Tailwind CSS + Framer Motion
+Frontend        Next.js 16 + TypeScript + Tailwind CSS 4 + Motion
 Bitcoin data    mempool.space REST API (fees, mempool, tx status)
-                Esplora/Blockstream API (UTXOs, raw tx, scripts)
-Tx building     bitcoinjs-lib (RBF/CPFP construction + PSBT)
-QR codes        qrcode.react (PSBT rendering)
-Payments        @getalby/bitcoin-connect (NWC Lightning)
-Deploy          Vercel (zero infrastructure)
+Tx building     bitcoinjs-lib v7 (RBF/CPFP construction + PSBT)
+QR codes        BBQr (animated PSBT QR) + qrcode.react
+Deploy          GitHub Pages via GitHub Actions (static export)
 ```
 
-No backend servers. No databases. No custody. Pure frontend + public APIs.
+No backend servers. No databases. No custody. Pure client-side code + public APIs.
 
 ## Architecture
 
@@ -133,7 +130,6 @@ User pastes TXID
 │  Diagnostic Engine   │
 │                      │
 │  mempool.space API   │──→ fee estimates, mempool stats, tx status
-│  Esplora API         │──→ full tx details, UTXO data, scripts
 │                      │
 │  Checks:             │
 │  • RBF signaling     │    (sequence number < 0xfffffffe)
@@ -153,7 +149,7 @@ User pastes TXID
 │  Transaction Builder │
 │                      │
 │  bitcoinjs-lib       │──→ RBF replacement or CPFP child tx
-│  PSBT output         │──→ QR code + raw hex
+│  PSBT output         │──→ QR code + .psbt file + raw hex
 │                      │
 │  User signs in       │
 │  their own wallet    │
@@ -170,7 +166,7 @@ User pastes TXID
 ### Prerequisites
 
 - Node.js 24 (run `nvm use`)
-- pnpm (recommended) or npm
+- pnpm
 
 ### Development
 
@@ -183,65 +179,52 @@ pnpm dev
 
 Open [http://localhost:3000](http://localhost:3000).
 
-### Environment Variables
-
-```env
-# Optional — defaults to public APIs
-NEXT_PUBLIC_MEMPOOL_API=https://mempool.space/api
-NEXT_PUBLIC_ESPLORA_API=https://blockstream.info/api
-
-# Optional — for self-hosted mempool instance
-# NEXT_PUBLIC_MEMPOOL_API=http://your-node:8999/api
-
-# Optional — NWC connection for Lightning payments
-NEXT_PUBLIC_NWC_RELAY=wss://relay.getalby.com/v1
-```
-
 ### Build
 
 ```bash
 pnpm build
-pnpm start
 ```
 
+Static output goes to `out/`. Serve it with any static file server.
+
 ## Pricing
 
+I intend to keep the diagnosis permanently free. V1 is completely free — no payment gating at all. Future versions may charge a small Lightning fee for PSBT generation to sustain the service, but if you run TxFix locally, everything is free forever. It's FOSS.
+
 | Tier | What you get | Cost |
 |------|-------------|------|
-| **Tecky: you run it locally** | Everything, free, forever | $0 | 
-| **Free forever** | Full diagnosis + recommendation. See exactly what's wrong and what to do. | $0 |
-| **Rescue** | Auto-generated PSBT for RBF or CPFP. One-click fix. | 2,000-10,000 sats per rescue |
-| **Copilot** *(V2)* | Watchlist, send time advisor, fee alerts, pre-flight checks. | ~$5/mo via Lightning |
-
-The diagnosis is always free in [txfit.it](https://txfit.it), paid services are intended to sustain the service. If you go for the soverign route you can run this whole FOSS tool locally.
+| **Run it yourself** | Everything, forever | $0 |
+| **Free tier** | Full diagnosis + recommendation | $0 |
+| **Rescue** *(future)* | Auto-generated PSBT for RBF or CPFP | Small Lightning fee |
 
 ## Why Open Source
 
 Bitcoin is a trust-minimized system. A transaction rescue tool should be too.
 
-- **Verify the code** — You can read exactly what txfix does with your TXID. No hidden tracking, no data harvesting, no wallet fingerprinting.
+- **Verify the code** — You can read exactly what TxFix does with your TXID. No hidden tracking, no data harvesting, no wallet fingerprinting.
 - **Self-host** — Run it on your own infrastructure, connect to your own mempool.space instance, keep everything private.
-- **Contribute** — Found an edge case? Better fee estimation logic? Submit a PR, everyone benefits.
+- **Contribute** — Found an edge case? Better fee estimation logic? Submit a PR.
 - **Fork it** — Build something better. I'd love that.
 
-The PSBT generation is fully client-side. Your keys never leave your device. There is nothing to trust.
+PSBT generation is fully client-side. Your keys never leave your device. There is nothing to trust.
 
 ## Roadmap
 
-- [ ] Diagnostic engine (RBF detection, CPFP feasibility, fee analysis)
-- [ ] Animated diagnostic sequence UI
-- [ ] Verdict card with recommendation logic
-- [ ] RBF replacement transaction construction
-- [ ] CPFP child transaction construction
-- [ ] PSBT generation + QR code rendering
-- [ ] Lightning payment via NWC
-- [ ] Rescue receipt / share card
+- [x] Diagnostic engine (RBF detection, CPFP feasibility, fee analysis)
+- [x] Animated diagnostic sequence UI
+- [x] Verdict card with recommendation logic
+- [x] RBF replacement transaction construction
+- [x] CPFP child transaction construction
+- [x] PSBT generation + BBQr animated QR + file download + hex copy
+- [x] Broadcast + live confirmation tracker
+- [x] Rescue receipt / share card
+- [x] GitHub Pages deployment (static export)
+- [ ] Lightning payment via phoenixd
 - [ ] Transaction watchlist with push notifications
 - [ ] Send time advisor (predictive fee forecasting)
 - [ ] Pre-flight check (paste raw tx, get risk score)
-- [ ] Fee alerts (Telegram, email, Nostr DM)
+- [ ] Fee alerts (Telegram, Nostr DM)
 - [ ] Umbrel / Start9 app for self-hosted deployment
-- [ ] Browser extension (inject rescue button into block explorers)
 
 ## License
 
@@ -251,10 +234,9 @@ AGPL
 
 Built on the shoulders of:
 
-- [mempool.space](https://mempool.space) — The best Bitcoin explorer and the API that makes txfix possible
+- [mempool.space](https://mempool.space) — The best Bitcoin explorer and the API that makes TxFix possible
 - [bitcoinjs-lib](https://github.com/bitcoinjs/bitcoinjs-lib) — Rock-solid Bitcoin transaction library
-- [Alby](https://getalby.com) — NWC and bitcoin-connect for frictionless Lightning payments
-- [Samourai Afterburner](https://web.archive.org/web/2023*/afterburner.samourai.io) (RIP) — Proved the concept of a standalone rescue tool
+- [BBQr](https://github.com/nicklockwood/bbqr) — Animated QR encoding for large payloads
 
 ---
 
diff --git a/src/components/PsbtDelivery.tsx b/src/components/PsbtDelivery.tsx
@@ -80,7 +80,7 @@ export function PsbtDelivery({
       <p className="text-xs text-muted text-center border-t border-card-border pt-3">
         Sign this PSBT in your wallet, then come back to broadcast.
         <br />
-        <strong className="text-foreground">We never touch your keys.</strong>
+        <strong className="text-foreground">TxFix never touches your keys.</strong>
       </p>
     </Card>
   );
