ton_sdk_client 1.9.0 → 1.15.0

data/lib/ton_sdk_client/debot.rb

@@ -1,7 +1,7 @@
 module TonSdk
 
   # NOTE
-  # as of 3 feb 2021, in the main repository this module is still unstable
+  # as of 28 apr 2021, in the main repository this module is still unstable
   module Debot
 
     #
@@ -19,28 +19,19 @@ module TonSdk
       GET_METHOD_FAILED = 808
       INVALID_MSG = 809
       EXTERNAL_CALL_FAILED = 810
+      BROWSER_CALLBACK_FAILED = 811
+      OPERATION_REJECTED = 812
     end
 
-    class DebotAction
-      attr_reader :description, :name, :action_type, :to, :attributes, :misc
-
-      def initialize(description:, name:, action_type:, to:, attributes:, misc:)
-        @description = description
-        @name = name
-        @action_type = action_type
-        @to = to
-        @attributes = attributes
-        @misc = misc
-      end
-
+    DebotAction = Struct.new(:description, :name, :action_type, :to, :attributes, :misc, keyword_init: true) do
       def to_h
         {
-          description: @description,
-          name: @name,
-          action_type: @action_type,
-          to: @to,
-          attributes: @attributes,
-          misc: @misc
+          description: self.description,
+          name: self.name,
+          action_type: self.action_type,
+          to: self.to,
+          attributes: self.attributes,
+          misc: self.misc
         }
       end
 
@@ -58,27 +49,18 @@ module TonSdk
       end
     end
 
-    class ParamsOfStart
-      attr_reader :address
-
-      def initialize(a)
-        @address = a
-      end
-
-      def to_h = { address: @address }
-    end
-
-    class RegisteredDebot
-      attr_reader :debot_handle
-
-      def initialize(a)
-        @debot_handle = a
-      end
+    ParamsOfStart = Struct.new(:debot_handle)
 
-      def to_h = { debot_handle: @debot_handle }
+    RegisteredDebot = Struct.new(:debot_handle, :debot_abi, :info) do
+      def to_h = {
+        debot_handle: @debot_handle,
+        debot_abi: @debot_abi,
+        info: @info.to_h
+      }
     end
 
     class ParamsOfAppDebotBrowser
+      private_class_method :new
 
       # todo remove?
       TYPE_VALUES = [
@@ -89,50 +71,56 @@ module TonSdk
         :input,
         :get_signing_box,
         :invoke_debot,
-        :send
+        :send,
+        :approve
       ]
 
-      attr_reader :type_, :msg, :context_id, :action, :prompt, :debot_addr, :message
+      attr_reader :type_, :msg, :context_id, :action, :prompt, :debot_addr, :message, :activity
 
-      def new_with_type_log(msg)
+      def self.new_with_type_log(msg)
         @type_ = :log
         @msg = msg
       end
 
-      def new_with_type_switch(context_id)
+      def self.new_with_type_switch(context_id)
         @type_ = :switch
         @context_id = context_id
       end
 
-      def new_with_type_switch_completed
+      def self.new_with_type_switch_completed
         @type_ = :switch_completed
       end
 
-      def new_with_type_show_action(action)
+      def self.new_with_type_show_action(action)
         @type_ = :show_action
         @action = action
       end
 
-      def new_with_type_input(prompt)
+      def self.new_with_type_input(prompt)
         @type_ = :input
         @prompt = prompt
       end
 
-      def new_with_type_get_signing_box
+      def self.new_with_type_get_signing_box
         @type_ = :get_signing_box
       end
 
-      def new_with_type_invoke_debot(debot_addr, action)
+      def self.new_with_type_invoke_debot(debot_addr, action)
         @type_ = :invoke_debot
         @debot_addr = debot_addr
         @action = action
       end
 
-      def new_with_type_send(message)
+      def self.new_with_type_send(message)
         @type_ = :send
         @message = message
       end
 
+      def self.new_with_type_approve(activity)
+        @type_ = :approve
+        @activity = activity
+      end
+
       def to_h
         {
           type: Helper.sym_to_capitalized_case_str(@type_),
@@ -148,14 +136,38 @@ module TonSdk
       def self.from_json(j)
         return nil if j.nil?
 
-        self.new(
-          type_: self.parse_type(j["type"]),
-          msg: j["msg"],
-          context_id: j["context_id"],
-          action: DebotAction.from_json(j["action"]),
-          prompt: j["prompt"],
-          debot_addr: j["debot_addr"]
-        )
+        tp = self.parse_type(j["type"])
+        case tp
+        when :log
+          self.new_with_type_log(j["msg"])
+
+        when :switch
+          self.new_with_type_switch(j["context_id"])
+
+        when :switch_completed
+          self.new_with_type_switch_completed
+
+        when :show_action
+          self.new_with_type_show_action(DebotAction.from_json(j["action"]))
+
+        when :input
+          self.new_with_type_input(j["prompt"])
+
+        when :get_signing_box
+          self.new_with_type_get_signing_box
+
+        when :invoke_debot
+          self.new_with_type_invoke_debot(j["debot_addr"], DebotAction.from_json(j["action"]))
+
+        when :send
+          self.new_with_type_send(j["message"])
+
+        when :approve
+          self.new_with_type_send(DebotActivity.from_json(j["activity"]))
+
+        else
+          raise ArgumentError.new("no handler for type: #{tp}")
+        end
       end
 
       private
@@ -171,42 +183,33 @@ module TonSdk
     end
 
     class ResultOfAppDebotBrowser
-      TYPE_VALUES = [
-        :input,
-        :get_signing_box,
-        :invoke_debot
-      ]
+      private_class_method :new
 
-      attr_reader :type_, :value, :signing_box
+      attr_reader :type_, :value, :signing_box, :is_approved
 
-      def initialize(type_:, value: nil, signing_box: nil)
-        unless TYPE_VALUES.include?(type_)
-          raise ArgumentError.new("type #{type_} is unknown; known types: #{TYPE_VALUES}")
-        end
-        @type_ = type_
-        @value = value
-        @signing_box = signing_box
+      def self.new_with_type_input(a)
+        @type_ = :input
+        @value = a
       end
-    end
 
-    class ParamsOfFetch
-      attr_reader :address
+      def self.new_with_type_get_signing_box(a)
+        @type_ = :get_signing_box
+        @signing_box = signing_box
+      end
 
-      def initialize(a)
-        @address = a
+      def self.new_with_type_invoke_debot
+        @type_ = :invoke_debot
       end
 
-      def to_h = { address: @address }
+      def self.new_with_type_approve(a)
+        @type_ = :approve
+        @is_approved = a
+      end
     end
 
-    class ParamsOfExecute
-      attr_reader :debot_handle, :action
-
-      def initialize(debot_handle:, action:)
-        @debot_handle = debot_handle
-        @action = action
-      end
+    ParamsOfFetch = Struct.new(:address)
 
+    ParamsOfExecute = Struct.new(:debot_handle, :action) do
       def to_h
         {
           debot_handle: @debot_handle,
@@ -215,115 +218,91 @@ module TonSdk
       end
     end
 
-    class ParamsOfSend
-      attr_reader :debot_handle, :message
+    ParamsOfSend = Struct.new(:debot_handle, :message)
+    ParamsOfInit = Struct.new(:address)
+    DebotInfo = Struct.new(
+      :name,
+      :version,
+      :publisher,
+      :caption,
+      :author,
+      :support,
+      :hello,
+      :language,
+      :dabi,
+      :icon,
+      :interfaces,
+      keyword_init: true
+    ) do
+      def initialize(
+        name: nil,
+        version: nil,
+        publisher: nil,
+        caption: nil,
+        author: nil,
+        support: nil,
+        hello: nil,
+        language: nil,
+        dabi: nil,
+        icon: nil,
+        interfaces: []
+      )
+        super
+      end
+    end
 
-      def initialize(debot_handle:, message:)
-        @debot_handle = debot_handle
-        @message = message
+    ResultOfFetch = Struct.new(:info)
+    Spending = Struct.new(:amount, :dst)
+
+    class DebotActivity
+      private_class_method :new
+
+      attr_reader :type_, :msg, :dst, :out, :fee, :setcode, :signkey, :signing_box_handle
+
+      def self.new_with_type_transaction(msg:, dst:, out:, fee:, setcode:, signkey:, signing_box_handle:)
+        @type_ = :transaction
+        @msg = msg
+        @dst = dst
+        @out = out
+        @fee = fee
+        @setcode = setcode
+        @signkey = signkey
+        @signing_box_handle = signing_box_handle
       end
 
-      def to_h
-        {
-          debot_handle: @debot_handle,
-          message: @message
-        }
+      def self.from_json(j)
+        # todo
       end
     end
 
+
+
     #
     # functions
     #
 
-    def self.start(ctx, params, app_browser_obj)
-      # TODO
-      # 1) the handlers in 'start' and 'fetch' are identical
-      # verify that it works and get rid of repetition
-
-      # 2) this all can be replaced with 'app_browser_obj.request(...)' and 
-      # 'app_browser_obj.notify(...)' calls, possibly
-
-      app_resp_handler = Proc.new do |data|
-        req_data = data["request_data"]
-        case data["type"]
-        when "Log"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          app_browser_obj.log(new_obj.msg)
-
-        when "Switch"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          app_browser_obj.switch_to(new_obj.context_id)
-
-        when "SwitchCompleted"
-          app_browser_obj.switch_completed()
-
-        when "ShowAction"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          app_browser_obj.show_action(new_obj.action)
-
-        when "Input"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          # TODO possibly in a new thread or fiber
-          app_req_res = begin
-            res = app_browser_obj.input(new_obj.prompt)
-            Client::AppRequestResult(type_: :ok, result: ResultOfAppDebotBrowser.new(type_: :input, value: res))
-          rescue Exception => e
-            Client::AppRequestResult(type_: :error, text: e.message)
-          end
-
-          params = Client::ParamsOfResolveAppRequest.new(
-            app_request_id: data["app_request_id"],
-            result: app_req_res
-          )
-          TonSdk::Client.resolve_app_request(c_ctx, params)
-
-        when "GetSigningBox"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          # TODO possibly in a new thread or fiber
-          app_req_res = begin
-            res = app_browser_obj.get_signing_box()
-            Client::AppRequestResult(type_: :ok, result: ResultOfAppDebotBrowser.new(type_: :get_signing_box, signing_box: res))
-          rescue Exception => e
-            Client::AppRequestResult(type_: :error, text: e.message)
-          end
-
-          params = Client::ParamsOfResolveAppRequest.new(
-            app_request_id: data["app_request_id"],
-            result: app_req_res
-          )
-          TonSdk::Client.resolve_app_request(c_ctx, params)
-
-        when "InvokeDebot"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          # TODO possibly in a new thread or fiber
-          app_req_res = begin
-            res = app_browser_obj.invoke_debot(new_obj.debot_addr, new_obj.action)
-            Client::AppRequestResult(type_: :ok, result: ResultOfAppDebotBrowser.new(type_: :invoke_debot))
-          rescue Exception => e
-            Client::AppRequestResult(type_: :error, text: e.message)
-          end
-
-          params = Client::ParamsOfResolveAppRequest.new(
-            app_request_id: data["app_request_id"],
-            result: app_req_res
+    def self.init(ctx, params, app_browser_obj)
+      Interop::request_to_native_lib(ctx, "debot.init", params) do |resp|
+        if resp.success?
+          yield NativeLibResponsetResult.new(
+            result: nil
           )
-          TonSdk::Client.resolve_app_request(c_ctx, params)
-
         else
-          # TODO log 'unknown option'
+          yield resp
         end
       end
+    end
 
+    def self.start(ctx, params)
       Interop::request_to_native_lib(
         ctx,
         "debot.start",
-        params.to_h.to_json,
-        debot_app_response_handler: app_resp_handler,
+        params,
         is_single_thread_only: false
       ) do |resp|
         if resp.success?
           yield NativeLibResponsetResult.new(
-            result: RegisteredDebot.new(resp.result["debot_handle"])
+            result: nil
           )
         else
           yield resp
@@ -331,95 +310,17 @@ module TonSdk
       end
     end
 
-    def self.fetch(ctx, params, app_browser_obj)
-      # TODO
-      # 1) the handlers in 'start' and 'fetch' are identical
-      # verify that it works and get rid of repetition
-
-      # 2) this all can be replaced with 'app_browser_obj.request(...)' and 
-      # 'app_browser_obj.notify(...)' calls, possibly
-
-      app_resp_handler = Proc.new do |data|
-        req_data = data["request_data"]
-        case data["type"]
-        when "Log"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          app_browser_obj.log(new_obj.msg)
-
-        when "Switch"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          app_browser_obj.switch_to(new_obj.context_id)
-
-        when "SwitchCompleted"
-          app_browser_obj.switch_completed()
-
-        when "ShowAction"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          app_browser_obj.show_action(new_obj.action)
-
-        when "Input"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          # TODO possibly in a new thread or fiber
-          app_req_res = begin
-            res = app_browser_obj.input(new_obj.prompt)
-            Client::AppRequestResult(type_: :ok, result: ResultOfAppDebotBrowser.new(type_: :input, value: res))
-          rescue Exception => e
-            Client::AppRequestResult(type_: :error, text: e.message)
-          end
-
-          params = Client::ParamsOfResolveAppRequest.new(
-            app_request_id: data["app_request_id"],
-            result: app_req_res
-          )
-          TonSdk::Client.resolve_app_request(c_ctx, params)
-
-        when "GetSigningBox"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          # TODO possibly in a new thread or fiber
-          app_req_res = begin
-            res = app_browser_obj.get_signing_box()
-            Client::AppRequestResult(type_: :ok, result: ResultOfAppDebotBrowser.new(type_: :get_signing_box, signing_box: res))
-          rescue Exception => e
-            Client::AppRequestResult(type_: :error, text: e.message)
-          end
-
-          params = Client::ParamsOfResolveAppRequest.new(
-            app_request_id: data["app_request_id"],
-            result: app_req_res
-          )
-          TonSdk::Client.resolve_app_request(c_ctx, params)
-
-        when "InvokeDebot"
-          new_obj = ParamsOfAppDebotBrowser.from_json(data)
-          # TODO possibly in a new thread or fiber
-          app_req_res = begin
-            res = app_browser_obj.invoke_debot(new_obj.debot_addr, new_obj.action)
-            Client::AppRequestResult(type_: :ok, result: ResultOfAppDebotBrowser.new(type_: :invoke_debot))
-          rescue Exception => e
-            Client::AppRequestResult(type_: :error, text: e.message)
-          end
-
-          params = Client::ParamsOfResolveAppRequest.new(
-            app_request_id: data["app_request_id"],
-            result: app_req_res
-          )
-          TonSdk::Client.resolve_app_request(c_ctx, params)
-
-        else
-          # TODO log 'unknown option'
-        end
-      end
-
+    def self.fetch(ctx, params)
       Interop::request_to_native_lib(
         ctx,
         "debot.fetch",
-        params.to_h.to_json,
-        debot_app_response_handler: app_resp_handler,
+        params,
         is_single_thread_only: false
       ) do |resp|
         if resp.success?
           yield NativeLibResponsetResult.new(
-            result: RegisteredDebot.new(resp.result["debot_handle"])
+            # TODO: parse DebotInfo
+            result: ResultOfFetch.new(resp.result["info"])
           )
         else
           yield resp
@@ -428,7 +329,7 @@ module TonSdk
     end
 
     def self.execute(ctx, params)
-      Interop::request_to_native_lib(ctx, "debot.execute", params.to_h.to_json) do |resp|
+      Interop::request_to_native_lib(ctx, "debot.execute", params) do |resp|
         if resp.success?
           yield NativeLibResponsetResult.new(
             result: nil
@@ -440,7 +341,7 @@ module TonSdk
     end
 
     def self.remove(ctx, params)
-      Interop::request_to_native_lib(ctx, "debot.remove", params.to_h.to_json) do |resp|
+      Interop::request_to_native_lib(ctx, "debot.remove", params) do |resp|
         if resp.success?
           yield NativeLibResponsetResult.new(
             result: nil
@@ -452,7 +353,7 @@ module TonSdk
     end
 
     def self.send(ctx, params)
-      Interop::request_to_native_lib(ctx, "debot.send", params.to_h.to_json) do |resp|
+      Interop::request_to_native_lib(ctx, "debot.send", params) do |resp|
         if resp.success?
           yield NativeLibResponsetResult.new(
             result: nil