PhotonBolt Prolog

Future agents should treat this page as the persistent execution log for the PhotonBolt workspace.

Always read /home/waheed/PhotonBoltXYZ/docs/prolog/index.html before appending new work history if the user mentions prolog.
Do not overwrite old entries. Append a new dated section at the end of Progress Log.
Summarize only completed work, not tentative ideas.
Keep entries concrete: what changed, what was verified, and any important blockers.
If relevant, include commit IDs, deployed URLs, and docs pages created.

You can use prompts like these in future sessions:

Read /home/waheed/PhotonBoltXYZ/docs/prolog/index.html and append today’s completed work after you finish this task.
Update the PhotonBolt prolog after completion. Read the existing prolog first and append, do not replace.
Before closing, add this task summary to docs/prolog/index.html.
Read the prolog and update it with what you completed in this session.

The shortest usable version is: Read the prolog and update it after completion.

Cloned photon-android-wallet, photon-web-wallet, and photonboltxyz into the workspace.
Analyzed the current local Photon stack based on bitcoind, electrs, and rgb-proxy-server.
Documented the stack and the repo mismatch around regtest.
Created analysis.html.

Analyzed which remote servers, proxies, explorers, and canisters are used by the Android and web wallets.
Created servers.html.

Documented how to add the current Photon dev stack without breaking the working web wallet.
Created upgrade.html.
Documented the Bitcoin HTTP adapter plan for regtest.
Created adapter-plan.html.

Implemented backend-profile support in photon-web-wallet.
Preserved current public behavior as the default profile.
Added a Photon regtest-oriented profile hook for future adapter integration.
Refactored Bitcoin HTTP routing helpers to use profile-based endpoint resolution.
Verified TypeScript build with npx tsc -b.
Confirmed the full Vite production build is currently blocked by the machine using Node 18.19.1 while the repo toolchain requires Node 20.19+ or 22.12+.
Committed and pushed the web wallet changes to GitHub: 7b56ad3 (Add backend profile routing for Photon regtest).
Created implementation.html.

Built a self-contained regtest faucet in /home/waheed/PhotonBoltXYZ/faucet with a Node backend, static frontend, and local claim store.
Configured the faucet backend to use the local Bitcoin Core regtest RPC and wallet photon_dev.
Installed the faucet as systemd service photon-faucet.
Configured Nginx for faucet.photonbolt.xyz.
Issued and deployed TLS for https://faucet.photonbolt.xyz.
Verified the public faucet frontend and /api/status endpoint over HTTPS.
Ran a real faucet claim and confirmed the regtest send-and-mine flow works end to end.
Created faucet documentation at docs/faucet.html and linked it from docs/index.html.

Redesigned the live faucet page to a darker console-style layout with compact status rails, request controls, workflow guidance, and recent activity.
Added clipboard paste and Ctrl+Enter submission support to the faucet UI.
Updated the faucet page to accept an address query parameter and prefill the request form.
Fixed photon-web-wallet regtest address derivation so the wallet now generates valid bcrt1... receive addresses instead of invalid cached/testnet-style addresses.
Added regtest-specific faucet handling in the web wallet so regtest users are directed to https://faucet.photonbolt.xyz/ instead of public testnet faucets.
Added a direct Open Photon faucet action in the web wallet Bitcoin receive screen, passing the current regtest address into the faucet URL.
Verified focused wallet tests for Bitcoin address derivation: 7/7 passed.
Confirmed the full web wallet production build remains blocked on this machine by Node 18.19.1 while the repo toolchain requires Node 20.19+ or 22.12+.
Committed and pushed the wallet changes to GitHub: 1b123f5 (Fix regtest receive addresses and faucet flow).

Identified that the web wallet was generating valid bcrt1... regtest addresses but still using the wrong HTTP balance backend unless the Photon regtest profile was selected.
Updated the faucet backend to expose regtest wallet API endpoints compatible with the web wallet’s balance, UTXO, activities, fee, and broadcast flows: /api/address/:address, /api/address/:address/utxo, /api/address/:address/txs, /api/v1/fees/recommended, and /api/tx.
Switched the wallet’s Photon regtest API base to https://faucet.photonbolt.xyz/api.
Added automatic backend profile switching so selecting regtest now forces the wallet to use Photon Dev Regtest defaults.
Verified the live regtest API returns real funded address data for discovery scans and balance reads.
Committed and pushed the wallet changes to GitHub: dc52a6f (Auto-route regtest wallet traffic to Photon stack).

How To Use This Page