tigerbeetle 0.0.37-aarch64-linux

data/lib/tigerbeetle/converters/account_filter.rb

@@ -0,0 +1,32 @@
+require 'tb_client'
+require 'tigerbeetle/account_filter'
+require 'tigerbeetle/converters/time'
+require 'tigerbeetle/converters/uint_128'
+
+module TigerBeetle
+  module Converters
+    class AccountFilter < Base
+      def self.native_type
+        TBClient::AccountFilter
+      end
+
+      def from_native(ptr)
+        raise 'Unexpected conversion of a native type to AccountFilter'
+      end
+
+      def to_native(ptr, value)
+        TBClient::AccountFilter.new(ptr).tap do |result|
+          Converters::UInt128.to_native(result[:account_id].to_ptr, value.account_id)
+          Converters::UInt128.to_native(result[:user_data_128].to_ptr, value.user_data_128)
+          result[:user_data_64] = value.user_data_64
+          result[:user_data_32] = value.user_data_32
+          result[:code] = value.code
+          Converters::Time.to_native(ptr + result.offset_of(:timestamp_min), value.timestamp_min || 0)
+          Converters::Time.to_native(ptr + result.offset_of(:timestamp_max), value.timestamp_max || 0)
+          result[:limit] = value.limit
+          result[:flags] = value.flags
+        end
+      end
+    end
+  end
+end

data/lib/tigerbeetle/converters/base.rb

@@ -0,0 +1,35 @@
+module TigerBeetle
+  module Converters
+    class Base
+      def self.from_native(ptr)
+        self.new.from_native(ptr)
+      end
+
+      def self.to_native(ptr, value)
+        self.new.to_native(ptr, value)
+      end
+
+      def self.native_type
+        raise NotImplementedError, 'Implement in sublcass'
+      end
+
+      def from_native(ptr)
+        raise NotImplementedError, 'Implement in sublcass'
+      end
+
+      def to_native(ptr, value)
+        raise NotImplementedError, 'Implement in sublcass'
+      end
+
+      private
+
+      def validate_uint!(name, bits, value)
+        if value > 2**bits - 1
+          raise ArgumentError, "#{name} == #{value} is too large to fit in #{bits} bits"
+        elsif value < 0
+          raise ArgumentError, "#{name} == #{value} cannot be negative"
+        end
+      end
+    end
+  end
+end

data/lib/tigerbeetle/converters/create_accounts_result.rb

@@ -0,0 +1,21 @@
+require 'tb_client'
+require 'tigerbeetle/converters/base'
+
+module TigerBeetle
+  module Converters
+    class CreateAccountsResult < Base
+      def self.native_type
+        TBClient::CreateAccountsResult
+      end
+
+      def from_native(ptr)
+        c_value = TBClient::CreateAccountsResult.new(ptr)
+        [c_value[:index], c_value[:result]]
+      end
+
+      def to_native(ptr, value)
+        raise 'Unexpected conversion of CreateAccountsResult to a native type'
+      end
+    end
+  end
+end

data/lib/tigerbeetle/converters/create_transfers_result.rb

@@ -0,0 +1,21 @@
+require 'tb_client'
+require 'tigerbeetle/converters/base'
+
+module TigerBeetle
+  module Converters
+    class CreateTransfersResult < Base
+      def self.native_type
+        TBClient::CreateTransfersResult
+      end
+
+      def from_native(ptr)
+        c_value = TBClient::CreateTransfersResult.new(ptr)
+        [c_value[:index], c_value[:result]]
+      end
+
+      def to_native(ptr, value)
+        raise 'Unexpected conversion of CreateTransfersResult to a native type'
+      end
+    end
+  end
+end

data/lib/tigerbeetle/converters/query_filter.rb

@@ -0,0 +1,33 @@
+require 'tb_client'
+require 'tigerbeetle/query_filter'
+require 'tigerbeetle/converters/base'
+require 'tigerbeetle/converters/time'
+require 'tigerbeetle/converters/uint_128'
+
+module TigerBeetle
+  module Converters
+    class QueryFilter < Base
+      def self.native_type
+        TBClient::QueryFilter
+      end
+
+      def from_native(ptr)
+        raise 'Unexpected conversion of a native type to QueryFilter'
+      end
+
+      def to_native(ptr, value)
+        TBClient::QueryFilter.new(ptr).tap do |result|
+          Converters::UInt128.to_native(result[:user_data_128].to_ptr, value.user_data_128)
+          result[:user_data_64] = value.user_data_64
+          result[:user_data_32] = value.user_data_32
+          result[:code] = value.code
+          result[:ledger] = value.ledger
+          Converters::Time.to_native(ptr + result.offset_of(:timestamp_min), value.timestamp_min || 0)
+          Converters::Time.to_native(ptr + result.offset_of(:timestamp_max), value.timestamp_max || 0)
+          result[:limit] = value.limit
+          result[:flags] = value.flags
+        end
+      end
+    end
+  end
+end

data/lib/tigerbeetle/converters/time.rb

@@ -0,0 +1,23 @@
+require 'ffi'
+require 'tigerbeetle/converters/base'
+
+module TigerBeetle
+  module Converters
+    class Time < Base
+      def self.native_type
+        FFI::Type::UINT64
+      end
+
+      def from_native(ptr)
+        ::Time.at(ptr.read(FFI::Type::UINT64) / 1e9)
+      end
+
+      def to_native(ptr, value)
+        int = (value.to_f * 1e9).to_i
+        validate_uint!(:timestamp, 64, int)
+
+        ptr.write(FFI::Type::UINT64, int)
+      end
+    end
+  end
+end

data/lib/tigerbeetle/converters/transfer.rb

@@ -0,0 +1,64 @@
+require 'tb_client'
+require 'tigerbeetle/transfer'
+require 'tigerbeetle/converters/base'
+require 'tigerbeetle/converters/time'
+require 'tigerbeetle/converters/uint_128'
+
+module TigerBeetle
+  module Converters
+    class Transfer < Base
+      def self.native_type
+        TBClient::Transfer
+      end
+
+      def from_native(ptr)
+        c_value = TBClient::Transfer.new(ptr)
+
+        TigerBeetle::Transfer.new(
+          id: Converters::UInt128.from_native(c_value[:id].to_ptr),
+          debit_account_id: Converters::UInt128.from_native(c_value[:debit_account_id].to_ptr),
+          credit_account_id: Converters::UInt128.from_native(c_value[:credit_account_id].to_ptr),
+          amount: Converters::UInt128.from_native(c_value[:amount].to_ptr),
+          pending_id: Converters::UInt128.from_native(c_value[:pending_id].to_ptr),
+          user_data_128: Converters::UInt128.from_native(c_value[:user_data_128].to_ptr),
+          user_data_64: c_value[:user_data_64],
+          user_data_32: c_value[:user_data_32],
+          timeout: c_value[:timeout],
+          ledger: c_value[:ledger],
+          code: c_value[:code],
+          flags: c_value[:flags],
+          timestamp: Converters::Time.from_native(ptr + c_value.offset_of(:timestamp))
+        )
+      end
+
+      def to_native(ptr, value)
+        validate_uint!(:id, 128, value.id)
+        validate_uint!(:debit_account_id, 128, value.debit_account_id)
+        validate_uint!(:credit_account_id, 128, value.credit_account_id)
+        validate_uint!(:amount, 128, value.amount)
+        validate_uint!(:user_data_128, 128, value.user_data_128)
+        validate_uint!(:user_data_64, 64, value.user_data_64)
+        validate_uint!(:user_data_32, 32, value.user_data_32)
+        validate_uint!(:timeout, 32, value.timeout)
+        validate_uint!(:ledger, 32, value.ledger)
+        validate_uint!(:code, 16, value.code)
+
+        TBClient::Transfer.new(ptr).tap do |result|
+          Converters::UInt128.to_native(result[:id].to_ptr, value.id)
+          Converters::UInt128.to_native(result[:debit_account_id].to_ptr, value.debit_account_id)
+          Converters::UInt128.to_native(result[:credit_account_id].to_ptr, value.credit_account_id)
+          Converters::UInt128.to_native(result[:amount].to_ptr, value.amount)
+          Converters::UInt128.to_native(result[:pending_id].to_ptr, value.pending_id)
+          Converters::UInt128.to_native(result[:user_data_128].to_ptr, value.user_data_128)
+          result[:user_data_64] = value.user_data_64
+          result[:user_data_32] = value.user_data_32
+          result[:timeout] = value.timeout
+          result[:ledger] = value.ledger
+          result[:code] = value.code
+          result[:flags] = value.flags
+          Converters::Time.to_native(ptr + result.offset_of(:timestamp), value.timestamp || 0)
+        end
+      end
+    end
+  end
+end

data/lib/tigerbeetle/converters/uint_128.rb

@@ -0,0 +1,24 @@
+require 'tb_client'
+require 'tigerbeetle/converters/base'
+
+module TigerBeetle
+  module Converters
+    class UInt128 < Base
+      def self.native_type
+        TBClient::UInt128
+      end
+
+      def from_native(ptr)
+        c_value = TBClient::UInt128.new(ptr)
+        c_value[:low] + (c_value[:high] << 64)
+      end
+
+      def to_native(ptr, value)
+        TBClient::UInt128.new(ptr).tap do |result|
+          result[:low] = value % 2**64
+          result[:high] = value >> 64
+        end
+      end
+    end
+  end
+end

data/lib/tigerbeetle/converters.rb

@@ -0,0 +1,12 @@
+require 'tigerbeetle/converters/account'
+require 'tigerbeetle/converters/account_balance'
+require 'tigerbeetle/converters/account_filter'
+require 'tigerbeetle/converters/create_accounts_result'
+require 'tigerbeetle/converters/create_transfers_result'
+require 'tigerbeetle/converters/query_filter'
+require 'tigerbeetle/converters/time'
+require 'tigerbeetle/converters/transfer'
+require 'tigerbeetle/converters/uint_128'
+
+module Converters
+end

data/lib/tigerbeetle/error.rb

@@ -0,0 +1,4 @@
+module TigerBeetle
+  class Error < StandardError; end
+  class ClientError < Error; end
+end

data/lib/tigerbeetle/id.rb

@@ -0,0 +1,30 @@
+require 'securerandom'
+
+module TigerBeetle
+  module ID
+    @last_time_ms = 0
+
+    # Generates a Universally Unique and Sortable Identifier as a 128-bit integer. Based on ULIDs
+    # Inspired by ext/tb_client/tigerbeetle/src/clients/python/src/tigerbeetle/client.py#id
+    def self.generate
+      rnd_bytes = SecureRandom.random_bytes(10)
+      time_ms = (Time.now.to_f * 1000).to_i
+
+      # Ensure time_ms monotonically increases
+      if time_ms <= @last_time_ms
+        time_ms = @last_time_ms
+      else
+        @last_time_ms = time_ms
+      end
+
+      # Convert time_ms integer to 6 bytes (string) in big-endian
+      time_bytes = [time_ms].pack("Q>")[2..7]
+
+      # Combine time and randomness and convert to two 64-bit integers in big-endian
+      integers = (time_bytes + rnd_bytes).unpack("Q>Q>")
+
+      # Re-combine into a single 128-bit integer in big-endian
+      integers[0] << 64 | integers[1]
+    end
+  end
+end

data/lib/tigerbeetle/platforms.rb

@@ -0,0 +1,9 @@
+module TigerBeetle
+  PLATFORMS = {
+    'x86_64-darwin'  => ['x86_64-macos'],
+    'arm64-darwin'   => ['aarch64-macos'],
+    'x86_64-linux'   => ['x86_64-linux-gnu.2.27', 'x86_64-linux-musl'],
+    'aarch64-linux'  => ['aarch64-linux-gnu.2.27', 'aarch64-linux-musl'],
+    'x64-mingw-ucrt' => ['x86_64-windows'],
+  }.freeze
+end

data/lib/tigerbeetle/query_filter.rb

@@ -0,0 +1,31 @@
+module TigerBeetle
+  QUERY_FILTER_PARAMS = %i[
+    user_data_128 user_data_64 user_data_32 ledger code timestamp_min timestamp_max limit flags
+  ]
+
+  QueryFilter = Struct.new(*QUERY_FILTER_PARAMS) do
+    def initialize(
+      user_data_128: 0,
+      user_data_64: 0,
+      user_data_32: 0,
+      ledger: 0,
+      code: 0,
+      timestamp_min: 0,
+      timestamp_max: 0,
+      limit:,
+      flags: []
+    )
+      super(
+        user_data_128,
+        user_data_64,
+        user_data_32,
+        ledger,
+        code,
+        timestamp_min,
+        timestamp_max,
+        limit,
+        flags
+      )
+    end
+  end
+end

data/lib/tigerbeetle/request.rb

@@ -0,0 +1,7 @@
+module TigerBeetle
+  Request = Struct.new(:packet, :converter, :block) do
+    def initialize(packet, converter, &block)
+      super(packet, converter, block)
+    end
+  end
+end

data/lib/tigerbeetle/transfer.rb

@@ -0,0 +1,40 @@
+module TigerBeetle
+  TRANSFER_PARAMS = %i[
+    id debit_account_id credit_account_id amount pending_id user_data_128
+    user_data_64 user_data_32 timeout ledger code flags timestamp
+  ]
+
+  Transfer = Struct.new(*TRANSFER_PARAMS) do
+    def initialize(
+      id:,
+      debit_account_id: 0,
+      credit_account_id: 0,
+      amount: 0,
+      pending_id: 0,
+      user_data_128: 0,
+      user_data_64: 0,
+      user_data_32: 0,
+      timeout: 0,
+      ledger: 0,
+      code: 0,
+      flags: [],
+      timestamp: nil
+    )
+      super(
+        id,
+        debit_account_id,
+        credit_account_id,
+        amount,
+        pending_id,
+        user_data_128,
+        user_data_64,
+        user_data_32,
+        timeout,
+        ledger,
+        code,
+        flags,
+        timestamp
+      )
+    end
+  end
+end

data/lib/tigerbeetle/version.rb

@@ -0,0 +1,4 @@
+module TigerBeetle
+  VERSION = '0.0.37'.freeze
+  TB_VERSION = '0.16.73'.freeze
+end

data/lib/tigerbeetle.rb

@@ -0,0 +1,13 @@
+require 'tigerbeetle/client'
+require 'tigerbeetle/id'
+require 'tigerbeetle/version'
+
+module TigerBeetle
+  def self.id
+    ID.generate
+  end
+
+  def self.connect(cluster_id = 0, address = '3000')
+    TigerBeetle::Client.new(cluster_id, address)
+  end
+end

data/tigerbeetle.gemspec

@@ -0,0 +1,50 @@
+require_relative './lib/tigerbeetle/version'
+require_relative './lib/tigerbeetle/platforms'
+
+Gem::Specification.new do |spec|
+  spec.required_ruby_version = '>= 3.0'
+
+  spec.name          = 'tigerbeetle'
+  spec.version       = TigerBeetle::VERSION
+  spec.authors       = ['Anthony D']
+  spec.email         = ['anthony.dmitriyev@gmail.com']
+
+  spec.summary       = 'TigerBeetle Ruby client'
+  spec.description   = 'A Ruby client for interacting with the high performance TigerBeetle ledger'
+  spec.homepage      = 'https://github.com/antstorm/tigerbeetle-ruby'
+  spec.license       = 'Apache-2.0'
+
+  spec.require_paths = ['lib']
+
+  platform = ENV['TB_PLATFORM']
+  files = [
+    Dir['lib/**/*.rb'],
+    'CHANGELOG.md',
+    'LICENSE',
+    'README.md',
+    'tigerbeetle.gemspec'
+  ].flatten
+
+  if platform
+    spec.platform = platform
+    native_files = TigerBeetle::PLATFORMS.fetch(platform).flat_map do |target|
+      Dir["lib/tb_client/native/#{target}/*"]
+    end
+    spec.files = files + native_files
+  else
+    ext = 'ext/tb_client/extconf.rb'
+    spec.extensions = [ext]
+    spec.files = files + [
+      ext,
+      Dir['ext/tb_client/tigerbeetle/src/**/*.{zig,c,h}'],
+      'ext/tb_client/tigerbeetle/build.zig',
+      'ext/tb_client/tigerbeetle/LICENSE'
+    ].flatten
+  end
+
+  spec.add_dependency 'ffi', '~> 1.14'
+
+  spec.add_development_dependency 'rake', '~> 13.1'
+  spec.add_development_dependency 'rspec', '~> 3.11'
+  spec.add_development_dependency 'pry', '~> 0.15'
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: tigerbeetle
+version: !ruby/object:Gem::Version
+  version: 0.0.37
+platform: aarch64-linux
+authors:
+- Anthony D
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-04-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.11'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+description: A Ruby client for interacting with the high performance TigerBeetle ledger
+email:
+- anthony.dmitriyev@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/tb_client.rb
+- lib/tb_client/native/aarch64-linux-gnu.2.27/libtb_client.a
+- lib/tb_client/native/aarch64-linux-gnu.2.27/libtb_client.so
+- lib/tb_client/native/aarch64-linux-musl/libtb_client.a
+- lib/tb_client/native/aarch64-linux-musl/libtb_client.so
+- lib/tb_client/shared_lib.rb
+- lib/tigerbeetle.rb
+- lib/tigerbeetle/account.rb
+- lib/tigerbeetle/account_balance.rb
+- lib/tigerbeetle/account_filter.rb
+- lib/tigerbeetle/atomic_counter.rb
+- lib/tigerbeetle/client.rb
+- lib/tigerbeetle/converters.rb
+- lib/tigerbeetle/converters/account.rb
+- lib/tigerbeetle/converters/account_balance.rb
+- lib/tigerbeetle/converters/account_filter.rb
+- lib/tigerbeetle/converters/base.rb
+- lib/tigerbeetle/converters/create_accounts_result.rb
+- lib/tigerbeetle/converters/create_transfers_result.rb
+- lib/tigerbeetle/converters/query_filter.rb
+- lib/tigerbeetle/converters/time.rb
+- lib/tigerbeetle/converters/transfer.rb
+- lib/tigerbeetle/converters/uint_128.rb
+- lib/tigerbeetle/error.rb
+- lib/tigerbeetle/id.rb
+- lib/tigerbeetle/platforms.rb
+- lib/tigerbeetle/query_filter.rb
+- lib/tigerbeetle/request.rb
+- lib/tigerbeetle/transfer.rb
+- lib/tigerbeetle/version.rb
+- tigerbeetle.gemspec
+homepage: https://github.com/antstorm/tigerbeetle-ruby
+licenses:
+- Apache-2.0
+metadata: {}
+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.5.22
+signing_key:
+specification_version: 4
+summary: TigerBeetle Ruby client
+test_files: []