diff --git a/docs.json b/docs.json index d18c8123d..774bbefcf 100644 --- a/docs.json +++ b/docs.json @@ -236,7 +236,10 @@ { "group": "Staking", "pages": [ - "ecosystem/staking/overview" + "ecosystem/staking/overview", + "ecosystem/staking/single_nominator", + "ecosystem/staking/nominator_pools", + "ecosystem/staking/ton_whales" ] }, "ecosystem/analytics" diff --git a/ecosystem/staking/nominator_pools.mdx b/ecosystem/staking/nominator_pools.mdx new file mode 100644 index 000000000..800ac8720 --- /dev/null +++ b/ecosystem/staking/nominator_pools.mdx @@ -0,0 +1,76 @@ +--- +title: "Nominator pool contracts" +sidebarTitle: "Nominator pools" +--- + +[Nominator pool contracts](https://github.com/ton-blockchain/nominator-pool) allow multiple nominators to delegate their stake to a validator without running validator infrastructure themselves. Funds from nominators are combined with the validator's own stake and used for network validation. The pool contract handles rewards and penalties according to predefined rules. + +## Key parameters + +- Minimum nominator stake: 10,000 TON, recommended. +- Maximum nominators per pool: 40. +- Operational costs: approximately 5 TON per validation round, paid by the validator. +- Withdrawals: full withdrawal only; partial withdrawals are not supported. +- Governance: nominators can participate in network configuration voting. + +## When to use + +Nominator pools are suitable for: + +- Staking below the validator minimum of 300,000 TON. +- Delegating stake to trusted validators without running infrastructure. +- Participating in network governance. +- Using a simple staking model without liquidity tokens or DeFi participation. + +## How it works + +1. Nominators deposit funds into a pool managed by a validator. +1. The validator stakes the combined funds, including the validator's own and nominators' stakes, for validation. +1. Rewards are distributed proportionally: + - The validator receives a commission defined by `validator_reward_share`. + - The remaining rewards are distributed to nominators based on their stake size. +1. If the validator is penalized: + - The penalty is first deducted from the validator's balance. + - If the validator balance is insufficient, losses are deducted proportionally from nominators. +1. The validator must maintain enough balance to cover the maximum possible penalties. + +## How to stake + +1. Choose a pool on [TON Nominators](https://tonvalidators.org/) and review its parameters, commission, and minimum stake. +1. Send a message to the nominator pool contract with: + - The desired TON amount. + - The text comment "d" for deposit. +1. The sent amount must be at least `min_nominator_stake + 1 TON`, while 1 TON is deducted as the deposit fee. +1. If the pool is not currently validating, the deposit is credited immediately; otherwise, it is added to pending deposits. + +## How to withdraw + +1. Send a message to the nominator pool contract with: + - The text comment "w" for withdraw. + - Approximately 1 TON for network fees. +1. If the pool has sufficient balance, the withdrawal is processed immediately. +1. If not, a withdrawal request is created and processed later. +1. Only full withdrawal is supported. + +## How to vote + +1. Find the proposal hash posted in [`@tonblockchain`](https://t.me/tonblockchain) or [`@tonstatus`](https://t.me/tonstatus). +1. Send a message with comment `"y"` to vote for or `"n"` to vote against. + - Example: `"yD855FFBCF813E50E10BEAB902D1177529CE79785CAE913EB96A72AE8EFBCBF47"`. +1. Attach approximately 1 TON for network fees. + +## Reward calculation + +Reward data can be obtained using the [TON Center nominator pools API](https://toncenter.com/api/smc-index/): + +- [getPoolBookings](/ecosystem/api/toncenter/smc-index/get-pool-bookings-method) — get all the bookings, including debits and credits, in a specified pool. +- [getNominatorBookings](/ecosystem/api/toncenter/smc-index/get-nominator-bookings-method) — get nominator bookings, including debits and credits, in a specified pool. +- [getNominatorEarnings](/ecosystem/api/toncenter/smc-index/get-nominator-earnings-method) — get nominator income in a specified pool, including stake amounts on each time point. +- [getNominator](/ecosystem/api/toncenter/smc-index/get-nominator-method) — get the nominator's balances across all pools in which the nominator participates. +- [getPool](/ecosystem/api/toncenter/smc-index/get-pool-method) — get pool data, including all nominators. + +## Validator setup + +- Use [MyTonCtrl nominator pools](/ecosystem/node/mytonctrl/pools#nominator-pool-operations-nominator-pool-mode) for standard multi-nominator operation. +- Pools can technically be configured with a minimum stake of 100 TON; however, 10,000 TON is the tested and recommended value. +- Validators can deploy pools manually using the [nominator pool contract](https://github.com/ton-blockchain/nominator-pool) without MyTonCtrl. diff --git a/ecosystem/staking/overview.mdx b/ecosystem/staking/overview.mdx index 560e24471..7305b7c6d 100644 --- a/ecosystem/staking/overview.mdx +++ b/ecosystem/staking/overview.mdx @@ -4,256 +4,180 @@ sidebarTitle: "Overview" --- import { Aside } from '/snippets/aside.jsx'; +import { Image } from '/snippets/image.jsx'; -Staking in TON enables earning rewards by locking Toncoin to support network security and validation. This guide covers the main staking options available and how to choose the right approach. +[Staking in TON](https://ton.org/en/stake) enables earning rewards by locking Toncoin to support network security and validation. TON supports several staking solutions, each designed for different use cases and operational models. -## Staking options +Staking secures the network through [proof-of-stake](https://en.wikipedia.org/wiki/Proof_of_stake). Depending on technical ability, stake size, and participation goals, users may choose between classic staking, single nominator, nominator pools, or liquid staking. Some solutions are suitable only for technically experienced operators, while others are intended for businesses providing staking as a service. However, all solutions require non-trivial setup, and there are limited number of support tools. -This page focuses on practical staking methods. TON offers several staking approaches, each with different requirements, benefits, and use cases: +## Overview of staking solutions -### Classic staking +The following smart contracts are commonly used in the TON ecosystem: -Classic staking involves running a validator node directly using MyTonCtrl. This method provides full control over validation and requires technical expertise to set up and maintain. +| Option | Intention | Features | +| :-------------------------------------------------------------------------: | :----------------------------------------------------: | :----------------------------------------------------------: | +| Classic staking | Operators running validator nodes. | Full control; high technical and operational requirements. | +| [Liquid staking](https://github.com/ton-blockchain/liquid-staking-contract) | Staking providers servicing retail users. | Liquidity and DeFi integration via wrapped staking tokens. | +| [Single nominator](https://github.com/ton-blockchain/single-nominator) | Large holders staking only their own funds. | Secure, contract-based self-staking; simple ownership model. | +| [Nominator pool](https://github.com/ton-blockchain/nominator-pool) | Small group of nominators delegating to one validator. | Has significant limitations; generally not recommended. | - -**Documentation**: See [MyTonCtrl validator documentation](/ecosystem/node/setup-mytonctrl) for detailed setup and management instructions. - -### Liquid staking - -Liquid staking protocols tokenize staked positions, enabling stakers to receive liquid tokens that represent staked TON. These tokens can be used in DeFi while the underlying TON earns rewards. - -**Benefits:** - -- Liquidity: Access staked funds without unstaking delays -- Composability: Use tokens in DeFi protocols and dApps -- Decentralization: Flexible staker-validator connections without central pools -- Accessibility: Low minimum deposits for broader participation -- Voting power: Some protocols allow governance influence -- Safety: Reduced slashing risks via diversification -- Diversification: Easy fund spreading across validators - -[**Tonstakers**](https://tonstakers.com): - -- Minimum stake: 1 TON -- Liquid token: tsTON -- Withdrawal: Instant if funds available; otherwise up to 18 hours -- Voting for network proposals -- Automated compounding -- Decentralized validation + The technical minimum stake required to participate in validation is 300,000 TON. However, validators compete for 400 slots in each validation round. As a result, the actual minimum stake is typically higher, approximately 700,000 TON. -[**Bemo**](https://bemo.finance): - -- Minimum stake: 1 TON -- Liquid token: bmTON -- Withdrawal: 36-72 hours cooldown -- Centralized validation - -[**Hipo**](https://hipo.fi): - -- Minimum stake: Varies -- Liquid token: hTON -- Withdrawal: Average 30 hours; instant (1 minute) if funds available -- Centralized validation - -**Protocol comparison:** - -| Protocol | Min deposit | Liquidity | Voting | Withdrawal | Decentralized validation | -| -------------------------------------------- | ----------- | ----------- | ------ | ---------------------------- | ------------------------ | -| Tonstakers | 1 TON | Yes (tsTON) | Yes | Up to 18h (instant possible) | Yes | -| Bemo | 1 TON | Yes (bmTON) | No | 36-72h cooldown | No | -| Hipo | Varies | Yes (hTON) | No | Avg 30h (instant possible) | No | -| [TON Whales](https://tonwhales.com/staking) | 50 TON | **No** | No | Up to 18h | No | -| [TON Nominators](https://tonvalidators.org/) | 10,000 TON | **No** | Yes | Up to 18h | No | - - -### Nominator pools - -Nominator pools are smart contracts that allow nominators to delegate their Toncoin to a validator for staking. The pool ensures validator funds are used exclusively for validation and guarantees proper reward distribution. +## Classic staking -**How it works:** +Classic staking involves [running a validator node](/ecosystem/node/mytonctrl/validator) using the [MyTonCtrl](/ecosystem/node/setup-mytonctrl) tool. This method provides full control over validation without intermediate contracts, but requires technical expertise to set up and maintain a validator. -- Nominators deposit funds into a pool managed by a validator -- The validator uses combined funds (validator's own + nominators') for validation -- Rewards are distributed proportionally: validator receives a share (set by `validator_reward_share`), remaining rewards go to nominators based on their stake size -- If validator performs poorly and gets fined, the fine is deducted from validator's balance first; if insufficient, losses are deducted from nominators proportionally -- Validator must maintain sufficient funds to cover maximum possible fines +### Key characteristics -**Key parameters:** +- Requires users to run and maintain a validator node. +- Requires a large minimum stake. The technical minimum is approximately 300,000 TON; the actual threshold depends on network conditions. +- Offers direct participation in consensus and reward generation. +- Provides the highest level of autonomy and control over the staking process. -- Minimum nominator stake: 10,000 TON (recommended configuration) -- Maximum nominators per pool: 40 -- Operational costs: \~5 TON per validation round (paid by validator) -- Partial withdrawals: Not supported — only full withdrawal available -- Voting: Nominators can vote on network configuration proposals +### Recommended use -**When to use:** +- Validators who want full control and have the infrastructure and technical expertise. +- Users comfortable with operational responsibility and network maintenance. -- Staking below validator minimum (300,000 TON) -- Delegating to trusted validators without running infrastructure -- Participating in network governance through voting -- Simple staking without liquidity tokens or DeFi participation +## Liquid staking -**How to stake:** +The [liquid staking contract](https://github.com/ton-blockchain/liquid-staking-contract) enables staking services to issue liquid staking tokens (LSTs) that represent the underlying staking position. LSTs can be used in DeFi while the underlying TON earns rewards. -1. Find a suitable pool on [TON Nominators](https://tonvalidators.org/) — check pool parameters, validator commission, and minimum stake requirements -1. Send a message to the nominator pool contract with TON and text comment `"d"` (deposit) -1. Amount must be ≥ `min_nominator_stake + 1 TON` (1 TON is deducted as deposit fee) -1. If pool is not validating, deposit is credited immediately; otherwise, it's added to pending deposits +### Key characteristics -**How to withdraw:** +- Users deposit TON and receive wrapped tokens, e.g. tsTON, that can be used in DeFi. +- Liquidity remains accessible even when underlying funds are staked. +- Flexible staker-validator connections without centralized pools. +- Low minimum deposits for broader participation. +- Some protocols allow governance influence. +- Reduced slashing risks using diversification. +- Easy fund spreading across validators. -1. Send a message to the nominator pool contract with text comment `"w"` (withdraw) and \~1 TON for network fee -1. If pool has sufficient balance, withdrawal is immediate; otherwise, a withdrawal request is created -1. Only full withdrawal is supported — partial withdrawals are not available +### Recommended use -**How to vote:** +- Staking providers serving retail users. +- Projects building liquid staking products or yield-bearing tokens. +- Operators who want to run staking services without committing sufficient personal funds. -1. Find the proposal hash posted in [`@tonblockchain`](https://t.me/tonblockchain) or [`@tonstatus`](https://t.me/tonstatus) -1. Send a message with comment `"y"` to vote for, or `"n"` to vote against (e.g., `"yD855FFBCF813E50E10BEAB902D1177529CE79785CAE913EB96A72AE8EFBCBF47"`) -1. Attach \~1 TON for network fee +### Staking providers -**Reward calculation:** +Third-party staking providers who use liquidity pool for staking: -- Use [TON Center Nominator Pools API](https://toncenter.com/api/smc-index/) to calculate nominator rewards for each round of validation -- Available API methods: - - [getPoolBookings](/ecosystem/api/toncenter/smc-index/get-pool-bookings-method) — get all the bookings (debits and credits) in specified pool - - [getNominatorBookings](/ecosystem/api/toncenter/smc-index/get-nominator-bookings-method) — get nominator bookings (debits and credits) in specified pool - - [getNominatorEarnings](/ecosystem/api/toncenter/smc-index/get-nominator-earnings-method) — get nominator income in specified pool with his stake on each timepoint - - [getNominator](/ecosystem/api/toncenter/smc-index/get-nominator-method) — get nominator's balances in all pools where he participates - - [getPool](/ecosystem/api/toncenter/smc-index/get-pool-method) — get pool data with all its nominators +| Protocol | Min deposit | Liquidity | Voting | Withdrawal | Decentralized validation | +| :------------------------------------------: | :---------: | :---------: | :----: | :--------------------------: | :----------------------: | +| [Tonstakers](https://tonstakers.com) | 1 TON | Yes (tsTON) | Yes | Up to 18h (instant possible) | Yes | +| [Bemo](https://bemo.finance) | 1 TON | Yes (bmTON) | No | 36-72h cooldown | No | +| [Hipo](https://hipo.fi) | Varies | Yes (hTON) | No | Avg 30h (instant possible) | No | +| [TON Whales](https://tonwhales.com/staking) | 50 TON | **No** | No | Up to 18h | No | +| [TON Nominators](https://tonvalidators.org/) | 10,000 TON | **No** | Yes | Up to 18h | No | -**Setup for validators:** +Tonstakers offers automated compounding and decentralized validation. -- [MyTonCtrl nominator pools](/ecosystem/node/mytonctrl/pools#nominator-pool-operations-nominator-pool-mode) — standard pools with multiple nominators -- Nominator pools can be configured with minimum stake of 100 TON (not recommended — 10,000 TON is the tested and recommended configuration) -- Use [nominator pool contract](https://github.com/ton-blockchain/nominator-pool) to deploy a pool without MyTonCtrl +All validators participating in these third-party protocols use MyTonCtrl for validation. For validator setup instructions, see: -### TON Whales nominator pools +- [Tonstakers setup](/ecosystem/node/mytonctrl/liquid-staking) +- [Nominator pool setup](/ecosystem/node/mytonctrl/pools#nominator-pool-operations-nominator-pool-mode) +- [Single nominator pool setup](/ecosystem/node/mytonctrl/pools#single-nominator-pool-operations-single-nominator-mode) -[TON Whales](https://tonwhales.com/staking) is a nominator pool service built on custom smart contracts by the TON Whales team. It provides the same core functionality as standard nominator pools but with different implementation and lower entry threshold. +## Single nominator pools -**Key differences from standard nominator pools:** +[Single nominator pool contract](/ecosystem/staking/single_nominator) is the standard solution designed for large holders who want to stake their own funds while delegating validator operations to a trusted operator. -- Lower minimum stake: 50 TON (vs 10,000 TON in standard pools) -- Custom contract architecture: Uses separate Owner, Controller, Proxy, and Pool contracts -- Fee structure: Deposit and withdrawal fees vary by pool (check pool information before staking) - -**Creating a pool:** - -- Whales contracts allow creating pools with minimum stake as low as 1 TON (not recommended) - -**How it works:** - -- Nominators deposit funds into Whales pools managed by validators -- Rewards are distributed proportionally minus validator commission -- Validator covers operational costs and is responsible for validation quality -- Funds are secured by smart contracts, but validators control pool operations + -**When to use:** +### Key characteristics -- Small to medium stakes (50+ TON) -- Simple staking without technical knowledge -- No validator setup required +- Supports a single nominator. +- Separates the owner's cold wallet from the validator's hot wallet to prevent theft if the validator node is compromised. +- Reduced complexity compared to multi-nominator pools, making it secure and easy to audit. +- The owner can recover stakes even in extreme scenarios, such as elector contract upgrades. +- Any modification would require a professional audit, which is costly and time-consuming; therefore, the contract remains intentionally unchanged. -**How to stake:** +### Recommended use -1. Use [TON Whales staking website](https://tonwhales.com/staking) to find a suitable pool and stake -1. Alternatively, send a message to any Whales-type nominator pool contract with TON and text comment `"Stake"` (capitalization is important) -1. Amount must be `desired_stake + deposit_fee` (check pool for current deposit fee) +- Large holders with their own funds. +- Validators who want to separate fund custody from node operation. -**How to withdraw:** +## Nominator pools -1. Send a message with text comment `"Withdraw"` (capitalization is important) and `withdraw_fee` (check pool for current fee) -1. Withdrawal is a two-step process: first request, then withdraw when solidified -1. Sometimes withdrawal can be immediate if pool has sufficient balance +[Nominator pools](/ecosystem/staking/nominator_pools) are smart contracts that allow a small group of nominators to combine their funds and delegate to a validator for staking collectively. However, it has limitations and safety concerns. -**See also:** +### Limitations -- [TON Whales staking](https://tonwhales.com/staking) -- [TON Whales nominator pool contracts](https://github.com/tonwhales/ton-nominators) +- Only the owner can withdraw funds from the pool. +- Supports up to approximately 40 nominators, which is not suitable for large pools. +- Not designed for small deposits or retail participation. +- Sending a message to the pool without a bounce flag may result in funds becoming locked. -### Single nominator pools +### Notes -Single nominator pools are security-focused smart contracts designed for validators with sufficient self-stake who want to validate independently without other participants. This is a simplified, more secure version of the nominator pool that supports only one nominator. +- The contract is not deprecated, but it is rarely an appropriate choice in practice. +- For large holders, the single nominator contract is preferred. +- This solution is not recommended for new staking services. - +## TON Whales nominator pools -**Key features:** +[TON Whales](/ecosystem/staking/ton_whales) is a nominator pool service built using custom smart contracts developed by the TON Whales team. It provides the same core functionality as standard nominator pools, with a different contract architecture and lower entry threshold. -- **Security-first design**: Separates cold wallet (owner) from hot wallet (validator) to prevent theft if validator node is compromised -- **Simplified architecture**: Reduced complexity compared to multi-nominator pools, making it secure and easy to audit -- **Emergency safeguards**: Owner can recover stakes even in extreme scenarios like Elector contract upgrades +## Differences from standard nominator pools -**How it works:** +- Lower minimum stake of 50 TON, compared to 10,000 TON in standard pools. +- Custom contract architecture with separate owner, controller, proxy, and pool contracts. +- Fee model where deposit and withdrawal fees vary by pool; users should check pool details before staking. -1. Owner (cold wallet) holds staking funds securely offline -1. Owner deposits funds into single nominator pool contract -1. Validator (hot wallet on node) instructs contract to participate in validation cycles -1. Contract sends stake to Elector for validation -1. After cycle completion, validator instructs contract to recover stake -1. Owner can withdraw funds at any time (only owner can withdraw) +## Recommendations for staking solutions -**Security benefits:** +For large holders staking only their own funds: -- Validator's hot wallet cannot steal funds — only owner can withdraw -- If validator is compromised, owner can change validator address immediately -- Owner can send raw messages to recover stakes in emergency situations -- Owner can upgrade contract code in extreme emergencies +- Use a single nominator contract for direct self-staking, or +- Stake through a reputable third-party staking provider. -**Setup for validators:** +For operators intending to run staking services for others: -- [MyTonCtrl single nominator pools](/ecosystem/node/mytonctrl/pools#single-nominator-pool-operations-single-nominator-mode) +- Use liquid staking contracts, which are appropriate when accepting deposits from retail users or when building DeFi-compatible staking tokens. -**Instruction for nominator:** +For small holders: -- Send an **empty message** to the single nominator pool contract with TON to deposit -- Send a message of 1 TON to the single nominator pool contract with text comment `"w"` (withdraw) to withdraw -- That's it +- Use a third-party staking service rather than running contracts directly. -**Reward and penalty tracking:** +The following recommendations are mapped onto the Cartesian plane below. The horizontal axis represents legal restrictions and setup complexity, while the vertical axis represents the operational model. -- Separate API tools are typically not needed for single nominator tracking, since validator and nominator are usually the same person (as originally designed) -- If validator and staking are handled by different parties, calculate exact income, all penalties (which should be charged to validator since penalties are due to their hardware/honesty issues), and fees -- For such cases, API is not yet available from TON Center, similar to [nominator pools API](/ecosystem/api/toncenter/smc-index/get-nominator-bookings-method) +
+ Recommendations +
-### Combining staking with DeFi +## Combining staking with DeFi Staking can be combined with various DeFi strategies to maximize returns and unlock additional value from staked assets. -**Liquid staking strategies:** - -- **Re-staking liquid tokens**: After staking TON and receiving liquid tokens (e.g., tsTON), stake these tokens again to earn additional yields. This creates a compounding effect where staking rewards are earned on both the original stake and the liquid token rewards. -- **DeFi integration**: Use liquid staking tokens in lending protocols, DEX liquidity pools, and other DeFi applications to earn multiple yield streams simultaneously. -- For detailed strategies and examples, see [Tonstakers Earn](https://tonstakers.com/) which covers leveraged staking, collateral staking, and DEX liquidity provision. +### Liquid staking strategies -**Vesting contracts with staking:** +- Re-stake liquid tokens. After staking TON and receiving liquid tokens such as tsTON, these tokens can be staked again to earn additional staking rewards. This creates a compounding effect, as rewards are earned on both the original stake and the liquid tokens. +- DeFi integration. Use liquid staking tokens in lending protocols, DEX liquidity pools, and other DeFi applications. +- Practical examples of leveraged staking, collateral staking, and DEX liquidity provision are available in the [Tonstakers Earn](https://app.tonstakers.com/earn). -- **Locked token purchases**: When buying tokens with a lock period via vesting contracts, buyers receive locked tokens that can be staked to participate in validation and earn rewards while they remain locked. -- This approach allows token buyers to generate income from locked assets during the vesting period, making locked token purchases more attractive while providing additional revenue streams. -- Setup instructions: See [Vesting contracts staking options](/standard/vesting#staking-options) for detailed configuration steps. +### Vesting contracts with staking -### See also +Tokens acquired through [vesting contracts](/standard/vesting) remain locked for a defined period but can be staked during vesting. This allows token holders to participate in validation and earn staking rewards while the tokens remain locked. -- [Staking links on ton.org](https://ton.org/en/stake) -- [MyTonCtrl validator guide](/ecosystem/node/mytonctrl/validator) -- [MyTonCtrl nominator pools](/ecosystem/node/mytonctrl/pools) -- [Vesting contracts](/standard/vesting) -- [Catchain consensus](https://docs.ton.org/catchain.pdf) +Configuration details are described in the [Vesting contracts staking options](/standard/vesting#staking-options). diff --git a/ecosystem/staking/single_nominator.mdx b/ecosystem/staking/single_nominator.mdx new file mode 100644 index 000000000..0137fbf2e --- /dev/null +++ b/ecosystem/staking/single_nominator.mdx @@ -0,0 +1,39 @@ +--- +title: "Single nominator pool contracts" +sidebarTitle: "Single nominator pools" +--- + +[Single nominator pool contracts](https://github.com/ton-blockchain/single-nominator) are designed for validators with [sufficient self-stake](https://tonscan.org/validators) who want to validate independently, without involving other participants. + +## How it works + +1. The owner, a cold wallet, securely holds staking funds offline. +1. The owner deposits funds into the single nominator pool contract. +1. The validator, a hot wallet on the node, instructs the contract to participate in validation cycles. +1. The contract transfers the stake to the elector for validation. +1. After the validation cycle completes, the validator instructs the contract to recover the stake. +1. The owner can withdraw funds at any time; withdrawals are restricted to the owner only. + +## Security properties + +- The validator's hot wallet cannot withdraw or steal funds. +- If the validator is compromised, the owner can immediately update the validator address. +- The owner can send raw messages to recover the stake in emergencies. +- In extreme cases, the owner can upgrade the contract code. + +## Validator setup + +Follow the [MyTonCtrl single nominator pools guide](/ecosystem/node/mytonctrl/pools#single-nominator-pool-operations-single-nominator-mode). + +## Nominator instructions + +- To deposit, send an empty message with TON to the single nominator pool contract. +- To withdraw, send a message with 1 TON and the text comment "w" (withdraw) to the contract. + +## Reward and penalty tracking + +- Separate APIs are typically unnecessary, as the validator and the nominator are usually the same entity. This is the original design assumption. +- If validation and staking are managed by different parties, rewards, penalties, and fees must be calculated explicitly. + - Penalties should be attributed to the validator, as they result from operational or hardware issues. +- TON Center does not provide a dedicated API for single nominator pools. + - This is similar to the limitations described for the [nominator pools API](/ecosystem/api/toncenter/smc-index/get-nominator-bookings-method). diff --git a/ecosystem/staking/ton_whales.mdx b/ecosystem/staking/ton_whales.mdx new file mode 100644 index 000000000..0577128c9 --- /dev/null +++ b/ecosystem/staking/ton_whales.mdx @@ -0,0 +1,32 @@ +--- +title: "TON Whales nominator pools" +sidebarTitle: "TON Whales nominator pools" +--- + +[TON Whales](https://tonwhales.com/staking) nominator pool contracts can create a pool with a minimum stake as low as 1 TON; however, this is not recommended. + +## When to use + +- Small to medium stakes (50+ TON); +- Staking without validator setup or technical knowledge; +- Users seeking a simple staking experience. + +## How it works + +- Nominators deposit funds into Whales pools managed by validators. +- Rewards are distributed proportionally, minus validator commission. +- The validator covers operational costs and is responsible for validation quality. +- Funds are secured by smart contracts, while validators control pool operations. + +## How to stake + +1. Use the [TON Whales staking website](https://tonwhales.com/staking) to find a suitable pool and stake. +1. Alternatively, send a message with TON and the case-sensitive text comment "Stake" to a [Whales-type nominator pool contract](https://github.com/tonwhales/ton-nominators). +1. The transferred amount must be equal to `stake_amount + deposit_fee`; refer to the pool details for the current fee. + +## How to withdraw + +1. Send a message with the case-sensitive text comment "Withdraw" and include the required `withdraw_fee`. +1. Withdrawals follow a two-step process: request first, then finalize after the funds are received. + +In some cases, withdrawals may be processed immediately if the pool has sufficient available balance. diff --git a/resources/images/staking-cartesian-dark.svg b/resources/images/staking-cartesian-dark.svg new file mode 100644 index 000000000..4a4cb691c --- /dev/null +++ b/resources/images/staking-cartesian-dark.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/resources/images/staking-cartesian-light.svg b/resources/images/staking-cartesian-light.svg new file mode 100644 index 000000000..084d1be93 --- /dev/null +++ b/resources/images/staking-cartesian-light.svg @@ -0,0 +1 @@ + \ No newline at end of file