Skip to content

Conversation

fakela
Copy link
Contributor

@fakela fakela commented Oct 9, 2025

This whitepaper has seven references cited.

Reference [1] is mentioned 3 times, [2] once, [3] 4 times, [4] 4 times, [5] once, [6] not mentioned, and [7] twice.

Closes issue: #561

I have also attached an external link to the reference N. Durov, “Telegram Open Network,” 2017 and 2018, for easier access.

@fakela fakela linked an issue Oct 9, 2025 that may be closed by this pull request
Copy link

github-actions bot commented Oct 9, 2025

To fix the formatting issues:

  1. Install necessary dependencies: npm ci
  2. Then, run this command:
npx remark -o --silent --silently-ignore ton/catchain.mdx 

Copy link

github-actions bot commented Oct 9, 2025

Thanks for the updates in this PR. I reviewed the changes and found no issues—no fixes needed from this review.

Copy link

To fix the formatting issues:

  1. Install necessary dependencies: npm ci
  2. Then, run this command:
npx remark -o --silent --silently-ignore ton/catchain.mdx 

Copy link

To fix the formatting issues:

  1. Install necessary dependencies: npm ci
  2. Then, run this command:
npx remark -o --silent --silently-ignore ton/catchain.mdx 

Copy link

To fix the formatting issues:

  1. Install necessary dependencies: npm ci
  2. Then, run this command:
npx remark -o --silent --silently-ignore ton/catchain.mdx 

Copy link

To fix the formatting issues:

  1. Install necessary dependencies: npm ci
  2. Then, run this command:
npx remark -o --silent --silently-ignore ton/catchain.mdx 

Copy link

To fix the formatting issues:

  1. Install necessary dependencies: npm ci
  2. Then, run this command:
npx remark -o --silent --silently-ignore ton/catchain.mdx 

Copy link

To fix the formatting issues:

  1. Install necessary dependencies: npm ci
  2. Then, run this command:
npx remark -o --silent --silently-ignore ton/catchain.mdx 

Copy link

To fix the formatting issues:

  1. Install necessary dependencies: npm ci
  2. Then, run this command:
npx remark -o --silent --silently-ignore ton/catchain.mdx 

ton/catchain.mdx Outdated
## Abstract

The aim of this text is to provide an outline of the Catchain Consensus Protocol, a Byzantine Fault Tolerant (BFT) protocol specifically crafted for block generation and validation in the TON Blockchain [\[3\]](#ref-3). This protocol can potentially be used for purposes other than block generation in a proof-of-stake (PoS) blockchain; however, the current implementation uses some optimizations valid only for this specific problem.
The aim of this text is to provide an outline of the Catchain Consensus Protocol, a Byzantine Fault Tolerant (BFT) protocol specifically crafted for block generation and validation in the TON Blockchain [[3, 2.1.12](/ton/ton#2-1-12-block-generation-intervals)][](#footnote-8). This protocol can potentially be used for purposes other than block generation in a proof-of-stake (PoS) blockchain; however, the current implementation uses some optimizations valid only for this specific problem.
Copy link
Collaborator

Choose a reason for hiding this comment

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

[3, 2.1.12]^8 notation is

  • obscure
  • not needed

We should have a link on "TON Blockchain" directly to 2.1.12 section of TON whitepaper, with an <Aside> telling that previous reference was incorrect.

Copy link
Contributor Author

@fakela fakela Oct 10, 2025

Choose a reason for hiding this comment

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

<Aside> section has been added

Copy link
Contributor Author

@fakela fakela Oct 10, 2025

Choose a reason for hiding this comment

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

@verytactical This links to the precise location on the TON blockchain and The Open Network, respectively. The footnote addition was me following this recommended approach by Alex: #627 (comment)

But I have switched to using <Aside>.

Copy link
Contributor Author

@fakela fakela Oct 10, 2025

Choose a reason for hiding this comment

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

Screenshot 2025-10-10 at 16 50 04

@verytactical this is what the <Aside> block with the comment on reference change

@fakela fakela changed the title add crossllink reference to catchain add crosslink reference to catchain Oct 10, 2025
@fakela fakela marked this pull request as ready for review October 13, 2025 13:21
Copy link
Collaborator

@verytactical verytactical left a comment

Choose a reason for hiding this comment

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

Previously requested changes were not applied. There's still a [3, 2.1.12] instead of link on "TON Blockchain".

image

@verytactical verytactical marked this pull request as draft October 13, 2025 22:31
@fakela
Copy link
Contributor Author

fakela commented Oct 13, 2025

Previously requested changes were not applied. There's still a [3, 2.1.12] instead of link on "TON Blockchain".

image

This is linking to the exact point in the TON Blockchain that it is called. It is linking to section 2.1.12 in the TON Blockchain and this applies to others.

We can't remove the ref number and add the link to the word "Ton Blockchain" they won't be able to get the reference.

@verytactical
Copy link
Collaborator

We can't remove the ref number and add the link to the word "Ton Blockchain" they won't be able to get the reference.

Who?

@reveloper
Copy link
Collaborator

reveloper commented Oct 14, 2025

@fakela, let's update this file (as the smallest pdf), then wait for the final review from @verytactical.

Please replace numbered references with textual ones. Change the links that relate to

  1. The current document (internal) links

Old format:

Section [3] (#3-block-consensus-protocol)

New format:

[Section 3](#3-block-consensus-protocol)
  1. TON blockchain whitepaper links

Old format:

(the block creation and validation software) and therefore is not the topic of this text (\[[4, 1.2](/ton/tblkch#1-2-principal-components-of-a-block-and-the-blockchain-state)] would be a more appropriate reference)

New format:

(the block creation and validation software) and therefore is not the topic of this text ([Block and the blockchain state](/ton/tblkch#1-2-principal-components-of-a-block-and-the-blockchain-state) would be a more appropriate reference)
  1. TON whitepaper links

Old format:

(a shardchain or the masterchain of the TON Blockchain; cf. \[[3, 2.6](/ton/ton#2-6-creating-and-validating-new-blocks)]

New format:

[a shardchain or the masterchain of the TON Blockchain](/ton/ton#2-6-creating-and-validating-new-blocks)

@anton-trunov anton-trunov deleted the crosslink-catchain branch October 14, 2025 14:49
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.

cross-link catchain.pdf

3 participants