lithic-com · stainless-app · Aug 3, 2026 · Aug 4, 2026 · Aug 5, 2026 · Aug 7, 2026
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.19.0"
+  ".": "0.20.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 214
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-59c09c7355b21b663e001d2ee1086ebd0a70d9b5433823282bca296eedff9eb0.yml
-openapi_spec_hash: d9c3b932c810809abc6e973d662ad376
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-fded34f73c5a63b9a5796a375e1dd8864051c14a1bd0123c8084554ffb2889bb.yml
+openapi_spec_hash: 4b64ebb958ea2ef8e7e20f564a5f30ed
 config_hash: 337a99d8cc30006358b7bc2531401669
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.20.0 (2026-08-11)
+
+Full Changelog: [v0.19.0...v0.20.0](https://github.com/lithic-com/lithic-ruby/compare/v0.19.0...v0.20.0)
+
+### Features
+
+* **api:** add blockchain_addresses field to FinancialAccount model ([c46e82c](https://github.com/lithic-com/lithic-ruby/commit/c46e82cc5bf4560c31adc1ebd6e991b55a1c3f2d))
+* **api:** add limit_cash_amount and limit_cash_count to velocity limit params ([4e4dfb7](https://github.com/lithic-com/lithic-ruby/commit/4e4dfb78069500939027ed67d445d63160cd9e1c))
+* **api:** add PROGRAM scope to auth rules, FINANCIAL_ACCOUNT/PROGRAM to case_entity ([1520693](https://github.com/lithic-com/lithic-ruby/commit/15206930f871b13afd3852083c6bf778a83e6eb9))
+* **api:** add STABLECOIN enum value to payment type ([5151e5d](https://github.com/lithic-com/lithic-ruby/commit/5151e5d6276054b59f41d32af07efae6badabcbb))
+* **api:** add stablecoin event types to payment/financial_event/statement_line_items ([2f1fbca](https://github.com/lithic-com/lithic-ruby/commit/2f1fbca332e111e3624d834a774db3f7d979f4a4))
+
+
+### Documentation
+
+* **api:** update cvv field documentation in Card and tokenization ([b520213](https://github.com/lithic-com/lithic-ruby/commit/b520213ceec3af853f96b5ca9e8ef32a34169a0a))
+
 ## 0.19.0 (2026-07-30)
 
 Full Changelog: [v0.18.1...v0.19.0](https://github.com/lithic-com/lithic-ruby/compare/v0.18.1...v0.19.0)

diff --git a/Gemfile.lock b/Gemfile.lock
@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    lithic (0.19.0)
+    lithic (0.20.0)
       cgi
       connection_pool
 

diff --git a/README.md b/README.md
@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "lithic", "~> 0.19.0"
+gem "lithic", "~> 0.20.0"
 ```
 
 <!-- x-release-please-end -->

diff --git a/lib/lithic/models/auth_rules/ach_payment_update_action.rb b/lib/lithic/models/auth_rules/ach_payment_update_action.rb
@@ -82,6 +82,7 @@ module Scope
             extend Lithic::Internal::Type::Enum
 
             FINANCIAL_ACCOUNT = :FINANCIAL_ACCOUNT
+            PROGRAM = :PROGRAM
 
             # @!method self.values
             #   @return [Array<Symbol>]

diff --git a/lib/lithic/models/auth_rules/card_transaction_update_action.rb b/lib/lithic/models/auth_rules/card_transaction_update_action.rb
@@ -83,6 +83,7 @@ module Scope
 
             CARD = :CARD
             ACCOUNT = :ACCOUNT
+            PROGRAM = :PROGRAM
 
             # @!method self.values
             #   @return [Array<Symbol>]

diff --git a/lib/lithic/models/auth_rules/v2_list_results_response.rb b/lib/lithic/models/auth_rules/v2_list_results_response.rb
@@ -1059,6 +1059,7 @@ module Scope
 
                 CARD = :CARD
                 ACCOUNT = :ACCOUNT
+                PROGRAM = :PROGRAM
 
                 # @!method self.values
                 #   @return [Array<Symbol>]
@@ -1269,6 +1270,7 @@ module Scope
                 extend Lithic::Internal::Type::Enum
 
                 FINANCIAL_ACCOUNT = :FINANCIAL_ACCOUNT
+                PROGRAM = :PROGRAM
 
                 # @!method self.values
                 #   @return [Array<Symbol>]

diff --git a/lib/lithic/models/auth_rules/velocity_limit_params.rb b/lib/lithic/models/auth_rules/velocity_limit_params.rb
@@ -29,6 +29,25 @@ class VelocityLimitParams < Lithic::Internal::Type::BaseModel
         #   @return [Integer, nil]
         optional :limit_amount, Integer, nil?: true
 
+        # @!attribute limit_cash_amount
+        #   The maximum amount of cash spend velocity allowed in the period in minor units
+        #   (the smallest unit of a currency, e.g. cents for USD). Cash spend covers ATM
+        #   withdrawals, cash disbursements, and purchases with cashback. Transactions
+        #   exceeding this limit will be declined.
+        #
+        #   @return [Integer, nil]
+        optional :limit_cash_amount, Integer, nil?: true
+
+        # @!attribute limit_cash_count
+        #   The number of cash spend velocity impacting transactions may not exceed this
+        #   limit in the period. Transactions exceeding this limit will be declined. A cash
+        #   velocity impacting transaction is an ATM withdrawal, cash disbursement, or
+        #   purchase with cashback that has been authorized, and optionally settled, or a
+        #   force post (a transaction that settled without prior authorization).
+        #
+        #   @return [Integer, nil]
+        optional :limit_cash_count, Integer, nil?: true
+
         # @!attribute limit_count
         #   The number of spend velocity impacting transactions may not exceed this limit in
         #   the period. Transactions exceeding this limit will be declined. A spend velocity
@@ -39,7 +58,7 @@ class VelocityLimitParams < Lithic::Internal::Type::BaseModel
         #   @return [Integer, nil]
         optional :limit_count, Integer, nil?: true
 
-        # @!method initialize(period:, scope:, filters: nil, limit_amount: nil, limit_count: nil)
+        # @!method initialize(period:, scope:, filters: nil, limit_amount: nil, limit_cash_amount: nil, limit_cash_count: nil, limit_count: nil)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::AuthRules::VelocityLimitParams} for more details.
         #
@@ -51,6 +70,10 @@ class VelocityLimitParams < Lithic::Internal::Type::BaseModel
         #
         #   @param limit_amount [Integer, nil] The maximum amount of spend velocity allowed in the period in minor units (the s
         #
+        #   @param limit_cash_amount [Integer, nil] The maximum amount of cash spend velocity allowed in the period in minor units (
+        #
+        #   @param limit_cash_count [Integer, nil] The number of cash spend velocity impacting transactions may not exceed this lim
+        #
         #   @param limit_count [Integer, nil] The number of spend velocity impacting transactions may not exceed this limit in
 
         # The scope the velocity is calculated for

diff --git a/lib/lithic/models/card.rb b/lib/lithic/models/card.rb
@@ -5,7 +5,7 @@ module Models
     # @see Lithic::Resources::Cards#create
     class Card < Lithic::Models::NonPCICard
       # @!attribute cvv
-      #   Three digit cvv printed on the back of the card.
+      #   Three or four digit CVV printed on the card. Amex cards use four digit CVVs
       #
       #   @return [String, nil]
       optional :cvv, String
@@ -24,7 +24,7 @@ class Card < Lithic::Models::NonPCICard
       #
       #   Card details with potentially PCI sensitive information for Enterprise customers
       #
-      #   @param cvv [String] Three digit cvv printed on the back of the card.
+      #   @param cvv [String] Three or four digit CVV printed on the card. Amex cards use four digit CVVs
       #
       #   @param pan [String] Primary Account Number (PAN) (i.e. the card number). Customers must be PCI compl
     end

diff --git a/lib/lithic/models/financial_account.rb b/lib/lithic/models/financial_account.rb
@@ -69,12 +69,23 @@ class FinancialAccount < Lithic::Internal::Type::BaseModel
       #   @return [String, nil]
       optional :account_number, String, nil?: true
 
+      # @!attribute blockchain_addresses
+      #   Provisioned blockchain deposit addresses for this financial account, keyed by
+      #   the full name of the blockchain network that each address belongs to (e.g.
+      #   `ETHEREUM`)
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :blockchain_addresses, Lithic::Internal::Type::HashOf[String], nil?: true
+
       # @!attribute routing_number
       #
       #   @return [String, nil]
       optional :routing_number, String, nil?: true
 
-      # @!method initialize(token:, account_token:, created:, credit_configuration:, is_for_benefit_of:, nickname:, status:, substatus:, type:, updated:, user_defined_status:, account_number: nil, routing_number: nil)
+      # @!method initialize(token:, account_token:, created:, credit_configuration:, is_for_benefit_of:, nickname:, status:, substatus:, type:, updated:, user_defined_status:, account_number: nil, blockchain_addresses: nil, routing_number: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::FinancialAccount} for more details.
+      #
       #   @param token [String] Globally unique identifier for the account
       #
       #   @param account_token [String, nil]
@@ -99,6 +110,8 @@ class FinancialAccount < Lithic::Internal::Type::BaseModel
       #
       #   @param account_number [String, nil]
       #
+      #   @param blockchain_addresses [Hash{Symbol=>String}, nil] Provisioned blockchain deposit addresses for this financial account, keyed by th
+      #
       #   @param routing_number [String, nil]
 
       # @see Lithic::Models::FinancialAccount#credit_configuration

diff --git a/lib/lithic/models/financial_accounts/statements/statement_line_items.rb b/lib/lithic/models/financial_accounts/statements/statement_line_items.rb
@@ -272,8 +272,11 @@ module EventType
               MONTHLY_REVERSAL = :MONTHLY_REVERSAL
               ACCOUNT_TO_ACCOUNT = :ACCOUNT_TO_ACCOUNT
               STABLECOIN_RECEIVED = :STABLECOIN_RECEIVED
+              STABLECOIN_INITIATED = :STABLECOIN_INITIATED
               STABLECOIN_REVIEWED = :STABLECOIN_REVIEWED
+              STABLECOIN_SENT = :STABLECOIN_SENT
               STABLECOIN_SETTLED = :STABLECOIN_SETTLED
+              STABLECOIN_REJECTED = :STABLECOIN_REJECTED
 
               # @!method self.values
               #   @return [Array<Symbol>]

diff --git a/lib/lithic/models/financial_event.rb b/lib/lithic/models/financial_event.rb
@@ -159,8 +159,11 @@ module Type
         MONTHLY_REVERSAL = :MONTHLY_REVERSAL
         ACCOUNT_TO_ACCOUNT = :ACCOUNT_TO_ACCOUNT
         STABLECOIN_RECEIVED = :STABLECOIN_RECEIVED
+        STABLECOIN_INITIATED = :STABLECOIN_INITIATED
         STABLECOIN_REVIEWED = :STABLECOIN_REVIEWED
+        STABLECOIN_SENT = :STABLECOIN_SENT
         STABLECOIN_SETTLED = :STABLECOIN_SETTLED
+        STABLECOIN_REJECTED = :STABLECOIN_REJECTED
 
         # @!method self.values
         #   @return [Array<Symbol>]

diff --git a/lib/lithic/models/payment.rb b/lib/lithic/models/payment.rb
@@ -327,8 +327,16 @@ class Event < Lithic::Internal::Type::BaseModel
         #
         #   - `STABLECOIN_RECEIVED` - Stablecoin pay-in received on-chain and pending
         #     release to available balance.
-        #   - `STABLECOIN_REVIEWED` - Stablecoin pay-in has completed the review process.
-        #   - `STABLECOIN_SETTLED` - Stablecoin pay-in funds released to available balance.
+        #   - `STABLECOIN_INITIATED` - Stablecoin withdrawal initiated, with the funds
+        #     placed on hold.
+        #   - `STABLECOIN_REVIEWED` - Stablecoin pay-in or withdrawal has completed the
+        #     review process.
+        #   - `STABLECOIN_SENT` - Stablecoin withdrawal accepted for on-chain submission to
+        #     the destination address, and pending confirmation.
+        #   - `STABLECOIN_SETTLED` - Stablecoin pay-in funds released to available balance,
+        #     or stablecoin withdrawal confirmed on-chain.
+        #   - `STABLECOIN_REJECTED` - Stablecoin withdrawal failed and the hold placed at
+        #     initiation has been reversed.
         #
         #   @return [Symbol, Lithic::Models::Payment::Event::Type]
         required :type, enum: -> { Lithic::Payment::Event::Type }
@@ -343,7 +351,9 @@ class Event < Lithic::Internal::Type::BaseModel
         # @!attribute external_id
         #   Payment event external ID. For ACH transactions, this is the ACH trace number.
         #   For inbound wire transfers, this is the IMAD (Input Message Accountability
-        #   Data).
+        #   Data). For stablecoin payments, this is the on-chain transaction hash of the
+        #   transfer; it is present on events that reflect on-chain activity and null on
+        #   internal lifecycle events.
         #
         #   @return [String, nil]
         optional :external_id, String, nil?: true
@@ -443,8 +453,16 @@ module Result
         #
         # - `STABLECOIN_RECEIVED` - Stablecoin pay-in received on-chain and pending
         #   release to available balance.
-        # - `STABLECOIN_REVIEWED` - Stablecoin pay-in has completed the review process.
-        # - `STABLECOIN_SETTLED` - Stablecoin pay-in funds released to available balance.
+        # - `STABLECOIN_INITIATED` - Stablecoin withdrawal initiated, with the funds
+        #   placed on hold.
+        # - `STABLECOIN_REVIEWED` - Stablecoin pay-in or withdrawal has completed the
+        #   review process.
+        # - `STABLECOIN_SENT` - Stablecoin withdrawal accepted for on-chain submission to
+        #   the destination address, and pending confirmation.
+        # - `STABLECOIN_SETTLED` - Stablecoin pay-in funds released to available balance,
+        #   or stablecoin withdrawal confirmed on-chain.
+        # - `STABLECOIN_REJECTED` - Stablecoin withdrawal failed and the hold placed at
+        #   initiation has been reversed.
         #
         # @see Lithic::Models::Payment::Event#type
         module Type
@@ -473,8 +491,11 @@ module Type
           WIRE_RETURN_OUTBOUND_SETTLED = :WIRE_RETURN_OUTBOUND_SETTLED
           WIRE_RETURN_OUTBOUND_REJECTED = :WIRE_RETURN_OUTBOUND_REJECTED
           STABLECOIN_RECEIVED = :STABLECOIN_RECEIVED
+          STABLECOIN_INITIATED = :STABLECOIN_INITIATED
           STABLECOIN_REVIEWED = :STABLECOIN_REVIEWED
+          STABLECOIN_SENT = :STABLECOIN_SENT
           STABLECOIN_SETTLED = :STABLECOIN_SETTLED
+          STABLECOIN_REJECTED = :STABLECOIN_REJECTED
 
           # @!method self.values
           #   @return [Array<Symbol>]
@@ -775,6 +796,7 @@ module Type
         WIRE_OUTBOUND_PAYMENT = :WIRE_OUTBOUND_PAYMENT
         WIRE_OUTBOUND_ADMIN = :WIRE_OUTBOUND_ADMIN
         WIRE_INBOUND_DRAWDOWN_REQUEST = :WIRE_INBOUND_DRAWDOWN_REQUEST
+        STABLECOIN = :STABLECOIN
 
         # @!method self.values
         #   @return [Array<Symbol>]

diff --git a/lib/lithic/models/tokenization_simulate_params.rb b/lib/lithic/models/tokenization_simulate_params.rb
@@ -8,7 +8,7 @@ class TokenizationSimulateParams < Lithic::Internal::Type::BaseModel
       include Lithic::Internal::Type::RequestParameters
 
       # @!attribute cvv
-      #   The three digit cvv for the card.
+      #   The three or four digit CVV for the card. AMEX cards use four digit CVVs.
       #
       #   @return [String]
       required :cvv, String
@@ -63,7 +63,7 @@ class TokenizationSimulateParams < Lithic::Internal::Type::BaseModel
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::TokenizationSimulateParams} for more details.
       #
-      #   @param cvv [String] The three digit cvv for the card.
+      #   @param cvv [String] The three or four digit CVV for the card. AMEX cards use four digit CVVs.
       #
       #   @param expiration_date [String] The expiration date of the card in 'MM/YY' format.
       #

diff --git a/lib/lithic/models/transaction_monitoring/case_entity.rb b/lib/lithic/models/transaction_monitoring/case_entity.rb
@@ -5,16 +5,21 @@ module Models
     module TransactionMonitoring
       class CaseEntity < Lithic::Internal::Type::BaseModel
         # @!attribute entity_token
-        #   Globally unique identifier for the associated entity
+        #   Globally unique identifier for the associated entity: the card token for `CARD`,
+        #   the account token for `ACCOUNT`, and the financial account token for
+        #   `FINANCIAL_ACCOUNT`. Null for `PROGRAM`, which is not scoped to an individual
+        #   entity
         #
-        #   @return [String]
-        required :entity_token, String
+        #   @return [String, nil]
+        required :entity_token, String, nil?: true
 
         # @!attribute entity_type
         #   The type of entity a case is associated with:
         #
         #   - `CARD` - The case is associated with a card
         #   - `ACCOUNT` - The case is associated with an account
+        #   - `FINANCIAL_ACCOUNT` - The case is associated with a financial account
+        #   - `PROGRAM` - The case is associated with the whole program
         #
         #   @return [Symbol, Lithic::Models::TransactionMonitoring::CaseEntity::EntityType]
         required :entity_type, enum: -> { Lithic::TransactionMonitoring::CaseEntity::EntityType }
@@ -25,21 +30,25 @@ class CaseEntity < Lithic::Internal::Type::BaseModel
         #
         #   The entity a case is associated with
         #
-        #   @param entity_token [String] Globally unique identifier for the associated entity
+        #   @param entity_token [String, nil] Globally unique identifier for the associated entity: the card token for `CARD`,
         #
         #   @param entity_type [Symbol, Lithic::Models::TransactionMonitoring::CaseEntity::EntityType] The type of entity a case is associated with:
 
         # The type of entity a case is associated with:
         #
         # - `CARD` - The case is associated with a card
         # - `ACCOUNT` - The case is associated with an account
+        # - `FINANCIAL_ACCOUNT` - The case is associated with a financial account
+        # - `PROGRAM` - The case is associated with the whole program
         #
         # @see Lithic::Models::TransactionMonitoring::CaseEntity#entity_type
         module EntityType
           extend Lithic::Internal::Type::Enum
 
           CARD = :CARD
           ACCOUNT = :ACCOUNT
+          FINANCIAL_ACCOUNT = :FINANCIAL_ACCOUNT
+          PROGRAM = :PROGRAM
 
           # @!method self.values
           #   @return [Array<Symbol>]

diff --git a/lib/lithic/models/transaction_monitoring/case_list_params.rb b/lib/lithic/models/transaction_monitoring/case_list_params.rb
@@ -49,7 +49,9 @@ class CaseListParams < Lithic::Internal::Type::BaseModel
         optional :ending_before, String
 
         # @!attribute entity_token
-        #   Only return cases associated with the provided entity.
+        #   Only return cases associated with the provided entity. Accepts a card, account,
+        #   or financial account token. Cases with a `PROGRAM` entity have no entity token
+        #   and are never returned by this filter.
         #
         #   @return [String, nil]
         optional :entity_token, String
@@ -113,7 +115,7 @@ class CaseListParams < Lithic::Internal::Type::BaseModel
         #
         #   @param ending_before [String] A cursor representing an item's token before which a page of results should end.
         #
-        #   @param entity_token [String] Only return cases associated with the provided entity.
+        #   @param entity_token [String] Only return cases associated with the provided entity. Accepts a card, account,
         #
         #   @param page_size [Integer] Page size (for pagination).
         #

diff --git a/lib/lithic/resources/tokenizations.rb b/lib/lithic/resources/tokenizations.rb
@@ -190,7 +190,7 @@ def resend_activation_code(tokenization_token, params = {})
       #
       # @overload simulate(cvv:, expiration_date:, pan:, tokenization_source:, account_score: nil, device_score: nil, entity: nil, wallet_recommended_decision: nil, request_options: {})
       #
-      # @param cvv [String] The three digit cvv for the card.
+      # @param cvv [String] The three or four digit CVV for the card. AMEX cards use four digit CVVs.
       #
       # @param expiration_date [String] The expiration date of the card in 'MM/YY' format.
       #

diff --git a/lib/lithic/resources/transaction_monitoring/cases.rb b/lib/lithic/resources/transaction_monitoring/cases.rb
@@ -92,7 +92,7 @@ def update(case_token, params = {})
         #
         # @param ending_before [String] A cursor representing an item's token before which a page of results should end.
         #
-        # @param entity_token [String] Only return cases associated with the provided entity.
+        # @param entity_token [String] Only return cases associated with the provided entity. Accepts a card, account,
         #
         # @param page_size [Integer] Page size (for pagination).
         #

diff --git a/lib/lithic/version.rb b/lib/lithic/version.rb
@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lithic
-  VERSION = "0.19.0"
+  VERSION = "0.20.0"
 end