Update staking
Access prerequisites
- Permission (module):
manageToken - License/Feature:
STAKING_TOKENS - Menu container: GENERAL → group Investments / Financial Distributions → screen Staking Applications
What it is / when to use
Dialog opened by the edit icon of an active staking application. Allows readjusting the ongoing contract at the request of the client or agent, across three independent dimensions: new yield percentage, new contract end date, and new total applied (additional contribution). When the percentage or applied amount changes, future payments are automatically recalculated until the end of the contract.
Prerequisites
- The application must be active (not yet finalized). The edit icon operates on the selected row in the listing.
- Permission:
manageToken(dual — CPM enum in the backend + module in the DB).
Fields
| Field | What it is | Required? | System/backend effect |
|---|---|---|---|
| New percentage | New yield rate for the contract | Conditional (any one of the 3 is sufficient) | Sent as newPercentage (BigNumber) to updateStakeForAdmin; recalculates future payments until the end of the contract |
| New end date | New contract termination date | Conditional | Sent as newEndDate; extends/shortens the payment schedule |
| Total applied | New total applied amount (additional contribution) | Conditional | Sent as totalApplied; recalculates payments based on the new principal |
Actions and modals
- Save: calls
updateStakeForAdminwith the filled-in fields (those not provided are sent asnull). The button remains disabled while none of the three fields is filled. - Cancel / Close: discards the edit without changing the contract.
Business rules / considerations
Attention
- Filling in all three fields is not required. Any one of them already enables the Save button; the others remain unchanged.
- Changing the percentage or total applied triggers the automatic recalculation of remaining payments until the end of the contract — the impact is retroactive only for future installments, not for those already paid.
- Numeric fields accept a comma or period as the decimal separator; the component normalizes to a period before sending.
- Financial values:
newPercentageandtotalAppliedare treated as BigNumber — no rounding at the source.