1.39 up

Author: nerzh

README.md

@@ -1,7 +1,7 @@
 # Swift Client for Everscale SDK
 
 [![SPM](https://img.shields.io/badge/swift-package%20manager-green)](https://swift.org/package-manager/)
-[![SPM](https://img.shields.io/badge/SDK%20VERSION-1.38.0-orange)](https://github.com/tonlabs/ever-sdk)
+[![SPM](https://img.shields.io/badge/SDK%20VERSION-1.39.0-orange)](https://github.com/tonlabs/ever-sdk)
 
 Swift is a strongly typed language that has long been used not only for iOS development. Apple is actively promoting it to new platforms and today it can be used for almost any task. Thanks to this, this implementation provides the work of Everscale SDK on many platforms at once, including the native one for mobile phones. Let me remind you that swift can also be built for android.
 

Sources/EverscaleClientSwift/Abi/AbiTypes.swift

@@ -54,6 +54,11 @@ public enum TSDKMessageSourceEnumTypes: String, Codable {
     case EncodingParams = "EncodingParams"
 }
 
+public enum TSDKDataLayout: String, Codable {
+    case Input = "Input"
+    case Output = "Output"
+}
+
 public struct TSDKAbi: Codable {
     public var type: TSDKAbiEnumTypes
     public var value: AnyValue?
@@ -471,11 +476,16 @@ public struct TSDKParamsOfDecodeMessage: Codable {
     public var message: String
     /// Flag allowing partial BOC decoding when ABI doesn't describe the full body BOC. Controls decoder behaviour when after decoding all described in ABI params there are some data left in BOC: `true` - return decoded values `false` - return error of incomplete BOC deserialization (default)
     public var allow_partial: Bool?
+    /// Function name or function id if is known in advance
+    public var function_name: String?
+    public var data_layout: TSDKDataLayout?
 
-    public init(abi: TSDKAbi, message: String, allow_partial: Bool? = nil) {
+    public init(abi: TSDKAbi, message: String, allow_partial: Bool? = nil, function_name: String? = nil, data_layout: TSDKDataLayout? = nil) {
         self.abi = abi
         self.message = message
         self.allow_partial = allow_partial
+        self.function_name = function_name
+        self.data_layout = data_layout
     }
 }
 
@@ -506,12 +516,17 @@ public struct TSDKParamsOfDecodeMessageBody: Codable {
     public var is_internal: Bool
     /// Flag allowing partial BOC decoding when ABI doesn't describe the full body BOC. Controls decoder behaviour when after decoding all described in ABI params there are some data left in BOC: `true` - return decoded values `false` - return error of incomplete BOC deserialization (default)
     public var allow_partial: Bool?
+    /// Function name or function id if is known in advance
+    public var function_name: String?
+    public var data_layout: TSDKDataLayout?
 
-    public init(abi: TSDKAbi, body: String, is_internal: Bool, allow_partial: Bool? = nil) {
+    public init(abi: TSDKAbi, body: String, is_internal: Bool, allow_partial: Bool? = nil, function_name: String? = nil, data_layout: TSDKDataLayout? = nil) {
         self.abi = abi
         self.body = body
         self.is_internal = is_internal
         self.allow_partial = allow_partial
+        self.function_name = function_name
+        self.data_layout = data_layout
     }
 }
 

Sources/EverscaleClientSwift/Boc/BocTypes.swift

@@ -56,7 +56,7 @@ public struct TSDKResultOfParse: Codable {
 public struct TSDKParamsOfParseShardstate: Codable {
     /// BOC encoded as base64
     public var boc: String
-    /// Shardstate identificator
+    /// Shardstate identifier
     public var id: String
     /// Workchain shardstate belongs to
     public var workchain_id: Int32

Sources/EverscaleClientSwift/Client/ClientTypes.swift

@@ -131,11 +131,11 @@ public struct TSDKNetworkConfig: Codable {
     /// Default is 1.
     public var sending_endpoint_count: UInt8?
     /// Frequency of sync latency detection.
-    /// Library periodically checks the current endpoint for blockchain data syncronization latency.
+    /// Library periodically checks the current endpoint for blockchain data synchronization latency.
     /// If the latency (time-lag) is less then `NetworkConfig.max_latency`then library selects another endpoint.
     /// Must be specified in milliseconds. Default is 60000 (1 min).
     public var latency_detection_interval: UInt32?
-    /// Maximum value for the endpoint's blockchain data syncronization latency (time-lag). Library periodically checks the current endpoint for blockchain data synchronization latency. If the latency (time-lag) is less then `NetworkConfig.max_latency` then library selects another endpoint.
+    /// Maximum value for the endpoint's blockchain data synchronization latency (time-lag). Library periodically checks the current endpoint for blockchain data synchronization latency. If the latency (time-lag) is less then `NetworkConfig.max_latency` then library selects another endpoint.
     /// Must be specified in milliseconds. Default is 60000 (1 min).
     public var max_latency: UInt32?
     /// Default timeout for http requests.
@@ -147,11 +147,11 @@ public struct TSDKNetworkConfig: Codable {
     /// /// Default is `HTTP`.
     public var queries_protocol: TSDKNetworkQueriesProtocol?
     /// UNSTABLE.
-    /// First REMP status awaiting timeout. If no status recieved during the timeout than fallback transaction scenario is activated.
+    /// First REMP status awaiting timeout. If no status received during the timeout than fallback transaction scenario is activated.
     /// Must be specified in milliseconds. Default is 1000 (1 sec).
     public var first_remp_status_timeout: UInt32?
     /// UNSTABLE.
-    /// Subsequent REMP status awaiting timeout. If no status recieved during the timeout than fallback transaction scenario is activated.
+    /// Subsequent REMP status awaiting timeout. If no status received during the timeout than fallback transaction scenario is activated.
     /// Must be specified in milliseconds. Default is 5000 (5 sec).
     public var next_remp_status_timeout: UInt32?
     /// Access key to GraphQL API (Project secret)

Sources/EverscaleClientSwift/Net/Net.swift

@@ -111,7 +111,7 @@ public final class TSDKNetModule {
 
     /// Creates a subscription
     /// The subscription is a persistent communication channel betweenclient and Everscale Network.
-    /// ### Important Notes on SubscriptionsUnfortunately sometimes the connection with the network breakes down.
+    /// ### Important Notes on SubscriptionsUnfortunately sometimes the connection with the network breaks down.
     /// In this situation the library attempts to reconnect to the network.
     /// This reconnection sequence can take significant time.
     /// All of this time the client is disconnected from the network.
@@ -217,7 +217,7 @@ public final class TSDKNetModule {
     /// If the chain of transactions execution is in progress while the function is running,it will wait for the next transactions to appear until the full tree or more than 50 transactionsare received.
     /// All the retrieved messages and transactions are includedinto `result.messages` and `result.transactions` respectively.
     /// Function reads transactions layer by layer, by pages of 20 transactions.
-    /// The retrieval prosess goes like this:
+    /// The retrieval process goes like this:
     /// Let's assume we have an infinite chain of transactions and each transaction generates 5 messages.
     /// 1. Retrieve 1st message (input parameter) and corresponding transaction - put it into result.
     /// It is the first level of the tree of transactions - its root.
@@ -261,7 +261,7 @@ public final class TSDKNetModule {
     }
 
     /// Resumes block iterator.
-    /// The iterator stays exactly at the same position where the `resume_state` was catched.
+    /// The iterator stays exactly at the same position where the `resume_state` was caught.
     /// Application should call the `remove_iterator` when iterator is no longer required.
     public func resume_block_iterator(_ payload: TSDKParamsOfResumeBlockIterator, _ handler: @escaping (TSDKBindingResponse<TSDKRegisteredIterator, TSDKClientError>) throws -> Void
     ) throws {

Sources/EverscaleClientSwift/Net/NetTypes.swift

@@ -18,6 +18,8 @@ public enum TSDKNetErrorCode: Int, Codable {
     case GraphqlWebsocketInitError = 613
     case NetworkModuleResumed = 614
     case Unauthorized = 615
+    case QueryTransactionTreeTimeout = 616
+    case GraphqlConnectionError = 617
 }
 
 public enum TSDKSortDirection: String, Codable {
@@ -357,13 +359,18 @@ public struct TSDKParamsOfQueryTransactionTree: Codable {
     public var abi_registry: [TSDKAbi]?
     /// Timeout used to limit waiting time for the missing messages and transaction.
     /// If some of the following messages and transactions are missing yetThe maximum waiting time is regulated by this option.
-    /// Default value is 60000 (1 min).
+    /// Default value is 60000 (1 min). If `timeout` is set to 0 then function will wait infinitelyuntil the whole transaction tree is executed
     public var timeout: UInt32?
+    /// Maximum transaction count to wait.
+    /// If transaction tree contains more transaction then this parameter then only first `transaction_max_count` transaction are awaited and returned.
+    /// Default value is 50. If `transaction_max_count` is set to 0 then no limitation ontransaction count is used and all transaction are returned.
+    public var transaction_max_count: UInt32?
 
-    public init(in_msg: String, abi_registry: [TSDKAbi]? = nil, timeout: UInt32? = nil) {
+    public init(in_msg: String, abi_registry: [TSDKAbi]? = nil, timeout: UInt32? = nil, transaction_max_count: UInt32? = nil) {
         self.in_msg = in_msg
         self.abi_registry = abi_registry
         self.timeout = timeout
+        self.transaction_max_count = transaction_max_count
     }
 }
 

Sources/EverscaleClientSwift/Tvm/Tvm.swift

@@ -10,7 +10,7 @@ public final class TSDKTvmModule {
     /// Emulates all the phases of contract execution locally
     /// Performs all the phases of contract execution on Transaction Executor -the same component that is used on Validator Nodes.
     /// Can be used for contract debugging, to find out the reason why a message was not delivered successfully.
-    /// Validators throw away the failed external inbound messages (if they failed bedore `ACCEPT`) in the real network.
+    /// Validators throw away the failed external inbound messages (if they failed before `ACCEPT`) in the real network.
     /// This is why these messages are impossible to debug in the real network.
     /// With the help of run_executor you can do that. In fact, `process_message` functionperforms local check with `run_executor` if there was no transaction as a result of processingand returns the error, if there is one.
     /// Another use case to use `run_executor` is to estimate fees for message execution.