mixin_bot 2.2.0 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2bbc251caedc50e5324a90713c291cf019b2bf0fa003a7ad4df3401af5b175fa
-  data.tar.gz: cb7e858d5073bb2fc8bd5e487027fc10a684b8ff05dbc2949aa48270808e1f0a
+  metadata.gz: ee9a02bff6da3b4331ff084e75d4f94d10d0a98b50e7b2c899679ec78340c659
+  data.tar.gz: 699c595d8f4acfd94041be582b0eda32db2ea4ba4da34359d1fc231d7e6bcbc2
 SHA512:
-  metadata.gz: 758781312e8be1e922eee338ed4ddfd3154c44ea25fb1d7e2b67d9e3ea8298381e4cc4d6df33904c35b831545d136da14c4af1630fdabe7789d3761a1617d6d9
-  data.tar.gz: a5350e9812115ef75e39a906e6fb48aa55189692887ee037c0dc3f29cf67b00e70b912575fbe5b9d1f44d93be29c520c2a3142804671c1bcfd3bc96dcfee6b9a
+  metadata.gz: ad0a66de09acfda9b1a4da94568ec4d704eab3be8f4eb92de145262bd0e74fc4b0efaee1243b16d5876199d270160c2fbd48aced6580af3308ab55117e156205
+  data.tar.gz: de638caf39c1af94cb169887f424d48127971f8bcd74c60a3f1b9e338b974c867001931e649244f16523e7d8efa501c6d81f0604c25f04a891cc7412550a45ed

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,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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/version.rb

@@ -11,5 +11,5 @@ module MixinBot
   #
   # @see https://semver.org/
   #
-  VERSION = '2.2.0'
+  VERSION = '2.2.1'
 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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mixin_bot
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.1
 platform: ruby
 authors:
 - an-lee