Skip to content

Formatting and enhance cost breakdown in Nominator Pool Documention #1158

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
May 12, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,20 @@ The pool is designed for large amounts of coins, prioritizing security and code

## Fees

Operating in the masterchain requires about 5 TON per validation round, paid by the validator. The pool must maintain a minimum balance of 10 TON for network storage fees (non-withdrawable).
In the TON blockchain, the validator cycle is approximately 18 hours, and there are roughly 40.5 validation rounds per month (assuming a 30-day month).

Here's the breakdown of costs based on participation:

- **Participating in only odd or even cycles (half of the rounds):**

- Rounds per month: ~20.25
- Cost per round: ~5 Toncoins
- `total cost = 20.25 * 5 -> ~101.25 Toncoins`

- **Participating in both odd and even cycles (all rounds):**
- Rounds per month: ~40.5
- Cost per round : ~ 5 Toncoins
- `total cost = 40.5 * 5 -> ~202.50 Toncoins`

## Reward distribution

Expand Down Expand Up @@ -195,7 +208,6 @@ For nominator `EQA0i8-CdGnF_DhUHHf92R1ONH6sIA9vLZ_WLcCIhfBBXwtG`:
get_nominator_data 0x348bcf827469c5fc38541c77fdd91d4e347eac200f6f2d9fd62dc08885f0415f
```


### Voting Methods

#### Get-method list_votes
Expand Down Expand Up @@ -237,4 +249,3 @@ To obtain the pool's complete state, you need to query both `get_pool_data` and
- [Usage guide](/v3/guidelines/smart-contracts/howto/nominator-pool)

<Feedback />

18 changes: 16 additions & 2 deletions docs/v3/guidelines/smart-contracts/howto/nominator-pool.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -109,6 +109,21 @@ In these commands, `1005` TON is the deposit amount. The pool will deduct 1 TON
13. Invite nominators to deposit into your pools. The participation in validation will commence automatically.

> (!) Ensure you have at least 200 TON/month in your validator wallet for operation fees.
>
> In the TON blockchain, the validator cycle is approximately 18 hours, and there are roughly 40.5 validation rounds per month (assuming a 30-day month).
>
> Here's the breakdown of costs based on participation:
>
> - **Participating in only odd or even cycles (half of the rounds):**
>
> - Rounds per month: ~20.25
> - Cost per round: ~5 Toncoins
> - `total cost = 20.25 * 5 -> ~101.25 Toncoins`
>
> - **Participating in both odd and even cycles (all rounds):**
> - Rounds per month: ~40.5
> - Cost per round : ~ 5 Toncoins
> - `total cost = 40.5 * 5 -> ~202.50 Toncoins`

## Pool configuration

Expand All @@ -123,5 +138,4 @@ If you're creating a pool for numerous nominators, you might use something like
2. Await the return of both your stakes from the elector.

3. Proceed with the steps under [Running the validator in nominator pool mode](#validator-pool-mode) from the **4th step** onwards.
<Feedback />

<Feedback />
Loading