Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 1.93 KB

tip-541.md

File metadata and controls

49 lines (33 loc) · 1.93 KB
Tip:  541
Title: Support canceling unstaking in Stake 2.0
Author: CooperDepp <[email protected]>
Discussions-to: https://github.com/tronprotocol/tips/issues/541
Status: Final
Type: Standards Track
Category: Core
Created: 2023-05-05

Simple Summary

Add an API in Stake 2.0 to allow users to cancel the unstaking transactions in the waiting period.

Abstract

To be consistent with TVM instructions in Stake 2.0, it is proposed to add an API to support canceling unstaking in Stake 2.0, which means that users can use this API to cancel unstaking in waiting period time, make the unstaking TRX restaked, and meanwhile help users withdraw the TRX expired waiting period to balance.

Motivation

Stake 2.0 has been launched on TRON mainnet, one of the changes is that there is a waiting period of 14 days after unstaking. As said in this issue, if users misoperate the unstaking transaction, or they change their mind during the waiting period and want to restake the TRX for earnings, for now, they can do nothing but wait for 14 days. This is detrimental to the user's benefit and the staking rate of TRX on the chain.

Meanwhile, as Stake 2.0 has already supported TVM instructions to cancel the unstakings in the smart contract, I think it is reasonable to add an API in Stake 2.0 to cancel the unstaking transactions.

Specifications

Add wallet/cancelallunfreezev2 API, the user can call this API to cancel all the ongoing unstaking transactions in the waiting period.

Params:

owner_address - address of transaction initiator, data type is string visible - whether the address is in base58 format, data type is bool Returns: unsigned transaction, data type is json string

Example:

curl -X POST  http://127.0.0.1:8092/wallet/cancelallunfreezev2 -d  \
'{
"owner_address":"TVrukxw11XrfnXuqDgbyQEgogXr1vcoWcq",
"visible":true
}'

Backward Compatibility

It will not influence the existed staking and unstaking related transactions.