Skip to main content

Address Pool

Create and manage a pool of receipt wallet addresses that will receive customer payments.

Overview​

Address pools enable efficient payment routing by creating multiple receipt addresses that can be assigned to orders automatically. This distributes payments across addresses and optimizes fund management.

Why Address Pools?​

Benefits:

  • ✅ Load Distribution: Spread payments across multiple addresses
  • ✅ Privacy: Different address per order
  • ✅ Organization: Separate addresses for different products/services
  • ✅ Scalability: Handle high transaction volumes

Creating an Address Pool​

Step 1: Navigate to Account​

  1. Go to HashNut Dashboard
  2. Select your account
  3. Navigate to "Address Pool" or "Receipt Wallets" section

Step 2: Create Address Pool​

  1. Click "Create Address Pool" or "Add Addresses"
  2. Enter number of addresses to create
  3. Review gas fee estimate
  4. Confirm transaction

Step 3: Confirm Transaction​

  • Review gas fee
  • Approve in wallet
  • Wait for confirmation
  • Addresses automatically added to pool

Address Pool Configuration​

Batch Size​

Recommended Sizes:

  • Small: 10-20 addresses (for testing)
  • Medium: 50-100 addresses (for moderate volume)
  • Large: 200+ addresses (for high volume)

Limits:

  • TRON: Up to 50 addresses per transaction
  • EVM Chains: Up to 50 addresses per transaction
  • Multiple Batches: Create multiple batches for larger pools

Gas Optimization​

Best Practice: Create addresses in batches of 50 to optimize gas costs.

Address Assignment​

Automatic Assignment​

When you create an order:

  1. System selects next available address from pool
  2. Address is assigned to the order
  3. Address marked as "in use"
  4. After payment, address can be reused (optional)

Address Reuse​

Options:

  • Reuse After Payment: Address becomes available for new orders
  • One-Time Use: Address used once and retired
  • Product-Specific: Assign addresses to specific products

Managing Address Pools​

View Pool Status​

  • Total addresses created
  • Available addresses
  • Addresses in use
  • Addresses with pending payments
  • Individual address details

Address Details​

For each address, view:

  • Address (full address string)
  • Current balance
  • Payment count
  • Last payment timestamp
  • Status (available, in use, etc.)

Pool Operations​

Add More Addresses:

  • Create additional batches
  • Add to existing pool
  • No limit on total pool size

Monitor Pool:

  • Track address usage
  • Monitor balances
  • View payment history

Best Practices​

Pool Sizing​

  1. Start Small: Create 20-50 addresses initially
  2. Monitor Usage: Track how many addresses are in use
  3. Scale Up: Add more addresses as volume increases
  4. Maintain Buffer: Keep 20-30% addresses available

Address Management​

  1. Regular Monitoring: Check pool status regularly
  2. Balance Tracking: Monitor balances per address
  3. Aggregation Planning: Plan when to aggregate funds
  4. Gas Optimization: Create addresses in batches

Security​

  1. Verify Addresses: Confirm addresses are correct
  2. Monitor Balances: Watch for unexpected balances
  3. Regular Aggregation: Don't let funds sit too long
  4. Backup Information: Save pool creation transaction hashes

Use Cases​

High-Volume Merchant​

Strategy:

  • Create large pool (500+ addresses)
  • Regular aggregation (daily/weekly)
  • Monitor pool utilization

Multi-Product Business​

Strategy:

  • Separate pools per product
  • Product-specific reporting
  • Independent fund management

Troubleshooting​

Pool Exhausted​

Symptom: No available addresses for new orders

Solution:

  1. Create more addresses
  2. Check if addresses can be reused
  3. Aggregate funds to free addresses

High Gas Costs​

Symptom: Expensive to create addresses

Solution:

  1. Create during low gas periods
  2. Use batch creation (50 per transaction)
  3. Consider address reuse policy

Address Not Assigned​

Symptom: Order creation fails with "no available address"

Solution:

  1. Check pool has available addresses
  2. Verify account is active
  3. Create more addresses if needed

Next Steps​

Pool created? Start Creating Orders →