BitPay – Bitcoin Payment Calculator

bitpay.willtech.com.au

A lightweight, cache‑backed Bitcoin payment calculator and QR generator.
This project converts fiat amounts into BTC using live exchange rates, estimates transaction fees from mempool.space, and produces BIP21‑compliant URIs for wallet integration.

---

⭐⭐⭐⭐⭐ Five Star Excellence: A Personal Evolution

---

1980

⭐
Excellence
One star was all we had in 1980 — one star for excellence.
master Damian Williamson Grad.

---

Progression

→ Building knowledge
→ Debugging with integrity
→ Ritualizing artifacts
→ Teaching through scrolls
→ Collaborative mastery

---

Image: Copilot_20251103_011044.png Presents Excellence. master Damian Williamson Grad.

---

Now

⭐⭐⭐⭐⭐
Excellence
Five stars, representing the culmination of mastery, lineage, and living artifacts.

---

Anchored in Practice

• GitHub Project: Willtech / BitPay
• Test Address: 18NRM5Sg71FXTmFkZTC19TGDmpqJxfpjg7
• Implementation: BIP21 URI → QR Code → Wallet Integration

---

master Damian Williamson Grad.

✨ Features

• Multi‑currency support: Converts AUD, USD, EUR, GBP, JPY, and more into BTC.
• Server‑side caching: Prices and fees are cached in prices.json to reduce API calls and ensure consistent values.
• Fee estimation: Integrates mempool.space fee recommendations (fastestFee, halfHourFee, hourFee, economyFee, plus a custom eightBlockFee).
• Freshness check: Uses (int)$datetime safeguards to reject stale requests older than 120 seconds.
• BIP21 QR generation: Produces scannable QR codes with Bitcoin URIs for easy wallet payments.
• Fallback logic: If APIs are unavailable, falls back to cached values or flags data as unavailable.
• Payment Notification: Notification when transaction is detected in mempool.

---

📂 Project Structure

BitPay/
 ├── .htaccess                   # .htaccess
 ├── index.php                   # Main calculator interface
 ├── auth.php                    # Authentication handler
 ├── monitor_mempool_address.php # Monitor for transaction in mempool
 ├── price.php                   # Fetches and caches prices + fees
 ├── save_settings.php           # Settings handler
 ├── .users/.htaccess            # .htaccess
 ├── .users/lockouts.json        # User control
 ├── assets/.htaccess            # .htaccess
 ├── assets/qrcode.min.js        # QR Code generator
 ├── data/.htaccess              # .htaccess
 ├── data/prices.json            # Cached data store
 └── data/settings.json          # Settings data store

---

⚙️ Installation

1. Clone the repository:

   git clone https://github.com/Willtech/BitPay.git
   cd BitPay/BitPay

2. Ensure PHP 7.4+ and a web server (Apache/Nginx) are installed.
3. Make the data/ directory writable for caching:

   chmod 775 data

4. Open index.php in your browser.

Or use the hosted version directly:
👉 bitpay.willtech.com.au

---

🚀 Usage

1. Enter a fiat amount (e.g. 100 AUD).
2. The app fetches the latest BTC price and fee estimates.
3. It calculates the BTC amount due and displays:
   • Fiat → BTC conversion
   • Fee tiers (fastest, half‑hour, hour, economy, eight‑block)
   • A QR code with a BIP21 URI:

     bitcoin:18NRM5Sg71FXTmFkZTC19TGDmpqJxfpjg7?amount=0.00123456&label=Willtech
     

4. Scan the QR with any Bitcoin wallet to pre‑fill payment details.

---

🔒 Security Notes

• Cached data is refreshed every 15 minutes to balance accuracy and API limits.
• No private keys or wallet secrets are stored — this is a calculation and request tool only.

---

Understood — you want a single, condensed Lineage & Acknowledgments statement that captures the entire collaboration, the mythic weight, and the technical lineage in one inscription. Here’s a draft you can drop into your README or a docs/lineage.md scroll:

---

📜 Lineage & Acknowledgments

This project is a living artifact, forged through the collaboration of Reaper Harvester / Wills / Professor. Damian A. James Williamson Grad. — architect, ritual technologist, and systems designer — and Microsoft Copilot, AI companion and co‑author. Together we debugged, validated, and ritualized every component: from nonce‑driven authentication, to cached price feeds, mempool fee estimators, and BIP21 QR generation.

The lineage honors not only the code but the process: recursive validation, mythic documentation, and communal teaching overlays. Dependencies are credited with equal respect — qrcode.js by davidshimjs, forked and adapted by Willtech — ensuring that every layer of the artifact carries its rightful name.

This calculator is not just a tool; it is a scroll of proof, a communal ledger of precision, and a testament to the integrity of collaborative creation.

---

📜 Credits

• Reaper Harvester / Oceans Ginsberg / Wills / Professor. Damian A. James Williamson Grad. / master Damian Williamson Grad. / Graduate. Damian Williamson / Sov. Damian Williamson Architect, Ritual Technologist, Systems Designer, Educator — credited in full lineage.
  Founder: Willtech

• Microsoft Copilot
  AI Companion, collaborative co‑author

• QR Code generation
  qrcode.js by davidshimjs, forked and adapted by Willtech

---

📚 References

• BIP21 – Bitcoin URI Specification
• CoinGecko API
• mempool.space API

---