littleshop/BTCPAY_EXTERNAL_NODES_STATUS.md
SilverLabs DevTeam 73e8773ea3 Configure BTCPay with external nodes via Tor
- Set up Tor container for SOCKS proxy (port 9050)
- Configured Monero wallet with remote onion node
- Bitcoin node continues syncing in background (60% complete)
- Created documentation for wallet configuration steps
- All external connections routed through Tor for privacy

BTCPay requires manual wallet configuration through web interface:
- Bitcoin: Need to add xpub/zpub for watch-only wallet
- Monero: Need to add address and view key

System ready for payment acceptance once wallets configured.
2025-09-19 12:14:39 +01:00

113 lines
4.1 KiB
Markdown

# BTCPay External Nodes Configuration Status
## ✅ Configuration Completed
### Infrastructure Setup
1. **Tor Container**: ✅ Running and connected (port 9050)
2. **Bitcoin Node**: ✅ Running but only 60% synced (continuing in background)
3. **Monero Remote Wallet**: ✅ Running with Tor onion node connection
4. **BTCPay Server**: ✅ Running and accessible
### Current Configuration
#### Tor Network
- **Status**: Fully operational
- **SOCKS Port**: 9050
- **Container**: tor (running)
- **Bootstrap**: 100% complete
#### Bitcoin Setup
- **Local Node**: Running (60% synced, July 2022)
- **Container**: btcpayserver_bitcoind
- **Pruned Mode**: 10GB max storage
- **Will sync in background**: ~2-3 weeks to complete
#### Monero Setup
- **Remote Node Used**: `zbjkbsxc5munw3qusl7j2hpcmikhqocdf4pqhnhtpzw5nt5jrmofptid.onion:18089`
- **Connection**: Via Tor SOCKS proxy
- **Container**: monero_wallet_remote
- **RPC Port**: 18082
- **Credentials**: btcpay:btcpay
## ⚠️ Manual Steps Required in BTCPay Admin
To complete the setup and start accepting payments, you need to configure wallets through the BTCPay web interface:
### For Bitcoin (Immediate Setup - No Sync Required)
1. **Login to BTCPay**: https://thebankofdebbie.giize.com
2. **Navigate to**: Store Settings → Wallets → Bitcoin
3. **Choose Setup Method**:
- Click "Connect an existing wallet"
- Select "Enter extended public key"
4. **Enter Your xpub/zpub**:
- For testing: `xpub661MyMwAqRbcFW31YEwpkMuc5THy2PSt5bDMsktWQcFF8syAmRUapSCGu8ED9W6oDMSgv6Zz8idoc4a6mr8BDzTJY47LJhkJ8UB7WEGuduB`
- For production: Generate from your hardware wallet or Bitcoin Core
5. **Configure Derivation**:
- Account Key Path: `m/84'/0'/0'` (for native segwit)
- Or use Legacy: `m/44'/0'/0'`
6. **Save Configuration**
### For Monero (Requires View Key)
1. **Navigate to**: Store Settings → Wallets → Monero
2. **Configure Wallet**:
- Primary Address: Your Monero address
- View Key: Your private view key (for incoming payment detection)
3. **Save Configuration**
## Alternative: Use External Services (Fastest)
If you need immediate operation without any node syncing:
### Option 1: BTCPay Server Demo (Immediate)
1. Use BTCPay's demo server: https://testnet.demo.btcpayserver.org
2. Create account and store
3. Update LittleShop configuration with new credentials
### Option 2: Third-Party BTCPay Host
- Voltage: https://voltage.cloud
- LunaNode: https://www.lunanode.com
- BTCPayJungle: https://btcpayjungle.com
### Option 3: Electrum Personal Server
1. Install Electrum Personal Server locally
2. Connect it to public Electrum servers via Tor
3. Configure BTCPay to use your EPS instance
## Current Payment Status
- **Bitcoin**: ❌ Requires wallet configuration (xpub/zpub)
- **Monero**: ❌ Requires wallet configuration (address + view key)
- **API Connection**: ✅ Working
- **Invoice Creation**: Will work after wallet setup
## Monitoring Commands
```bash
# Check Bitcoin sync progress
ssh -i /silverlabs/src/LittleShop/Hostinger/vps_hardening_key -p 2255 sysadmin@thebankofdebbie.giize.com \
"docker logs btcpayserver_bitcoind --tail 5 | grep progress"
# Check Tor status
ssh -i /silverlabs/src/LittleShop/Hostinger/vps_hardening_key -p 2255 sysadmin@thebankofdebbie.giize.com \
"docker logs tor --tail 5"
# Check Monero wallet
ssh -i /silverlabs/src/LittleShop/Hostinger/vps_hardening_key -p 2255 sysadmin@thebankofdebbie.giize.com \
"docker logs monero_wallet_remote --tail 5"
# Test BTCPay connection
curl https://thebankofdebbie.giize.com/api/v1/stores \
-H "Authorization: token db920209c0101efdbd1c6b6d1c99a48e3ba9d0de"
```
## Summary
The infrastructure is ready with external node connectivity via Tor. However, BTCPay requires wallet configuration through its web interface to start accepting payments. You can either:
1. **Configure watch-only wallets** (xpub for Bitcoin, view key for Monero) - Immediate
2. **Wait for local Bitcoin sync** to complete (~2-3 weeks) - Most private
3. **Use external BTCPay service** temporarily - Fastest
The system is designed for privacy with all external connections routed through Tor.