Blockchain Nodes Configuration

Connect your own blockchain nodes for enhanced privacy, control, and reliability when processing cryptocurrency payments.

What are Blockchain Nodes?

Blockchain nodes are servers that run cryptocurrency software and maintain a copy of the blockchain. By connecting your own nodes to U.Cash, you can:

  • Process payments without third-party dependencies
  • Generate addresses directly from your node
  • Monitor transactions in real-time
  • Automatically transfer received funds
  • Enable refunds and advanced features

Bitcoin Node

Configure your Bitcoin (BTC) node for direct blockchain interaction.

Requirements

  • Bitcoin Core v0.16 or higher
  • RPC access enabled
  • Wallet functionality enabled (disable-wallet=0)
  • Recommended: Pruned node or with prune option enabled

Configuration Steps

  1. Navigate to Settings → Bitcoin Node
  2. Enter your Node URL (e.g., http://user:password@localhost:8332)
  3. Optionally add Node Headers for authentication
  4. For address generation, provide your wallet's Xpub key
  5. Enable Address Generation to use node for creating addresses
  6. Optionally configure Transfer to Address for auto-consolidation

Advanced Features

  • Address Generation: Generate addresses via BIP32/BIP44 hierarchical deterministic wallets
  • Transfer to Address: Automatically consolidate received funds to a main address
  • Refunds: Enable Bitcoin refunds from your node

bitcoin.conf Example

server=1
rpcuser=bitcoin
rpcpassword=your_secure_password
rpcallowip=127.0.0.1
rpcport=8332
disable-wallet=0

Ethereum Node

Configure your Ethereum (ETH) node for direct blockchain interaction.

Requirements

  • Geth, Nethermind, or similar Ethereum client
  • WebSocket or HTTP RPC access
  • Latest or recent stable version

Configuration Steps

  1. Navigate to Settings → Ethereum Node
  2. Enter your Node URL (e.g., https://mainnet.infura.io/v3/YOUR_KEY)
  3. Add Node Headers if required for authentication
  4. Select Network (Mainnet or Sepolia testnet)
  5. Enable Address Generation for wallet creation
  6. Configure Instant Conversion to auto-convert ETH to stablecoins

Network Support

  • Mainnet: Production Ethereum network
  • Sepolia: Testnet for testing (configured separately)
  • L2 Networks: BASE, ARB, OP supported via separate configurations

Instant Conversion

Automatically convert received ETH to stablecoins:

  • Supported: USDT, USDC, UNI, SHIB, LINK
  • Requires gas fees for conversion transactions
  • Configured in Ethereum node settings

Lightning Network Node

Configure Lightning Network for instant, low-fee Bitcoin payments.

Requirements

  • LND (Lightning Network Daemon) v0.11 or higher
  • REST API access enabled
  • Macaroon authentication

Configuration Steps

  1. Navigate to Settings → Bitcoin Lightning Network
  2. Check Active to enable Lightning payments
  3. Enter your Node URL (e.g., https://your-lnd-server:8080)
  4. Provide your Macaroon hex-encoded authentication file
  5. Add Node Headers if additional auth is needed

Benefits

  • Instant payment confirmation
  • Very low transaction fees
  • Scalable for small payments
  • Best for microtransactions

LND Configuration

# lnd.conf
[Application Options]
listen=0.0.0.0:9735
rpclisten=0.0.0.0:10009
restlisten=0.0.0.0:8080

[Bitcoind]
bitcoind.rpchost=localhost:8332
bitcoind.rpcuser=bitcoin
bitcoind.rpcpass=your_password

Other Supported Nodes

Zcash Node

Configure Zcash (ZEC) node for privacy-focused payments.

  • Requires Zcashd with RPC access
  • Supports transparent and shielded addresses
  • Configure in Settings → Zcash Node

Solana Node

Configure Solana (SOL) node for high-speed payments.

  • Requires Solana RPC endpoint
  • Supports mainnet and devnet
  • Configure in Settings → Solana Node

Wallet Configuration

For advanced features like transfers and refunds, configure your wallet keys.

Bitcoin Wallet Key

  • Used for signing transactions
  • Should match your configured node
  • Store securely - never share

Ethereum Wallet Key

  • Private key for ETH transactions
  • Required for transfers and conversions
  • Keep encrypted and backed up
⚠️ Security Warning: Never commit wallet keys to version control or share them. Use environment variables or secure vaults for storage.

Troubleshooting

Connection Issues

  • Verify RPC is enabled in node configuration
  • Check firewall allows connections from U.Cash servers
  • Ensure username/password are correct
  • Test connectivity with curl or similar tools

Address Generation Failures

  • Confirm wallet is unlocked (if using Bitcoin Core)
  • Verify Xpub key is correct and supported
  • Check node has sufficient funds for initial transactions
  • Ensure address generation method matches your setup

Transaction Monitoring

  • Check node is fully synced with blockchain
  • Verify transaction hash is valid
  • Allow time for block confirmations
  • Review node logs for errors

Best Practices

  • Keep nodes updated to latest stable releases
  • Monitor disk space - blockchains grow continuously
  • Use secure passwords for RPC authentication
  • Enable pruning on Bitcoin Core to save space
  • Backup wallets regularly and securely
  • Test on testnets before using mainnet
  • Monitor node health and set up alerts
  • Use separate nodes for production and testing