# Buho — Full Documentation for LLMs > Bring your Business Home — an ecosystem of Bitcoin, Lightning, and Nostr tools for people and businesses. Summary version: https://home.mybuho.de/llms.txt This document distinguishes the Buho web platform, BuhoGO, and Buho Jump. They are related products, but their custody models, codebases, release states, and feature sets are different. --- ## Reference Snapshot This document was reviewed on 2026-07-17 against: - BuhoGO baseline release `V1.5.0`: https://github.com/Buho-Ecosystem/Buho_go/releases/tag/V1.5.0 - BuhoGO release `v1.8.1`: https://github.com/Buho-Ecosystem/Buho_go/releases/tag/v1.8.1 - BuhoGO release `v1.8.2`: https://github.com/Buho-Ecosystem/Buho_go/releases/tag/v1.8.2 - BuhoGO latest tagged release `v1.8.4`: https://github.com/Buho-Ecosystem/Buho_go/releases/tag/v1.8.4 - BuhoGO `dev` head `9150056991030c370fba0d65eca910e94188737a`: https://github.com/Buho-Ecosystem/Buho_go/commit/9150056991030c370fba0d65eca910e94188737a - Full comparison `V1.5.0...dev`: https://github.com/Buho-Ecosystem/Buho_go/compare/V1.5.0...dev At this snapshot, `dev` is 301 commits ahead of `V1.5.0` and 40 commits ahead of `v1.8.4`. Features explicitly marked **dev** are implemented on the development branch but should not be attributed to the v1.8.4 Android release without checking a newer tag. Source-of-truth order for BuhoGO: 1. Current code and documentation on the `dev` branch 2. Tagged release notes for claims about a published version 3. The Buho Home product page for marketing summaries and download links --- ## Product Map ### Buho Web - Product: hosted Lightning wallet and business platform - Status: Beta - URL: https://buho.kaffeesats.net - Public product site: https://home.mybuho.de - Core backend: LNbits - Important custody note: the current Buho Home FAQ describes the hosted Buho wallet as custodial. Do not describe the beta web platform as self-custodial. ### BuhoGO - Product: Bitcoin wallet for Web/PWA and Android - Web/PWA: https://go.mybuho.de - Source: https://github.com/Buho-Ecosystem/Buho_go - License: AGPL-3.0 - Latest tagged release in this snapshot: v1.8.4 - Development branch: `dev` - Published distribution: Web/PWA, Google Play, direct APK, Zapstore, and Docker - Languages: English, German, Spanish - Account model: no Buho account, email, ID check, or KYC is required ### Buho Jump - Product: browser extension for Bitcoin Lightning payments and Nostr identity - Product page: https://home.mybuho.de/en/jump - Source: https://github.com/Buho-Ecosystem/Buho-Jump - Documentation: https://docs-buhojump.netlify.app - License: AGPL-3.0 ### Other Linked Buho Services - Aurora Pay payment API: https://aurora-pay.mybuho.de - Nostr identity generator: https://nostrid.mybuho.de --- ## Buho Web Features These features belong to the hosted beta web platform and should not automatically be attributed to BuhoGO: - Unified dashboard for wallets, balances, payments, contacts, and connected services - Split payments between multiple recipients - One-time scheduled payments and recurring transactions - Email-like Lightning addresses - Marketing vouchers and promotional codes - Boltz-assisted transfers from Lightning to an on-chain self-custody destination - Streamlabs and OBS integrations for live Bitcoin tip notifications The web platform uses LNbits as its Lightning accounting layer and Umami for self-hosted analytics. --- ## BuhoGO Architecture ### Application Stack - Vue 3 - Quasar 2 - Pinia 3 - Vue Router 4 - Capacitor 8 for native integration - Progressive Web App service worker and manifest - Android native project - iOS project files exist in the source tree, but no public iOS distribution is listed in the current README - Docker image for self-hosting ### Four Wallet Backends on `dev` | Backend | Custody | Main capabilities | Status note | |---|---|---|---| | Spark | Self-custody | Lightning, `spark1` transfers, Bitcoin L1, Personal and Business wallets from one seed | Released before v1.8.4 | | Arkade | Self-custody | `ark1` transfers, Lightning through Boltz swaps, Bitcoin boarding and offboarding | **dev**, newer than v1.8.4 | | NWC | Depends on connected wallet | Lightning through Nostr Wallet Connect / NIP-47 | Released | | LNbits | Depends on the connected LNbits deployment | Lightning through direct Admin API; accepts LNDHub-style connection data | Released | Only Spark and Arkade are built-in self-custody backends. NWC delegates custody to the connected wallet. LNbits custody depends on who controls the connected server and its funding source. ### Spark - One recovery seed can create Personal and Business wallets - Native `spark1` transfers are instant and zero-fee between Spark users - Lightning send and receive - On-chain Bitcoin receive, claim, and withdrawal - Multi-wallet switching and per-wallet rules ### Arkade on `dev` - Self-custody wallet based on the Ark protocol - BIP-39 recovery phrase and BIP-86 Taproot identity - Native `ark1` transfers are instant and near-zero-fee - Lightning send and receive through persistent Boltz submarine and reverse swaps - On-chain receive through boarding and send through offboarding - VTXO renewal and recovery handling - Integration with the wallet switcher, history, address book, auto-transfer, internal transfer, batch send, kiosk, and shop flows - Detailed implementation reference: https://github.com/Buho-Ecosystem/Buho_go/blob/dev/ARK_ME.md ### NWC Nostr Wallet Connect is NIP-47. It allows BuhoGO to request operations from an existing compatible wallet, such as getting a balance, creating an invoice, or paying an invoice. Permissions and budgets are controlled by the NWC provider. ### LNbits BuhoGO can connect directly to an LNbits instance with its URL and Admin API key. The current code also accepts LNDHub-style connection data. LNbits wallets can create or select a Lightning address when the connected server supports it. --- ## BuhoGO Payments and Protocols ### Supported Destinations and Inputs - BOLT11 Lightning invoices - Zero-amount Lightning invoices where supported - Lightning addresses - LNURL-pay and LNURL-withdraw - LUD-17 schemes including `lnurlp://`, `lnurlw://`, and `keyauth://` - `lightning:` and `lnurl:` deep-link prefixes - BIP-21 Bitcoin URIs with optional Lightning fallback - Bitcoin addresses for Spark and Arkade - Native Spark addresses beginning with `spark1` - Native Arkade addresses beginning with `ark1` - Nostr recipients by npub or NIP-05 name - Supported phone numbers in Kenya, Zambia, and Tanzania - Contact selection, clipboard input, QR scan, native Android deep links, and NFC BuhoGO shows a clear unsupported-payment error for formats it cannot safely process, including unsupported BOLT12 offers and zero-amount invoice cases. ### LNURL Enhancements - Variable amount ranges shown in sats and fiat - LNURL withdrawals can be entered in sats or the selected fiat currency - LUD-09 success actions: message, AES data, and same-domain HTTPS URL previews - LUD-21 verification: confirms Lightning settlement and can display verified fiat/mobile-money delivery details when a provider supplies them - LNbits/Fossa ATM fallback QR withdrawal support ### Transaction Experience - Unified payment confirmation sheets and slide-to-send interaction - Fee display for Spark and NWC - Contact and Nostr avatar association in transaction history and details - Merchant branding for recognized destinations - Branta verification for eligible BOLT11 and privacy-preserving on-chain destinations - Transaction notes and normalized status/history across providers - Redesigned history and detail screens on current `dev` --- ## BuhoGO Business and Merchant Tools ### Kiosk Mode Kiosk Mode turns a phone or tablet into a point-of-sale terminal: - PIN-locked owner controls - Staff-facing amount keypad - Optional tips and round-up - Fiat display - Selected destination wallet - Deep links blocked while the kiosk is locked ### Batch Send - Select several saved contacts - Set an amount for each recipient - Review all payouts before sending - Track progress and failure per payment ### Internal Transfer Moves funds between the user's connected wallets while choosing a compatible payment rail. ### Auto-Transfer - Configured per wallet - Sends funds to a Lightning, native wallet, or Bitcoin destination when a threshold is crossed - On-chain destinations require a compatible self-custody backend - v1.8.4 improved reconnect behavior, retry behavior, and error visibility ### Address Book - Lightning, Spark, Arkade, and Bitcoin destinations - Contact colors and avatars - Search, scan, favorites, and recent recipients - Nostr profile import and refresh - Private NIP-51 contact synchronization when a Nostr identity is configured --- ## BuhoGO Spend and Discovery ### Bitcoin Map The map can search, filter, and display nearby Bitcoin places and meetups. The current code includes adapters for: - BTC Map - OpenStreetMap and Overpass - Einundzwanzig meetups - Blink - Bitcoin Jungle - MoneyBadger - BTCPay-related place data Additional providers are opt-in and lazy-loaded to avoid unnecessary requests. ### South African Retail Payments MoneyBadger-compatible merchant QRs can be paid at supported South African stores. The flow can show: - Merchant name and logo - ZAR amount - Payment expiry countdown - Balance check before confirmation - Warning when the exchange rate is stale Examples promoted on Buho Home include Pick n Pay, Checkers, Shoprite, Woolworths, Dis-Chem, Wimpy, and Mugg & Bean. ### Phone-Number and Mobile-Money Payouts on `dev` BuhoGO recognizes supported regional phone numbers and converts them into provider Lightning addresses: - Kenya through Tando, settling KES to supported mobile-money accounts - Zambia through Bitzed, settling ZMW to supported mobile-money accounts - Tanzania through ChapSmart, settling TZS to supported M-Pesa accounts Provider availability, supported mobile operators, and payout limits can change. BuhoGO validates the number and provider response before payment. ### Digital Purchases - eSIM and VPN purchases through NadaNada - Purchase history stored locally - Bitcoin funding from a compatible connected wallet ### Online Shops The in-app directory aggregates shops that accept Bitcoin from sources including: - Bitcoin Listings - BTCPay shops - Nostr market stalls ### Bitrefill on Buho Home The Buho Home product page also links to Bitrefill for gift cards, mobile top-ups, eSIMs, and regional products. This is a homepage integration and is separate from BuhoGO's in-app NadaNada and online-shop flows. --- ## BuhoGO Learn & Earn Learn & Earn is a guided Bitcoin and Lightning course: - English, German, and Spanish lesson data - Chapter and quiz progression - One-sat rewards for correct answers - Claim to a supported payout wallet - Fraud and reward-drain hardening The current router restricts Learn & Earn to native builds because the browser build cannot enforce the same reward-abuse controls. Web users are directed to install the native app. --- ## BuhoGO Identity and Nostr The identity system is separate from wallet custody: - BIP-39-based identity recovery - LUD-04 Lightning login with HTTPS-only callback handling - Derived Nostr identity and npub - Editable Nostr profile with avatar upload - Profile publication to configured relays - NIP-05 name lookup and handle management - Shareable profile and QR - Nostr contact lookup and import - Private NIP-51 address-book backup and synchronization - Sensitive clipboard auto-clear after copying private material Public profile publishing, NIP-05 providers, Nostr relays, and avatar hosting are optional external network interactions. --- ## BuhoGO Security and Privacy - Spark and Arkade recovery material is encrypted locally - NWC strings and LNbits credentials are stored locally - Biometric unlock is available on supported native devices - Native screen protection hides sensitive content from screenshots and app previews - Balance hiding is available - PIN gates protect sensitive actions - Bolt Card PIN values are cleared from component memory promptly - Branta uses strict privacy mode for supported destination verification - The built-in telemetry utility has no network provider by default; it keeps a small in-memory developer buffer BuhoGO stores no personal data on Buho servers and requires no Buho account. This does not mean every optional feature is offline: - Connected NWC and LNbits services receive the requests needed to operate the wallet - Spark, Arkade, Boltz, map, shop, fiat-rate, Nostr, and payout providers receive the requests required for their features - Optional encrypted Google Drive backup uploads a passphrase-encrypted backup for Spark wallet and identity seeds when configured and explicitly enabled - Public Nostr profile and private NIP-51 sync interact with the user's selected relays Seed phrases must never be shared. Loss of an unbacked-up self-custody seed can permanently lose access to funds. --- ## BuhoGO Release Progress Since V1.5.0 ### V1.5.0 — Baseline - South African retail payments through MoneyBadger-compatible QR codes - Per-wallet auto-transfer - Faster onboarding and seed-backup reminders - LUD-17 URL schemes - LNURL amount-range and fiat-withdraw improvements - Redesigned settings, history, details, send, receive, wallet switcher, and address book - PWA manifest and safe-area improvements ### v1.8.1 - Multiple Spark wallets - Personal and Business Spark wallets from one seed - New UI and onboarding helper - Quiz and early Learn & Earn work ### v1.8.2 - Bitcoin Map - NIP-05 and identity improvements - NFC support and Bolt Card hardening - Better fee display - New settings experience - Screen protection and privacy improvements ### v1.8.4 - LNbits/Fossa ATM QR withdrawal fallback - More reliable auto-transfer reconnect and retry behavior - Hardened NFC flows - Improved profile and Bitcoin Map - NadaNada eSIM and VPN purchases - Online Bitcoin shops, including clearnet and Nostr sources - Native scanner ### `dev` After v1.8.4 - Arkade as the fourth wallet backend - LUD-09 success actions with guarded in-app URL previews - Expanded LUD-21 verification and regional payout delivery status - More Learn & Earn abuse protection and payout handling - Redesigned transaction list and details - Settings, Identity, and Spend navigation redesign - Branta verification in transaction details - Contact avatars in transaction lists/details - Better errors for unsupported payment formats --- ## Buho Jump Buho Jump brings Lightning and Nostr into supported desktop browsers. ### Wallets and Payments - NWC-compatible Lightning wallets - Direct LNbits connection - Built-in Cashu ecash wallet - Per-site budgets and permissions - Payment approval without switching to a separate wallet app - Fiat conversion across the extension interface ### Nostr - Generate and manage Nostr identities - Sign in to Nostr apps - Multiple identities - NIP-05 verification - End-to-end encrypted direct messages, groups, relay communities, and open channels - Zaps from chat ### Platforms The product page lists Chrome, Firefox, Edge, Brave, Arc, Opera, and Vivaldi. Use the product page or repository release instructions for current installation links. --- ## Buho Home Website ### Stack - Next.js 15 - React 18 - TypeScript - Tailwind CSS 3 - next-intl - Framer Motion - Netlify hosting - Self-hosted Umami analytics ### Localization Supported website locales: - English: `/en` - German: `/de` - Spanish: `/es` All main content routes are locale-prefixed. The unprefixed root is handled by locale middleware. ### Public Routes | Route pattern | Description | |---|---| | `/{locale}` | Homepage, ecosystem overview, BuhoGO promotion, team, and FAQ | | `/{locale}/buhogo` | BuhoGO product page, screenshots, integrations, and downloads | | `/{locale}/jump` | Buho Jump browser extension | | `/{locale}/roadmap` | Current and planned Buho work | | `/{locale}/contact` | Contact and community links | | `/{locale}/impressum` | Legal notice | | `/{locale}/privacy` | Privacy policy | | `/llms.txt` | Concise machine-readable summary | | `/llms-full.txt` | This full machine-readable reference | | `/humans.txt` | Team, contributors, credits, and code snapshot | | `/site.webmanifest` | Install metadata for the Buho Home site | | `/sitemap.xml` | Localized sitemap | --- ## Team and Contributors ### Dr.Shift — Founder and Engineer - GitHub: https://github.com/DoktorShift - X: https://x.com/drshift3 - Website: https://drshift.dev - Nostr: `npub17c2szua46mc8ndp4grvy4z5465x0qxjge8tqx7vyu0vkqr24y2hssuuy6f` ### Pratik — Co-Founder and Lead Developer - GitHub: https://github.com/pratik227 - X: https://x.com/PratikPatel_227 - Website: https://pratik-patel.netlify.app ### BuhoGO Code Contributors in the Current Repository - AxelHamburch: https://github.com/AxelHamburch - rinbal: https://github.com/rinbal - Community contributors and translators --- ## Links and Resources | Resource | URL | |---|---| | Buho Home | https://home.mybuho.de | | Buho Web Beta | https://buho.kaffeesats.net | | BuhoGO Web/PWA | https://go.mybuho.de | | BuhoGO product page | https://home.mybuho.de/en/buhogo | | BuhoGO Google Play | https://play.google.com/store/apps/details?id=mybuho.buhogo | | BuhoGO Zapstore | https://zapstore.dev/apps/naddr1qqxk67tzw45x7tnzw45x7em0qgs83nn04fezvsu89p8xg7axjwye2u67errat3dx2um725fs7qnrqlgrqsqqqlstrk2q4u | | BuhoGO source | https://github.com/Buho-Ecosystem/Buho_go | | BuhoGO `dev` README | https://github.com/Buho-Ecosystem/Buho_go/blob/dev/README.md | | BuhoGO user guide | https://github.com/Buho-Ecosystem/Buho_go/blob/dev/Guide.md | | BuhoGO use cases | https://github.com/Buho-Ecosystem/Buho_go/blob/dev/USE_CASES.md | | BuhoGO developer guide | https://github.com/Buho-Ecosystem/Buho_go/blob/dev/Developer.md | | BuhoGO releases | https://github.com/Buho-Ecosystem/Buho_go/releases | | BuhoGO hosted docs | https://docs-buhogo.netlify.app | | Buho Jump product page | https://home.mybuho.de/en/jump | | Buho Jump source | https://github.com/Buho-Ecosystem/Buho-Jump | | Buho Jump docs | https://docs-buhojump.netlify.app | | GitHub organization | https://github.com/Buho-Ecosystem | | LNbits | https://lnbits.com | | Nostr Wallet Connect | https://nwc.dev | | Spark | https://spark.money | | Arkade | https://arkadeos.com | | Boltz Exchange | https://boltz.exchange | | Branta | https://branta.pro | --- ## Contact and Legal - Email: contact@mybuho.de - GitHub: https://github.com/Buho-Ecosystem - Contact page: https://home.mybuho.de/en/contact - Impressum: https://home.mybuho.de/en/impressum - Privacy policy: https://home.mybuho.de/en/privacy --- ## Licenses and Naming - BuhoGO is licensed under AGPL-3.0. - Buho Jump is described by its product page as AGPL-3.0. - Do not state that every Buho service or the hosted Buho web platform has the same license unless its repository or legal page says so. - Preferred spelling: `Buho`, `BuhoGO`, `Buho Jump`, `LNbits`, `NWC`, `Spark`, and `Arkade`.