Skip to content

Add tlb codegen link #675

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.

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

Merged
merged 4 commits into from
Aug 2, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/develop/dapps/asset-processing/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Here you can find a **short overview** on [how TON transfers work](/develop/dapp

## Overview on messages and transactions

Embodying a fully asynchronous approach, TON Blockchain involves a few concepts which are uncommon to traditional blockchains. Particularly, each interaction of any actor with the blockchain consists of a graph of asynchronously transferred [messages](/develop/smart-contracts/guidelines/message-delivery-guarantees) between smart contracts and/or the external world. Each transaction consists of one incoming message and up to 512 outgoing messages.
Embodying a fully asynchronous approach, TON Blockchain involves a few concepts which are uncommon to traditional blockchains. Particularly, each interaction of any actor with the blockchain consists of a graph of asynchronously transferred [messages](/develop/smart-contracts/guidelines/message-delivery-guarantees) between smart contracts and/or the external world. Each transaction consists of one incoming message and up to 255 outgoing messages.

There are 3 types of messages, that are fully described [here](/develop/smart-contracts/messages#types-of-messages). To put it briefly:
* [external message](/develop/smart-contracts/guidelines/external-messages):
Expand Down
7 changes: 0 additions & 7 deletions docs/develop/data-formats/tl-b-language.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -640,13 +640,6 @@ a comment
// This is one line comment
```

## IDE Support

The [intellij-ton](https://github.com/andreypfau/intellij-ton) plugin supports Fift, FunC and also TL-B.
The TL-B grammar is described in
the [TlbParser.bnf](https://github.com/ton-blockchain/intellij-ton/blob/main/src/main/grammar/TlbParser.bnf) file.


## Useful sources

- [A description of an older version of TL](https://core.telegram.org/mtproto/TL)
Expand Down
19 changes: 4 additions & 15 deletions docs/develop/data-formats/tlb-ide.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,7 @@
# IDE Support

The [intellij-ton](https://github.com/andreypfau/intellij-ton) plugin supports the Fift and FunC programming languages
as well as the typed language binary (TL-B) format.

### Highlight
The [intellij-ton](https://github.com/andreypfau/intellij-ton) plugin supports the Fift and FunC programming languages as well as the typed language binary (TL-B) format.

Additionally, the correct TL-B syntax specifications are described in the [TlbParser.bnf](https://github.com/andreypfau/intellij-ton/blob/main/src/main/grammars/TlbParser.bnf) file.

### TL-B Parsers

TL-B parsers help carry out the serialization of basic [TL-B types](/develop/data-formats/tl-b-types). Each of which implements TL-B types as an object, and returns serialized binary data.

| Language | SDK | Social |
|------------|-------------------------------------------------------------------------------------------------------------|------------------------|
| Kotlin | [ton-kotlin](https://github.com/andreypfau/ton-kotlin/tree/main/ton-kotlin-tlb) (+ parsing `.tlb` files) | https://t.me/tonkotlin |
| Go | [tonutils](https://github.com/xssnick/tonutils-go/tree/master/tlb) | https://t.me/tonutils |
| Go | [tongo](https://github.com/tonkeeper/tongo/tree/master/tlb) (+ parsing `.tlb` files) | https://t.me/tongo_lib |
| TypeScript | [tlb-parser](https://github.com/ton-community/tlb-parser) | - |
Additionally, the correct TL-B syntax specifications are described in
the [TlbParser.bnf](https://github.com/ton-blockchain/intellij-ton/blob/main/src/main/grammar/TlbParser.bnf) file.
17 changes: 17 additions & 0 deletions docs/develop/data-formats/tlb-tools.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# TL-B Tools

## TL-B Parsers

TL-B parsers help carry out the serialization of basic [TL-B types](/develop/data-formats/tl-b-types). Each of which
implements TL-B types as an object, and returns serialized binary data.

| Language | SDK | Social |
|------------|----------------------------------------------------------------------------------------------------------|------------------------|
| Kotlin | [ton-kotlin](https://github.com/andreypfau/ton-kotlin/tree/main/ton-kotlin-tlb) (+ parsing `.tlb` files) | https://t.me/tonkotlin |
| Go | [tonutils](https://github.com/xssnick/tonutils-go/tree/master/tlb) | https://t.me/tonutils |
| Go | [tongo](https://github.com/tonkeeper/tongo/tree/master/tlb) (+ parsing `.tlb` files) | https://t.me/tongo_lib |
| TypeScript | [tlb-parser](https://github.com/ton-community/tlb-parser) | - |

## TL-B Generator

[tlb-codegen](https://github.com/ton-community/tlb-codegen) package allows you to generate Typescript code for serializing and deserializing structures according to the TLB scheme provided.
1 change: 1 addition & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -580,6 +580,7 @@ const sidebars = {
'develop/data-formats/transaction-layout',
'develop/data-formats/crc32',
'develop/data-formats/tlb-ide',
'develop/data-formats/tlb-tools',
],
},
'develop/data-formats/tl',
Expand Down
Loading