Withdraw Funds
Learn how to withdraw sale proceeds after a successful token sale. Requires FUNDS_MANAGER_ROLE and a SUCCESS finalization status.
After a sale is finalized as SUCCESS, the designated funds manager can withdraw the collected payment proceeds to a configurable treasury recipient. Withdrawals are per currency -- each accepted payment token is withdrawn separately.
Prerequisites
- Your wallet has FUNDS_MANAGER_ROLE on the token
- The sale status is Success
Steps
Open the Manage dropdown
Navigate to the sale detail page and open the Manage dropdown.
Select Withdraw Funds
Click Withdraw Funds. A panel opens listing all accepted payment currencies with their accumulated balances. The sale token itself is not a valid withdrawal currency and is excluded from the list -- recover unsold sale tokens with Withdraw Unsold Tokens instead.
Choose currency and recipient
Select the payment currency to withdraw and enter the treasury recipient address. The recipient is validated -- the zero address is rejected with a decoded reason. Repeat for each currency you want to withdraw.
Confirm and authenticate
Click Withdraw, review the amount and recipient, then authenticate with your PIN or OTP.
The full balance of that currency is sent to the recipient. The balance resets to zero on the contract.
Withdrawing unsold tokens
To recover tokens not purchased by investors, use Withdraw Unsold Tokens from the Manage dropdown. This returns uncommitted tokens to a recipient address and is available after the sale ends regardless of SUCCESS/FAILED outcome.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
SoftCapNotReached | Soft cap is configured but the sale is not yet finalized | Finalize the sale first, then retry |
RefundGracePeriodActive | Less than 30 days since FAILED finalization | Wait for the grace period to expire |
CannotWithdrawSaleToken | You attempted to withdraw the sale token itself | Use Withdraw Unsold Tokens instead |
InvalidAddress | The recipient is the zero address | Enter a valid treasury recipient |
Next steps
How to end and finalize a token sale
Learn how to end a token sale before its scheduled close and how to finalize it after it ends to determine SUCCESS or FAILED status.
How to withdraw vested tokens
Learn how to withdraw your vested tokens after purchasing in a token sale with vesting enabled. Tokens are released linearly after the cliff period.