Merge pull request #424 from Gusarich/patch-2

add comments for bit sequences in messages serialisation

docs/develop/dapps/asset-processing/nfts.md

@@ -187,7 +187,7 @@ var nft_msg = begin_cell()
   .store_uint(0x18, 6)
   .store_slice(nft_address)
   .store_coins(0)
-  .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1)
+  .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
   .store_uint(op::transfer(), 32)
   .store_uint(query_id, 64)
   .store_slice(sender_address) ;; new_owner_address

docs/develop/func/cookbook.md

@@ -402,7 +402,7 @@ cell msg = begin_cell()
     .store_uint(0x18, 6)
     .store_slice(addr)
     .store_coins(amount)
-    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1)
+    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
     .store_uint(op, 32)
 .end_cell();
 
@@ -451,7 +451,7 @@ cell msg = begin_cell()
     .store_uint(0x18, 6)
     .store_slice(addr)
     .store_coins(amount)
-    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1) 
+    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1) ;; default message headers (see sending messages page)
     .store_uint(1, 1) ;; set bit to 1 to indicate that the cell will go on
     .store_ref(message_body)
 .end_cell();
@@ -500,7 +500,7 @@ cell msg = begin_cell()
     .store_uint(0x18, 6)
     .store_slice(addr)
     .store_coins(amount)
-    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1)
+    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
     .store_uint(op, 32)
     .store_slice(message_body)
 .end_cell();
@@ -1081,7 +1081,7 @@ cell msg = begin_cell()
     .store_uint(0x18, 6) ;; flags
     .store_slice("EQBIhPuWmjT7fP-VomuTWseE8JNWv2q7QYfsVQ1IZwnMk8wL"a) ;; destination address
     .store_coins(100) ;; amount of nanoTons to send
-    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; 107 zero-bits
+    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
     .store_uint(0, 32) ;; zero opcode - means simple transfer message with comment
     .store_slice("Hello from FunC!") ;; comment
 .end_cell();
@@ -1111,7 +1111,7 @@ The contract example below is useful to us if we need to perform any actions bet
         .store_uint(0x18, 6)
         .store_slice(addr)
         .store_coins(100) ;; just for example
-        .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1)
+        .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
         .store_slice(body)
     .end_cell();
     send_raw_message(msg, mode);
@@ -1133,7 +1133,7 @@ cell msg = begin_cell()
     .store_uint(0x18, 6) ;; flags
     .store_slice("EQBIhPuWmjT7fP-VomuTWseE8JNWv2q7QYfsVQ1IZwnMk8wL"a) ;; destination address
     .store_coins(0) ;; we don't care about this value right now
-    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; 107 zero-bits
+    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
     .store_uint(0, 32) ;; zero opcode - means simple transfer message with comment
     .store_slice("Hello from FunC!") ;; comment
 .end_cell();
@@ -1173,7 +1173,7 @@ cell msg = begin_cell()
     ;; We use literal `a` to get valid address inside slice from string containing address 
     .store_slice("EQBIhPuWmjT7fP-VomuTWseE8JNWv2q7QYfsVQ1IZwnMk8wL"a) ;; destination address
     .store_coins(100) ;; amount of nanoTons to send
-    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1) ;; 106 zero-bits, necessary for internal messages
+    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1) ;; default message headers (see sending messages page)
     .store_uint(1, 1) ;; we want to store body as a ref
     .store_ref(body)
 .end_cell();

docs/develop/howto/fees-low-level.md

@@ -79,7 +79,7 @@ slice payload_encoding(int a, int b, int c) {
     .store_uint(0x18, 6)
     .store_slice(destination)
     .store_coins(0)
-    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; some flags related to message header
+    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
     .store_uint(0x33bbff77, 32) ;; op-code (see smart-contract guidelines)
     .store_uint(cur_lt(), 64)  ;; query_id (see smart-contract guidelines)
     .store_slice(payload)
@@ -107,7 +107,7 @@ builder payload_encoding(int a, int b, int c) {
     .store_uint(0x18, 6)
     .store_slice(destination)
     .store_coins(0)
-    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; some flags related to message header
+    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
     .store_uint(0x33bbff77, 32) ;; op-code (see smart-contract guidelines)
     .store_uint(cur_lt(), 64)  ;; query_id (see smart-contract guidelines)
     .store_builder(payload)

docs/develop/smart-contracts/guidelines/get-methods.md

@@ -340,7 +340,7 @@ int get_total() method_id {
             .store_uint(0x18, 6)
             .store_slice(sender)
             .store_coins(0)
-            .store_uint(0, 107)
+            .store_uint(0, 107) ;; default message headers (see sending messages page)
             .store_uint(3, 32) ;; response operation code
             .store_uint(total, 32) ;; the requested number
         .end_cell(), 64);

docs/develop/smart-contracts/guidelines/random-number-generation.md

@@ -52,7 +52,7 @@ The purpose of this contract is just to forward the message back to the sender.
             .store_uint(0x18, 6)
             .store_slice(sender)
             .store_coins(0)
-            .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1)
+            .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
             .store_slice(in_msg_body)
         .end_cell(),
         64 + 2 ;; send the remaining value of an incoming msg & ignore errors
@@ -87,7 +87,7 @@ const echo_address = "Ef8Nb7157K5bVxNKAvIWreRcF0RcUlzcCA7lwmewWVNtqM3s"a;
                 .store_uint(0x18, 6)
                 .store_slice(echo_address)
                 .store_coins(0)
-                .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1)
+                .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
                 .store_uint(1, 32) ;; let 1 be echo opcode in our contract
                 .store_slice(sender) ;; forward user address
             .end_cell(),
@@ -111,7 +111,7 @@ const echo_address = "Ef8Nb7157K5bVxNKAvIWreRcF0RcUlzcCA7lwmewWVNtqM3s"a;
                     .store_uint(0x18, 6)
                     .store_slice(user)
                     .store_coins(2000000000) ;; 2 TON
-                    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1)
+                    .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
                 .end_cell(),
                 3 ;; ignore errors & pay fees separately
             );

docs/develop/smart-contracts/tutorials/wallet.md

@@ -342,7 +342,7 @@ var msg = begin_cell()
   .store_uint(0x18, 6) ;; or 0x10 for non-bounce
   .store_slice(to_address)
   .store_coins(amount)
-  .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1)
+  .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
   ;; store something as a body
 ```
 
@@ -357,7 +357,7 @@ var msg = begin_cell()
   .store_uint(0, 2) ;; src -> two zero bits for addr_none
   .store_slice(to_address)
   .store_coins(amount)
-  .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1)
+  .store_uint(0, 1 + 4 + 4 + 64 + 32 + 1 + 1) ;; default message headers (see sending messages page)
   ;; store something as a body
 ```
 Now let’s go through each option in detail: