Skip to content

Confirm note claim before downloading note PNG (mobile fix)#366

Merged
kojibai merged 1 commit intomainfrom
codex/investigate-mobile-claimed-status-issue
Feb 1, 2026
Merged

Confirm note claim before downloading note PNG (mobile fix)#366
kojibai merged 1 commit intomainfrom
codex/investigate-mobile-claimed-status-issue

Conversation

@kojibai
Copy link
Copy Markdown
Owner

@kojibai kojibai commented Feb 1, 2026

Motivation

  • Mobile download flows could navigate away before the note-claim registry update ran, causing the UI to not reflect a freshly claimed note; the fix ensures the claim confirmation runs before download and is robust to mobile navigation.

Description

  • Added a single-run guard (confirmIssued / confirmOnce) and call it before triggering the PNG download and in the finally block inside onDownloadNotePng in src/pages/VerifyPage.tsx, ensuring confirmNoteSend() executes at most once and prior to downloads.

Testing

  • No automated tests were run.

Codex Task

@vercel
Copy link
Copy Markdown

vercel bot commented Feb 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
phi-network-5aii Ready Ready Preview, Comment Feb 1, 2026 2:06am

Request Review

@kojibai kojibai merged commit f661d5f into main Feb 1, 2026
1 of 2 checks passed
kojibai added a commit that referenced this pull request Feb 1, 2026
ΦNet Release Notes — v43.0.0

Theme: Exhale Note global-claim propagation is now PWA-proof (without breaking desktop).

🔥 Highlights

Global claim propagation is fixed end-to-end for Exhale Notes (including PWA). Claims now propagate reliably even when the iOS “Save / Share / Download” sheet temporarily background-suspends or refreshes the app.

Sigil Explorer API routing is hardened. The client now avoids the “POST/GET /sigils/* → 404 on the static host” loop that was hammering retries and cascading into state loss. This is the v42.9.14 hardening that stabilized cleared-cache + PWA flows.

Note rotation is now deterministic: when you download a fresh note PNG (child), the parent is confirmed/claimed correctly (and the child stays unclaimed).

✅ What Changed
PWA + Mobile Reliability (the core fix)

Fix global claim propagation in PWA (merged) and ship PWA-specific claim reliability work.

Probe inhale online status in PWA to prevent false “offline” behavior during iOS lifecycle transitions.

Fix PWA note claim propagation so claim state survives the download/save lifecycle and returns globally.

VerifyPage: Note download / claim timing (no more “claimed on desktop, not on mobile/PWA”)

Confirm parent note when downloading fresh PNG (this is the canonical behavior: parent gets claimed after minting child).

Fix note claim confirmation for downloaded PNGs (tightens metadata + registry state).

Fix note download claim timing (prevents lifecycle races).

Trigger note download on pointer events (prevents unmount/gesture timing issues on mobile).

Allow note download while claiming / after immediate claim (removes deadlocks and “stuck” states).

Update note claim state on download (ensures registry + UI reflect the new truth immediately).

Mobile regressions explicitly handled

Fix mobile note claim update before download (attempted) and then reverted when it introduced incorrect behavior.

Avoid claiming rotated fresh exhale notes (prevents accidentally claiming the newly minted child).

Prevent re-downloading claimed exhale notes on mobile (stops repeat-spend UX).

Version trail included in this release package

This release consolidates the v42.9.x stabilization train through v42.9.14 into a single “this is now stable” drop.

🧠 Why it broke (the real root cause)

What you saw (“works in Safari, breaks in PWA when the save sheet pops”) is classic iOS PWA lifecycle behavior: the standalone app can be backgrounded, suspended, or reloaded during the system download/save UI. If your /sigils/* calls temporarily routed to the wrong base (static host → 404), the inhale/registry flush never completed, and the claim never made it into the durable registry—so after the refresh, the UI looked “unclaimed.”
This release fixes that by hardening the API client routing + PWA-specific claim/inhale propagation paths.

Deployment Notes

PWA users: after updating, fully close the PWA and relaunch once to ensure the latest service worker + assets are active (this matters specifically for the “save sheet” lifecycle).

If you host on a non-API domain (e.g., static frontend): the /sigils/* client must resolve to the Lah-Mah-Tor API domains (or a real configured proxy). This release’s API client hardening is what prevents the 404 retry storm.

Full Changelog (by PR / commit)

#384 fix-global-claim-propagation-in-pwa

“Probe inhale online status in PWA”

“Fix PWA note claim propagation”

#373 fix-regression-in-verifypage.tsx

“Confirm parent note when downloading fresh PNG”

“Fix note claim confirmation for downloaded PNGs”

#367 revert mobile claimed-status investigation

#366 investigate mobile claimed status issue

#365 fix-download-button-unmounting-issue

#364 handle immediate claim + download flow

#362 fix-mobile-exhale-note-claimed-status
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant