Merge pull request #10 from defi-pickle/send-modes

feat: message modes documentation

Author: Hiyorimi

pages/language/ref/_meta.json

@@ -1,8 +1,9 @@
 {
-  "common": "Common",
-  "strings": "Strings",
-  "random": "Random",
-  "math": "Math",
-  "cells": "Cells, Builders and Slices",
-  "advanced": "Advanced"
+	"common": "Common",
+	"strings": "Strings",
+	"random": "Random",
+	"math": "Math",
+	"cells": "Cells, Builders and Slices",
+	"message-modes": "Message modes",
+	"advanced": "Advanced"
 }

pages/language/ref/message-modes.mdx

@@ -0,0 +1,35 @@
+import { Callout } from 'nextra-theme-docs';
+
+# Message modes
+
+As you might've noticed, we send messages with `mode` param. To figure out the mode that best suits your needs, take a look at the following table:
+
+| Name                 | Mode | Description                                                                                                            |
+| -------------------- | ---- | ---------------------------------------------------------------------------------------------------------------------- |
+| SendPayGasSeparately | 1    | Pay transfer fees separately from the message value                                                                    |
+| SendIgnoreErrors     | 2    | Ignore any errors arising while processing this message during the action phase                                        |
+| SendDestroyIfZero    | 32   | Current account must be destroyed if its resulting balance is zero (often used with Mode 128)                          |
+| SendRemainingValue   | 64   | Carry all the remaining value of the inbound message in addition to the value initially indicated in the new message   |
+| SendRemainingBalance | 128  | Carry all the remaining balance of the current smart contract instead of the value originally indicated in the message |
+
+## Combining modes
+
+You can also join modes with _flags_ (modes: 1, 2, 32) in one message, for example:
+
+```tact
+let to: Address = ...;
+let value: Int = ton("1");
+send(SendParameters{
+    to: to,
+    value: value,
+    mode: SendRemainingValue + SendIgnoreErrors,
+    bounce: true,
+    body: "Hello, World!".asComment()
+});
+```
+
+# What to read next?
+
+This article was inspired by the following materials:
+
+- [https://docs.ton.org/develop/smart-contracts/messages#message-modes](https://docs.ton.org/develop/smart-contracts/messages#message-modes)