From 18a9dfae4c716cf1f91decec5fea2b2bd97dcafe Mon Sep 17 00:00:00 2001 From: Russell Ballestrini Date: Tue, 30 Sep 2025 22:28:44 -0400 Subject: [PATCH] Simplify Monero recovery procedures and remove automated health checks - Remove 'Automated Health Checks' section - redundant with make commands - Simplify recovery procedures to match Dogecoin documentation style - Remove bash script examples and implementation details - Keep focus on essential backup/recovery information --- docs/DOGECOIN.md | 71 ++---------------------------------------------- docs/MONERO.rst | 39 ++------------------------ 2 files changed, 5 insertions(+), 105 deletions(-) diff --git a/docs/DOGECOIN.md b/docs/DOGECOIN.md index 9c90a65..bb97259 100644 --- a/docs/DOGECOIN.md +++ b/docs/DOGECOIN.md @@ -272,7 +272,7 @@ chown -R dogecoin:dogecoin /home/dogecoin/.dogecoin/ **Shop Configuration:** -Each shop configures their own cold wallet address through the web interface. The system validates Dogecoin addresses (must start with 'D' and be 34 characters) before accepting them. +Each shop configures their own cold wallet address through the web interface. The system performs basic format checking but cannot verify the address is accessible - test with small amounts before relying on auto-sweep. **Auto-Sweep System:** @@ -291,33 +291,8 @@ make dogecoin-node # Start pruned node ``` **Automated Health Checks:** -```bash -#!/bin/bash -# dogecoin_health_check.sh -# Check if dogecoind is running -if ! dogecoin-cli getblockchaininfo >/dev/null 2>&1; then - echo "CRITICAL: Dogecoin daemon not responding" - exit 2 -fi - -# Check synchronization -blocks=$(dogecoin-cli getblockchaininfo | grep '"blocks"' | cut -d: -f2 | tr -d ' ,') -headers=$(dogecoin-cli getblockchaininfo | grep '"headers"' | cut -d: -f2 | tr -d ' ,') - -if [ "$blocks" != "$headers" ]; then - echo "WARNING: Dogecoin not fully synced (blocks: $blocks, headers: $headers)" - exit 1 -fi - -# Check wallet connectivity -if ! dogecoin-cli getwalletinfo >/dev/null 2>&1; then - echo "WARNING: Wallet not accessible" - exit 1 -fi - -echo "OK: Dogecoin healthy, blocks: $blocks" -``` +Use `make dogecoin-status` to check node health and sync status. The crypto watcher service monitors payment processing health automatically. ### Log Analysis @@ -381,48 +356,8 @@ tail -f logs/crypto_watcher.log | grep DOGE ``` **Recovery Procedures:** -```bash -# Regular wallet backups are critical -# Store wallet.dat backups in secure location -# Recovery requires restoring wallet.dat and restarting dogecoind -``` -### Emergency Procedures - -**Emergency Fund Sweep:** -```bash -# If server compromise is suspected -# Sweep ALL wallet funds to emergency cold storage - -EMERGENCY_DOGE_ADDRESS="your_emergency_cold_wallet_address" - -# Get total spendable balance -balance=$(dogecoin-cli getbalance) - -if [ "$(echo "$balance > 0" | bc -l)" = "1" ]; then - # Send all funds to emergency address - tx_hash=$(dogecoin-cli sendtoaddress "$EMERGENCY_DOGE_ADDRESS" "$balance" "" "" true) - echo "Emergency sweep transaction: $tx_hash" - echo "Amount swept: $balance DOGE" -else - echo "No funds to sweep" -fi -``` - -**Wallet Recovery:** -```bash -# If wallet is corrupted or lost -# 1. Stop dogecoind -dogecoin-cli stop - -# 2. Restore from backup -cp /secure/backup/latest-wallet.dat ~/.dogecoin/wallet.dat - -# 3. Restart and rescan -dogecoind -sleep 10 -dogecoin-cli rescanblockchain 0 -``` +Regular wallet.dat backups are critical. Store backups in secure, offline locations. For emergency sweeps, use `COLD_WALLET_ADDRESS=
make sweep-all-doge`. ## Advanced Configuration diff --git a/docs/MONERO.rst b/docs/MONERO.rst index 3a0dcee..3088980 100644 --- a/docs/MONERO.rst +++ b/docs/MONERO.rst @@ -310,7 +310,7 @@ Cold Storage Integration **Shop Configuration:** -Each shop must configure their own cold wallet address for automatic sweep destinations through the web interface. The system validates Monero addresses (95 or 106 characters starting with '4'). +Each shop must configure their own cold wallet address for automatic sweep destinations through the web interface. The system performs basic format checking but cannot verify the address is accessible - ensure you control the wallet before configuring. **Auto-Sweep System:** @@ -329,9 +329,6 @@ Wallet Health Monitoring make monero-transactions # View recent transactions make crypto-watcher # Monitor payment processing -**Automated Health Checks:** - -Monitor wallet health through the crypto watcher service (``make crypto-watcher``) which handles payment detection and processing. Log Analysis ------------ @@ -393,40 +390,8 @@ Common Issues - Verify subaddress labels match payment IDs **Recovery Procedures:** -:: - # Wallet recovery from mnemonic seed - monero-wallet-cli \ - --restore-deterministic-wallet \ - --wallet-file=data/mps-wallet-restored \ - --password-file=data/wallet-password.txt - - # Account recreation handled by application - # Account indices stored in database must match wallet - -Emergency Procedures --------------------- - -**Emergency Fund Sweep:** -:: - - # If server compromise is suspected - # Sweep ALL accounts to emergency cold storage - - EMERGENCY_ADDRESS="your_emergency_cold_wallet_address" - - # Use Make command for emergency sweeps - COLD_WALLET_ADDRESS=$EMERGENCY_ADDRESS make sweep-all - -**Wallet Backup and Recovery:** -:: - - # Regular backup procedures - # 1. Backup wallet files - cp data/mps-wallet* /secure/backup/location/ - - # 2. Account configuration stored in database - # Account indices preserved during recovery +Wallet recovery requires the 25-word mnemonic seed saved during wallet creation. Regular wallet file backups are critical. Store backups in secure, offline locations. For emergency sweeps to cold storage, use ``COLD_WALLET_ADDRESS=
make sweep-all``. Advanced Configuration ======================