Skip to content
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

png_update #924

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

png_update #924

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
89fdb8d
MMC_update
AiramGol Jan 22, 2025
00e62da
Message_and_tracsaction_update
AiramGol Jan 24, 2025
64197eb
Jetton_processing_update
AiramGol Jan 24, 2025
167f701
scheme_guidelines_update
AiramGol Jan 24, 2025
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
12 changes: 6 additions & 6 deletions docs/v3/contribute/docs/schemes-guidelines.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,8 @@ If the order of transactions doesn't matter, you can omit their labels. This sim
<ThemedImage
alt=""
sources={{
light: '/img/docs/scheme-templates/message-processing-graphs/Graphic-Explanations-Guidelines_1.svg?raw=true',
dark: '/img/docs/scheme-templates/message-processing-graphs/Graphic-Explanations-Guidelines_1_dark.svg?raw=true',
light: '/img/docs/scheme-templates/message-processing-graphs/Graphic-Explanations-Guidelines_1.png?raw=true',
dark: '/img/docs/scheme-templates/message-processing-graphs/Graphic-Explanations-Guidelines_1_dark.png?raw=true',
}}
/>
<br></br>
Expand All @@ -35,8 +35,8 @@ If the order of transactions doesn't matter, you can omit their labels. This sim
<ThemedImage
alt=""
sources={{
light: '/img/docs/message-delivery/message_delivery_2.svg?raw=true',
dark: '/img/docs/message-delivery/message_delivery_2_dark.svg?raw=true',
light: '/img/docs/message-delivery/message_delivery_2.png?raw=true',
dark: '/img/docs/message-delivery/message_delivery_2_dark.png?raw=true',
}}
/>
<br></br>
Expand Down Expand Up @@ -79,8 +79,8 @@ In the case of complex and repetitive communication schemes between 2-3 actors,
<ThemedImage
alt=""
sources={{
light: '/img/docs/message-delivery/message_delivery_7.svg?raw=true',
dark: '/img/docs/message-delivery/message_delivery_7_dark.svg?raw=true',
light: '/img/docs/message-delivery/message_delivery_7.png?raw=true',
dark: '/img/docs/message-delivery/message_delivery_7_dark.png?raw=true',
}}
/>
</div>
Expand Down
34 changes: 17 additions & 17 deletions .../v3/documentation/smart-contracts/message-management/message-modes-cookbook.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ State before transaction: Account A has 1 TON, Account B has 1 TON

State after transaction: Account A has 0.9 TON, Account B has 1.096 TON

![](/img/docs/message-modes-cookbook/send_regular_message_1.svg)
![](/img/docs/message-modes-cookbook/send_regular_message_1.png)

| Mode and Flags | Code |
| :-------------------- | :------------------------- |
Expand All @@ -79,7 +79,7 @@ Funds included with an ignored message will still be [credited to the receiving
If no errors the result is the same as [`mode = 0`](#1-send-a-regular-message).
:::

![](/img/docs/message-modes-cookbook/send_regular_message_2.svg)
![](/img/docs/message-modes-cookbook/send_regular_message_2.png)

| Mode and Flags | Code |
| :--------------------- | :------------------------- |
Expand All @@ -94,13 +94,13 @@ In case of an error during [action phase](https://retracer.ton.org/?tx=e9dccba82

State after transaction with error: Account A has 1 - ([total_fee](/v3/documentation/smart-contracts/transaction-fees/fees#basic-fees-formula) + `fwd_fee`) TON, Account B has 1 TON

![](/img/docs/message-modes-cookbook/send_regular_message_3_error.svg)
![](/img/docs/message-modes-cookbook/send_regular_message_3_error.png)

:::info tip
If no errors the result is the same as [`mode = 0`](#1-send-a-regular-message).
:::

![](/img/docs/message-modes-cookbook/send_regular_message_3_noerror.svg)
![](/img/docs/message-modes-cookbook/send_regular_message_3_noerror.png)

| Mode and Flags | Code |
| :---------------------- | :-------------------------- |
Expand All @@ -114,7 +114,7 @@ State before transaction: Account A has 1 TON, Account B has 1 TON

State after transaction: Account A has 0.896 TON, Account B has 1.1 TON

![](/img/docs/message-modes-cookbook/send_regular_message_4.svg)
![](/img/docs/message-modes-cookbook/send_regular_message_4.png)

| Mode and Flags | Code |
| :--------------------- | :------------------------- |
Expand All @@ -129,13 +129,13 @@ In case of an error [during action phase](https://retracer.ton.org/?tx=e9dccba82

State after transaction with error: Account A has 1 - ([total_fee](/v3/documentation/smart-contracts/transaction-fees/fees#basic-fees-formula) + `fwd_fee`) TON, Account B has 1 TON

![](/img/docs/message-modes-cookbook/send_regular_message_5_error.svg)
![](/img/docs/message-modes-cookbook/send_regular_message_5_error.png)

:::info tip
If no errors the result is the same as [`mode = 1`](#4-send-a-regular-message-with-separate-fees).
:::

![](/img/docs/message-modes-cookbook/send_regular_message_5_noerror.svg)
![](/img/docs/message-modes-cookbook/send_regular_message_5_noerror.png)

| Mode and Flags | Code |
| :------------------------------- | :-------------------------- |
Expand All @@ -160,7 +160,7 @@ Please note that `SENDRAWMSG` doesn't update balance.
If you try to send multiple messages (i.e. mode 0 **and** mode 64) you'll get exit code 37.
:::

![](/img/docs/message-modes-cookbook/carry_remaining_value_6.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_6.png)

| Mode and Flags | Code |
| :--------------------- | :-------------------------- |
Expand All @@ -179,7 +179,7 @@ You might check [this example](https://retracer.ton.org/?tx=5c2525feeb3b93db594b
Please note that `storage_fee` is included in `total_fee` but it is always paid from contract `balance`.
:::

![](/img/docs/message-modes-cookbook/carry_remaining_value_7.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_7.png)

| Mode and Flags | Code |
| :---------------------- | :-------------------------- |
Expand All @@ -194,13 +194,13 @@ In case of an error during action phase, the message will bounce and `total_fee`

State after transaction with error: Account A has 1 - (total_fee + `fwd_fee`) TON, Account B has 1 TON, Account C has 1 TON

![](/img/docs/message-modes-cookbook/carry_remaining_value_8_error.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_8_error.png)

:::info tip
If no errors the result is the same as [`mode = 64`](#6-carry-remaining-value-with-new-message). This mode is actually used a lot in TON for jetton transfers, you can [check it in C5 action list](https://retracer.ton.org/?tx=6489d60d9197c0be7ee64b0812139d82221e8f94c6e378c356acc10f9067310c) of the jetton wallet.
:::

![](/img/docs/message-modes-cookbook/carry_remaining_value_8_noerror.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_8_noerror.png)

| Mode and Flags | Code |
| :----------------------- | :-------------------------- |
Expand All @@ -215,13 +215,13 @@ In case of an error during action phase, the message will bounce and `total_fee`

State after transaction with error: Account A has 1 - (total_fee + `fwd_fee`) TON, Account B has 1 TON, Account C has 1 TON

![](/img/docs/message-modes-cookbook/carry_remaining_value_9_error.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_9_error.png)

:::info tip
If no errors the result is the same as [`mode = 65`](#7-carry-remaining-value-with-new-message-with-separate-fees).
:::

![](/img/docs/message-modes-cookbook/carry_remaining_value_9_noerror.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_9_noerror.png)

| Mode and Flags | Code |
| :--------------------------- | :-------------------------- |
Expand All @@ -235,7 +235,7 @@ State before transaction: Account A has 1 TON, Account B has 1 TON, Account C ha

State after transaction: Account A has 0.896 TON, Account B has 0 TON, Account C has 2.1 - (total_fee + `fwd_fee`) TON

![](/img/docs/message-modes-cookbook/carry_remaining_value_10.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_10.png)

| Mode and Flags | Code |
| :---------------------- | :--------------------------- |
Expand All @@ -249,13 +249,13 @@ State before transaction: Account A has 1 TON, Account B has 1 TON, Account C ha

State after transaction with error: Account A has 1 - (total_fee + `fwd_fee`) TON, Account B has 1 TON, Account C has 1 TON

![](/img/docs/message-modes-cookbook/carry_remaining_value_11_error.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_11_error.png)

:::info tip
If no errors the result is the same as [`mode = 128`](#10-send-all-received-tokens-together-with-the-contract-balance). This mode is actually used a lot in TON for jetton transfers, you can [check it in C5 action list](https://retracer.ton.org/?tx=e4f31e37eec74a8cfcecdad9246a6bbf3da20c4edb3635150cb0fa54b9def558) of the jetton wallet.
:::

![](/img/docs/message-modes-cookbook/carry_remaining_value_11_noerror.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_11_noerror.png)

| Mode and Flags | Code |
| :------------------------ | :--------------------------- |
Expand All @@ -271,7 +271,7 @@ State after transaction: Account A has 0.896 TON, Account B has 0 TON and `nonex

When the balance reaches 0 TON destroy the contract.

![](/img/docs/message-modes-cookbook/carry_remaining_value_12.svg)
![](/img/docs/message-modes-cookbook/carry_remaining_value_12.png)

| Mode and Flags | Code |
| :------------------------ | :--------------------------- |
Expand Down
34 changes: 17 additions & 17 deletions .../documentation/smart-contracts/message-management/messages-and-transactions.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ A message is a packet of data exchanged between actors (users, applications, or
<ThemedImage
alt=""
sources={{
light: '/img/docs/message-delivery/message_delivery_1.svg?raw=true',
dark: '/img/docs/message-delivery/message_delivery_1_dark.svg?raw=true',
light: '/img/docs/message-delivery/message_delivery_1.png?raw=true',
dark: '/img/docs/message-delivery/message_delivery_1_dark.png?raw=true',
}}
/>
</div>
Expand All @@ -41,8 +41,8 @@ A transaction in TON consists of the following:
<ThemedImage
alt=""
sources={{
light: '/img/docs/message-delivery/message_delivery_2.svg?raw=true',
dark: '/img/docs/message-delivery/message_delivery_2_dark.svg?raw=true',
light: '/img/docs/message-delivery/message_delivery_2.png?raw=true',
dark: '/img/docs/message-delivery/message_delivery_2_dark.png?raw=true',
}}
/>
<br></br>
Expand Down Expand Up @@ -105,8 +105,8 @@ It is strictly guaranteed that the transaction resulting from a message will hav
<ThemedImage
alt=""
sources={{
light: '/img/docs/message-delivery/message_delivery_3.svg?raw=true',
dark: '/img/docs/message-delivery/message_delivery_3_dark.svg?raw=true',
light: '/img/docs/message-delivery/message_delivery_3.png?raw=true',
dark: '/img/docs/message-delivery/message_delivery_3_dark.png?raw=true',
}}
/>
<br></br>
Expand All @@ -124,8 +124,8 @@ If `msg1_lt < msg2_lt` => `tx1_lt < tx2_lt`.
<ThemedImage
alt=""
sources={{
light: '/img/docs/message-delivery/message_delivery_5.svg?raw=true',
dark: '/img/docs/message-delivery/message_delivery_5_dark.svg?raw=true',
light: '/img/docs/message-delivery/message_delivery_5.png?raw=true',
dark: '/img/docs/message-delivery/message_delivery_5_dark.png?raw=true',
}}
/>
</div>
Expand Down Expand Up @@ -153,7 +153,7 @@ Suppose that there are two contracts - _A_ and _B_. _A_ receives an external mes
alt=""
sources={{
light: '/img/docs/message-delivery/msg-delivery-1.png?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-1_dark.svg?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-1-dark.png?raw=true',
}}
/>
</div>
Expand All @@ -176,8 +176,8 @@ We have two possible traces for these transaction,
<ThemedImage
alt=""
sources={{
light: '/img/docs/message-delivery/message_delivery_6.svg?raw=true',
dark: '/img/docs/message-delivery/message_delivery_6_dark.svg?raw=true',
light: '/img/docs/message-delivery/message_delivery_6.png?raw=true',
dark: '/img/docs/message-delivery/message_delivery_6_dark.png?raw=true',
}}
/>
</div>
Expand All @@ -190,8 +190,8 @@ We have two possible traces for these transaction,
<ThemedImage
alt=""
sources={{
light: '/img/docs/message-delivery/message_delivery_7.svg?raw=true',
dark: '/img/docs/message-delivery/message_delivery_7_dark.svg?raw=true',
light: '/img/docs/message-delivery/message_delivery_7.png?raw=true',
dark: '/img/docs/message-delivery/message_delivery_7_dark.png?raw=true',
}}
/>
</div>
Expand All @@ -205,7 +205,7 @@ The same thing happens in the reverse case, when two contracts _B_ and _C_ send
alt=""
sources={{
light: '/img/docs/message-delivery/msg-delivery-3.png?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-3_dark.svg?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-3_dark.png?raw=true',
}}
/>
</div>
Expand All @@ -219,7 +219,7 @@ There can be many possible scenarios of smart contract interactions, and in any
alt=""
sources={{
light: '/img/docs/message-delivery/msg-delivery-4.png?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-4_dark.svg?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-4_dark.png?raw=true',
}}
/>
</div>
Expand All @@ -231,7 +231,7 @@ There can be many possible scenarios of smart contract interactions, and in any
alt=""
sources={{
light: '/img/docs/message-delivery/msg-delivery-5.png?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-5_dark.svg?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-5_dark.png?raw=true',
}}
/>
</div>
Expand All @@ -243,7 +243,7 @@ There can be many possible scenarios of smart contract interactions, and in any
alt=""
sources={{
light: '/img/docs/message-delivery/msg-delivery-6.png?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-6_dark.svg?raw=true',
dark: '/img/docs/message-delivery/msg-delivery-6-dark.png?raw=true',
}}
/>
</div>
Expand Down
8 changes: 4 additions & 4 deletions docs/v3/guidelines/dapps/asset-processing/jettons.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -102,8 +102,8 @@ Standardized tokens on TON are implemented using a set of smart contracts, inclu
<ThemedImage
alt=""
sources={{
light: '/img/docs/asset-processing/jetton_contracts.svg?raw=true',
dark: '/img/docs/asset-processing/jetton_contracts_dark.svg?raw=true',
light: '/img/docs/asset-processing/jetton_contracts.png?raw=true',
dark: '/img/docs/asset-processing/jetton_contracts_dark.png?raw=true',
}}
/>
<br></br>
Expand Down Expand Up @@ -273,8 +273,8 @@ Communication between Jetton wallets and TON wallets occurs through the followin
<ThemedImage
alt=""
sources={{
light: '/img/docs/asset-processing/jetton_transfer.svg?raw=true',
dark: '/img/docs/asset-processing/jetton_transfer_dark.svg?raw=true',
light: '/img/docs/asset-processing/jetton_transfer.png?raw=true',
dark: '/img/docs/asset-processing/jetton_transfer_dark.png?raw=true',
}}
/>
<br></br>
Expand Down
Binary file added static/img/docs/asset-processing/jetton_contracts.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/asset-processing/jetton_contracts_dark.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/asset-processing/jetton_transfer.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/asset-processing/jetton_transfer_dark.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/img/docs/cells-as-data-storage/Cells-as-data-storage_1_dark.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/message-delivery/Old/6 message_delivery_3.vsdx
View file
Open in desktop
Binary file not shown.
Binary file added static/img/docs/message-delivery/Old/message_delivery_1.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
0 ...s/message-delivery/message_delivery_1.svg → ...ssage-delivery/Old/message_delivery_1.svg
View file
Open in desktop
File renamed without changes
0 ...sage-delivery/message_delivery_1_dark.svg → ...-delivery/Old/message_delivery_1_dark.svg
View file
Open in desktop
File renamed without changes
0 ...s/message-delivery/message_delivery_2.svg → ...ssage-delivery/Old/message_delivery_2.svg
View file
Open in desktop
File renamed without changes
0 ...sage-delivery/message_delivery_2_dark.svg → ...-delivery/Old/message_delivery_2_dark.svg
View file
Open in desktop
File renamed without changes
0 ...s/message-delivery/message_delivery_3.svg → ...ssage-delivery/Old/message_delivery_3.svg
View file
Open in desktop
File renamed without changes
0 ...sage-delivery/message_delivery_3_dark.svg → ...-delivery/Old/message_delivery_3_dark.svg
View file
Open in desktop
File renamed without changes
0 ...s/message-delivery/message_delivery_5.svg → ...ssage-delivery/Old/message_delivery_5.svg
View file
Open in desktop
File renamed without changes
0 ...sage-delivery/message_delivery_5_dark.svg → ...-delivery/Old/message_delivery_5_dark.svg
View file
Open in desktop
File renamed without changes
0 ...s/message-delivery/message_delivery_6.svg → ...ssage-delivery/Old/message_delivery_6.svg
View file
Open in desktop
File renamed without changes
0 ...sage-delivery/message_delivery_6_dark.svg → ...-delivery/Old/message_delivery_6_dark.svg
View file
Open in desktop
File renamed without changes
0 ...s/message-delivery/message_delivery_7.svg → ...ssage-delivery/Old/message_delivery_7.svg
View file
Open in desktop
File renamed without changes
0 ...sage-delivery/message_delivery_7_dark.svg → ...-delivery/Old/message_delivery_7_dark.svg
View file
Open in desktop
File renamed without changes
0 .../message-delivery/msg-delivery-1_dark.svg → ...sage-delivery/Old/msg-delivery-1_dark.svg
View file
Open in desktop
File renamed without changes
0 .../message-delivery/msg-delivery-3_dark.svg → ...sage-delivery/Old/msg-delivery-3_dark.svg
View file
Open in desktop
File renamed without changes
0 .../message-delivery/msg-delivery-4_dark.svg → ...sage-delivery/Old/msg-delivery-4_dark.svg
View file
Open in desktop
File renamed without changes
0 .../message-delivery/msg-delivery-5_dark.svg → ...sage-delivery/Old/msg-delivery-5_dark.svg
View file
Open in desktop
File renamed without changes
0 .../message-delivery/msg-delivery-6_dark.svg → ...sage-delivery/Old/msg-delivery-6_dark.svg
View file
Open in desktop
File renamed without changes
Binary file added static/img/docs/message-delivery/message_delivery_1.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/message-delivery/message_delivery_1_dark.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/docs/message-delivery/message_delivery_2.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/message_delivery_2_dark.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/message_delivery_3.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/message_delivery_3_dark.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/message_delivery_5.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/message_delivery_5_dark.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/message_delivery_6.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/message_delivery_6_dark.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/message_delivery_7.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/message_delivery_7_dark.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/msg-delivery-1-dark.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/msg-delivery-3_dark.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/msg-delivery-4_dark.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/msg-delivery-5_dark.png
View file
Open in desktop
Binary file added static/img/docs/message-delivery/msg-delivery-6-dark.png
View file
Open in desktop
Binary file added static/img/docs/message-modes-cookbook/carry_remaining_value_10.png
View file
Open in desktop
Loading
Loading