tigerbeetle 0.0.1.pre.dev → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a54d9b5cd63da1c737566b85d0e719bad994ed4e43e5ac3d04e2c0efdac4ef4a
-  data.tar.gz: 229b14cfa7ee986831a4f83b029d42e37c1b744388e83644c3b9e571fb092927
+  metadata.gz: a43ba782e05b5f19597449072629a92c1d3116d17b7290fa3ac944287cb4aa43
+  data.tar.gz: 4be7ab09feaca3f520fcb0d1ba2f98e1836cc81011fb54a5c240086b1dda4a0a
 SHA512:
-  metadata.gz: 97b9a2b121ffa25ae9d65a2e8d0ae57c533dd208562d72b8984cd1228483407929c64ef44458dd67bc471eaf569264c6459c9d2cb68e33ce5fa27b6d36465b9c
-  data.tar.gz: aa7cd0fe0219867c6a737faeb60dcad7b4974d114b3130b7fcc7e6642ea18fa1a06e406f0674878661c94d5f2aa18f9ec6da7ccd837eeb23833be28217c2e093
+  metadata.gz: 86cbf91c466a9c3b6811239bf6d56835dfa50e381524a3e2f36f5d01409a2d2679ec6a88f938d9df545b7eba88e1c4e51b64333b547aad27089b3bbbe0aa1749
+  data.tar.gz: f2ed940ae715bf9c5c8dad92e2886069bcd67c2d3ecfb6b77567284adbaf5875f814c8d999509f2671cc300973178689a0758dcdf69afa8f5c206cf092f09d5e

data/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 0.0.2
+
+- Non-optional fields no longer have default values
+- Client errors are now `TigerBeetle::ClientError`
+- Dependency versions corrected
+- Fixed issue with in-flight requests
+
+## 0.0.1
+
+- First release
+- Based on TigerBeetle 0.16.37

data/README.md

@@ -0,0 +1,94 @@
+# Ruby Client for TigerBeetle
+
+[![Gem](https://badge.fury.io/rb/tigerbeetle.svg)](https://rubygems.org/gems/tigerbeetle)
+[![CI](https://github.com/antstorm/tigerbeetle-ruby/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/antstorm/tigerbeetle-ruby/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/antstorm/tigerbeetle-ruby.svg)](https://opensource.org/licenses/apache-2-0)
+
+Are you looking to integrate [Tigebeetle](https://tigerbeetle.com/) into your Ruby (or Rails) stack?
+You've come to the right place!
+
+TigerBeetle is a high performance financial transaction database (i.e. Ledger) designed to power
+the next 30 years of Online Transaction Processing. And this is a feature complete Ruby client for
+it that leverages [the native Zig client](https://tigerbeetle.com/blog/2023-02-21-writing-high-performance-clients-for-tigerbeetle/).
+
+
+## Usage
+
+Start by adding the TigerBeetle gem to your Gemfile:
+
+```ruby
+gem 'tigerbeeetle'
+```
+
+Ensure TigerBeetle is running ([more on this](https://docs.tigerbeetle.com/start/)):
+
+```bash
+$ curl -Lo tigerbeetle.zip https://linux.tigerbeetle.com && unzip tigerbeetle.zip && ./tigerbeetle version
+$ ./tigerbeetle format --cluster=0 --replica=0 --replica-count=1 --development 0_0.tigerbeetle
+$ ./tigerbeetle start --addresses=3000 --development 0_0.tigerbeetle
+```
+
+Connect your Ruby client and start using it:
+
+```ruby
+client = TigerBeetle.connect # using default cluster_id (0) and address (127.0.0.1:3000)
+
+# create accounts
+client.create_accounts(
+  TigerBeetle::Account.new(id: 100, ledger: 1, code: 1),
+  TigerBeetle::Account.new(id: 101, ledger: 1, code: 1)
+)
+
+# move funds between accounts
+client.create_transfers(
+  TigerBeetle::Transfer.new(
+    id: 100,
+    debit_account_id: 100,
+    credit_account_id: 101,
+    amount: 999,
+    ledger: 1,
+    code: 10
+  )
+)
+
+# check balances
+account_1, account_2 = client.lookup_accounts(100, 101)
+account_1.debits_posted # 999
+account_2.credits_posted # 999
+```
+
+*More information on the `ledger` and `code` attributes can be found
+[here](https://docs.tigerbeetle.com/coding/data-modeling/).*
+
+## IDs
+
+You can choose whatever IDs you want when creating accounts and transfers (as long as they are
+unique per cluster). However to leverage the maximum performance TigerBeetle recommends using
+strictly increasing decentralized 128-bit IDs. To generate such an ID you can use the provided
+`TigerBeetle.id` method.
+
+```ruby
+client.create_accounts(
+  TigerBeetle::Account.new(id: TigerBeetle.id, ledger: 1, code: 1)
+)
+```
+
+*More on how to approach this — https://docs.tigerbeetle.com/coding/data-modeling/#id.*
+
+
+## Contributing
+
+We'd love your help building the TigerBeetle Ruby gem.
+
+- Join the [official Slack](https://slack.tigerbeetle.com/join) for general questions on TigerBeetle
+- For any discovered problems or questions about the Ruby client — [open a new issue](https://github.com/antstorm/tigerbeetle-ruby/issues/new)
+- For codebase improvements:
+  - Fork this repo
+  - Implement your changes
+  - Ensure the tests pass by running `bundle exec rspec`
+  - Open a new pull request
+
+
+## License
+
+This project is licensed under [Apache 2.0 license](https://github.com/temporalio/temporal/blob/main/LICENSE).

data/ext/tb_client/extconf.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+require 'mkmf'
+
+makefile_path = File.join('Makefile')
+client_version = '0.16.37'
+tar_package = 'pkg.tar.gz'
+
+makefile = ''
+
+if find_executable('zig') && File.exist?('./tigerbeetle/build.zig')
+  makefile = <<~MFILE
+    all:
+    \techo "Compiling native TB client from the source"
+    \tzig version
+    \tunset -v DESTDIR && cd ./tigerbeetle && zig build clients:c -Dconfig-release=#{client_version} -Dconfig-release-client-min=#{client_version}
+    \n\n
+    install:
+    \tcp -rf ./tigerbeetle/src/clients/c/lib ./pkg
+    \n\n
+    clean:
+    \trm -rf ./tigerbeetle/src/clients/c/lib
+  MFILE
+elsif File.exist?("./#{tar_package}")
+  makefile = <<~MFILE
+    all:
+    \tmkdir -p pkg
+    \ttar -xzf #{tar_package} -C ./pkg
+    \n\n
+    install:
+    \techo "Installing precompiled native TB client"
+    \n\n
+    clean:
+    \techo "Nothing to clean"
+  MFILE
+end
+
+File.open(makefile_path, 'w') do |f|
+  f.puts makefile
+end

data/lib/tb_client/shared_lib.rb

@@ -0,0 +1,59 @@
+module TBClient
+  module SharedLib
+    class << self
+      PKG_DIR = '../../ext/tb_client/pkg'.freeze
+
+      def path
+        prefix = ''
+        linux_libc = ''
+        suffix = ''
+
+        arch, os = RUBY_PLATFORM.split('-')
+
+        arch =
+          case arch
+          when 'x86_64', 'amd64' then 'x86_64'
+          when 'aarch64', 'arm64' then 'aarch64'
+          else
+            raise "Unsupported architecture: #{arch}"
+          end
+
+        case os
+        when /darwin/
+          prefix = 'lib'
+          system = 'macos'
+          suffix = '.dylib'
+        when 'linux'
+          prefix = 'lib'
+          system = 'linux'
+          linux_libc = detect_libc
+          suffix = '.so'
+        when 'windows'
+          system = 'windows'
+          suffix = '.dll'
+        else
+          raise "Unsupported system: #{os}"
+        end
+
+        File.expand_path(
+          "#{PKG_DIR}/#{arch}-#{system}#{linux_libc}/#{prefix}tb_client#{suffix}",
+          __dir__
+        )
+      end
+
+      private
+
+      def detect_libc
+        ldd_output = `ldd --version 2>&1 | head -n 1`.downcase
+
+        if ldd_output.include?('musl')
+          '-musl'
+        elsif ldd_output.include?('gnu') || ldd_output.include?('glibc')
+          '-gnu.2.27'
+        else
+          raise "Unsupported libc: #{ldd_output}"
+        end
+      end
+    end
+  end
+end

data/lib/tb_client.rb

@@ -0,0 +1,282 @@
+require 'ffi'
+require 'tb_client/shared_lib'
+
+module TBClient
+  extend FFI::Library
+
+  ffi_lib SharedLib.path
+
+  InitStatus = enum(FFI::Type::UINT8, [
+                    :SUCCESS, 0,
+                    :UNEXPECTED,
+                    :OUT_OF_MEMORY,
+                    :ADDRESS_INVALID,
+                    :ADDRESS_LIMIT_EXCEEDED,
+                    :SYSTEM_RESOURCES,
+                    :NETWORK_SUBSYSTEM])
+
+  ClientStatus = enum(FFI::Type::UINT8, [
+                      :OK, 0,
+                      :INVALID])
+
+  PacketStatus = enum(FFI::Type::UINT8, [
+                      :OK, 0,
+                      :TOO_MUCH_DATA,
+                      :CLIENT_EVICTED,
+                      :CLIENT_RELEASE_TOO_LOW,
+                      :CLIENT_RELEASE_TOO_HIGH,
+                      :CLIENT_SHUTDOWN,
+                      :INVALID_OPERATION,
+                      :INVALID_DATA_SIZE])
+
+  RegisterLogCallbackStatus = enum(FFI::Type::UINT8, [
+                                   :SUCCESS, 0,
+                                   :ALREADY_REGISTERED,
+                                   :NOT_REGISTERED])
+
+  Operation = enum(FFI::Type::UINT8, [
+                   :PULSE, 128,
+                   :GET_EVENTS, 137,
+                   :CREATE_ACCOUNTS, 138,
+                   :CREATE_TRANSFERS, 139,
+                   :LOOKUP_ACCOUNTS, 140,
+                   :LOOKUP_TRANSFERS, 141,
+                   :GET_ACCOUNT_TRANSFERS, 142,
+                   :GET_ACCOUNT_BALANCES, 143,
+                   :QUERY_ACCOUNTS, 144,
+                   :QUERY_TRANSFERS, 145])
+
+  CreateAccountResult = enum(FFI::Type::UINT32, [
+                             :OK, 0,
+                             :LINKED_EVENT_FAILED, 1,
+                             :LINKED_EVENT_CHAIN_OPEN, 2,
+                             :IMPORTED_EVENT_EXPECTED, 22,
+                             :IMPORTED_EVENT_NOT_EXPECTED, 23,
+                             :TIMESTAMP_MUST_BE_ZERO, 3,
+                             :IMPORTED_EVENT_TIMESTAMP_OUT_OF_RANGE, 24,
+                             :IMPORTED_EVENT_TIMESTAMP_MUST_NOT_ADVANCE, 25,
+                             :RESERVED_FIELD, 4,
+                             :RESERVED_FLAG, 5,
+                             :ID_MUST_NOT_BE_ZERO, 6,
+                             :ID_MUST_NOT_BE_INT_MAX, 7,
+                             :EXISTS_WITH_DIFFERENT_FLAGS, 15,
+                             :EXISTS_WITH_DIFFERENT_USER_DATA_128, 16,
+                             :EXISTS_WITH_DIFFERENT_USER_DATA_64, 17,
+                             :EXISTS_WITH_DIFFERENT_USER_DATA_32, 18,
+                             :EXISTS_WITH_DIFFERENT_LEDGER, 19,
+                             :EXISTS_WITH_DIFFERENT_CODE, 20,
+                             :EXISTS, 21,
+                             :FLAGS_ARE_MUTUALLY_EXCLUSIVE, 8,
+                             :DEBITS_PENDING_MUST_BE_ZERO, 9,
+                             :DEBITS_POSTED_MUST_BE_ZERO, 10,
+                             :CREDITS_PENDING_MUST_BE_ZERO, 11,
+                             :CREDITS_POSTED_MUST_BE_ZERO, 12,
+                             :LEDGER_MUST_NOT_BE_ZERO, 13,
+                             :CODE_MUST_NOT_BE_ZERO, 14,
+                             :IMPORTED_EVENT_TIMESTAMP_MUST_NOT_REGRESS, 26])
+
+  CreateTransferResult = enum(FFI::Type::UINT32, [
+                              :OK, 0,
+                              :LINKED_EVENT_FAILED, 1,
+                              :LINKED_EVENT_CHAIN_OPEN, 2,
+                              :IMPORTED_EVENT_EXPECTED, 56,
+                              :IMPORTED_EVENT_NOT_EXPECTED, 57,
+                              :TIMESTAMP_MUST_BE_ZERO, 3,
+                              :IMPORTED_EVENT_TIMESTAMP_OUT_OF_RANGE, 58,
+                              :IMPORTED_EVENT_TIMESTAMP_MUST_NOT_ADVANCE, 59,
+                              :RESERVED_FLAG, 4,
+                              :ID_MUST_NOT_BE_ZERO, 5,
+                              :ID_MUST_NOT_BE_INT_MAX, 6,
+                              :EXISTS_WITH_DIFFERENT_FLAGS, 36,
+                              :EXISTS_WITH_DIFFERENT_PENDING_ID, 40,
+                              :EXISTS_WITH_DIFFERENT_TIMEOUT, 44,
+                              :EXISTS_WITH_DIFFERENT_DEBIT_ACCOUNT_ID, 37,
+                              :EXISTS_WITH_DIFFERENT_CREDIT_ACCOUNT_ID, 38,
+                              :EXISTS_WITH_DIFFERENT_AMOUNT, 39,
+                              :EXISTS_WITH_DIFFERENT_USER_DATA_128, 41,
+                              :EXISTS_WITH_DIFFERENT_USER_DATA_64, 42,
+                              :EXISTS_WITH_DIFFERENT_USER_DATA_32, 43,
+                              :EXISTS_WITH_DIFFERENT_LEDGER, 67,
+                              :EXISTS_WITH_DIFFERENT_CODE, 45,
+                              :EXISTS, 46,
+                              :ID_ALREADY_FAILED, 68,
+                              :FLAGS_ARE_MUTUALLY_EXCLUSIVE, 7,
+                              :DEBIT_ACCOUNT_ID_MUST_NOT_BE_ZERO, 8,
+                              :DEBIT_ACCOUNT_ID_MUST_NOT_BE_INT_MAX, 9,
+                              :CREDIT_ACCOUNT_ID_MUST_NOT_BE_ZERO, 10,
+                              :CREDIT_ACCOUNT_ID_MUST_NOT_BE_INT_MAX, 11,
+                              :ACCOUNTS_MUST_BE_DIFFERENT, 12,
+                              :PENDING_ID_MUST_BE_ZERO, 13,
+                              :PENDING_ID_MUST_NOT_BE_ZERO, 14,
+                              :PENDING_ID_MUST_NOT_BE_INT_MAX, 15,
+                              :PENDING_ID_MUST_BE_DIFFERENT, 16,
+                              :TIMEOUT_RESERVED_FOR_PENDING_TRANSFER, 17,
+                              :CLOSING_TRANSFER_MUST_BE_PENDING, 64,
+                              :LEDGER_MUST_NOT_BE_ZERO, 19,
+                              :CODE_MUST_NOT_BE_ZERO, 20,
+                              :DEBIT_ACCOUNT_NOT_FOUND, 21,
+                              :CREDIT_ACCOUNT_NOT_FOUND, 22,
+                              :ACCOUNTS_MUST_HAVE_THE_SAME_LEDGER, 23,
+                              :TRANSFER_MUST_HAVE_THE_SAME_LEDGER_AS_ACCOUNTS, 24,
+                              :PENDING_TRANSFER_NOT_FOUND, 25,
+                              :PENDING_TRANSFER_NOT_PENDING, 26,
+                              :PENDING_TRANSFER_HAS_DIFFERENT_DEBIT_ACCOUNT_ID, 27,
+                              :PENDING_TRANSFER_HAS_DIFFERENT_CREDIT_ACCOUNT_ID, 28,
+                              :PENDING_TRANSFER_HAS_DIFFERENT_LEDGER, 29,
+                              :PENDING_TRANSFER_HAS_DIFFERENT_CODE, 30,
+                              :EXCEEDS_PENDING_TRANSFER_AMOUNT, 31,
+                              :PENDING_TRANSFER_HAS_DIFFERENT_AMOUNT, 32,
+                              :PENDING_TRANSFER_ALREADY_POSTED, 33,
+                              :PENDING_TRANSFER_ALREADY_VOIDED, 34,
+                              :PENDING_TRANSFER_EXPIRED, 35,
+                              :IMPORTED_EVENT_TIMESTAMP_MUST_NOT_REGRESS, 60,
+                              :IMPORTED_EVENT_TIMESTAMP_MUST_POSTDATE_DEBIT_ACCOUNT, 61,
+                              :IMPORTED_EVENT_TIMESTAMP_MUST_POSTDATE_CREDIT_ACCOUNT, 62,
+                              :IMPORTED_EVENT_TIMEOUT_MUST_BE_ZERO, 63,
+                              :DEBIT_ACCOUNT_ALREADY_CLOSED, 65,
+                              :CREDIT_ACCOUNT_ALREADY_CLOSED, 66,
+                              :OVERFLOWS_DEBITS_PENDING, 47,
+                              :OVERFLOWS_CREDITS_PENDING, 48,
+                              :OVERFLOWS_DEBITS_POSTED, 49,
+                              :OVERFLOWS_CREDITS_POSTED, 50,
+                              :OVERFLOWS_DEBITS, 51,
+                              :OVERFLOWS_CREDITS, 52,
+                              :OVERFLOWS_TIMEOUT, 53,
+                              :EXCEEDS_CREDITS, 54,
+                              :EXCEEDS_DEBITS, 55])
+
+  LogLevel = enum(FFI::Type::UINT8, [
+                  :ERR, 0,
+                  :WARN,
+                  :INFO,
+                  :DEBUG])
+
+  AccountFlags = bitmask(FFI::Type::UINT16, [
+    :LINKED,
+    :DEBITS_MUST_NOT_EXCEED_CREDITS,
+    :CREDITS_MUST_NOT_EXCEED_DEBITS,
+    :HISTORY,
+    :IMPORTED,
+    :CLOSED]
+  )
+
+  TransferFlags = bitmask(FFI::Type::UINT16, [
+    :LINKED,
+    :PENDING,
+    :POST_PENDING_TRANSFER,
+    :VOID_PENDING_TRANSFER,
+    :BALANCING_DEBIT,
+    :BALANCING_CREDIT,
+    :CLOSING_DEBIT,
+    :CLOSING_CREDIT,
+    :IMPORTED]
+  )
+
+  AccountFilterFlags = bitmask(FFI::Type::UINT32, [:DEBITS, :CREDITS, :REVERSED])
+
+  QueryFilterFlags = bitmask(FFI::Type::UINT32, [:REVERSED])
+
+  class Client < FFI::Struct
+    layout opaque: [:uint64, 4]
+  end
+
+  class UInt128 < FFI::Struct
+    layout low: :uint64,
+           high: :uint64
+  end
+
+  class Packet < FFI::Struct
+    layout user_data: :pointer,
+           data: :pointer,
+           data_size: :uint32,
+           user_tag: :uint16,
+           operation: Operation,
+           status: PacketStatus,
+           opaque: [:uint8, 32]
+  end
+
+  class Account < FFI::Struct
+    layout id: UInt128,
+           debits_pending: UInt128,
+           debits_posted: UInt128,
+           credits_pending: UInt128,
+           credits_posted: UInt128,
+           user_data_128: UInt128,
+           user_data_64: :uint64,
+           user_data_32: :uint32,
+           reserved: :uint32,
+           ledger: :uint32,
+           code: :uint16,
+           flags: AccountFlags,
+           timestamp: :uint64
+  end
+
+  class Transfer < FFI::Struct
+    layout id: UInt128,
+           debit_account_id: UInt128,
+           credit_account_id: UInt128,
+           amount: UInt128,
+           pending_id: UInt128,
+           user_data_128: UInt128,
+           user_data_64: :uint64,
+           user_data_32: :uint32,
+           timeout: :uint32,
+           ledger: :uint32,
+           code: :uint16,
+           flags: TransferFlags,
+           timestamp: :uint64
+  end
+
+  class CreateAccountsResult < FFI::Struct
+    layout index: :uint32,
+           result: CreateAccountResult
+  end
+
+  class CreateTransfersResult < FFI::Struct
+    layout index: :uint32,
+           result: CreateTransferResult
+  end
+
+  class AccountFilter < FFI::Struct
+    layout account_id: UInt128,
+           user_data_128: UInt128,
+           user_data_64: :uint64,
+           user_data_32: :uint32,
+           code: :uint16,
+           reserved: [:uint8, 58],
+           timestamp_min: :uint64,
+           timestamp_max: :uint64,
+           limit: :uint32,
+           flags: AccountFilterFlags
+  end
+
+  class QueryFilter < FFI::Struct
+    layout user_data_128: UInt128,
+           user_data_64: :uint64,
+           user_data_32: :uint32,
+           ledger: :uint32,
+           code: :uint16,
+           reserved: [:uint8, 6],
+           timestamp_min: :uint64,
+           timestamp_max: :uint64,
+           limit: :uint32,
+           flags: QueryFilterFlags
+  end
+
+  class AccountBalance < FFI::Struct
+    layout debits_pending: UInt128,
+           debits_posted: UInt128,
+           credits_pending: UInt128,
+           credits_posted: UInt128,
+           timestamp: :uint64,
+           reserved: [:uint8, 56]
+  end
+
+  callback :on_completion, [:uint, Packet.by_ref, :uint64, :pointer, :uint32], :void
+  callback :log_handler, [LogLevel, :pointer, :uint32], :void
+
+  attach_function :tb_client_init, [Client.by_ref, :pointer, :string, :uint32, :uint, :on_completion], InitStatus
+  attach_function :tb_client_submit, [Client.by_ref, Packet.by_ref], ClientStatus
+  attach_function :tb_client_deinit, [Client.by_ref], ClientStatus
+  attach_function :tb_client_register_log_callback, [:log_handler, :bool], RegisterLogCallbackStatus
+end

data/lib/tigerbeetle/account.rb

@@ -0,0 +1,38 @@
+module TigerBeetle
+  ACCOUNT_PARAMS = %i[
+    id debits_pending debits_posted credits_pending credits_posted user_data_128
+    user_data_64 user_data_32 ledger code flags timestamp
+  ]
+
+  Account = Struct.new(*ACCOUNT_PARAMS) do
+    def initialize(
+      id:,
+      debits_pending: 0,
+      debits_posted: 0,
+      credits_pending: 0,
+      credits_posted: 0,
+      user_data_128: 0,
+      user_data_64: 0,
+      user_data_32: 0,
+      ledger:,
+      code:,
+      flags: [],
+      timestamp: nil
+    )
+      super(
+        id,
+        debits_pending,
+        debits_posted,
+        credits_pending,
+        credits_posted,
+        user_data_128,
+        user_data_64,
+        user_data_32,
+        ledger,
+        code,
+        flags,
+        timestamp
+      )
+    end
+  end
+end

data/lib/tigerbeetle/account_balance.rb

@@ -0,0 +1,23 @@
+module TigerBeetle
+  ACCOUNT_BALANCE_PARAMS = %i[
+    debits_pending debits_posted credits_pending credits_posted timestamp
+  ]
+
+  AccountBalance = Struct.new(*ACCOUNT_BALANCE_PARAMS) do
+    def initialize(
+      debits_pending: 0,
+      debits_posted: 0,
+      credits_pending: 0,
+      credits_posted: 0,
+      timestamp: 0
+    )
+      super(
+        debits_pending,
+        debits_posted,
+        credits_pending,
+        credits_posted,
+        timestamp
+      )
+    end
+  end
+end

data/lib/tigerbeetle/account_filter.rb

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

data/lib/tigerbeetle/atomic_counter.rb

@@ -0,0 +1,14 @@
+module TigerBeetle
+  class AtomicCounter
+    attr_reader :value
+
+    def initialize(value = 0)
+      @value = value
+      @mutex = Mutex.new
+    end
+
+    def increment
+      @mutex.synchronize { @value += 1 }
+    end
+  end
+end