tigerbeetle 0.17.8 → 0.17.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2997253dc893829fe68df06a1a6a90450e2887e8a8206f759df6ae6adb3c6d84
-  data.tar.gz: b6382e837c861ec9e8d01ee0ea3241cf4afab975603ed9361c85f80c37768e21
+  metadata.gz: 43f442704bc340264a0e59ae73e1d877f3c4a213f42c2d06fc6f30c419831cea
+  data.tar.gz: 5c76d2fb2c3f608e43743e3071202040f542f6cb906d1ad9ff1baab5c8bda1ec
 SHA512:
-  metadata.gz: 9898305fee80abe764d276d926d83a8a551ad5af5d05b48757c0330b1664b36f56833b708bba83b3ba25853fe571b9675620325ebbc0cbc313e9f19a60308b23
-  data.tar.gz: 96b88a1a864c3c84d9f1fbc06589c8aa3e0c1000344e51332ece592a713923a84c5b33daec6a9e9deae6c7d80dc78afffdf31f0c5da579e27ee916d75c02805e
+  metadata.gz: 5604eb11cfa72d5fa1237f0e11abf0f0b7f9512a8408d227ba273718cafbf0cba7af950a3bf7a042957074f1f18f1ba106ac6304966d114ccb718d2dac38d5a3
+  data.tar.gz: 0d825674cf6047888820446b4b3046ddbe20eb01f7c03dc54d41b246e1fa1e6ab9cac4a66126b4cc69e2a128c010f85f1f0ce93d1ebfed527c1cc9053aae0ced

data/README.md

@@ -6,7 +6,9 @@ The TigerBeetle client for Ruby.
 >[!IMPORTANT]
 >This gem changed ownership from [Anthony D](https://github.com/antstorm)
 to TigerBeetle. If you're upgrading from a 0.0.x version, please consult
-the [migration guide](./docs/migration.md) for the necessary code changes.
+the [migration guide](
+https://github.com/tigerbeetle/tigerbeetle/blob/main/src/clients/ruby/docs/migration.md
+) for the necessary code changes.
 
 ## Prerequisites
 

data/sig/tigerbeetle.rbs

@@ -254,9 +254,109 @@ module TigerBeetle
     def initialize: () -> void
   end
 
+  type create_account_status_name =
+    :created
+    | :linked_event_failed
+    | :linked_event_chain_open
+    | :imported_event_expected
+    | :imported_event_not_expected
+    | :timestamp_must_be_zero
+    | :imported_event_timestamp_out_of_range
+    | :imported_event_timestamp_must_not_advance
+    | :reserved_field
+    | :reserved_flag
+    | :id_must_not_be_zero
+    | :id_must_not_be_int_max
+    | :exists_with_different_flags
+    | :exists_with_different_user_data_128
+    | :exists_with_different_user_data_64
+    | :exists_with_different_user_data_32
+    | :exists_with_different_ledger
+    | :exists_with_different_code
+    | :exists
+    | :flags_are_mutually_exclusive
+    | :debits_pending_must_be_zero
+    | :debits_posted_must_be_zero
+    | :credits_pending_must_be_zero
+    | :credits_posted_must_be_zero
+    | :ledger_must_not_be_zero
+    | :code_must_not_be_zero
+    | :imported_event_timestamp_must_not_regress
+
+  type create_transfer_status_name =
+    :created
+    | :linked_event_failed
+    | :linked_event_chain_open
+    | :imported_event_expected
+    | :imported_event_not_expected
+    | :timestamp_must_be_zero
+    | :imported_event_timestamp_out_of_range
+    | :imported_event_timestamp_must_not_advance
+    | :reserved_flag
+    | :id_must_not_be_zero
+    | :id_must_not_be_int_max
+    | :exists_with_different_flags
+    | :exists_with_different_pending_id
+    | :exists_with_different_timeout
+    | :exists_with_different_debit_account_id
+    | :exists_with_different_credit_account_id
+    | :exists_with_different_amount
+    | :exists_with_different_user_data_128
+    | :exists_with_different_user_data_64
+    | :exists_with_different_user_data_32
+    | :exists_with_different_ledger
+    | :exists_with_different_code
+    | :exists
+    | :id_already_failed
+    | :flags_are_mutually_exclusive
+    | :debit_account_id_must_not_be_zero
+    | :debit_account_id_must_not_be_int_max
+    | :credit_account_id_must_not_be_zero
+    | :credit_account_id_must_not_be_int_max
+    | :accounts_must_be_different
+    | :pending_id_must_be_zero
+    | :pending_id_must_not_be_zero
+    | :pending_id_must_not_be_int_max
+    | :pending_id_must_be_different
+    | :timeout_reserved_for_pending_transfer
+    | :closing_transfer_must_be_pending
+    | :ledger_must_not_be_zero
+    | :code_must_not_be_zero
+    | :debit_account_not_found
+    | :credit_account_not_found
+    | :accounts_must_have_the_same_ledger
+    | :transfer_must_have_the_same_ledger_as_accounts
+    | :pending_transfer_not_found
+    | :pending_transfer_not_pending
+    | :pending_transfer_has_different_debit_account_id
+    | :pending_transfer_has_different_credit_account_id
+    | :pending_transfer_has_different_ledger
+    | :pending_transfer_has_different_code
+    | :exceeds_pending_transfer_amount
+    | :pending_transfer_has_different_amount
+    | :pending_transfer_already_posted
+    | :pending_transfer_already_voided
+    | :pending_transfer_expired
+    | :imported_event_timestamp_must_not_regress
+    | :imported_event_timestamp_must_postdate_debit_account
+    | :imported_event_timestamp_must_postdate_credit_account
+    | :imported_event_timeout_must_be_zero
+    | :debit_account_already_closed
+    | :credit_account_already_closed
+    | :overflows_debits_pending
+    | :overflows_credits_pending
+    | :overflows_debits_posted
+    | :overflows_credits_posted
+    | :overflows_debits
+    | :overflows_credits
+    | :overflows_timeout
+    | :exceeds_credits
+    | :exceeds_debits
+
   class CreateAccountResult
     attr_reader timestamp: Integer
     attr_reader status: Integer
+    attr_reader status_name: create_account_status_name
 
     def initialize: () -> void
   end
@@ -264,6 +364,7 @@ module TigerBeetle
   class CreateTransferResult
     attr_reader timestamp: Integer
     attr_reader status: Integer
+    attr_reader status_name: create_transfer_status_name
 
     def initialize: () -> void
   end

data/src/ext/tigerbeetle/rb_tb_gen.h

@@ -14,7 +14,10 @@
 #include <string.h>
 
 static inline void rb_tb_pack_u128(VALUE v, void *dst) {
-    rb_integer_pack(v, dst, 16, 1, 0, INTEGER_PACK_LITTLE_ENDIAN);
+    int status = rb_integer_pack(v, dst, 16, 1, 0, INTEGER_PACK_LITTLE_ENDIAN);
+    if (status != 0 && status != 1) {
+        rb_raise(rb_eRangeError, "integer must be between 0 and 2**128 - 1");
+    }
 }
 
 static inline VALUE rb_tb_unpack_u128(const void *src) {
@@ -58,6 +61,212 @@ static const char *rb_tb_init_error_message(TB_INIT_STATUS status) {
     }
 }
 
+static VALUE rb_tb_create_accounts_status_name(uint32_t status) {
+    switch (status) {
+    case 4294967295:
+        return ID2SYM(rb_intern("created"));
+    case 1:
+        return ID2SYM(rb_intern("linked_event_failed"));
+    case 2:
+        return ID2SYM(rb_intern("linked_event_chain_open"));
+    case 22:
+        return ID2SYM(rb_intern("imported_event_expected"));
+    case 23:
+        return ID2SYM(rb_intern("imported_event_not_expected"));
+    case 3:
+        return ID2SYM(rb_intern("timestamp_must_be_zero"));
+    case 24:
+        return ID2SYM(rb_intern("imported_event_timestamp_out_of_range"));
+    case 25:
+        return ID2SYM(rb_intern("imported_event_timestamp_must_not_advance"));
+    case 4:
+        return ID2SYM(rb_intern("reserved_field"));
+    case 5:
+        return ID2SYM(rb_intern("reserved_flag"));
+    case 6:
+        return ID2SYM(rb_intern("id_must_not_be_zero"));
+    case 7:
+        return ID2SYM(rb_intern("id_must_not_be_int_max"));
+    case 15:
+        return ID2SYM(rb_intern("exists_with_different_flags"));
+    case 16:
+        return ID2SYM(rb_intern("exists_with_different_user_data_128"));
+    case 17:
+        return ID2SYM(rb_intern("exists_with_different_user_data_64"));
+    case 18:
+        return ID2SYM(rb_intern("exists_with_different_user_data_32"));
+    case 19:
+        return ID2SYM(rb_intern("exists_with_different_ledger"));
+    case 20:
+        return ID2SYM(rb_intern("exists_with_different_code"));
+    case 21:
+        return ID2SYM(rb_intern("exists"));
+    case 8:
+        return ID2SYM(rb_intern("flags_are_mutually_exclusive"));
+    case 9:
+        return ID2SYM(rb_intern("debits_pending_must_be_zero"));
+    case 10:
+        return ID2SYM(rb_intern("debits_posted_must_be_zero"));
+    case 11:
+        return ID2SYM(rb_intern("credits_pending_must_be_zero"));
+    case 12:
+        return ID2SYM(rb_intern("credits_posted_must_be_zero"));
+    case 13:
+        return ID2SYM(rb_intern("ledger_must_not_be_zero"));
+    case 14:
+        return ID2SYM(rb_intern("code_must_not_be_zero"));
+    case 26:
+        return ID2SYM(rb_intern("imported_event_timestamp_must_not_regress"));
+    default:
+        tb_assert(false);
+        return Qnil;
+    }
+}
+
+static VALUE rb_tb_create_transfers_status_name(uint32_t status) {
+    switch (status) {
+    case 4294967295:
+        return ID2SYM(rb_intern("created"));
+    case 1:
+        return ID2SYM(rb_intern("linked_event_failed"));
+    case 2:
+        return ID2SYM(rb_intern("linked_event_chain_open"));
+    case 56:
+        return ID2SYM(rb_intern("imported_event_expected"));
+    case 57:
+        return ID2SYM(rb_intern("imported_event_not_expected"));
+    case 3:
+        return ID2SYM(rb_intern("timestamp_must_be_zero"));
+    case 58:
+        return ID2SYM(rb_intern("imported_event_timestamp_out_of_range"));
+    case 59:
+        return ID2SYM(rb_intern("imported_event_timestamp_must_not_advance"));
+    case 4:
+        return ID2SYM(rb_intern("reserved_flag"));
+    case 5:
+        return ID2SYM(rb_intern("id_must_not_be_zero"));
+    case 6:
+        return ID2SYM(rb_intern("id_must_not_be_int_max"));
+    case 36:
+        return ID2SYM(rb_intern("exists_with_different_flags"));
+    case 40:
+        return ID2SYM(rb_intern("exists_with_different_pending_id"));
+    case 44:
+        return ID2SYM(rb_intern("exists_with_different_timeout"));
+    case 37:
+        return ID2SYM(rb_intern("exists_with_different_debit_account_id"));
+    case 38:
+        return ID2SYM(rb_intern("exists_with_different_credit_account_id"));
+    case 39:
+        return ID2SYM(rb_intern("exists_with_different_amount"));
+    case 41:
+        return ID2SYM(rb_intern("exists_with_different_user_data_128"));
+    case 42:
+        return ID2SYM(rb_intern("exists_with_different_user_data_64"));
+    case 43:
+        return ID2SYM(rb_intern("exists_with_different_user_data_32"));
+    case 67:
+        return ID2SYM(rb_intern("exists_with_different_ledger"));
+    case 45:
+        return ID2SYM(rb_intern("exists_with_different_code"));
+    case 46:
+        return ID2SYM(rb_intern("exists"));
+    case 68:
+        return ID2SYM(rb_intern("id_already_failed"));
+    case 7:
+        return ID2SYM(rb_intern("flags_are_mutually_exclusive"));
+    case 8:
+        return ID2SYM(rb_intern("debit_account_id_must_not_be_zero"));
+    case 9:
+        return ID2SYM(rb_intern("debit_account_id_must_not_be_int_max"));
+    case 10:
+        return ID2SYM(rb_intern("credit_account_id_must_not_be_zero"));
+    case 11:
+        return ID2SYM(rb_intern("credit_account_id_must_not_be_int_max"));
+    case 12:
+        return ID2SYM(rb_intern("accounts_must_be_different"));
+    case 13:
+        return ID2SYM(rb_intern("pending_id_must_be_zero"));
+    case 14:
+        return ID2SYM(rb_intern("pending_id_must_not_be_zero"));
+    case 15:
+        return ID2SYM(rb_intern("pending_id_must_not_be_int_max"));
+    case 16:
+        return ID2SYM(rb_intern("pending_id_must_be_different"));
+    case 17:
+        return ID2SYM(rb_intern("timeout_reserved_for_pending_transfer"));
+    case 64:
+        return ID2SYM(rb_intern("closing_transfer_must_be_pending"));
+    case 19:
+        return ID2SYM(rb_intern("ledger_must_not_be_zero"));
+    case 20:
+        return ID2SYM(rb_intern("code_must_not_be_zero"));
+    case 21:
+        return ID2SYM(rb_intern("debit_account_not_found"));
+    case 22:
+        return ID2SYM(rb_intern("credit_account_not_found"));
+    case 23:
+        return ID2SYM(rb_intern("accounts_must_have_the_same_ledger"));
+    case 24:
+        return ID2SYM(rb_intern("transfer_must_have_the_same_ledger_as_accounts"));
+    case 25:
+        return ID2SYM(rb_intern("pending_transfer_not_found"));
+    case 26:
+        return ID2SYM(rb_intern("pending_transfer_not_pending"));
+    case 27:
+        return ID2SYM(rb_intern("pending_transfer_has_different_debit_account_id"));
+    case 28:
+        return ID2SYM(rb_intern("pending_transfer_has_different_credit_account_id"));
+    case 29:
+        return ID2SYM(rb_intern("pending_transfer_has_different_ledger"));
+    case 30:
+        return ID2SYM(rb_intern("pending_transfer_has_different_code"));
+    case 31:
+        return ID2SYM(rb_intern("exceeds_pending_transfer_amount"));
+    case 32:
+        return ID2SYM(rb_intern("pending_transfer_has_different_amount"));
+    case 33:
+        return ID2SYM(rb_intern("pending_transfer_already_posted"));
+    case 34:
+        return ID2SYM(rb_intern("pending_transfer_already_voided"));
+    case 35:
+        return ID2SYM(rb_intern("pending_transfer_expired"));
+    case 60:
+        return ID2SYM(rb_intern("imported_event_timestamp_must_not_regress"));
+    case 61:
+        return ID2SYM(rb_intern("imported_event_timestamp_must_postdate_debit_account"));
+    case 62:
+        return ID2SYM(rb_intern("imported_event_timestamp_must_postdate_credit_account"));
+    case 63:
+        return ID2SYM(rb_intern("imported_event_timeout_must_be_zero"));
+    case 65:
+        return ID2SYM(rb_intern("debit_account_already_closed"));
+    case 66:
+        return ID2SYM(rb_intern("credit_account_already_closed"));
+    case 47:
+        return ID2SYM(rb_intern("overflows_debits_pending"));
+    case 48:
+        return ID2SYM(rb_intern("overflows_credits_pending"));
+    case 49:
+        return ID2SYM(rb_intern("overflows_debits_posted"));
+    case 50:
+        return ID2SYM(rb_intern("overflows_credits_posted"));
+    case 51:
+        return ID2SYM(rb_intern("overflows_debits"));
+    case 52:
+        return ID2SYM(rb_intern("overflows_credits"));
+    case 53:
+        return ID2SYM(rb_intern("overflows_timeout"));
+    case 54:
+        return ID2SYM(rb_intern("exceeds_credits"));
+    case 55:
+        return ID2SYM(rb_intern("exceeds_debits"));
+    default:
+        tb_assert(false);
+        return Qnil;
+    }
+}
+
 static VALUE rb_tb_deserialize_lookup_accounts(const uint8_t *buf, uint32_t buf_size) {
     VALUE klass = rb_path2class("TigerBeetle::Account");
     tb_assert(buf_size % sizeof(tb_account_t) == 0);
@@ -73,13 +282,13 @@ static VALUE rb_tb_deserialize_lookup_accounts(const uint8_t *buf, uint32_t buf_
         rb_ivar_set(obj, rb_intern("@credits_pending"), rb_tb_unpack_u128(&item->credits_pending));
         rb_ivar_set(obj, rb_intern("@credits_posted"), rb_tb_unpack_u128(&item->credits_posted));
         rb_ivar_set(obj, rb_intern("@user_data_128"), rb_tb_unpack_u128(&item->user_data_128));
-        rb_ivar_set(obj, rb_intern("@user_data_64"), ULL2NUM(item->user_data_64));
-        rb_ivar_set(obj, rb_intern("@user_data_32"), UINT2NUM(item->user_data_32));
+        rb_ivar_set(obj, rb_intern("@user_data_64"), RB_ULL2NUM(item->user_data_64));
+        rb_ivar_set(obj, rb_intern("@user_data_32"), RB_UINT2NUM(item->user_data_32));
         tb_assert(item->reserved == 0);
-        rb_ivar_set(obj, rb_intern("@ledger"), UINT2NUM(item->ledger));
-        rb_ivar_set(obj, rb_intern("@code"), UINT2NUM(item->code));
-        rb_ivar_set(obj, rb_intern("@flags"), UINT2NUM(item->flags));
-        rb_ivar_set(obj, rb_intern("@timestamp"), ULL2NUM(item->timestamp));
+        rb_ivar_set(obj, rb_intern("@ledger"), RB_UINT2NUM(item->ledger));
+        rb_ivar_set(obj, rb_intern("@code"), RB_UINT2NUM(item->code));
+        rb_ivar_set(obj, rb_intern("@flags"), RB_UINT2NUM(item->flags));
+        rb_ivar_set(obj, rb_intern("@timestamp"), RB_ULL2NUM(item->timestamp));
         rb_ary_push(results, obj);
     }
     return results;
@@ -100,13 +309,13 @@ static VALUE rb_tb_deserialize_lookup_transfers(const uint8_t *buf, uint32_t buf
         rb_ivar_set(obj, rb_intern("@amount"), rb_tb_unpack_u128(&item->amount));
         rb_ivar_set(obj, rb_intern("@pending_id"), rb_tb_unpack_u128(&item->pending_id));
         rb_ivar_set(obj, rb_intern("@user_data_128"), rb_tb_unpack_u128(&item->user_data_128));
-        rb_ivar_set(obj, rb_intern("@user_data_64"), ULL2NUM(item->user_data_64));
-        rb_ivar_set(obj, rb_intern("@user_data_32"), UINT2NUM(item->user_data_32));
-        rb_ivar_set(obj, rb_intern("@timeout"), UINT2NUM(item->timeout));
-        rb_ivar_set(obj, rb_intern("@ledger"), UINT2NUM(item->ledger));
-        rb_ivar_set(obj, rb_intern("@code"), UINT2NUM(item->code));
-        rb_ivar_set(obj, rb_intern("@flags"), UINT2NUM(item->flags));
-        rb_ivar_set(obj, rb_intern("@timestamp"), ULL2NUM(item->timestamp));
+        rb_ivar_set(obj, rb_intern("@user_data_64"), RB_ULL2NUM(item->user_data_64));
+        rb_ivar_set(obj, rb_intern("@user_data_32"), RB_UINT2NUM(item->user_data_32));
+        rb_ivar_set(obj, rb_intern("@timeout"), RB_UINT2NUM(item->timeout));
+        rb_ivar_set(obj, rb_intern("@ledger"), RB_UINT2NUM(item->ledger));
+        rb_ivar_set(obj, rb_intern("@code"), RB_UINT2NUM(item->code));
+        rb_ivar_set(obj, rb_intern("@flags"), RB_UINT2NUM(item->flags));
+        rb_ivar_set(obj, rb_intern("@timestamp"), RB_ULL2NUM(item->timestamp));
         rb_ary_push(results, obj);
     }
     return results;
@@ -119,14 +328,14 @@ static void rb_tb_serialize_get_account_transfers(VALUE items_rb, uint8_t *buf,
         tb_account_filter_t *item = &items[i];
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@account_id")), &item->account_id);
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@user_data_128")), &item->user_data_128);
-        item->user_data_64 = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
-        item->user_data_32 = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
-        item->code = (uint16_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@code")));
+        item->user_data_64 = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
+        item->user_data_32 = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
+        item->code = RB_NUM2USHORT(rb_ivar_get(item_rb, rb_intern("@code")));
         memset(item->reserved, 0, sizeof(item->reserved));
-        item->timestamp_min = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_min")));
-        item->timestamp_max = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_max")));
-        item->limit = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@limit")));
-        item->flags = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
+        item->timestamp_min = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_min")));
+        item->timestamp_max = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_max")));
+        item->limit = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@limit")));
+        item->flags = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
     }
 }
 
@@ -145,13 +354,13 @@ static VALUE rb_tb_deserialize_get_account_transfers(const uint8_t *buf, uint32_
         rb_ivar_set(obj, rb_intern("@amount"), rb_tb_unpack_u128(&item->amount));
         rb_ivar_set(obj, rb_intern("@pending_id"), rb_tb_unpack_u128(&item->pending_id));
         rb_ivar_set(obj, rb_intern("@user_data_128"), rb_tb_unpack_u128(&item->user_data_128));
-        rb_ivar_set(obj, rb_intern("@user_data_64"), ULL2NUM(item->user_data_64));
-        rb_ivar_set(obj, rb_intern("@user_data_32"), UINT2NUM(item->user_data_32));
-        rb_ivar_set(obj, rb_intern("@timeout"), UINT2NUM(item->timeout));
-        rb_ivar_set(obj, rb_intern("@ledger"), UINT2NUM(item->ledger));
-        rb_ivar_set(obj, rb_intern("@code"), UINT2NUM(item->code));
-        rb_ivar_set(obj, rb_intern("@flags"), UINT2NUM(item->flags));
-        rb_ivar_set(obj, rb_intern("@timestamp"), ULL2NUM(item->timestamp));
+        rb_ivar_set(obj, rb_intern("@user_data_64"), RB_ULL2NUM(item->user_data_64));
+        rb_ivar_set(obj, rb_intern("@user_data_32"), RB_UINT2NUM(item->user_data_32));
+        rb_ivar_set(obj, rb_intern("@timeout"), RB_UINT2NUM(item->timeout));
+        rb_ivar_set(obj, rb_intern("@ledger"), RB_UINT2NUM(item->ledger));
+        rb_ivar_set(obj, rb_intern("@code"), RB_UINT2NUM(item->code));
+        rb_ivar_set(obj, rb_intern("@flags"), RB_UINT2NUM(item->flags));
+        rb_ivar_set(obj, rb_intern("@timestamp"), RB_ULL2NUM(item->timestamp));
         rb_ary_push(results, obj);
     }
     return results;
@@ -164,14 +373,14 @@ static void rb_tb_serialize_get_account_balances(VALUE items_rb, uint8_t *buf, l
         tb_account_filter_t *item = &items[i];
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@account_id")), &item->account_id);
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@user_data_128")), &item->user_data_128);
-        item->user_data_64 = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
-        item->user_data_32 = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
-        item->code = (uint16_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@code")));
+        item->user_data_64 = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
+        item->user_data_32 = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
+        item->code = RB_NUM2USHORT(rb_ivar_get(item_rb, rb_intern("@code")));
         memset(item->reserved, 0, sizeof(item->reserved));
-        item->timestamp_min = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_min")));
-        item->timestamp_max = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_max")));
-        item->limit = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@limit")));
-        item->flags = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
+        item->timestamp_min = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_min")));
+        item->timestamp_max = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_max")));
+        item->limit = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@limit")));
+        item->flags = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
     }
 }
 
@@ -188,7 +397,7 @@ static VALUE rb_tb_deserialize_get_account_balances(const uint8_t *buf, uint32_t
         rb_ivar_set(obj, rb_intern("@debits_posted"), rb_tb_unpack_u128(&item->debits_posted));
         rb_ivar_set(obj, rb_intern("@credits_pending"), rb_tb_unpack_u128(&item->credits_pending));
         rb_ivar_set(obj, rb_intern("@credits_posted"), rb_tb_unpack_u128(&item->credits_posted));
-        rb_ivar_set(obj, rb_intern("@timestamp"), ULL2NUM(item->timestamp));
+        rb_ivar_set(obj, rb_intern("@timestamp"), RB_ULL2NUM(item->timestamp));
         uint8_t zero[sizeof(item->reserved)] = {0};
         tb_assert(memcmp(item->reserved, zero, sizeof(item->reserved)) == 0);
         rb_ary_push(results, obj);
@@ -202,15 +411,15 @@ static void rb_tb_serialize_query_accounts(VALUE items_rb, uint8_t *buf, long co
         VALUE item_rb = RARRAY_AREF(items_rb, i);
         tb_query_filter_t *item = &items[i];
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@user_data_128")), &item->user_data_128);
-        item->user_data_64 = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
-        item->user_data_32 = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
-        item->ledger = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@ledger")));
-        item->code = (uint16_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@code")));
+        item->user_data_64 = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
+        item->user_data_32 = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
+        item->ledger = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@ledger")));
+        item->code = RB_NUM2USHORT(rb_ivar_get(item_rb, rb_intern("@code")));
         memset(item->reserved, 0, sizeof(item->reserved));
-        item->timestamp_min = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_min")));
-        item->timestamp_max = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_max")));
-        item->limit = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@limit")));
-        item->flags = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
+        item->timestamp_min = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_min")));
+        item->timestamp_max = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_max")));
+        item->limit = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@limit")));
+        item->flags = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
     }
 }
 
@@ -229,13 +438,13 @@ static VALUE rb_tb_deserialize_query_accounts(const uint8_t *buf, uint32_t buf_s
         rb_ivar_set(obj, rb_intern("@credits_pending"), rb_tb_unpack_u128(&item->credits_pending));
         rb_ivar_set(obj, rb_intern("@credits_posted"), rb_tb_unpack_u128(&item->credits_posted));
         rb_ivar_set(obj, rb_intern("@user_data_128"), rb_tb_unpack_u128(&item->user_data_128));
-        rb_ivar_set(obj, rb_intern("@user_data_64"), ULL2NUM(item->user_data_64));
-        rb_ivar_set(obj, rb_intern("@user_data_32"), UINT2NUM(item->user_data_32));
+        rb_ivar_set(obj, rb_intern("@user_data_64"), RB_ULL2NUM(item->user_data_64));
+        rb_ivar_set(obj, rb_intern("@user_data_32"), RB_UINT2NUM(item->user_data_32));
         tb_assert(item->reserved == 0);
-        rb_ivar_set(obj, rb_intern("@ledger"), UINT2NUM(item->ledger));
-        rb_ivar_set(obj, rb_intern("@code"), UINT2NUM(item->code));
-        rb_ivar_set(obj, rb_intern("@flags"), UINT2NUM(item->flags));
-        rb_ivar_set(obj, rb_intern("@timestamp"), ULL2NUM(item->timestamp));
+        rb_ivar_set(obj, rb_intern("@ledger"), RB_UINT2NUM(item->ledger));
+        rb_ivar_set(obj, rb_intern("@code"), RB_UINT2NUM(item->code));
+        rb_ivar_set(obj, rb_intern("@flags"), RB_UINT2NUM(item->flags));
+        rb_ivar_set(obj, rb_intern("@timestamp"), RB_ULL2NUM(item->timestamp));
         rb_ary_push(results, obj);
     }
     return results;
@@ -247,15 +456,15 @@ static void rb_tb_serialize_query_transfers(VALUE items_rb, uint8_t *buf, long c
         VALUE item_rb = RARRAY_AREF(items_rb, i);
         tb_query_filter_t *item = &items[i];
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@user_data_128")), &item->user_data_128);
-        item->user_data_64 = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
-        item->user_data_32 = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
-        item->ledger = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@ledger")));
-        item->code = (uint16_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@code")));
+        item->user_data_64 = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
+        item->user_data_32 = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
+        item->ledger = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@ledger")));
+        item->code = RB_NUM2USHORT(rb_ivar_get(item_rb, rb_intern("@code")));
         memset(item->reserved, 0, sizeof(item->reserved));
-        item->timestamp_min = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_min")));
-        item->timestamp_max = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_max")));
-        item->limit = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@limit")));
-        item->flags = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
+        item->timestamp_min = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_min")));
+        item->timestamp_max = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp_max")));
+        item->limit = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@limit")));
+        item->flags = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
     }
 }
 
@@ -274,13 +483,13 @@ static VALUE rb_tb_deserialize_query_transfers(const uint8_t *buf, uint32_t buf_
         rb_ivar_set(obj, rb_intern("@amount"), rb_tb_unpack_u128(&item->amount));
         rb_ivar_set(obj, rb_intern("@pending_id"), rb_tb_unpack_u128(&item->pending_id));
         rb_ivar_set(obj, rb_intern("@user_data_128"), rb_tb_unpack_u128(&item->user_data_128));
-        rb_ivar_set(obj, rb_intern("@user_data_64"), ULL2NUM(item->user_data_64));
-        rb_ivar_set(obj, rb_intern("@user_data_32"), UINT2NUM(item->user_data_32));
-        rb_ivar_set(obj, rb_intern("@timeout"), UINT2NUM(item->timeout));
-        rb_ivar_set(obj, rb_intern("@ledger"), UINT2NUM(item->ledger));
-        rb_ivar_set(obj, rb_intern("@code"), UINT2NUM(item->code));
-        rb_ivar_set(obj, rb_intern("@flags"), UINT2NUM(item->flags));
-        rb_ivar_set(obj, rb_intern("@timestamp"), ULL2NUM(item->timestamp));
+        rb_ivar_set(obj, rb_intern("@user_data_64"), RB_ULL2NUM(item->user_data_64));
+        rb_ivar_set(obj, rb_intern("@user_data_32"), RB_UINT2NUM(item->user_data_32));
+        rb_ivar_set(obj, rb_intern("@timeout"), RB_UINT2NUM(item->timeout));
+        rb_ivar_set(obj, rb_intern("@ledger"), RB_UINT2NUM(item->ledger));
+        rb_ivar_set(obj, rb_intern("@code"), RB_UINT2NUM(item->code));
+        rb_ivar_set(obj, rb_intern("@flags"), RB_UINT2NUM(item->flags));
+        rb_ivar_set(obj, rb_intern("@timestamp"), RB_ULL2NUM(item->timestamp));
         rb_ary_push(results, obj);
     }
     return results;
@@ -297,13 +506,13 @@ static void rb_tb_serialize_create_accounts(VALUE items_rb, uint8_t *buf, long c
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@credits_pending")), &item->credits_pending);
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@credits_posted")), &item->credits_posted);
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@user_data_128")), &item->user_data_128);
-        item->user_data_64 = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
-        item->user_data_32 = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
+        item->user_data_64 = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
+        item->user_data_32 = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
         item->reserved = 0;
-        item->ledger = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@ledger")));
-        item->code = (uint16_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@code")));
-        item->flags = (uint16_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
-        item->timestamp = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp")));
+        item->ledger = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@ledger")));
+        item->code = RB_NUM2USHORT(rb_ivar_get(item_rb, rb_intern("@code")));
+        item->flags = RB_NUM2USHORT(rb_ivar_get(item_rb, rb_intern("@flags")));
+        item->timestamp = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp")));
     }
 }
 
@@ -316,8 +525,13 @@ static VALUE rb_tb_deserialize_create_accounts(const uint8_t *buf, uint32_t buf_
     for (long i = 0; i < count; i++) {
         const tb_create_account_result_t *item = &items[i];
         VALUE obj = rb_obj_alloc(klass);
-        rb_ivar_set(obj, rb_intern("@timestamp"), ULL2NUM(item->timestamp));
-        rb_ivar_set(obj, rb_intern("@status"), UINT2NUM(item->status));
+        rb_ivar_set(obj, rb_intern("@timestamp"), RB_ULL2NUM(item->timestamp));
+        rb_ivar_set(obj, rb_intern("@status"), RB_UINT2NUM(item->status));
+        rb_ivar_set(
+            obj,
+            rb_intern("@status_name"),
+            rb_tb_create_accounts_status_name(item->status)
+        );
         tb_assert(item->reserved == 0);
         rb_ary_push(results, obj);
     }
@@ -335,13 +549,13 @@ static void rb_tb_serialize_create_transfers(VALUE items_rb, uint8_t *buf, long
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@amount")), &item->amount);
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@pending_id")), &item->pending_id);
         rb_tb_pack_u128(rb_ivar_get(item_rb, rb_intern("@user_data_128")), &item->user_data_128);
-        item->user_data_64 = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
-        item->user_data_32 = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
-        item->timeout = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@timeout")));
-        item->ledger = (uint32_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@ledger")));
-        item->code = (uint16_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@code")));
-        item->flags = (uint16_t)NUM2UINT(rb_ivar_get(item_rb, rb_intern("@flags")));
-        item->timestamp = NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp")));
+        item->user_data_64 = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@user_data_64")));
+        item->user_data_32 = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@user_data_32")));
+        item->timeout = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@timeout")));
+        item->ledger = RB_NUM2UINT(rb_ivar_get(item_rb, rb_intern("@ledger")));
+        item->code = RB_NUM2USHORT(rb_ivar_get(item_rb, rb_intern("@code")));
+        item->flags = RB_NUM2USHORT(rb_ivar_get(item_rb, rb_intern("@flags")));
+        item->timestamp = RB_NUM2ULL(rb_ivar_get(item_rb, rb_intern("@timestamp")));
     }
 }
 
@@ -354,8 +568,13 @@ static VALUE rb_tb_deserialize_create_transfers(const uint8_t *buf, uint32_t buf
     for (long i = 0; i < count; i++) {
         const tb_create_transfer_result_t *item = &items[i];
         VALUE obj = rb_obj_alloc(klass);
-        rb_ivar_set(obj, rb_intern("@timestamp"), ULL2NUM(item->timestamp));
-        rb_ivar_set(obj, rb_intern("@status"), UINT2NUM(item->status));
+        rb_ivar_set(obj, rb_intern("@timestamp"), RB_ULL2NUM(item->timestamp));
+        rb_ivar_set(obj, rb_intern("@status"), RB_UINT2NUM(item->status));
+        rb_ivar_set(
+            obj,
+            rb_intern("@status_name"),
+            rb_tb_create_transfers_status_name(item->status)
+        );
         tb_assert(item->reserved == 0);
         rb_ary_push(results, obj);
     }

data/src/ext/tigerbeetle/tigerbeetle.c

@@ -101,7 +101,7 @@ static VALUE rb_tb_request_result(VALUE self) {
         }
     }
 
-    return rb_ary_new_from_args(2, UINT2NUM(req->status), result);
+    return rb_ary_new_from_args(2, RB_UINT2NUM(req->status), result);
 }
 
 static void rb_tb_write_completion(int fd, rb_tb_request_t *req) {
@@ -182,12 +182,12 @@ static VALUE rb_tb_client_initialize(
     TypedData_Get_Struct(self, tb_client_t, &rb_tb_client_type, client);
 
     uint8_t cluster_id_bytes[16] = {0};
-    rb_integer_pack(cluster_id_rb, cluster_id_bytes, 16, 1, 0, INTEGER_PACK_LITTLE_ENDIAN);
+    rb_tb_pack_u128(cluster_id_rb, cluster_id_bytes);
 
     const char *addr = StringValueCStr(addresses_rb);
     uint32_t addr_len = (uint32_t)RSTRING_LEN(addresses_rb);
 
-    int completion_fd = NUM2INT(completion_fd_rb);
+    int completion_fd = RB_NUM2INT(completion_fd_rb);
 
     TB_INIT_STATUS status = tb_client_init(
         client, cluster_id_bytes, addr, addr_len, (uintptr_t)completion_fd, rb_tb_on_completion
@@ -232,7 +232,7 @@ static VALUE rb_tb_client_submit(VALUE self, VALUE operation_rb, VALUE items_rb)
     tb_client_t *client;
     TypedData_Get_Struct(self, tb_client_t, &rb_tb_client_type, client);
 
-    TB_OPERATION operation = (TB_OPERATION)NUM2INT(operation_rb);
+    TB_OPERATION operation = (TB_OPERATION)RB_NUM2INT(operation_rb);
     long count = RARRAY_LEN(items_rb);
 
     rb_tb_request_t *req = malloc(sizeof(rb_tb_request_t));
@@ -290,12 +290,12 @@ static VALUE rb_tb_client_submit(VALUE self, VALUE operation_rb, VALUE items_rb)
 static VALUE rb_tb_request_id(VALUE self) {
     rb_tb_request_t *req;
     TypedData_Get_Struct(self, rb_tb_request_t, &rb_tb_request_type, req);
-    return ULL2NUM((unsigned long long)(uintptr_t)req);
+    return RB_ULL2NUM((unsigned long long)(uintptr_t)req);
 }
 
 static void rb_tb_init_native_client(VALUE mTigerBeetle) {
-    rb_define_const(mTigerBeetle, "PACKET_OK", INT2NUM(TB_PACKET_OK));
-    rb_define_const(mTigerBeetle, "PACKET_CLIENT_SHUTDOWN", INT2NUM(TB_PACKET_CLIENT_SHUTDOWN));
+    rb_define_const(mTigerBeetle, "PACKET_OK", RB_INT2NUM(TB_PACKET_OK));
+    rb_define_const(mTigerBeetle, "PACKET_CLIENT_SHUTDOWN", RB_INT2NUM(TB_PACKET_CLIENT_SHUTDOWN));
 
     VALUE cNativeClient = rb_define_class_under(mTigerBeetle, "NativeClient", rb_cObject);
     rb_define_alloc_func(cNativeClient, rb_tb_client_alloc);

data/src/tigerbeetle/bindings.rb

@@ -327,21 +327,29 @@ module TigerBeetle
   class CreateAccountResult
     attr_reader :timestamp
     attr_reader :status
+    attr_reader :status_name
 
     def initialize
       @timestamp = 0
       @status = 0
     end
+
+    def to_s =
+      "#<#{self.class} timestamp=#{@timestamp} status_name=#{@status_name}>"
   end
 
   class CreateTransferResult
     attr_reader :timestamp
     attr_reader :status
+    attr_reader :status_name
 
     def initialize
       @timestamp = 0
       @status = 0
     end
+
+    def to_s =
+      "#<#{self.class} timestamp=#{@timestamp} status_name=#{@status_name}>"
   end
 
 end

data/src/tigerbeetle/version.rb

@@ -1,3 +1,3 @@
 module TigerBeetle
-  VERSION = "0.17.8"
+  VERSION = "0.17.9"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tigerbeetle
 version: !ruby/object:Gem::Version
-  version: 0.17.8
+  version: 0.17.9
 platform: ruby
 authors:
 - TigerBeetle, Inc