cns 0.7.4 → 0.7.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7880ff81313f41571c941a08e2f77d3f3725e19a68b5603aaa0fa00760e98f46
-  data.tar.gz: da5bba73d734f8263506662a7a966628e32f95ca4bc5cba9bedff0294dd30e12
+  metadata.gz: c057fdcc8c76136db6203c763bb68b551c712a3023e705915f88c54b1d08ca7a
+  data.tar.gz: 1cc5eeb11f55d0cb3cbee6b80eb3d2978c8ff201ae58a18c58a9d930b774811d
 SHA512:
-  metadata.gz: fb30d1db97b27bef9caa97c6d6ecc8a319707a5ddba20b382b21b8607b31b46ec1f0d6f269d7e3defd733f0881e6a6a3a67d41b26b767b3e830226611df54997
-  data.tar.gz: 8eec81e398a8358b47051dcabbc70dd3fbf1c7faf3bbeee05d5cc26d3cec36bfb1968af98caf80a1a43d823b3523184e3d1791933c4704724d292b0422910195
+  metadata.gz: b1d061301afeafd4643509e0ce966cff4f5fce04970dea65a78a7ba901d5cf1c71f38030b4a8ffe9f13437a3bf511e58b673881c8f956f6f91c988131fb943c0
+  data.tar.gz: 457cf0ab8be639742b00b26d0ffab798fc6d313b264f2ba52ae6f821ef766f9fc0bf524b8ec1d0e29d9d22dcece13cb5e603a1a288fb72a2e5241d327025b900

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    cns (0.7.4)
+    cns (0.7.6)
       curb
       faraday
       google-cloud-bigquery
@@ -62,7 +62,7 @@ GEM
       signet (>= 0.16, < 2.a)
     httpclient (2.8.3)
     jaro_winkler (1.6.0)
-    json (2.9.1)
+    json (2.10.1)
     jwt (2.10.1)
       base64
     kramdown (2.5.1)
@@ -120,6 +120,7 @@ GEM
       parser (~> 2.2)
       slop (~> 3.4, >= 3.4.7)
     ruby-progressbar (1.13.0)
+    rufo (0.18.0)
     signet (0.19.0)
       addressable (~> 2.8)
       faraday (>= 0.17.5, < 3.a)
@@ -159,6 +160,7 @@ DEPENDENCIES
   rubocop
   rubocop-rake
   ruby-lint
+  rufo
   solargraph
   yard
 

data/cns.gemspec

@@ -32,6 +32,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency('rubocop')
   spec.add_development_dependency('rubocop-rake')
   spec.add_development_dependency('ruby-lint')
+  spec.add_development_dependency('rufo')
   spec.add_development_dependency('solargraph')
   spec.add_development_dependency('yard')
 

data/lib/cns/apibc.rb

@@ -1,386 +1,137 @@
 # frozen_string_literal: true
 
-require('faraday')
-require('json')
+require("faraday")
+require("json")
 
 # @author Hernani Rodrigues Vaz
 module Cns
   # classe para acesso dados blockchains
   class Apibc
-    # @example account_es
-    #  {
-    #    status: '1',
-    #    message: 'OK',
-    #    result: [
-    #      { account: '0x...', balance: '4000000000000000000' },
-    #      { account: '0x...', balance: '87000000000000000000' }
-    #    ]
-    #  }
-    # @param [Array<String>] ads lista enderecos ETH (max 20)
-    # @return [Array<Hash>] lista enderecos e seus saldos
-    def account_es(ads)
-      JSON.parse(
-        conn_es.get('/api', action: 'balancemulti', tag: 'latest', address: ads.join(',')).body,
-        symbolize_names: true
-      )[:result]
-    rescue StandardError
-      []
+    # Get account balances for multiple ETH addresses
+    # @param addresses [Array<String>] List of ETH addresses (max 20)
+    # @return [Array<Hash>] List of addresses with balances
+    def account_es(addresses)
+      response = etherscan_req("balancemulti", addresses.join(","), 1, tag: "latest")
+      response[:status] == "1" ? response.dig(:result) : []
     end
 
-    # @example account_gm
-    #  {
-    #    account_name: '...',
-    #    head_block_num: 141_391_122,
-    #    head_block_time: '2020-09-11T16:05:51.000',
-    #    privileged: false,
-    #    last_code_update: '1970-01-01T00:00:00.000',
-    #    created: '2018-06-09T13:14:37.000',
-    #
-    #    core_liquid_balance: '1232.0228 EOS',
-    #    total_resources: { owner: '...', net_weight: '1000.1142 EOS', cpu_weight: '1000.1144 EOS', ram_bytes: 8148 },
-    #
-    #    ram_quota: 9548,
-    #    net_weight: 10_001_142,
-    #    cpu_weight: 10_001_144,
-    #    net_limit: { used: 0, available: 1_066_648_346, max: 1_066_648_346 },
-    #    cpu_limit: { used: 338, available: 88_498, max: 88_836 },
-    #    ram_usage: 3574,
-    #    permissions: [
-    #      {
-    #        perm_name: 'active',
-    #        parent: 'owner',
-    #        required_auth: {
-    #          threshold: 1, keys: [{ key: 'EOS...', weight: 1 }], accounts: [], waits: []
-    #        }
-    #      },
-    #      {
-    #        perm_name: 'owner',
-    #        parent: '',
-    #        required_auth: {
-    #          threshold: 1, keys: [{ key: 'EOS...', weight: 1 }], accounts: [], waits: []
-    #        }
-    #      }
-    #    ],
-    #    self_delegated_bandwidth: { from: '...', to: '...', net_weight: '1000.1142 EOS', cpu_weight: '1000.1144 EOS' },
-    #    refund_request: nil,
-    #    voter_info: {
-    #      owner: '...',
-    #      proxy: '...',
-    #      producers: [],
-    #      staked: 20_002_286,
-    #      last_vote_weight: '17172913021904.12109375000000000',
-    #      proxied_vote_weight: '0.00000000000000000',
-    #      is_proxy: 0,
-    #      flags1: 0,
-    #      reserved2: 0,
-    #      reserved3: '0.0000 EOS'
-    #    },
-    #    rex_info: nil
-    #  }
-    # @param [String] add endereco EOS
-    # @return [Hash] endereco e seus saldo/recursos
-    def account_gm(add)
-      JSON.parse(conn_gm.post('/v1/chain/get_account', { account_name: add }.to_json).body, symbolize_names: true)
-    rescue StandardError
-      { core_liquid_balance: 0, total_resources: { net_weight: 0, cpu_weight: 0 } }
+    # Get EOS account information
+    # @param address [String] EOS account name
+    # @return [Hash] Account details with resources
+    def account_gm(address)
+      response = greymass_req("/v1/chain/get_account", { account_name: address })
+      response || { core_liquid_balance: 0, total_resources: { net_weight: 0, cpu_weight: 0 } }
     end
 
-    # @example norml_es
-    #  {
-    #    status: '1',
-    #    message: 'OK',
-    #    result: [
-    #      {
-    #        blockNumber: '4984535',
-    #        timeStamp: '1517094794',
-    #        hash: '0x...',
-    #        nonce: '10',
-    #        blockHash: '0x...',
-    #        transactionIndex: '17',
-    #        from: '0x...',
-    #        to: '0x...',
-    #        value: '52627271000000000000',
-    #        gas: '21000',
-    #        gasPrice: '19000000000',
-    #        isError: '0',
-    #        txreceipt_status: '1',
-    #        input: '0x',
-    #        contractAddress: '',
-    #        gasUsed: '21000',
-    #        cumulativeGasUsed: '566293',
-    #        confirmations: '5848660'
-    #      },
-    #      {}
-    #    ]
-    #  }
-    # @param [String] add endereco ETH
-    # @param [Integer] pag pagina transacoes
-    # @param [Array<Hash>] aes acumulador transacoes
+    # Get normal transactions for ETH address
+    # @param [String] address endereco ETH
     # @return [Array<Hash>] lista transacoes normais etherscan
-    def norml_es(add, pag = 0, aes = [])
-      res = JSON.parse(
-        conn_es.get('/api', action: 'txlist', offset: 10_000, address: add, page: pag += 1).body,
-        symbolize_names: true
-      )[:result]
-      aes += res
-      res.count < 10_000 ? aes : norml_es(add, pag, aes)
-    rescue StandardError
-      aes
+    def norml_es(address)
+      pag_etherscan_req("txlist", address)
     end
 
-    # @example inter_es
-    # {
-    #   status: '1',
-    #   message: 'OK',
-    #   result: [
-    #     {
-    #       blockNumber: '15592786',
-    #       timeStamp: '1663896779',
-    #       hash: '0x...',
-    #       from: '0x...',
-    #       to: '0x...',
-    #       value: '22000000000000000',
-    #       contractAddress: '',
-    #       input: '',
-    #       type: 'call',
-    #       gas: '2300',
-    #       gasUsed: '0',
-    #       traceId: '0_1_1',
-    #       isError: '0',
-    #       errCode: ''
-    #     }
-    #   ]
-    # }
+    # Get internal transactions for ETH address
     # @param (see norml_es)
     # @return [Array<Hash>] lista transacoes internas etherscan
-    def inter_es(add, pag = 0, aes = [])
-      res = JSON.parse(
-        conn_es.get('/api', action: 'txlistinternal', offset: 10_000, address: add, page: pag += 1).body,
-        symbolize_names: true
-      )[:result]
-      aes += res
-      res.count < 10_000 ? aes : inter_es(add, pag, aes)
-    rescue StandardError
-      aes
+    def inter_es(address)
+      pag_etherscan_req("txlistinternal", address)
     end
 
-    # @example block_es
-    # {
-    #   status: '1',
-    #   message: 'OK',
-    #   result: [
-    #     { blockNumber: '15737070', timeStamp: '1665638459', blockReward: '8922867945448231' },
-    #     { blockNumber: '15592786', timeStamp: '1663896779', blockReward: '44997990286623752' },
-    #     { blockNumber: '15570222', timeStamp: '1663622819', blockReward: '261211525682683684' },
-    #     { blockNumber: '15568554', timeStamp: '1663602539', blockReward: '41993833217879559' }
-    #   ]
-    # }
+    # Get mined blocks for ETH address
     # @param (see norml_es)
     # @return [Array<Hash>] lista blocos etherscan
-    def block_es(add, pag = 0, aes = [])
-      res = JSON.parse(
-        conn_es.get(
-          '/api',
-          action: 'getminedblocks',
-          blocktype: 'blocks',
-          offset: 10_000,
-          address: add,
-          page: pag += 1
-        ).body,
-        symbolize_names: true
-      )[:result]
-      aes += res
-      res.count < 10_000 ? aes : block_es(add, pag, aes)
-    rescue StandardError
-      aes
+    def block_es(address)
+      pag_etherscan_req("getminedblocks", address, blocktype: "blocks")
     end
 
-    # @example withw_es
-    # {
-    #    "status":"1",
-    #    "message":"OK",
-    #    "result":[
-    #       {
-    #          "withdrawalIndex":"14",
-    #          "validatorIndex":"119023",
-    #          "address":"0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
-    #          "amount":"3244098967",
-    #          "blockNumber":"17034877",
-    #          "timestamp":"1681338599"
-    #       }
-    #    ]
-    # }
+    # Get withdrawals for ETH address
     # @param (see norml_es)
     # @return [Array<Hash>] lista blocos etherscan
-    def withw_es(add, pag = 0, aes = [])
-      res = JSON.parse(
-        conn_es.get(
-          '/api',
-          action: 'txsBeaconWithdrawal',
-          address: add,
-          offset: 10_000,
-          page: pag += 1
-        ).body,
-        symbolize_names: true
-      )[:result]
-      aes += res
-      res.count < 10_000 ? aes : withw_es(add, pag, aes)
-    rescue StandardError
-      aes
+    def withw_es(address)
+      pag_etherscan_req("txsBeaconWithdrawal", address)
     end
 
-    # @example token_es
-    #  {
-    #    status: '1',
-    #    message: 'OK',
-    #    result: [
-    #      {
-    #        blockNumber: '3967652',
-    #        timeStamp: '1499081515',
-    #        hash: '0x registo duplicado com todos os dados iguais',
-    #        nonce: '3',
-    #        blockHash: '0x00a49e999036dc13dc6c4244bb1d51d3146fe7f00bfb500a7624d82e299c7328',
-    #        from: '0xd0a6e6c54dbc68db5db3a091b171a77407ff7ccf',
-    #        contractAddress: '0x86fa049857e0209aa7d9e616f7eb3b3b78ecfdb0',
-    #        to: '0x...',
-    #        value: '0',
-    #        tokenName: 'EOS',
-    #        tokenSymbol: 'EOS',
-    #        tokenDecimal: '18',
-    #        transactionIndex: '83',
-    #        gas: '173399',
-    #        gasPrice: '21000000000',
-    #        gasUsed: '173398',
-    #        input: 'deprecated',
-    #        cumulativeGasUsed: '7484878',
-    #        confirmations: '3442641'
-    #      },
-    #      {}
-    #    ]
-    #  }
+    # Get token transfers for ETH address
     # @param (see norml_es)
     # @return [Array<Hash>] lista token transfer events etherscan
-    def token_es(add, pag = 0, aes = [])
-      # registos duplicados aparecem em token events (ver exemplo acima)
-      # -quando ha erros na blockchain (acho)
-      # -quando ha token events identicos no mesmo block (acho)
-      res = JSON.parse(
-        conn_es.get('/api', action: 'tokentx', offset: 10_000, address: add, page: pag += 1).body,
-        symbolize_names: true
-      )[:result]
-      aes += res
-      res.count < 10_000 ? aes : token_es(add, pag, aes)
-    rescue StandardError
-      aes
+    def token_es(address)
+      pag_etherscan_req("tokentx", address)
     end
 
-    # @example ledger_gm
-    #  {
-    #    actions: [
-    #      {
-    #        account_action_seq: 964,
-    #        action_trace: {
-    #          account_ram_deltas: [],
-    #          act: {
-    #            account: 'voicebestapp',
-    #            authorization: [
-    #              { actor: 'thetruevoice', permission: 'active' },
-    #              { actor: 'voicebestapp', permission: 'active' }
-    #            ],
-    #            data: { from: 'voicebestapp', memo: '...', quantity: '1.0001 MESSAGE', to: '...' },
-    #            hex_data: '...',
-    #            name: 'transfer'
-    #          },
-    #          action_ordinal: 10,
-    #          block_num: 141_345_345,
-    #          block_time: '2020-09-11T09:44:04.500',
-    #          closest_unnotified_ancestor_action_ordinal: 5,
-    #          context_free: false,
-    #          creator_action_ordinal: 5,
-    #          elapsed: 6,
-    #          producer_block_id: '...',
-    #          receipt: {
-    #            abi_sequence: 1,
-    #            act_digest: '...',
-    #            auth_sequence: [['thetruevoice', 6_778_215], ['voicebestapp', 435_346]],
-    #            code_sequence: 1,
-    #            global_sequence: 233_283_589_258,
-    #            receiver: '...',
-    #            recv_sequence: 927
-    #          },
-    #          receiver: '...',
-    #          trx_id: '...'
-    #        },
-    #        block_num: 141_345_345,
-    #        block_time: '2020-09-11T09:44:04.500',
-    #        global_action_seq: 233_283_589_258,
-    #        irreversible: true
-    #      },
-    #      {}
-    #    ],
-    #    head_block_num: 141_721_698,
-    #    last_irreversible_block: 141_721_371
-    #  }
-    # @param add (see account_gm)
-    # @param [Array<Hash>] agm acumulador transacoes
+    # Get complete transaction history for EOS account
+    # @param (see account_gm)
     # @return [Array<Hash>] lista completa transacoes greymass
-    def ledger_gm(add, agm = [])
-      res = JSON.parse(
-        conn_gm.post('/v1/history/get_actions', { account_name: add, pos: agm.count, offset: 100 }.to_json).body,
-        symbolize_names: true
-      )[:actions]
-      agm += res
-      res.count < 100 ? agm : ledger_gm(add, agm)
-    rescue StandardError
-      agm
+    def ledger_gm(address)
+      actions = []
+      pos = 0
+      loop do
+        response = greymass_req("/v1/history/get_actions", { account_name: address, pos: pos, offset: 100 })
+        batch = response[:actions] || []
+        actions += batch
+        break if batch.size < 100
+
+        pos += 100
+      end
+      actions
     end
 
     private
 
-    # @return [<Symbol>] adapter for the connection - default :net_http
-    def adapter
-      @adapter ||= Faraday.default_adapter
+    # Reusable Faraday connection
+    def connection(base_url)
+      Faraday.new(base_url) do |conn|
+        conn.headers = { content_type: "application/json", accept: "application/json", user_agent: "blockchain-api-client" }
+        conn.adapter Faraday.default_adapter
+      end
+    end
+
+    # Generic Etherscan API request handler
+    def etherscan_req(action, address, page = 1, params = {})
+      params = {
+        module: "account",
+        action: action,
+        address: address,
+        page: page,
+        apikey: ENV.fetch("ETHERSCAN_API_KEY"),
+      }.merge(params)
+      parse_json(connection("https://api.etherscan.io").get("/api", params).body)
+    rescue Faraday::Error, JSON::ParserError
+      { status: "0", result: [] }
     end
 
-    # @return [<Faraday::Connection>] connection object for etherscan
-    def conn_es
-      @conn_es ||=
-        Faraday.new(
-          url: 'https://api.etherscan.io',
-          params: { module: 'account', apikey: ENV.fetch('ETHERSCAN_API_KEY', nil) },
-          headers: { content_type: 'application/json', accept: 'application/json', user_agent: 'etherscan;ruby' }
-        ) do |con|
-          con.request(:url_encoded)
-          con.adapter(adapter)
-        end
+    # Generic method for paginated Etherscan requests
+    # @param action [String] API action name
+    # @param address [String] Blockchain address
+    # @param params [Hash] Additional request parameters
+    # @return [Array<Hash>] Combined results from all pages
+    def pag_etherscan_req(action, address, params = {})
+      results = []
+      page = 1
+      loop do
+        response = etherscan_req(action, address, page, params)
+        break unless response[:status] == "1"
+
+        batch = response[:result] || []
+        results += batch
+        break if batch.size < 10000
+
+        page += 1
+      end
+      results
     end
 
-    # @return [<Faraday::Connection>] connection object for greymass
-    def conn_gm
-      @conn_gm ||=
-        Faraday.new(url: 'https://eos.greymass.com', headers: { content_type: 'application/json' }) do |con|
-          con.request(:url_encoded)
-          con.adapter(adapter)
-        end
+    # Generic Greymass API request handler
+    def greymass_req(endpoint, payload)
+      parse_json((connection("https://eos.greymass.com").post(endpoint) { |req| req.body = payload.to_json }).body)
+    rescue Faraday::Error, JSON::ParserError
+      nil
     end
 
-    # @param [String] uri ETH2 API
-    # @return [Array<Hash>] lista dados beaconchain
-    # def data_bc(uri)
-    #   res = JSON.parse(conn_bc.get(uri).body, symbolize_names: true)[:data] || []
-    #   # calls are rate limited to 10 requests/minute/IP
-    #   sleep(3)
-    #   res.is_a?(Array) ? res : [res]
-    # rescue StandardError
-    #   []
-    # end
-    # @return [<Faraday::Connection>] connection object for beaconchain
-    # def conn_bc
-    #   @conn_bc ||=
-    #     Faraday.new(url: 'https://beaconcha.in', headers: { accept: 'application/json' }) do |con|
-    #       con.request(:url_encoded)
-    #       con.adapter(adapter)
-    #     end
-    # end
+    # Safe JSON parsing with error handling
+    def parse_json(body)
+      JSON.parse(body, symbolize_names: true)
+    rescue JSON::ParserError
+      {}
+    end
   end
 end

data/lib/cns/bigquery.rb

@@ -169,12 +169,12 @@ module Cns
     def apies
       @apies ||= Etherscan.new(
         {
-          wb: sql("select * from #{BD}.wetb order by 2"),
-          ni: sql("select * from #{BD}.netai"),
-          nk: sql("select * from #{BD}.netak"),
-          np: sql("select * from #{BD}.netap"),
-          nt: sql("select * from #{BD}.netat"),
-          nw: sql("select * from #{BD}.netaw")
+          wb: sql("select * from #{BD}.wetb order by ax"),
+          ni: sql("select * from #{BD}.netbi"),
+          nk: sql("select * from #{BD}.netbk"),
+          np: sql("select * from #{BD}.netbp"),
+          nt: sql("select * from #{BD}.netbt"),
+          nw: sql("select * from #{BD}.netbw")
         },
         ops
       )
@@ -184,12 +184,12 @@ module Cns
     def apiesc
       @apies ||= Etherscan.new(
         {
-          wb: sql("select * from #{BD}.wetc order by 2"),
-          ni: sql("select * from #{BD}.netbi"),
-          nk: sql("select * from #{BD}.netbk"),
-          np: sql("select * from #{BD}.netbp"),
-          nt: sql("select * from #{BD}.netbt"),
-          nw: sql("select * from #{BD}.netbw")
+          wb: sql("select * from #{BD}.wetc order by ax"),
+          ni: sql("select * from #{BD}.netci"),
+          nk: sql("select * from #{BD}.netck"),
+          np: sql("select * from #{BD}.netcp"),
+          nt: sql("select * from #{BD}.netct"),
+          nw: sql("select * from #{BD}.netcw")
         },
         ops
       )
@@ -199,7 +199,7 @@ module Cns
     def apigm
       @apigm ||= Greymass.new(
         {
-          wb: sql("select * from #{BD}.weos order by 2"),
+          wb: sql("select * from #{BD}.weos order by ax"),
           nt: sql("select * from #{BD}.neosx")
         },
         ops

data/lib/cns/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cns
-  VERSION = '0.7.4'
+  VERSION = '0.7.6'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cns
 version: !ruby/object:Gem::Version
-  version: 0.7.4
+  version: 0.7.6
 platform: ruby
 authors:
 - Hernâni Rodrigues Vaz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-10 00:00:00.000000000 Z
+date: 2025-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -94,6 +94,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rufo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: solargraph
   requirement: !ruby/object:Gem::Requirement