make_post_sell/docs/DOGECOIN.md

4 KiB

Dogecoin Setup Guide 🐕

Make Post Sell supports Dogecoin payments using Dogecoin Core in pruned mode - just like mobile wallets but for servers!

Minimal blockchain storage with full hot wallet functionality.

1. Install Dogecoin Core

# Download latest release
wget https://github.com/dogecoin/dogecoin/releases/download/v1.14.6/dogecoin-1.14.6-x86_64-linux-gnu.tar.gz
tar -xzf dogecoin-1.14.6-x86_64-linux-gnu.tar.gz
sudo mv dogecoin-1.14.6/bin/* /usr/local/bin/

2. Configure Pruned Mode

Create ~/.dogecoin/dogecoin.conf:

# Enable server mode for RPC
server=1
daemon=1

# RPC credentials
rpcuser=your_rpc_user
rpcpassword=your_very_secure_rpc_password
rpcallowip=127.0.0.1
rpcport=22555

# PRUNED MODE - keeps only ~2GB instead of 50GB!
prune=2000

# Connect to reliable peers (faster sync)
addnode=seed.dogechain.info
addnode=seed.multidoge.org
addnode=seed.dogecoin.com

# Wallet settings
wallet=make_post_sell_hot_wallet

3. Start & Sync (Much Faster!)

# Start dogecoin daemon
dogecoind

# Initial sync takes ~2-4 hours (vs 12+ hours for full node)
# Watch progress:
dogecoin-cli getblockchaininfo

# When "blocks" equals "headers", sync is complete

4. Configure Make Post Sell

# Enable Dogecoin payments
payments.dogecoin.enabled = true

# Connect to local pruned node
dogecoin.rpc_url = http://localhost:22555
dogecoin.rpc_user = your_rpc_user
dogecoin.rpc_pass = your_very_secure_rpc_password

# Confirmation settings
dogecoin.confirmations.petty = 2    # < $10: 2 confirmations
dogecoin.confirmations.mid = 6      # $10-$100: 6 confirmations  
dogecoin.confirmations.high = 20    # > $100: 20 confirmations

# Fee buffer for customer payments
dogecoin.fee_buffer = 0.01

Why This Works Perfectly

Like Mobile Apps:

  • Real hot wallet with private keys
  • Connects to remote peers for blockchain data
  • Minimal storage (~2GB vs 50GB)
  • Full RPC functionality (send, receive, sweep)
  • Fast sync (2-4 hours vs 12+ hours)

Production Ready:

  • Auto-sweep enabled
  • True address generation
  • No API dependencies
  • Decentralized operation

Alternative: Full Node Mode

If you need maximum decentralization, you can run without pruning:

# Full node (in dogecoin.conf) - removes prune=2000
server=1
daemon=1
rpcuser=your_rpc_user
rpcpassword=your_very_secure_rpc_password

Trade-offs:

  • Complete blockchain history
  • ~50GB storage requirement
  • 12+ hour initial sync

Shop Configuration

Both modes require shop owners to:

  1. Enable Dogecoin in shop settings
  2. Configure cold wallet address where funds will be swept
  3. Set risk thresholds for confirmation requirements

Payment Flow

  1. Customer Checkout: Selects "Pay with Dogecoin 🐕"
  2. Quote Generation: Real-time USD/DOGE rate from CoinGecko
  3. Address Creation: Unique address per payment
  4. Payment Monitoring: 20-second polling for confirmations
  5. Auto-Finalization: Products unlocked when confirmed
  6. Auto-Sweep: Automatic sweep to cold wallet when confirmed

Monitoring & Logs

# Watch the crypto watcher logs
tail -f /path/to/logs/crypto_watcher.log

# Key log messages:
# "Processing 1 DOGE payments"
# "Found 2 incoming DOGE transfers for address D..."
# "DOGE auto-sweep successful for payment [uuid]"

Troubleshooting

Full Node Issues

  • Sync Problems: Check dogecoin.conf and network connectivity
  • RPC Errors: Verify credentials and rpcallowip settings
  • Storage Full: Use prune=10000 to limit blockchain storage

Security Notes

  • Cold Wallets: Always use hardware wallets or offline storage for shop sweep addresses
  • RPC Security: Never expose RPC ports to the internet
  • Private Keys: Node stores keys on disk - secure the server properly

Much setup! Such payments! Very wow! 🐕🚀

Ready to accept DOGE payments with zero blockchain bloat!