Added abi.decode_boc

src/main/kotlin/ee/nx01/tonclient/abi/AbiModule.kt

@@ -161,4 +161,22 @@ class AbiModule(private val tonClient: TonClient) {
     suspend fun getSignatureData(params: ParamsOfGetSignatureData): ResultOfGetSignatureData {
         return tonClient.request("abi.get_signature_data", params)
     }
+
+
+    /**
+     * Decodes BOC into JSON as a set of provided parameters.
+     * Solidity functions use ABI types for builder encoding. The simplest way to decode such a BOC is to use ABI decoding.
+     * ABI has it own rules for fields layout in cells so manually encoded BOC can not be described in terms of ABI rules.
+     * To solve this problem we introduce a new ABI type Ref(<ParamType>) which allows to store ParamType ABI parameter
+     * in cell reference and, thus, decode manually encoded BOCs. This type is available only in decode_boc function and will
+     * not be available in ABI messages encoding until it is included into some ABI revision.
+     * Such BOC descriptions covers most users needs. If someone wants to decode some BOC which can not be described by these rules
+     * (i.e. BOC with TLB containing constructors of flags defining some parsing conditions) then they can decode the fields up to fork condition,
+     * check the parsed data manually, expand the parsing schema and then decode the whole BOC with the full schema.
+     */
+    suspend fun decodeBoc(params: ParamsOfDecodeBoc): ResultOfDecodeBoc {
+        return tonClient.request("abi.decode_boc", params)
+    }
 }
+
+

src/main/kotlin/ee/nx01/tonclient/abi/Types.kt

@@ -277,4 +277,14 @@ data class ParamsOfGetSignatureData(
 data class ResultOfGetSignatureData(
     val signature: String,
     val unsigned: String
+)
+
+data class ParamsOfDecodeBoc(
+    val params: List<AbiParam>,
+    val boc: String,
+    val allow_partial: Boolean
+)
+
+data class ResultOfDecodeBoc(
+    val data: Any
 )

src/test/kotlin/ee/nx01/tonclient/abi/AbiModuleTest.kt

@@ -244,4 +244,16 @@ class AbiModuleTest : StringSpec({
 
     }
 
+
+    "Should be able decode boc " {
+        val client = TonClient()
+
+        val abiParams = listOf(AbiParam("a", "uint32"), AbiParam("b", "ref(int64)"), AbiParam("c", "bool"))
+
+        val response = client.abi.decodeBoc(ParamsOfDecodeBoc(abiParams, "te6ccgEBAgEAEgABCQAAAADAAQAQAAAAAAAAAHs=", true))
+
+        response shouldNotBe null
+
+    }
+
 })