From b8bfabfcba1b9457be7059956b028a9455daea14 Mon Sep 17 00:00:00 2001 From: Vladimir Lebedev Date: Mon, 10 Nov 2025 14:54:05 +0700 Subject: [PATCH 1/7] feat: whitepaper comments --- foundations/whitepapers/comments.mdx | 42 ++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 foundations/whitepapers/comments.mdx diff --git a/foundations/whitepapers/comments.mdx b/foundations/whitepapers/comments.mdx new file mode 100644 index 000000000..decaa0a53 --- /dev/null +++ b/foundations/whitepapers/comments.mdx @@ -0,0 +1,42 @@ +--- +title: "Whitepapers comments" +--- + +Whitepapers were written a couple of years ago, here is comments to whitepapers. + +## The Open Network (ton.pdf) + +## TON Virtual Machine (tvm.pdf) + +### 1.3.2. List of control registers + +The zero element of the `c7` tuple is an environment information (which itself is also a tuple). The remaining 255 slots are used for global variables. [`[i] SETGLOB`](/tvm/instructions#f87_-setglob) modifies `c7`, inserting an element with index `i`, [`[i] GETGLOB`](/tvm/instructions#f85_-getglob) reads `i`-th element from `c7`. See [TVM > Registers](/tvm/registers#c7-%E2%80%94-environment-information-and-global-variables) for details. + +### 4.4. Continuations as objects + +It is possible to construct such objects, however, no high-level language implemented it yet. + +### 4.5.7. List of predefined exceptions + +Exit code `11` is thrown by [standard function selector](/tvm/registers#c3-—-function-selector) if there is no function with given id. Also it is thrown by [SENDMSG](/tvm/instructions#fb08-sendmsg) in case of invalid message. + +### 5.1. Codepages and interoperability of different TVM versions + +Currently only codepage `0` implemented. + +### A. Instructions and opcodes + +Basic gas price is `10 + b`, not `10 + b + 5r`. See [TVM > Gas](/tvm/gas) for details. + +Provided instruction list is obsolete. Consider use [TVM > Instructions](/tvm/instructions). + +### B.2. Step function of TVM + +"Reference implementation of TVM" and codepages `-1` and `-2` are not implemented yet. + +## TON Blockchain (tblkch.pdf) + +## Catchain (catchain.pdf) + +## Fift (fiftbase.pdf) + From 85252a0df0a545e8447c6249fe69156d96edde25 Mon Sep 17 00:00:00 2001 From: Vladimir Lebedev Date: Thu, 13 Nov 2025 22:42:35 +0700 Subject: [PATCH 2/7] Update foundations/whitepapers/comments.mdx Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- foundations/whitepapers/comments.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/foundations/whitepapers/comments.mdx b/foundations/whitepapers/comments.mdx index decaa0a53..af1f7fcc3 100644 --- a/foundations/whitepapers/comments.mdx +++ b/foundations/whitepapers/comments.mdx @@ -18,7 +18,7 @@ It is possible to construct such objects, however, no high-level language implem ### 4.5.7. List of predefined exceptions -Exit code `11` is thrown by [standard function selector](/tvm/registers#c3-—-function-selector) if there is no function with given id. Also it is thrown by [SENDMSG](/tvm/instructions#fb08-sendmsg) in case of invalid message. +Exit code `11` is thrown by [standard function selector](/tvm/registers#c3-—-function-selector) if there is no function with given id. Also it is thrown by [`SENDMSG`](/tvm/instructions#fb08-sendmsg) in case of invalid message. ### 5.1. Codepages and interoperability of different TVM versions From 47a00e32f5c3c541002b0d8c3baa2f4d4f803b16 Mon Sep 17 00:00:00 2001 From: Vladimir Lebedev Date: Thu, 13 Nov 2025 22:43:33 +0700 Subject: [PATCH 3/7] Update foundations/whitepapers/comments.mdx Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- foundations/whitepapers/comments.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/foundations/whitepapers/comments.mdx b/foundations/whitepapers/comments.mdx index af1f7fcc3..c6965250d 100644 --- a/foundations/whitepapers/comments.mdx +++ b/foundations/whitepapers/comments.mdx @@ -2,7 +2,7 @@ title: "Whitepapers comments" --- -Whitepapers were written a couple of years ago, here is comments to whitepapers. +Clarifications and status notes for the whitepapers. ## The Open Network (ton.pdf) From cb0d70c0f73aff63f550e0f405140e72ea8bc324 Mon Sep 17 00:00:00 2001 From: Vladimir Lebedev Date: Fri, 14 Nov 2025 18:24:51 +0700 Subject: [PATCH 4/7] Update foundations/whitepapers/comments.mdx Co-authored-by: Novus Nota <68142933+novusnota@users.noreply.github.com> --- foundations/whitepapers/comments.mdx | 42 +++++++++++++++++++++++++++- 1 file changed, 41 insertions(+), 1 deletion(-) diff --git a/foundations/whitepapers/comments.mdx b/foundations/whitepapers/comments.mdx index c6965250d..d75ce9f6c 100644 --- a/foundations/whitepapers/comments.mdx +++ b/foundations/whitepapers/comments.mdx @@ -38,5 +38,45 @@ Provided instruction list is obsolete. Consider use [TVM > Instructions](/tvm/in ## Catchain (catchain.pdf) -## Fift (fiftbase.pdf) +## Fift, `fiftbase.pdf` + +### 1 Overview + +> The dictionary is supposed to be split into several vocabularies, or namespaces; however, namespaces are not implemented yet, so all words are currently defined in the same global namespace. + +Namespaces and context switching are now implemented — Fift words are defined in the default dictionary and accessible through the global namespace called `Fift`. + +It is now possible to add new namespaces with the `namespace` word or switch dictionary contexts on the fly. It is also possible to define words or named constants directly under those namespaces and reference words from different namespaces: + +```fift +namespace My + +"a" constant a +"b" constant b +"c" constant c + +a b c .s { drop } 3 times // "a" "b" "c" + +My definitions +"b-my" constant b +"c-my" constant c +"d-my" constant d + +a b c d .s { drop } 4 times // "a" "b-my" "c-my" "d-my" + +Fift definitions +a b c .s { drop } 3 times // "a" "b-my" "c-my" "d-my" + +My b My c My d .s { drop } 3 times // "b-my" "c-my" "d-my" +a b c .s { drop } 3 times // "a" "b" "c" "d" + +My definitions +a b c d .s { drop } 4 times // "a" "b-my" "c-my" "d-my" +Fift a Fift b Fift c d .s { drop } 4 times // "a" "b" "c" "d-my" + +Fift definitions +cr +My-wordlist @ +{ drop type -1 } hmapforeach drop cr // "b " "d " "c " +``` From c6af95a9436d9bdaf290c41e77b5c16636e531f4 Mon Sep 17 00:00:00 2001 From: Vladimir Lebedev Date: Tue, 18 Nov 2025 16:46:54 +0700 Subject: [PATCH 5/7] Remove outdated sections from comments.mdx Removed sections for 'The Open Network' and 'TON Blockchain' from comments. --- foundations/whitepapers/comments.mdx | 6 ------ 1 file changed, 6 deletions(-) diff --git a/foundations/whitepapers/comments.mdx b/foundations/whitepapers/comments.mdx index d75ce9f6c..6c339ca2c 100644 --- a/foundations/whitepapers/comments.mdx +++ b/foundations/whitepapers/comments.mdx @@ -4,8 +4,6 @@ title: "Whitepapers comments" Clarifications and status notes for the whitepapers. -## The Open Network (ton.pdf) - ## TON Virtual Machine (tvm.pdf) ### 1.3.2. List of control registers @@ -34,10 +32,6 @@ Provided instruction list is obsolete. Consider use [TVM > Instructions](/tvm/in "Reference implementation of TVM" and codepages `-1` and `-2` are not implemented yet. -## TON Blockchain (tblkch.pdf) - -## Catchain (catchain.pdf) - ## Fift, `fiftbase.pdf` ### 1 Overview From 0d0179fc989070da7c980cb14147078e48bc91d8 Mon Sep 17 00:00:00 2001 From: Vladimir Lebedev Date: Tue, 18 Nov 2025 16:52:24 +0700 Subject: [PATCH 6/7] fix: navigation, formatting --- docs.json | 1 + foundations/whitepapers/comments.mdx | 5 ++--- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs.json b/docs.json index d901eb966..b9804a80d 100644 --- a/docs.json +++ b/docs.json @@ -563,6 +563,7 @@ "group": "Whitepapers", "pages": [ "foundations/whitepapers/overview", + "foundations/whitepapers/comments", "foundations/whitepapers/tvm", "foundations/whitepapers/tblkch", "foundations/whitepapers/ton", diff --git a/foundations/whitepapers/comments.mdx b/foundations/whitepapers/comments.mdx index 6c339ca2c..60b8b298b 100644 --- a/foundations/whitepapers/comments.mdx +++ b/foundations/whitepapers/comments.mdx @@ -4,7 +4,7 @@ title: "Whitepapers comments" Clarifications and status notes for the whitepapers. -## TON Virtual Machine (tvm.pdf) +## TON Virtual Machine, `tvm.pdf` ### 1.3.2. List of control registers @@ -20,7 +20,7 @@ Exit code `11` is thrown by [standard function selector](/tvm/registers#c3-—-f ### 5.1. Codepages and interoperability of different TVM versions -Currently only codepage `0` implemented. +Currently only codepage `0` implemented. ### A. Instructions and opcodes @@ -73,4 +73,3 @@ cr My-wordlist @ { drop type -1 } hmapforeach drop cr // "b " "d " "c " ``` - From ec4119ba8d4175bb129ee27d40f24816042b7997 Mon Sep 17 00:00:00 2001 From: Novus Nota <68142933+novusnota@users.noreply.github.com> Date: Tue, 18 Nov 2025 12:04:42 +0100 Subject: [PATCH 7/7] Update foundations/whitepapers/comments.mdx --- foundations/whitepapers/comments.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/foundations/whitepapers/comments.mdx b/foundations/whitepapers/comments.mdx index 60b8b298b..bf6e24446 100644 --- a/foundations/whitepapers/comments.mdx +++ b/foundations/whitepapers/comments.mdx @@ -1,5 +1,6 @@ --- title: "Whitepapers comments" +sidebarTitle: "Comments" --- Clarifications and status notes for the whitepapers.