add ecosystem -> rpc -> ton center overview + rate limit pages #1054

laviniat1996 · 2025-10-30T15:03:35Z

Closes #1044
Closes #1041

Added new overview.mdx page for TON Center, covering hosted access and API environments
Added new rate-limit.mdx page explaining plan tiers, default limits, and rate-limit behavior.

github-actions · 2025-10-30T15:04:18Z

To fix the formatting issues:

Install necessary dependencies: npm ci
Then, run this command:

npx remark -o --silent --silently-ignore ecosystem/rpc/toncenter/rate-limit.mdx ecosystem/rpc/toncenter/overview.mdx

laviniat1996 · 2025-10-30T15:14:00Z

/review

github-actions

No documentation issues detected.

reveloper · 2025-10-31T07:59:00Z

@laviniat1996
Pages united for api/v3 and api/v2 together. We should split them, as Ruslan suggested, and make pages related to specific issues.

Since this is not only about versions, but also about different architectures API v2 and API v3, we expect differences that will be better specified independently.

reveloper · 2025-10-31T08:04:19Z

cc @kdimentionaltree.

laviniat1996 · 2025-10-31T08:31:58Z

@reveloper Thank you for reviewing. I sent this PR to Ruslan yesterday, he asked me to wait a bit till he reviews the unified page before splitting it in two.

laviniat1996 · 2025-10-31T08:33:09Z

I want to also mention: I know we should have one page per PR, but in this case the overview contains a link to the rate limit page, and I made an exception.

verytactical · 2025-10-31T15:28:09Z

Waiting for Ruslan's review. Please ping when it's ready to be merged.

verytactical · 2025-11-04T07:45:45Z

Conflicts, moving to Draft.

kdimentionaltree

Here are several things I'd request to improve:

Transpose table with APIs so mainnet and testnet becomes columns. There are several more APIs, TON Center provides. It would be easier to add them into transposed table.
Hosted Access -> Managed Service, Self-Hosting -> Self-Hosted Service. These names better fit in my opinion.
All appearance of v3 and v2 would better to replace with "API v3" and "API v2".
Rate limiting -> Managed plans and rate limiting.
Common mistakes: describe a case when user bought subscription, but he faces ratelimit of 1RPS.

Check that API key is specified properly. RPS with API key should be 10RPS insdead of 1RPS. Facing 1RPS means API key isn't properly specified.
Subscription plans and API key changes are applies within 10 minutes to TON Center rate limiting.

…ystem/rpc -> ecosystem/api (#1064) - other minor structure improvements # Conflicts: # docs.json # ecosystem/api/toncenter/rate-limit.mdx

* feat: allow <kbd> * feat: clarify aside usage * feat: clarify pronouns * feat: format internal references as links

* upd(jettons/tokens): add decimals Insert it into jeeton metadata subsection on the metadata page. Also added link to this on Jetton how to transfer page. --------- Co-authored-by: skywardboundd <[email protected]>

Complete transfer from LaTeX to webview of the TON Blockchain whitepaper.

github-actions · 2025-11-05T22:42:53Z

To fix the formatting issues:

Install necessary dependencies: npm ci
Then, run this command:

npx remark -o --silent --silently-ignore ecosystem/api/toncenter/rate-limit.mdx ecosystem/api/toncenter/overview.mdx

laviniat1996 · 2025-11-05T22:48:20Z

@kdimentionaltree Thank you for the feedback! I've addressed all your comments, if you want to take a look.

github-actions

Thanks for the update—across ecosystem/api/toncenter I left several suggestions to fix tone and internal link format; please apply the inline suggestions.

github-actions · 2025-11-05T23:07:39Z

ecosystem/api/toncenter/overview.mdx

+Hosted access means using TON Center’s managed infrastructure instead of running your own node. This lets you
+connect to the network immediately, without setup or maintenance.
+
+You can start making requests without an API key at a default rate of 1 request per second.


[HIGH] Second-person pronouns in technical docs

Lines 123–126 address the reader directly (“This lets you…”, “You can start…”) which violates the “don’t get personal” style rule. This tone reduces neutrality and can hinder translation quality and consistency. Keep phrasing neutral and impersonal (see https://github.com/ton-org/docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L169-L172).

Suggested change

Hosted access means using TON Center’s managed infrastructure instead of running your own node. This lets you

connect to the network immediately, without setup or maintenance.

You can start making requests without an API key at a default rate of 1 request per second.

Hosted access uses TON Center’s managed infrastructure instead of running a personal node. This approach enables

immediate network access without setup or maintenance.

Requests without an API key are limited to a default rate of 1 request per second.

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

github-actions · 2025-11-05T23:07:39Z

ecosystem/api/toncenter/overview.mdx

+
+You can start making requests without an API key at a default rate of 1 request per second.
+
+To increase this limit or access private liteservers, generate an [API key](./get-api-key) and [choose a plan](./rate-limit) that suits your needs.


[HIGH] Internal links use relative paths

Line 128 links to internal pages using relative URLs ./get-api-key and ./rate-limit. The style guide requires all internal links to be root-absolute to remain stable across file moves. See https://github.com/ton-org/docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L625-L629.

Suggested change

To increase this limit or access private liteservers, generate an [API key](./get-api-key) and [choose a plan](./rate-limit) that suits your needs.

To increase this limit or access private liteservers, generate an [API key](/ecosystem/api/toncenter/get-api-key) and [choose a plan](/ecosystem/api/toncenter/rate-limit) that suits your needs.

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

github-actions · 2025-11-05T23:07:39Z

ecosystem/api/toncenter/rate-limit.mdx

+To ensure stability and fair access, TON Center applies rate limits to all API requests.\
+If your application exceeds these limits, the API returns a **429** response.
+
+You can increase your limits by [requesting an API key](./get-api-key) and selecting a higher subscription plan.


[HIGH] Internal link uses a relative path

Line 11 links to an internal page using ./get-api-key. Internal links must be root-absolute to avoid breakage when files move or paths are refactored. See https://github.com/ton-org/docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L625-L629.

Suggested change

You can increase your limits by [requesting an API key](./get-api-key) and selecting a higher subscription plan.

You can increase your limits by [requesting an API key](/ecosystem/api/toncenter/get-api-key) and selecting a higher subscription plan.

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

github-actions · 2025-11-05T23:07:40Z

ecosystem/api/toncenter/rate-limit.mdx

+## Rate limit exceeded
+
+When requests are sent faster than the allowed rate limit, the TON Center API temporarily blocks new ones.\
+You’ll receive a JSON response that tells you the rate limit was exceeded:


[HIGH] Reader-directed pronouns (“you”, “your”)

Line 34 uses “You’ll receive…,” addressing the reader directly. Rephrase to neutral language per the style guide. See https://github.com/ton-org/docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L169-L172.

Suggested change

You’ll receive a JSON response that tells you the rate limit was exceeded:

A JSON response indicates the rate limit was exceeded:

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

add ton center overview + rate limit pages

ccf1834

mintlify bot deployed to staging October 30, 2025 15:05 View deployment

fix linting

fd1baa4

mintlify bot deployed to staging October 30, 2025 15:10 View deployment

Merge branch 'main' into overview

63cff40

mintlify bot deployed to staging October 30, 2025 15:15 View deployment

laviniat1996 self-assigned this Oct 30, 2025

laviniat1996 requested a review from verytactical October 30, 2025 15:19

github-actions bot reviewed Oct 30, 2025

View reviewed changes

Merge branch 'main' into overview

b879baa

mintlify bot deployed to staging October 31, 2025 04:43 View deployment

reveloper requested a review from kdimentionaltree October 31, 2025 08:04

verytactical marked this pull request as draft November 4, 2025 07:45

kdimentionaltree suggested changes Nov 5, 2025

View reviewed changes

laviniat1996 and others added 8 commits November 6, 2025 00:27

fixes

cc23a56

fix(ci): do not skip empty suggestions (#1065)

d55bb26

feat(structure): tvm/serialization -> foundations/serialization, ecos…

025d5b5

…ystem/rpc -> ecosystem/api (#1064) - other minor structure improvements # Conflicts: # docs.json # ecosystem/api/toncenter/rate-limit.mdx

update docs.json after structure move

a4c275c

fix(ecosystem.node): mylocalton improvements (#1062)

a670d5a

feat(styleguide): improvements (#1061)

6fdeb62

* feat: allow <kbd> * feat: clarify aside usage * feat: clarify pronouns * feat: format internal references as links

feat(tvm): gas page (#1056)

a1afbaa

fix(func): improve types article (#978)

cdfb7d1

skywardboundd and others added 12 commits November 6, 2025 00:38

upd(jettons/tokens): add decimals (#1076)

79968fd

* upd(jettons/tokens): add decimals Insert it into jeeton metadata subsection on the metadata page. Also added link to this on Jetton how to transfer page. --------- Co-authored-by: skywardboundd <[email protected]>

feat(styleguide): ban relative links (#1081)

61d0252

feat(guides): improve "Make a dApp" article (#999)

3f00cc2

feat: preprocessed wallet v2 (#972)

405c770

fix: feedback on "hands-on debugging" (#927)

b18eff7

feat: blockchain sharding and hypercube routing page (#926)

09f2590

feat(wallet contracts): better illustrations (#887)

37e0f5b

refactor: split nft page into several pages (#743)

1043bee

feat: contract upgrades (#706)

13a5b2b

feat: tonviewer wording/images (#576)

70f4b8d

Convert tblkch latex to web whitepaper v2 (#921)

009f84c

Complete transfer from LaTeX to webview of the TON Blockchain whitepaper.

fix: stronger style rules for filenames

4556a1d

mintlify bot deployed to staging November 5, 2025 22:41 View deployment

Merge branch 'main' into overview

affe710

mintlify bot deployed to staging November 5, 2025 22:43 View deployment

fix linting

5be1929

mintlify bot deployed to staging November 5, 2025 22:46 View deployment

laviniat1996 marked this pull request as ready for review November 5, 2025 22:48

laviniat1996 linked an issue Nov 5, 2025 that may be closed by this pull request

[TON Center > API/v2 > Limits] #1023

Open

github-actions bot reviewed Nov 5, 2025

View reviewed changes


		You can start making requests without an API key at a default rate of 1 request per second.

		To increase this limit or access private liteservers, generate an [API key](./get-api-key) and [choose a plan](./rate-limit) that suits your needs.

	You can increase your limits by [requesting an API key](./get-api-key) and selecting a higher subscription plan.
	You can increase your limits by [requesting an API key](/ecosystem/api/toncenter/get-api-key) and selecting a higher subscription plan.

	You’ll receive a JSON response that tells you the rate limit was exceeded:
	A JSON response indicates the rate limit was exceeded:

add ecosystem -> rpc -> ton center overview + rate limit pages #1054

Are you sure you want to change the base?

add ecosystem -> rpc -> ton center overview + rate limit pages #1054

Uh oh!

Conversation

laviniat1996 commented Oct 30, 2025

Uh oh!

github-actions bot commented Oct 30, 2025

Uh oh!

laviniat1996 commented Oct 30, 2025

Uh oh!

github-actions bot left a comment

Choose a reason for hiding this comment

Uh oh!

reveloper commented Oct 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

reveloper commented Oct 31, 2025

Uh oh!

laviniat1996 commented Oct 31, 2025

Uh oh!

laviniat1996 commented Oct 31, 2025

Uh oh!

verytactical commented Oct 31, 2025

Uh oh!

verytactical commented Nov 4, 2025

Uh oh!

kdimentionaltree left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Nov 5, 2025

Uh oh!

laviniat1996 commented Nov 5, 2025

Uh oh!

github-actions bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 5, 2025

Choose a reason for hiding this comment

[HIGH] Second-person pronouns in technical docs

Uh oh!

github-actions bot Nov 5, 2025

Choose a reason for hiding this comment

[HIGH] Internal links use relative paths

Uh oh!

github-actions bot Nov 5, 2025

Choose a reason for hiding this comment

[HIGH] Internal link uses a relative path

Uh oh!

github-actions bot Nov 5, 2025

Choose a reason for hiding this comment

[HIGH] Reader-directed pronouns (“you”, “your”)

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

12 participants

reveloper commented Oct 31, 2025 •

edited

Loading