Merge pull request #485 from tonlabs/1.23.0-rc

Version 1.23.0

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.23.0] – 2021-10-05
+
+### New
+- `boc.get_code_salt` and `boc.set_code_salt` functions for contract code salt management.
+- `boc.encode_tvc` and `boc.decode_tvc` functions for TVC image encoding and decoding
+- `boc.get_compiler_version` function extracting compiler version from contract code
+- `abi.update_initial_data` and `abi.decode_initial_data` function for pre-deployment contract data management
+
 ## [1.22.0] – 2021-09-20
 
 ### New

api/derive/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "api_derive"
-version = "1.22.0"
+version = "1.23.0"
 authors = ["TON DEV SOLUTIONS LTD <[email protected]>"]
 edition = "2018"
 

api/info/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "api_info"
-version = "1.22.0"
+version = "1.23.0"
 authors = ["TON DEV SOLUTIONS LTD <[email protected]>"]
 edition = "2018"
 

api/test/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "api_test"
-version = "1.22.0"
+version = "1.23.0"
 authors = ["TON DEV SOLUTIONS LTD <[email protected]>"]
 edition = "2018"
 

docs/mod_abi.md

@@ -22,6 +22,10 @@ Provides message encoding and decoding according to the ABI specification.
 
 [decode_account_data](#decode_account_data) – Decodes account data using provided data BOC and ABI.
 
+[update_initial_data](#update_initial_data) – Updates initial account data with initial values for the contract's static variables and owner's public key. This operation is applicable only for initial account data (before deploy). If the contract is already deployed, its data doesn't contain this data section any more.
+
+[decode_initial_data](#decode_initial_data) – Decodes initial values of a contract's static variables and owner's public key from account initial data This operation is applicable only for initial account data (before deploy). If the contract is already deployed, its data doesn't contain this data section any more.
+
 ## Types
 [AbiErrorCode](#AbiErrorCode)
 
@@ -89,6 +93,14 @@ Provides message encoding and decoding according to the ABI specification.
 
 [ResultOfDecodeData](#ResultOfDecodeData)
 
+[ParamsOfUpdateInitialData](#ParamsOfUpdateInitialData)
+
+[ResultOfUpdateInitialData](#ResultOfUpdateInitialData)
+
+[ParamsOfDecodeInitialData](#ParamsOfDecodeInitialData)
+
+[ResultOfDecodeInitialData](#ResultOfDecodeInitialData)
+
 
 # Functions
 ## encode_message_body
@@ -481,6 +493,73 @@ function decode_account_data(
 - `data`: _any_ – Decoded data as a JSON structure.
 
 
+## update_initial_data
+
+Updates initial account data with initial values for the contract's static variables and owner's public key. This operation is applicable only for initial account data (before deploy). If the contract is already deployed, its data doesn't contain this data section any more.
+
+```ts
+type ParamsOfUpdateInitialData = {
+    abi?: Abi,
+    data: string,
+    initial_data?: any,
+    initial_pubkey?: string,
+    boc_cache?: BocCacheType
+}
+
+type ResultOfUpdateInitialData = {
+    data: string
+}
+
+function update_initial_data(
+    params: ParamsOfUpdateInitialData,
+): Promise<ResultOfUpdateInitialData>;
+```
+### Parameters
+- `abi`?: _[Abi](mod_abi.md#Abi)_ – Contract ABI
+- `data`: _string_ – Data BOC or BOC handle
+- `initial_data`?: _any_ – List of initial values for contract's static variables.
+<br>`abi` parameter should be provided to set initial data
+- `initial_pubkey`?: _string_ – Initial account owner's public key to set into account data
+- `boc_cache`?: _[BocCacheType](mod_boc.md#BocCacheType)_ – Cache type to put the result. The BOC itself returned if no cache type provided.
+
+
+### Result
+
+- `data`: _string_ – Updated data BOC or BOC handle
+
+
+## decode_initial_data
+
+Decodes initial values of a contract's static variables and owner's public key from account initial data This operation is applicable only for initial account data (before deploy). If the contract is already deployed, its data doesn't contain this data section any more.
+
+```ts
+type ParamsOfDecodeInitialData = {
+    abi?: Abi,
+    data: string
+}
+
+type ResultOfDecodeInitialData = {
+    initial_data?: any,
+    initial_pubkey: string
+}
+
+function decode_initial_data(
+    params: ParamsOfDecodeInitialData,
+): Promise<ResultOfDecodeInitialData>;
+```
+### Parameters
+- `abi`?: _[Abi](mod_abi.md#Abi)_ – Contract ABI.
+<br>Initial data is decoded if this parameter is provided
+- `data`: _string_ – Data BOC or BOC handle
+
+
+### Result
+
+- `initial_data`?: _any_ – List of initial values of contract's public variables.
+<br>Initial data is decoded if `abi` input parameter is provided
+- `initial_pubkey`: _string_ – Initial account owner's public key
+
+
 # Types
 ## AbiErrorCode
 ```ts
@@ -497,7 +576,8 @@ enum AbiErrorCode {
     InvalidSigner = 310,
     InvalidAbi = 311,
     InvalidFunctionId = 312,
-    InvalidData = 313
+    InvalidData = 313,
+    EncodeInitialDataFailed = 314
 }
 ```
 One of the following value:
@@ -515,6 +595,7 @@ One of the following value:
 - `InvalidAbi = 311`
 - `InvalidFunctionId = 312`
 - `InvalidData = 313`
+- `EncodeInitialDataFailed = 314`
 
 
 ## Abi
@@ -1138,3 +1219,54 @@ type ResultOfDecodeData = {
 - `data`: _any_ – Decoded data as a JSON structure.
 
 
+## ParamsOfUpdateInitialData
+```ts
+type ParamsOfUpdateInitialData = {
+    abi?: Abi,
+    data: string,
+    initial_data?: any,
+    initial_pubkey?: string,
+    boc_cache?: BocCacheType
+}
+```
+- `abi`?: _[Abi](mod_abi.md#Abi)_ – Contract ABI
+- `data`: _string_ – Data BOC or BOC handle
+- `initial_data`?: _any_ – List of initial values for contract's static variables.
+<br>`abi` parameter should be provided to set initial data
+- `initial_pubkey`?: _string_ – Initial account owner's public key to set into account data
+- `boc_cache`?: _[BocCacheType](mod_boc.md#BocCacheType)_ – Cache type to put the result. The BOC itself returned if no cache type provided.
+
+
+## ResultOfUpdateInitialData
+```ts
+type ResultOfUpdateInitialData = {
+    data: string
+}
+```
+- `data`: _string_ – Updated data BOC or BOC handle
+
+
+## ParamsOfDecodeInitialData
+```ts
+type ParamsOfDecodeInitialData = {
+    abi?: Abi,
+    data: string
+}
+```
+- `abi`?: _[Abi](mod_abi.md#Abi)_ – Contract ABI.
+<br>Initial data is decoded if this parameter is provided
+- `data`: _string_ – Data BOC or BOC handle
+
+
+## ResultOfDecodeInitialData
+```ts
+type ResultOfDecodeInitialData = {
+    initial_data?: any,
+    initial_pubkey: string
+}
+```
+- `initial_data`?: _any_ – List of initial values of contract's public variables.
+<br>Initial data is decoded if `abi` input parameter is provided
+- `initial_pubkey`: _string_ – Initial account owner's public key
+
+