About

Our Ton nomination staking integration enables users to stake their TON assets with any available nomination pool. It allows users to earn TON staking rewards without being required to run their own validators and stake more than 300,000 TON. When a user stakes, they start earning as soon as the pool gets included in the active set or enters the next validation cycle.

If the pool is not currently participating in validation, then the staked position will be credited immediately. Otherwise, the staked position will be pending and credited after the completion of the current round of validation (within 18 hours).

When unstaking, the withdrawal will be made immediately if there is enough TON on the nomination pool's balance. Otherwise, the staked TON will be withdrawn after the end of the current validation round.

Due to the intricacies of the Ton nomination pool staking, the nomination pool metadata includes additional information compared to the other native staking yields supported by StakeKit The important additions are:

export class ValidatorDto {
 // ... other properties omitted for brevity ...

 /** Maximum remaining amount that can be staked with the validator in the TON network */
 remainingPossibleStake?: string;

 /** Minimum amount required to stake with this validator in the TON network */
 minimumStake?: string;

 /** Number of remaining slots available for staking in the TON network */
 remainingSlots?: number;
}

These additional yield metadata points can provide users with precise information, empowering them to make informed decisions when selecting a nomination pool.

StakeKit safeguards users by blocking attempts to stake with nomination pools that have a remainingSlots value of 0, by preventing stakes exceeding the remainingPossibleStake for a given pool as well as staking less than the pool's minimumStake requirement. Without these protections, transactions might fail if initiated. Projects integrating the StakeKit API should take these values into account to deliver a seamless user experience.

Pending Actions

None

Considerations

1. Due to the nature of the TON blockchain, it is required to send an extra 1 TON when performing the stake action. 1 TON is deducted as a commission for deposit processing. Similarly, when a user withdraws they will need to have at least 1 TON available balance to cover the fees.
2. Although there is a minimum requirement, the nomination pools themselves set the ultimate minimum requirement, but it is never lower than 10,000 TON. StakeKit sets the minimum as 10,001 due to the consideration above.
3. Partial withdrawals are not supported — users can only withdraw the full balance.