Drain an account

This section shows how to transfer all tokens from one account (implicit or originated) to another so that the source account balance is zero.

Draining implicit accounts (tz1, tz2, tz3)#

We want to "empty" an implicit account by sending all of its tokens to another account. It can be tricky to empty a tezos account because the system must subtract the gas fee from the account balance.

To do so, we first need to estimate the fees related to this operation. The estimate property of the TezosToolkit provides access to operation estimation utilities. Calling the transfer method will return an instance of the Estimate class and its suggestedFeeMutez property will allow us to know the fee associated with the operation.

Once we know the associated fees, we can calculate the maximum amount that needs to send to drain the account by subtracting these fees from the account balance.

Finally, we can do the transfer operation and use the maximum amount we just calculated as the amount parameter of the transfer function.

note

In the following example, we have not revealed the account that we want to empty. We need to keep in mind that there are fees related to a reveal operation. We are subtracting 374 mutez from the balance to cover reveal fees.

If the account to drain has already been revealed, you must not subtract the reveal fee from the balance.

Live Editor
Result

Draining originated accounts (KT1)#

In the following example, we first originate a contract with a starting balance of 8 ꜩ. Then, we transfer all of its tokens to an implicit account.

The contract we originate is a manager contract. It has a do method taking a lambda function as a parameter. We call the smart contract by passing a function called transferImplicit to its do method to transfer its tokens to the implicit address. More information on transfers involving originated KT1 addresses can be found here.

In the example, we estimate the transfer operation before doing it. The associated fees are deducted from the manager's address when draining the account. Thus, for the operation to be successful, the manager's address for that account must contain funds to cover the gas.

Live Editor
Result