Skip to content

Conversation

@laviniat1996
Copy link
Collaborator

@laviniat1996 laviniat1996 commented Oct 16, 2025

Closes #722

@laviniat1996 laviniat1996 self-assigned this Oct 16, 2025
@github-actions

This comment was marked as resolved.

@github-actions
Copy link

Thanks for the update in the TON Center RPC docs. I found a couple of HIGH style‑guide blockers to address before merge.

Findings (2)

High (2)

[HIGH] External links include tracking parameters

Location:

[▶️ Watch Guide](https://www.canva.com/design/DAGuzMRoHjI/7FaLbvC29bSmS_JFykiu2g/watch?utm_content=DAGuzMRoHjI\&utm_campaign=designshare\&utm_medium=link2\&utm_source=uniquelinks\&utlId=h72f6e944b5)

Description:
Both “Watch Guide” Canva links include tracking query parameters (utm_*, uniquelinks, utlId), which violates the Clean URLs rule. A second occurrence appears at ecosystem/rpc/toncenter/self-hosted-ton-center-v2.mdx?plain=1#L205-L205. See https://github.com/ton-org/docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L610-L610 and https://github.com/ton-org/docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L31-L31.

Suggestion:
Remove the query strings, keeping the canonical HTTPS URLs.

--- a/ecosystem/rpc/toncenter/self-hosted-ton-center-v2.mdx
+++ b/ecosystem/rpc/toncenter/self-hosted-ton-center-v2.mdx
@@
-[▶️ Watch Guide](https://www.canva.com/design/DAGuzMRoHjI/7FaLbvC29bSmS_JFykiu2g/watch?utm_content=DAGuzMRoHjI\&utm_campaign=designshare\&utm_medium=link2\&utm_source=uniquelinks\&utlId=h72f6e944b5)
+[▶️ Watch Guide](https://www.canva.com/design/DAGuzMRoHjI/7FaLbvC29bSmS_JFykiu2g/watch)
@@
-[▶️ Watch Guide](https://www.canva.com/design/DAGuygDmwKk/TxCNWeDg4QjdTUSKkhAa2A/watch?utm_content=DAGuygDmwKk\&utm_campaign=designshare\&utm_medium=link2\&utm_source=uniquelinks\&utlId=hed091a20b9)
+[▶️ Watch Guide](https://www.canva.com/design/DAGuygDmwKk/TxCNWeDg4QjdTUSKkhAa2A/watch)

[HIGH] Emoji used in prose link text

Location:

[▶️ Watch Guide](https://www.canva.com/design/DAGuzMRoHjI/7FaLbvC29bSmS_JFykiu2g/watch?utm_content=DAGuzMRoHjI\&utm_campaign=designshare\&utm_medium=link2\&utm_source=uniquelinks\&utlId=h72f6e944b5)

Description:
The link text uses an emoji (“▶️”), which the style guide forbids in prose and headings because it reduces clarity and harms localization. The same pattern appears again at ecosystem/rpc/toncenter/self-hosted-ton-center-v2.mdx?plain=1#L205-L205. See https://github.com/ton-org/docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L95-L100.

Suggestion:
Remove the emoji and use clear, descriptive text.

- [▶️ Watch Guide](https://www.canva.com/design/DAGuzMRoHjI/7FaLbvC29bSmS_JFykiu2g/watch?utm_content=DAGuzMRoHjI\&utm_campaign=designshare\&utm_medium=link2\&utm_source=uniquelinks\&utlId=h72f6e944b5)
+ [Watch guide](https://www.canva.com/design/DAGuzMRoHjI/7FaLbvC29bSmS_JFykiu2g/watch?utm_content=DAGuzMRoHjI\&utm_campaign=designshare\&utm_medium=link2\&utm_source=uniquelinks\&utlId=h72f6e944b5)
- [▶️ Watch Guide](https://www.canva.com/design/DAGuygDmwKk/TxCNWeDg4QjdTUSKkhAa2A/watch?utm_content=DAGuygDmwKk\&utm_campaign=designshare\&utm_medium=link2\&utm_source=uniquelinks\&utlId=hed091a20b9)
+ [Watch guide](https://www.canva.com/design/DAGuygDmwKk/TxCNWeDg4QjdTUSKkhAa2A/watch?utm_content=DAGuygDmwKk\&utm_campaign=designshare\&utm_medium=link2\&utm_source=uniquelinks\&utlId=hed091a20b9)

@laviniat1996 laviniat1996 linked an issue Oct 17, 2025 that may be closed by this pull request
@novusnota novusnota self-requested a review October 17, 2025 08:33
title: Self-Host API v2 (HTTP)
---

## Overview
Copy link
Collaborator

Choose a reason for hiding this comment

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

Please don't start an article with 2 headers in a row.

The part without a header is an overview.


This guide explains how to self-host the TON HTTP API (v2) locally using either:

- **Docker (recommended for production setups):** Works on any x86\_64 and arm64 OS with Docker available.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Too much bold text.


This guide explains how to self-host the TON HTTP API (v2) locally using either:

- **Docker (recommended for production setups):** Works on any x86\_64 and arm64 OS with Docker available.
Copy link
Collaborator

Choose a reason for hiding this comment

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

List items have a structure: name, purpose, platforms. Such lists are best formatted as tables.

Platform list should be a list.


This guide explains how to self-host the TON HTTP API (v2) locally using either:

- **Docker (recommended for production setups):** Works on any x86\_64 and arm64 OS with Docker available.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Docker is a containerization solution. Python is a programming language. They shouldn't be listed as equivalent solutions.

It's very likely that inside of a Docker image there is the very same Python code.


## Recommended hardware

- **CPU architecture:** x86\_64 or arm64.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Bold.


| Flag | Description |
| ------------------------------------ | -------------------------------------- |
| `--liteserver-config` | Path or URL to LiteServer config file |
Copy link
Collaborator

Choose a reason for hiding this comment

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

How would it distinguish /foo *nix path from /foo relative URL?


| Flag | Description |
| ------------------------------------ | -------------------------------------- |
| `--liteserver-config` | Path or URL to LiteServer config file |
Copy link
Collaborator

Choose a reason for hiding this comment

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

What's LiteServer?

| `--liteserver-config` | Path or URL to LiteServer config file |
| `--tonlib-keystore` | Path to keystore directory |
| `--parallel-requests-per-liteserver` | Max concurrent requests per LiteServer |
| `--cdll-path` | Path to `tonlibjson` binary |
Copy link
Collaborator

Choose a reason for hiding this comment

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

What's tonlibjson?


| Flag | Description |
| ---------------- | ----------------------------------------------- |
| `--logs-level` | Logging level: `DEBUG`, `INFO`, `WARNING`, etc. |
Copy link
Collaborator

Choose a reason for hiding this comment

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

Is there any documentation about the things that might be found in logs?

| Flag | Description |
| ---------------- | ----------------------------------------------- |
| `--logs-level` | Logging level: `DEBUG`, `INFO`, `WARNING`, etc. |
| `--logs-jsonify` | Print logs in JSON format |
Copy link
Collaborator

Choose a reason for hiding this comment

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

Is there a schema for this JSON?

@verytactical verytactical marked this pull request as draft October 23, 2025 17:06
@reveloper reveloper changed the title add ton center self host http api guide feat: add ton center self host http api guide Nov 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Ecosystem > API > Run a self-hosted HTTP-API]

4 participants