PhotonBolt Prolog
Ongoing execution log. This page is intended to keep growing as work is completed.
How To Use This Page
- This file should be updated after meaningful tasks are completed.
- New progress entries should be appended rather than replacing older ones.
- Current path:
/home/waheed/PhotonBoltXYZ/docs/prolog/index.html
- Public URL:
https://docs.photonbolt.xyz/prolog/
Agent Instructions
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.
Prompt Examples
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.
Progress Log
2026-03-13: Repo Collection And Analysis
- 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.
2026-03-13: Docs Structure And Public Access
- Moved HTML reports into the docs folder at
/home/waheed/PhotonBoltXYZ/docs.
- Created the docs landing page at
docs/index.html.
- Configured Nginx for
docs.photonbolt.xyz.
- Issued and deployed TLS for
https://docs.photonbolt.xyz.
2026-03-13: Server Usage Analysis
- Analyzed which remote servers, proxies, explorers, and canisters are used by the Android and web wallets.
- Created
servers.html.
2026-03-13: Upgrade And Adapter Planning
- 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.
2026-03-13: Web Wallet Implementation
- 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.
2026-03-13: Prolog Initialized
- Created the persistent progress log at
docs/prolog/index.html.
- This page should be updated and extended on future tasks.
2026-03-13: PhotonBolt Regtest Faucet Deployed
- 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.
2026-03-13: Faucet UI Redesign And Wallet Integration
- 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).
2026-03-13: Regtest Balance Routing Fixed
- 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).