aure_ex 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f3dec012ab63d5a5524f2142f4e04da0faa0d75ab711a5bfcc2b90472913f54e
+  data.tar.gz: 29658bbe1b0ec7c98bf5b7fac0634f5834d4d8e60eecdacde9f628e2fe367830
+SHA512:
+  metadata.gz: 8ddb22f2573f210eeb2b80c4dc2d128ff17f24c4b41511247e02798c530187ff3d788a1ccdb4e4e64e2b2e5a43e29968eefc09fd38d3646af45d07789344524b
+  data.tar.gz: f5be7a7e70d9fa9f2f4db5c5c1bbfa26780075581a309e46426c713bc8b90c5295f1c595befc04242468b061a4f216bca3cda3afac9d56f013aacfb7779fde42

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) AureEX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,42 @@
+# aure_ex
+
+SDK oficial da API AureEX para Ruby.
+
+## Instalação
+
+```bash
+gem install aure_ex
+```
+
+## Uso
+
+```ruby
+require 'aure_ex'
+
+aure_ex = AureEx.new(
+  api_key: ENV['AUREEX_API_KEY'],
+  api_secret: ENV['AUREEX_API_SECRET']
+)
+
+aure_ex.deposits.create({
+  method: 'usdt',
+  reference: 'order-1',
+  amount: 10_000
+})
+aure_ex.webhooks.list
+aure_ex.company.balance
+aure_ex.conversions.quote({ from: 'USDT', to: 'BRL', amount: 100 })
+```
+
+## Mapa de métodos
+
+| SDK | HTTP |
+| --- | --- |
+| `aure_ex.deposits` | `/v1/deposits` |
+| `aure_ex.withdrawals` | `/v1/withdrawals` |
+| `aure_ex.webhooks` | `/v1/webhooks` |
+| `aure_ex.company.get` / `balance` | `/v1/company`, `/v1/company/balance` |
+| `aure_ex.conversions` / `quote` | `/v1/conversions`, `/v1/conversions/quote` |
+
+Docs: https://api.aure-ex.com/docs/sdks  
+OpenAPI: https://api.aure-ex.com/openapi.yaml

data/lib/aure_ex/client.rb

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'net/http'
+require 'uri'
+
+module AureEx
+  # Erro tipado da API AureEX.
+  class Error < StandardError
+    attr_reader :code, :details, :status_code
+
+    def initialize(message, code: nil, details: nil, status_code: 0)
+      super(message)
+      @code = code
+      @details = details
+      @status_code = status_code
+    end
+  end
+
+  # Transporte HTTP autenticado com retry em 429.
+  class HttpTransport
+    def initialize(api_key:, api_secret:, base_url:, max_retries: 2)
+      @api_key = api_key
+      @api_secret = api_secret
+      @base_url = base_url.sub(%r{/\z}, '')
+      @max_retries = max_retries
+    end
+
+    # Executa requisição autenticada e desempacota o envelope `data`.
+    def request(method, path, body: nil, extra_headers: {})
+      url = URI("#{@base_url}/#{path.sub(%r{\A/}, '')}")
+      attempt = 0
+
+      loop do
+        attempt += 1
+        http = Net::HTTP.new(url.host, url.port)
+        http.use_ssl = url.scheme == 'https'
+
+        verb = method.to_s.upcase
+        request_class = {
+          'GET' => Net::HTTP::Get,
+          'POST' => Net::HTTP::Post,
+          'PUT' => Net::HTTP::Put,
+          'PATCH' => Net::HTTP::Patch,
+          'DELETE' => Net::HTTP::Delete
+        }.fetch(verb)
+
+        request = request_class.new(url)
+        request['X-Api-Key'] = @api_key
+        request['X-Api-Secret'] = @api_secret
+        request['Accept'] = 'application/json'
+        request['Content-Type'] = 'application/json'
+        extra_headers.each { |key, value| request[key] = value }
+        request.body = JSON.generate(body) unless body.nil?
+
+        response = http.request(request)
+        status = response.code.to_i
+        raw = response.body.to_s
+        decoded = raw.empty? ? nil : JSON.parse(raw)
+
+        if status == 429 && attempt <= @max_retries + 1
+          sleep([1, (response['Retry-After'] || '1').to_i].max)
+          next
+        end
+
+        if status >= 400
+          error = decoded.is_a?(Hash) ? decoded['error'] : nil
+          message = error.is_a?(Hash) ? (error['message'] || 'Request failed.') : 'Request failed.'
+          raise Error.new(
+            message.to_s,
+            code: error.is_a?(Hash) ? error['code'] : nil,
+            details: error.is_a?(Hash) ? error['details'] : nil,
+            status_code: status
+          )
+        end
+
+        return decoded['data'] if decoded.is_a?(Hash) && decoded.key?('data')
+
+        return decoded
+      end
+    end
+  end
+
+  # Recurso CRUD genérico (list/create/get/update/delete).
+  class CrudResource
+    def initialize(http, base_path)
+      @http = http
+      @base_path = base_path
+    end
+
+    def list(query = {})
+      path = @base_path
+      unless query.nil? || query.empty?
+        path = "#{path}?#{URI.encode_www_form(query)}"
+      end
+      @http.request('Get', path)
+    end
+
+    def create(payload, idempotency_key: nil)
+      headers = idempotency_key ? { 'Idempotency-Key' => idempotency_key } : {}
+      @http.request('Post', @base_path, body: payload, extra_headers: headers)
+    end
+
+    def get(id)
+      @http.request('Get', "#{@base_path}/#{URI.encode_www_form_component(id)}")
+    end
+
+    def update(id, payload)
+      @http.request('Put', "#{@base_path}/#{URI.encode_www_form_component(id)}", body: payload)
+    end
+
+    def delete(id)
+      @http.request('Delete', "#{@base_path}/#{URI.encode_www_form_component(id)}")
+    end
+  end
+
+  # Empresa autenticada e saldo.
+  class Company
+    def initialize(http)
+      @http = http
+    end
+
+    # Dados da empresa (GET /company).
+    def get
+      @http.request('Get', '/company')
+    end
+
+    # Saldo disponível (GET /company/balance).
+    def balance
+      @http.request('Get', '/company/balance')
+    end
+  end
+
+  # Conversões crypto (ex.: USDT/BRL).
+  class Conversions < CrudResource
+    def initialize(http)
+      super(http, '/conversions')
+    end
+
+    # Cotação de conversão (POST /conversions/quote).
+    def quote(payload)
+      @http.request('Post', '/conversions/quote', body: payload)
+    end
+  end
+
+  # Facade principal da API AureEX (crypto only).
+  class Client
+    attr_reader :deposits, :withdrawals, :webhooks, :company, :conversions
+
+    def initialize(api_key:, api_secret:, base_url: 'https://api.aure-ex.com/v1', max_retries: 2)
+      api_key = api_key.to_s.strip
+      api_secret = api_secret.to_s.strip
+      raise Error.new('api_key and api_secret are required.') if api_key.empty? || api_secret.empty?
+
+      http = HttpTransport.new(
+        api_key: api_key,
+        api_secret: api_secret,
+        base_url: base_url,
+        max_retries: max_retries
+      )
+
+      @deposits = CrudResource.new(http, '/deposits')
+      @withdrawals = CrudResource.new(http, '/withdrawals')
+      @webhooks = CrudResource.new(http, '/webhooks')
+      @company = Company.new(http)
+      @conversions = Conversions.new(http)
+    end
+  end
+
+  # Alias ergonômico: AureEx.new(...)
+  def self.new(**kwargs)
+    Client.new(**kwargs)
+  end
+end

data/lib/aure_ex/generated/api/company_api.rb

@@ -0,0 +1,132 @@
+=begin
+#AureEX REST API
+
+#API REST AureEX (camelCase inglês): depósitos USDT, saques USDT, conversões com origem USDT, webhooks e empresa. Auth: headers `X-Api-Key` e `X-Api-Secret`. Envelope: `{ \"success\": true, \"data\": ... }` / `{ \"success\": false, \"error\": { \"code\", \"message\", \"details\" } }`. Fonte para agentes: https://api.aure-ex.com/llms-full.txt 
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module AureEx
+  class CompanyApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Saldo disponível
+    # @param [Hash] opts the optional parameters
+    # @return [SuccessEnvelope]
+    def company_balance(opts = {})
+      data, _status_code, _headers = company_balance_with_http_info(opts)
+      data
+    end
+
+    # Saldo disponível
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SuccessEnvelope, Integer, Hash)>] SuccessEnvelope data, response status code and response headers
+    def company_balance_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.company_balance ...'
+      end
+      # resource path
+      local_var_path = '/company/balance'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SuccessEnvelope'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ApiSecretAuth']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.company_balance",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#company_balance\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Dados da empresa autenticada
+    # @param [Hash] opts the optional parameters
+    # @return [SuccessEnvelope]
+    def company_get(opts = {})
+      data, _status_code, _headers = company_get_with_http_info(opts)
+      data
+    end
+
+    # Dados da empresa autenticada
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SuccessEnvelope, Integer, Hash)>] SuccessEnvelope data, response status code and response headers
+    def company_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CompanyApi.company_get ...'
+      end
+      # resource path
+      local_var_path = '/company'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SuccessEnvelope'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ApiSecretAuth']
+
+      new_options = opts.merge(
+        :operation => :"CompanyApi.company_get",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CompanyApi#company_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/aure_ex/generated/api/conversions_api.rb

@@ -0,0 +1,262 @@
+=begin
+#AureEX REST API
+
+#API REST AureEX (camelCase inglês): depósitos USDT, saques USDT, conversões com origem USDT, webhooks e empresa. Auth: headers `X-Api-Key` e `X-Api-Secret`. Envelope: `{ \"success\": true, \"data\": ... }` / `{ \"success\": false, \"error\": { \"code\", \"message\", \"details\" } }`. Fonte para agentes: https://api.aure-ex.com/llms-full.txt 
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module AureEx
+  class ConversionsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Cria conversão (origem USDT)
+    # @param [Hash] opts the optional parameters
+    # @option opts [ConversionCreate] :conversion_create 
+    # @return [SuccessEnvelope]
+    def conversions_create(opts = {})
+      data, _status_code, _headers = conversions_create_with_http_info(opts)
+      data
+    end
+
+    # Cria conversão (origem USDT)
+    # @param [Hash] opts the optional parameters
+    # @option opts [ConversionCreate] :conversion_create 
+    # @return [Array<(SuccessEnvelope, Integer, Hash)>] SuccessEnvelope data, response status code and response headers
+    def conversions_create_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConversionsApi.conversions_create ...'
+      end
+      # resource path
+      local_var_path = '/conversions'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'conversion_create'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SuccessEnvelope'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ApiSecretAuth']
+
+      new_options = opts.merge(
+        :operation => :"ConversionsApi.conversions_create",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ConversionsApi#conversions_create\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Consulta conversão
+    # @param id [String] Identificador ULID do recurso
+    # @param [Hash] opts the optional parameters
+    # @return [SuccessEnvelope]
+    def conversions_get(id, opts = {})
+      data, _status_code, _headers = conversions_get_with_http_info(id, opts)
+      data
+    end
+
+    # Consulta conversão
+    # @param id [String] Identificador ULID do recurso
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SuccessEnvelope, Integer, Hash)>] SuccessEnvelope data, response status code and response headers
+    def conversions_get_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConversionsApi.conversions_get ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ConversionsApi.conversions_get"
+      end
+      # resource path
+      local_var_path = '/conversions/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SuccessEnvelope'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ApiSecretAuth']
+
+      new_options = opts.merge(
+        :operation => :"ConversionsApi.conversions_get",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ConversionsApi#conversions_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Lista conversões
+    # @param [Hash] opts the optional parameters
+    # @return [SuccessEnvelope]
+    def conversions_list(opts = {})
+      data, _status_code, _headers = conversions_list_with_http_info(opts)
+      data
+    end
+
+    # Lista conversões
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SuccessEnvelope, Integer, Hash)>] SuccessEnvelope data, response status code and response headers
+    def conversions_list_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConversionsApi.conversions_list ...'
+      end
+      # resource path
+      local_var_path = '/conversions'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SuccessEnvelope'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ApiSecretAuth']
+
+      new_options = opts.merge(
+        :operation => :"ConversionsApi.conversions_list",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ConversionsApi#conversions_list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Cotação de conversão
+    # @param [Hash] opts the optional parameters
+    # @option opts [ConversionCreate] :conversion_create 
+    # @return [SuccessEnvelope]
+    def conversions_quote(opts = {})
+      data, _status_code, _headers = conversions_quote_with_http_info(opts)
+      data
+    end
+
+    # Cotação de conversão
+    # @param [Hash] opts the optional parameters
+    # @option opts [ConversionCreate] :conversion_create 
+    # @return [Array<(SuccessEnvelope, Integer, Hash)>] SuccessEnvelope data, response status code and response headers
+    def conversions_quote_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConversionsApi.conversions_quote ...'
+      end
+      # resource path
+      local_var_path = '/conversions/quote'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'conversion_create'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SuccessEnvelope'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ApiSecretAuth']
+
+      new_options = opts.merge(
+        :operation => :"ConversionsApi.conversions_quote",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ConversionsApi#conversions_quote\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end