mixin_bot 2.2.0 → 2.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2bbc251caedc50e5324a90713c291cf019b2bf0fa003a7ad4df3401af5b175fa
-  data.tar.gz: cb7e858d5073bb2fc8bd5e487027fc10a684b8ff05dbc2949aa48270808e1f0a
+  metadata.gz: 5a607209836b8c47fbcff727229f7ab93940f9b1dc5a99d4ab307345ffa952a0
+  data.tar.gz: aae920ac21d384f0a978b7e4a07e20df5c55cc6016cd7fbce1fa5231c638b742
 SHA512:
-  metadata.gz: 758781312e8be1e922eee338ed4ddfd3154c44ea25fb1d7e2b67d9e3ea8298381e4cc4d6df33904c35b831545d136da14c4af1630fdabe7789d3761a1617d6d9
-  data.tar.gz: a5350e9812115ef75e39a906e6fb48aa55189692887ee037c0dc3f29cf67b00e70b912575fbe5b9d1f44d93be29c520c2a3142804671c1bcfd3bc96dcfee6b9a
+  metadata.gz: 46937ef32ab9ada8e3218c682fbe36a4086f7688ed5cf21ed5ad5aab575f9e8d8fe65c45220748021194500b486a538a06ddaa4d653af6762d65744c0bff51f8
+  data.tar.gz: 4a6d552a0fc8476105cf553b79ab1f2c231db95acc4cedec9131cc805758c1a68fd9845bc819f5396a42c297b3caf20f119a57e9cd066ab37d7f1cb7de04edb5

data/AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md — MixinBot
 
-Ruby gem (v2.2.0): Mixin Network REST SDK + `mixinbot` CLI. Parity targets: [bot-api-go-client](https://github.com/MixinNetwork/bot-api-go-client), [bot-api-nodejs-client](https://github.com/MixinNetwork/bot-api-nodejs-client).
+Ruby gem (v2.2.1): Mixin Network REST SDK + `mixinbot` CLI. Parity targets: [bot-api-go-client](https://github.com/MixinNetwork/bot-api-go-client), [bot-api-nodejs-client](https://github.com/MixinNetwork/bot-api-nodejs-client).
 
 ## Commands
 

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.2] - 2026-05-24
+
+### Fixed
+
+- **Safe transfer raw encoding** — version 5 transactions now always encode and decode the references count (including `0000` when empty), matching the Mixin kernel and official Go/TS SDKs. Fixes `/safe/transaction/requests` rejection after the v2 transaction encoder refactor.
+
+## [2.2.1] - 2026-05-24
+
+### Changed
+
+- **Billing preflight `increment`** — `ensure_app_billing_credit!` accepts an `increment` parameter (default `0`) instead of reading `app_properties.price`. `create_user` / `create_safe_user` default to `0.5` per billed user; pass `increment: 0` for free-tier headroom.
+
 ## [2.2.0] - 2026-05-24
 
 ### Added

data/README.md

@@ -6,7 +6,7 @@ Ruby SDK and CLI for [Mixin Network](https://developers.mixin.one/docs): authent
 
 The gem aims for **parity with the official [bot-api-go-client](https://github.com/MixinNetwork/bot-api-go-client)** Go SDK and **[bot-api-nodejs-client](https://github.com/MixinNetwork/bot-api-nodejs-client)** Node SDK. See [API_COVERAGE.md](API_COVERAGE.md) for the full mapping; run `rake mixin_bot:api_coverage` to confirm no gaps are marked missing.
 
-Current gem version: **2.2.0** (see [CHANGELOG.md](CHANGELOG.md) for breaking changes and deprecations).
+Current gem version: **2.2.1** (see [CHANGELOG.md](CHANGELOG.md) for breaking changes and deprecations).
 
 ## Requirements
 

data/lib/mixin_bot/api/app.rb

@@ -29,21 +29,22 @@ module MixinBot
       # creating a network user). Skipped when +force+ is true.
       #
       # @param force [Boolean] skip the preflight and call the API anyway
+      # @param increment [Numeric, String] estimated cost added to total billing
+      #   cost for headroom (default +0+)
       # @raise [InsufficientAppBillingError] when +credit+ is not greater than
-      #   total cost plus the next user fee from {app_properties}
+      #   total cost plus +increment+
       #
-      def ensure_app_billing_credit!(force: false, access_token: nil)
+      def ensure_app_billing_credit!(force: false, access_token: nil, increment: 0)
         return if force
 
         app_id = config.app_id
         billing = app_billing(app_id, access_token:)['data']
-        properties = app_properties(access_token:)['data']
 
         credit = billing_decimal billing['credit']
         cost_users = billing_decimal billing.dig('cost', 'users')
         cost_resources = billing_decimal billing.dig('cost', 'resources')
         cost = cost_users + cost_resources
-        increment = billing_decimal properties['price']
+        increment = billing_decimal increment
 
         return if credit > cost + increment
 

data/lib/mixin_bot/api/user.rb

@@ -23,6 +23,10 @@ module MixinBot
       # the new TIP PIN has time to propagate on the server side.
       TIP_PIN_PROPAGATION_DELAY = 1
 
+      # Billed cost per network user created via {#create_user} (USD), after
+      # the free tier. Pass +increment: 0+ to skip headroom for the new user.
+      CREATE_USER_BILLING_INCREMENT = '0.5'
+
       def user(user_id, access_token: nil)
         path = format('/users/%<user_id>s', user_id:)
         client.get path, access_token:
@@ -39,11 +43,13 @@ module MixinBot
       # @param key [String, nil] optional 32-byte Ed25519 seed
       # @param force [Boolean] when false (default), verify app billing credit
       #   headroom before calling the API; when true, skip the preflight
+      # @param increment [Numeric, String] billing headroom for the new user
+      #   (defaults to {CREATE_USER_BILLING_INCREMENT}; use +0+ on free tier)
       # @return [Hash] Mixin response merged with the hex-encoded private key
       # @raise [InsufficientAppBillingError] when billing credit lacks headroom
       #
-      def create_user(full_name, key: nil, force: false)
-        ensure_app_billing_credit!(force:)
+      def create_user(full_name, key: nil, force: false, increment: CREATE_USER_BILLING_INCREMENT)
+        ensure_app_billing_credit!(force:, increment:)
 
         keypair = JOSE::JWA::Ed25519.keypair key
         session_secret = Base64.urlsafe_encode64 keypair[0], padding: false
@@ -92,6 +98,7 @@ module MixinBot
       # @param spend_key [String, nil] optional 32-byte spend Ed25519 seed
       # @param force [Boolean] forwarded to {#create_user}; see billing preflight
       #   there
+      # @param increment [Numeric, String] forwarded to {#create_user}
       # @return [Hash] keystore with +:app_id+, +:session_id+,
       #   +:session_private_key+, +:server_public_key+ and +:spend_key+
       # @raise [MixinBot::Error] when registration ultimately fails. Transient
@@ -100,13 +107,13 @@ module MixinBot
       # @raise [InsufficientAppBillingError] when {#create_user} billing
       #   preflight fails
       #
-      def create_safe_user(name, private_key: nil, spend_key: nil, force: false)
+      def create_safe_user(name, private_key: nil, spend_key: nil, force: false, increment: CREATE_USER_BILLING_INCREMENT)
         session_keypair = JOSE::JWA::Ed25519.keypair private_key
         spend_keypair = JOSE::JWA::Ed25519.keypair spend_key
 
         spend_key_hex = spend_keypair[1].unpack1('H*')
 
-        user = create_user name, key: session_keypair[1][...32], force: force
+        user = create_user name, key: session_keypair[1][...32], force: force, increment: increment
         data = user.fetch('data')
 
         keystore = {

data/lib/mixin_bot/transaction/decoder.rb

@@ -26,7 +26,7 @@ module MixinBot
 
         decode_inputs
         decode_outputs
-        decode_references if @tx.version >= Transaction::REFERENCES_TX_VERSION && @tx.references.present?
+        decode_references if @tx.version >= Transaction::REFERENCES_TX_VERSION
 
         extra_size = MixinBot.utils.decode_uint32 @buf.shift(4)
         @tx.extra = @buf.shift(extra_size).pack('C*')

data/lib/mixin_bot/transaction/encoder.rb

@@ -23,7 +23,7 @@ module MixinBot
 
         bytes += encode_inputs
         bytes += encode_outputs
-        bytes += encode_references if @tx.version >= Transaction::REFERENCES_TX_VERSION && @tx.references.present?
+        bytes += encode_references if @tx.version >= Transaction::REFERENCES_TX_VERSION
 
         extra_bytes = @tx.extra.bytes
         raise InvalidTransactionFormatError, 'extra is too long' if extra_bytes.size > Transaction::MAX_EXTRA_SIZE
@@ -173,9 +173,10 @@ module MixinBot
       def encode_references
         bytes = []
 
-        bytes += MixinBot.utils.encode_uint16 @tx.references.size
+        references = Array(@tx.references)
+        bytes += MixinBot.utils.encode_uint16 references.size
 
-        @tx.references.each do |reference|
+        references.each do |reference|
           bytes += [reference].pack('H*').bytes
         end
 

data/lib/mixin_bot/version.rb

@@ -11,5 +11,5 @@ module MixinBot
   #
   # @see https://semver.org/
   #
-  VERSION = '2.2.0'
+  VERSION = '2.2.2'
 end

data/llms.txt

@@ -1,6 +1,6 @@
 # MixinBot
 
-> Ruby SDK and CLI for Mixin Network: Safe UTXO transfers, REST API, Blaze messaging, transaction crypto, optional MVM helpers. Ruby >= 3.2. Gem version 2.2.0.
+> Ruby SDK and CLI for Mixin Network: Safe UTXO transfers, REST API, Blaze messaging, transaction crypto, optional MVM helpers. Ruby >= 3.2. Gem version 2.2.1.
 
 Important notes:
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mixin_bot
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.2
 platform: ruby
 authors:
 - an-lee
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-23 00:00:00.000000000 Z
+date: 2026-05-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport