Skip to main content

woosh multi

Multi-wallet maintenance utilities for managing intermediate and worker (active) wallets.

This command group handles SOL funding, token distribution through layered wallets, ATA creation, and cleanup of unused or inactive accounts. All actions depend on the configuration in your woosh.config file under multi_wallet_settings.

Required Config​

"multi_wallet_settings": {
  "intermediate_wallet_count": 5,
  "intermediate_wallet_sol_balance": 0.5,
  "active_wallet_count": 1,
  "active_wallet_sol_balance": 0.5,
  "enable_active_wallet_stake": false,
  "active_wallet_stake_percentage": 50
}

⚡ Command: woosh multi transfer-sol​

Generates new intermediate and active wallets and funds them with the specified SOL balance.

  • Wallets are saved under:

    • transfer/1 – intermediate wallets
    • transfer/2 – worker (active) wallets

  • Private key and address of each wallet are stored in respective folders.

Usage:​

woosh multi transfer-sol

🔁 Command: woosh multi transfer-tokens​

Transfers all token balance from the launch wallet to intermediate wallets, and then distributes tokens from intermediates to randomly chosen worker wallets.

  • Token balance is randomly split across worker wallets.
  • Only wallets below required SOL balance receive additional SOL.
  • Will not re-transfer to already processed wallets.

Usage:​

woosh multi transfer-tokens

🛠️ Command: woosh multi create-ata​

Creates token accounts (ATAs) for intermediate and active wallets before sending tokens.

  • Optional but recommended to speed up the transfer process.
  • Can be used independently or before transfer-tokens.

Usage:​

woosh multi create-ata

🧹 Command: woosh multi close-accounts​

Closes empty token accounts from intermediate wallets and returns remaining SOL to the funding wallet.

  • Any token balance below decimal value is burned.
  • Intermediate wallets are cleaned post-transfer.

Usage:​

woosh multi close-accounts

🧼 Command: woosh multi close-inactive​

Closes inactive worker wallets that have token balances below decimal value and no significant SOL left.

  • SOL is returned to the funding wallet.
  • Closed wallets are moved to: transfer/non-active.

Usage:​

woosh multi close-inactive

Folder Structure:​

  • transfer/1: Intermediate wallets
  • transfer/2: Active (worker) wallets
  • transfer/non-active: Closed/unused worker wallets

This command group is essential for layered token operations and automated fund distribution in large-scale Solana deployments using Woosh.