This BEP describes an improvement for the freeze feature of tokens on the Binance Chain.
BEP-21 Proposal describes functionality to improve freeze functionality of tokens on the Binance Chain. Such as:
- Freeze from Any: Currently only the token owner can freeze tokens. This should be updated to allow any account holder to freeze tokens on their address.
- Freeze with BondPeriod: Freeze the token with a specified bond period for the token after which they can be claimed.
- Unfreeze: Unfreeze the tokens and begin the unbonding period (if any). A second unfreeze call after tokens are unbonded is necessary to then claim.
- QueryBondPeriod: QueryBondPeriod will return the bond period of the token freeze.
- QueryUnlockTime: QueryUnlockTime will return the unlock time of the token freeze.
This BEP is under implementation.
Some dApps require token holders to perform certain actions in holding utility coins before unlocking features, such as freezing tokens for certain time periods. For example, a dApp with a certain premium feature set may require token holders to freeze a certain quantity of tokens on their address for 30 days (bond period).
Freeze transactions can freeze tokens from the owner address for a specified bond period. Any address can freeze its own tokens.
The existing fee (a fixed amount of BNB) will be charged on Freeze transactions.
Parameters for Freeze Operation:
| Field | Type | Description |
|---|---|---|
| Description | string | Description of the freeze operation. Max length of description is 128 bytes. |
| Amount | []Coin | A set of tokens to be frozen |
| BondPeriod | int64 | The time period for bonding in seconds. Max BondPeriod should be less than 315,360,000 (10 years). Default is 0. |
| UnlockTime | int64 | Timestamp for when the tokens can be unlocked. Default is null if BondPeriod==0. |
Freeze transaction will transfer frozen tokens to a purely-code-controlled escrow account and will return a Frozen record id. No one can transfer the tokens out of the escrow account, unless the owner of the tokens successfully runs “UnFreeze” under the preset requirements.
Unfreeze transactions unlock tokens from a given Freeze record if time.now() > UnlockTime && UnlockTime != 0, or BondPeriod==0.
If time.now() < UnlockTime, then Unfreeze transactions will apply the BondPeriod by setting Unfreeze to a timestamp that is time.now() + BondPeriod.
Unfreeze will fail if the address is not the same as the tokens’ owner.
If a Unfreeze transaction succeeds, the locked tokens will be returned to the owner's account, and the related Freeze record will be deleted.
A fee (a fixed amount of BNB) will be charged on Unfreeze transactions.
Parameters for Unfreeze Operation:
| Field | Type | Description |
|---|---|---|
| RecordId | int64 | Freeze record id |
QueryBondPeriod will return all BondPeriod records of a specific address.
QueryUnlockTime will return UnlockTime record of a given Freeze record id of a specific address.
The content is licensed under CC0.