Skip to content

feat: add toncenter overview and rate limit pages #1054

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.

Sign up for GitHub

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

Jump to bottom
Open
wants to merge 49 commits into
base: main
Choose a base branch
from
Open

feat: add toncenter overview and rate limit pages #1054

wants to merge 49 commits into from
+224 −0

Conversation

@laviniat1996
Copy link
Collaborator

@laviniat1996 laviniat1996 commented Oct 30, 2025

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
Copy link

github-actions bot commented Oct 30, 2025

To fix the formatting issues:

  1. Install necessary dependencies: npm ci
  2. Then, run this command:
npx remark -o --silent --silently-ignore ecosystem/rpc/toncenter/rate-limit.mdx ecosystem/rpc/toncenter/overview.mdx

@laviniat1996
Copy link
Collaborator Author

laviniat1996 commented Oct 30, 2025

/review

@laviniat1996 laviniat1996 self-assigned this Oct 30, 2025
github-actions[bot]
github-actions bot reviewed Oct 30, 2025
View reviewed changes
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No documentation issues detected.

@reveloper
Copy link
Collaborator

reveloper commented Oct 31, 2025 •
edited
Loading

@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
Copy link
Collaborator

reveloper commented Oct 31, 2025

cc @kdimentionaltree.

@laviniat1996
Copy link
Collaborator Author

laviniat1996 commented Oct 31, 2025

@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
Copy link
Collaborator Author

laviniat1996 commented Oct 31, 2025

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
Copy link
Collaborator

verytactical commented Oct 31, 2025

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

@verytactical
Copy link
Collaborator

verytactical commented Nov 4, 2025

Conflicts, moving to Draft.

@verytactical verytactical marked this pull request as draft November 4, 2025 07:45
kdimentionaltree
kdimentionaltree suggested changes Nov 5, 2025
View reviewed changes
Copy link
Collaborator

@kdimentionaltree kdimentionaltree left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here are several things I'd request to improve:

  1. 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.
  2. Hosted Access -> Managed Service, Self-Hosting -> Self-Hosted Service. These names better fit in my opinion.
  3. All appearance of v3 and v2 would better to replace with "API v3" and "API v2".
  4. Rate limiting -> Managed plans and rate limiting.
  5. 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.

laviniat1996 and others added 8 commits November 6, 2025 00:27
@laviniat1996
fixes
cc23a56
@Gusarich @laviniat1996
fix(ci): do not skip empty suggestions (#1065)
d55bb26
@laviniat1996
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
@laviniat1996
update docs.json after structure move
a4c275c
@hacker-volodya @laviniat1996
fix(ecosystem.node): mylocalton improvements (#1062)
a670d5a
@Gusarich @laviniat1996
feat(styleguide): improvements (#1061)
6fdeb62 
* feat: allow <kbd>

* feat: clarify aside usage

* feat: clarify pronouns

* feat: format internal references as links
@hacker-volodya @laviniat1996
feat(tvm): gas page (#1056)
a1afbaa
@aigerimu @laviniat1996
fix(func): improve types article (#978)
cdfb7d1
@laviniat1996 @github-actions
Update ecosystem/api/toncenter/rate-limit.mdx
6487149 
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@laviniat1996 @github-actions
Update ecosystem/api/toncenter/rate-limit.mdx
65e798b 
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
laviniat1996 and others added 2 commits November 17, 2025 10:11
@laviniat1996 @github-actions
Update ecosystem/api/toncenter/rate-limit.mdx
796b876 
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@laviniat1996 @github-actions
Update ecosystem/api/toncenter/overview.mdx
b73198d 
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
kdimentionaltree
kdimentionaltree suggested changes Nov 19, 2025
View reviewed changes
Copy link
Collaborator

@kdimentionaltree kdimentionaltree left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated rateliming rules.
#1327

@reveloper reveloper self-requested a review November 21, 2025 00:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@github-actions github-actions[bot] github-actions[bot] left review comments

@verytactical verytactical Awaiting requested review from verytactical

@reveloper reveloper Awaiting requested review from reveloper

+1 more reviewer

@kdimentionaltree kdimentionaltree kdimentionaltree approved these changes

Reviewers whose approvals may not affect merge requirements

At least 1 approving review is required to merge this pull request.

Assignees

@laviniat1996 laviniat1996

Labels

3p Reviewed by someone else (a third party). Used for filtering PRs. Don't mind this.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[TON Center > API/v3 > Limits] [TON Center > API/v3 > Introduction] [TON Center > API/v2 > Limits]