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
This commit is contained in:
Russell Ballestrini 2025-09-30 22:28:44 -04:00
parent dc01348782
commit 18a9dfae4c
2 changed files with 5 additions and 105 deletions

View file

@ -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=<address> make sweep-all-doge`.
## Advanced Configuration

View file

@ -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=<address> make sweep-all``.
Advanced Configuration
======================