polarloop 1.0.0

data/lib/polarloop/gas_strategy.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module PolarLoop
+  class GasStrategy
+    @cache = {}
+
+    class << self
+      def for_chain(chain_id, eth_client)
+        @cache[chain_id] ||= detect(chain_id, eth_client)
+      end
+
+      def reset!
+        @cache = {}
+      end
+
+      private
+
+      def detect(chain_id, eth_client)
+        response = eth_client.send(:do_rpc, "eth_feeHistory", params: [1, "latest", []])
+        if response && response["baseFeePerGas"]
+          :eip1559
+        else
+          :legacy
+        end
+      rescue
+        :legacy
+      end
+    end
+
+    attr_reader :strategy
+
+    def initialize(chain_id, eth_client)
+      @strategy = self.class.for_chain(chain_id, eth_client)
+    end
+
+    def legacy?
+      @strategy == :legacy
+    end
+  end
+end

data/lib/polarloop/manager.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module PolarLoop
+  class Manager
+    def initialize(configuration)
+      @config = configuration
+      @config.validate!
+      @wallet = Wallet.new(@config.mnemonic, index: @config.index)
+      @clients = {}
+    end
+
+    def client(chain_name)
+      chain_name = chain_name.to_sym
+      @clients[chain_name] ||= begin
+        chain_config = @config.chain(chain_name)
+        Client.new(chain_config: chain_config, key: @wallet.key)
+      end
+    end
+
+    def address
+      @wallet.address
+    end
+  end
+end

data/lib/polarloop/types/batch_result.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module PolarLoop
+  module Types
+    BatchResult = Struct.new(
+      :mandate_id,
+      :success,
+      :reason,
+      keyword_init: true
+    ) do
+      def self.from_abi_array(tuples)
+        tuples.map do |tuple|
+          new(
+            mandate_id: to_hex_bytes32(tuple[0]),
+            success: tuple[1],
+            reason: tuple[2]
+          )
+        end
+      end
+
+      def self.to_hex_bytes32(binary)
+        if binary.is_a?(String) && binary.start_with?("0x")
+          binary.downcase
+        elsif binary.is_a?(String)
+          "0x" + binary.unpack1("H*")
+        else
+          "0x" + binary.to_s(16).rjust(64, "0")
+        end
+      end
+    end
+  end
+end

data/lib/polarloop/types/charge_ready_result.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module PolarLoop
+  module Types
+    ChargeReadyResult = Struct.new(:ready, :reason, keyword_init: true)
+  end
+end

data/lib/polarloop/types/event.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module PolarLoop
+  module Types
+    MandateCreatedEvent = Struct.new(
+      :mandate_id,
+      :payer,
+      :merchant,
+      :token,
+      :amount,
+      :interval,
+      :max_total_amount,
+      :reference_id,
+      :block_number,
+      :tx_hash,
+      :log_index,
+      keyword_init: true
+    )
+
+    MandateChargedEvent = Struct.new(
+      :mandate_id,
+      :payer,
+      :merchant,
+      :amount,
+      :timestamp,
+      :block_number,
+      :tx_hash,
+      :log_index,
+      keyword_init: true
+    )
+
+    MandateRevokedEvent = Struct.new(
+      :mandate_id,
+      :payer,
+      :block_number,
+      :tx_hash,
+      :log_index,
+      keyword_init: true
+    )
+  end
+end

data/lib/polarloop/types/mandate.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module PolarLoop
+  module Types
+    Mandate = Struct.new(
+      :payer,
+      :created_at,
+      :last_charged_at,
+      :merchant,
+      :interval,
+      :active,
+      :token,
+      :amount,
+      :max_total_amount,
+      :total_charged,
+      :reference_id,
+      keyword_init: true
+    ) do
+      # Converts positional array from ABI decoder to Mandate struct.
+      # ABI order matches Solidity struct field order.
+      def self.from_abi(values)
+        new(
+          payer: values[0],
+          created_at: values[1].to_i,
+          last_charged_at: values[2].to_i,
+          merchant: values[3],
+          interval: values[4].to_i,
+          active: values[5],
+          token: values[6],
+          amount: values[7].to_i,
+          max_total_amount: values[8].to_i,
+          total_charged: values[9].to_i,
+          reference_id: to_hex_bytes32(values[10])
+        )
+      end
+
+      def self.to_hex_bytes32(binary)
+        return "0x" + "00" * 32 if binary.nil?
+
+        if binary.is_a?(String) && binary.start_with?("0x")
+          binary.downcase
+        elsif binary.is_a?(String)
+          "0x" + binary.unpack1("H*")
+        else
+          "0x" + binary.to_s(16).rjust(64, "0")
+        end
+      end
+    end
+  end
+end

data/lib/polarloop/types/tx_result.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module PolarLoop
+  module Types
+    TxResult = Struct.new(
+      :tx_hash,
+      :block_number,
+      :gas_used,
+      :status,
+      :batch_results,
+      keyword_init: true
+    )
+  end
+end

data/lib/polarloop/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PolarLoop
+  VERSION = "1.0.0"
+end

data/lib/polarloop/wallet.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "bip_mnemonic"
+require "money-tree"
+
+module PolarLoop
+  class Wallet
+    BIP44_BASE_PATH = "m/44'/60'/0'/0"
+
+    attr_reader :key
+
+    def initialize(mnemonic, index: 0)
+      validate_mnemonic!(mnemonic)
+      seed_hex = BipMnemonic.to_seed(mnemonic: mnemonic)
+      master = MoneyTree::Master.new(seed_hex: seed_hex)
+      node = master.node_for_path("#{BIP44_BASE_PATH}/#{index}")
+      @key = Eth::Key.new(priv: node.private_key.to_hex)
+    rescue WalletError
+      raise
+    rescue => e
+      raise WalletError, "Failed to derive wallet: #{e.message}"
+    end
+
+    def address
+      @key.address.to_s
+    end
+
+    private
+
+    def validate_mnemonic!(mnemonic)
+      words = mnemonic.to_s.strip.split(/\s+/)
+      raise WalletError, "Invalid mnemonic: must be 12, 15, 18, 21 or 24 words" unless [12, 15, 18, 21, 24].include?(words.length)
+
+      BipMnemonic.to_entropy(mnemonic: mnemonic)
+    rescue WalletError
+      raise
+    rescue => e
+      raise WalletError, "Invalid mnemonic: #{e.message}"
+    end
+  end
+end

data/lib/polarloop.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "eth"
+
+# Patch eth.rb HTTP client — HTTPX hangs on some RPC endpoints (HTTP/2 + persistent).
+# Replace with Net::HTTP which works reliably everywhere.
+require "net/http"
+
+module Eth
+  class Client::Http < Client
+    def send_request(payload)
+      http = Net::HTTP.new(@uri.host, @uri.port)
+      http.use_ssl = @ssl
+      http.open_timeout = 15
+      http.read_timeout = 30
+      request = Net::HTTP::Post.new(@uri.request_uri)
+      request["Content-Type"] = "application/json"
+      request.body = payload
+      response = http.request(request)
+      response.body
+    end
+  end
+end
+
+require_relative "polarloop/version"
+require_relative "polarloop/errors"
+require_relative "polarloop/types/mandate"
+require_relative "polarloop/types/batch_result"
+require_relative "polarloop/types/charge_ready_result"
+require_relative "polarloop/types/tx_result"
+require_relative "polarloop/types/event"
+require_relative "polarloop/abi"
+require_relative "polarloop/configuration"
+require_relative "polarloop/wallet"
+require_relative "polarloop/gas_strategy"
+require_relative "polarloop/contract_caller"
+require_relative "polarloop/event_parser"
+require_relative "polarloop/client"
+require_relative "polarloop/manager"
+
+module PolarLoop
+  class << self
+    def configure
+      @configuration = Configuration.new
+      yield(@configuration)
+      @manager = Manager.new(@configuration)
+      @configuration
+    end
+
+    def client(chain_name)
+      raise ConfigurationError, "PolarLoop not configured. Call PolarLoop.configure first." unless @manager
+
+      @manager.client(chain_name)
+    end
+
+    def address
+      @manager&.address
+    end
+
+    def configuration
+      @configuration
+    end
+
+    def reset!
+      @configuration = nil
+      @manager = nil
+      GasStrategy.reset!
+    end
+  end
+end

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: polarloop
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Pontifi
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: eth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.17
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.17
+- !ruby/object:Gem::Dependency
+  name: bip_mnemonic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+- !ruby/object:Gem::Dependency
+  name: money-tree
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Ruby gem for interacting with PolarLoop EVM smart contract — mandate
+  management, charging, events
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/polarloop.rb
+- lib/polarloop/abi.rb
+- lib/polarloop/abi/polar_loop.json
+- lib/polarloop/client.rb
+- lib/polarloop/configuration.rb
+- lib/polarloop/contract_caller.rb
+- lib/polarloop/errors.rb
+- lib/polarloop/event_parser.rb
+- lib/polarloop/gas_strategy.rb
+- lib/polarloop/manager.rb
+- lib/polarloop/types/batch_result.rb
+- lib/polarloop/types/charge_ready_result.rb
+- lib/polarloop/types/event.rb
+- lib/polarloop/types/mandate.rb
+- lib/polarloop/types/tx_result.rb
+- lib/polarloop/version.rb
+- lib/polarloop/wallet.rb
+homepage: https://rubygems.org/gems/polarloop
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://rubygems.org/gems/polarloop
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Ruby client for PolarLoop smart contract
+test_files: []