-
Notifications
You must be signed in to change notification settings - Fork 216
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
c3d90c1
commit 630c59c
Showing
1 changed file
with
63 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
- **TEP**: [0](https://github.com/ton-blockchain/TEPs/pull/0) *(don't change)* | ||
- **title**: Lockable Jettons Wallets | ||
- **status**: Draft | ||
- **type**: Contract Interface | ||
- **authors**: [KuznetsovNikita](https://github.com/KuznetsovNikita) | ||
- **created**: 13.04.2023 | ||
- **replaces**: - | ||
- **replaced by**: - | ||
|
||
# Summary | ||
|
||
This proposal suggests extending the standard Jetton Wallet by adding the option `get_locked_balance` get method. | ||
|
||
# Motivation | ||
|
||
New contracts have may want to disable jetton transfer until a time in the future. For this case, the Jetton Wallet should show zero balance to not affect old services and add a new get method to allow to get a locked balance and expiration date. | ||
|
||
The standard may use for: | ||
1. Jetton DAO contract may want to disable jetton transfer until voting is in progress. | ||
2. Jetton Vesting contract may want to release tokens in the future. | ||
|
||
|
||
# Guide | ||
|
||
Upon calling `get_locked_balance` get method Jetton Wallet should respond with integer jetton balance, integer jetton locked balance, and expiration date in integer UNIX epoch seconds format. | ||
|
||
# Specification | ||
|
||
## New Jetton Master contracts | ||
An example of the implementation jetton wallet code can be found [here](https://github.com/OpenProduct/jetton-dao-contracts/blob/ece785f82e07a7833194992cfc0e2fa1a690b524/contracts/jetton_wallet.func#L367) | ||
|
||
|
||
Jetton Wallet should implement the get method: | ||
|
||
``` | ||
(int, int, int) get_locked_balance() method_id { | ||
(int balance, slice owner_address, | ||
slice jetton_master_address, cell jetton_wallet_code, | ||
int locked, int lock_expiration, | ||
cell vote_keeper_code) = load_data(); | ||
return (balance, locked, lock_expiration); | ||
} | ||
``` | ||
|
||
# Drawbacks | ||
|
||
The standard implies single expiration date single locked balance. | ||
|
||
# Rationale and alternatives | ||
|
||
This design allows us to show balance and locked balance in a user-friendly and clear format in blockchain explorers and wallets. | ||
|
||
# Prior art | ||
|
||
- | ||
|
||
# Unresolved questions | ||
|
||
- | ||
|
||
# Future possibilities | ||
|
||
- |