Flush Transactions: Consolidate Funds Across Addresses into a Single Root Wallet
Flush Transactions in Poof let developers programmatically sweep funds from multiple HD wallet addresses (indexes > 0) back to a single root address using TSS keyshares. Ideal for crypto payment processors, this feature helps automate wallet consolidation, streamline treasury management, and is fully supported in Poof API v3.
💡 What Is a Flush Transaction?
In Poof's HD wallet system, each wallet can have infinite receiving addresses, all derived from a single XPUB. These addresses are often used in payment processing, where each transaction or user gets a unique deposit address (a new index).
Over time, these scattered balances across indexes can become fragmented.
That's where Flush Transactions come in.
📥 What Does "Flush" Do?
When you click Flush, Poof forwards all funds from derived addresses (indexes > 0) back to your root address (index 0).
This ensures your primary wallet holds the consolidated balance, making it easier to manage funds, withdraw, swap, or payout.
🖼 Accessing Flush
You can trigger a flush by clicking the "Flush" icon in the top action bar.
This is visible next to Send, Deposit, and Swap.
It applies per wallet, and the action will prompt you to sign the transaction using your keyshare (TSS shard).
🖼 Broadcasting the Flush
You’ll select the asset you want to flush (e.g., BNB).
Enter your keyshare (your shard), which is required to authorize the flush securely.
Click “Broadcast Transaction” to push the signed sweep to the blockchain.
The result: all funds from payment-specific addresses are swept back to your index 0 root address, ready for further actions.
🛠 How Flush Is Used in Payment Processing
Poof is built to scale payments across millions of users. When each customer gets a unique deposit address:
- 💰 Balances are received across many indexes.
- 📊 This enables precise tracking and separation by user/order.
- 🧹 Periodically, you flush to consolidate.
Flush transactions make it easy to:
- Collect revenue from fragmented deposits
- Clear old indexes after payments are complete
- Prepare funds for swaps, payouts, or treasury actions
- Keep wallets efficient and balances centralized
📡 Use via API v3
Flush is also available via Poof API v3:
Poof handles transaction construction, shard-based signing, and broadcasting
Perfect for platforms automating recurring payment cleanup, receiving funds, or preparing funds for treasury workflows.
Updated 13 days ago