release: 0.146.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.145.0"
+  ".": "0.146.0"
 }

.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
-config_hash: 337a99d8cc30006358b7bc2531401669
+configured_endpoints: 215
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-113e179e6007c80abd835ff26bfdce4dd24beee5174678687431cb672ce06be8.yml
+openapi_spec_hash: 0f42308e15d062d48e3d4857c39ac749
+config_hash: f6d04d790aaddf639fc04b7f0092e7ec

CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.146.0 (2026-08-14)
+
+Full Changelog: [v0.145.0...v0.146.0](https://github.com/lithic-com/lithic-node/compare/v0.145.0...v0.146.0)
+
+### Features
+
+* **api:** add blockchain_addresses field to financial account responses ([4194b81](https://github.com/lithic-com/lithic-node/commit/4194b81f3cdcd7f58faa97b42884c79b86920390))
+* **api:** add blockchain_recipients resource with create method ([67a3827](https://github.com/lithic-com/lithic-node/commit/67a3827c8cfe4f618593da7e002956c4b1e73fc9))
+* **api:** add claim_token param/field and WRITE_OFF_REVERSED enum to disputesV2 ([fe4d256](https://github.com/lithic-com/lithic-node/commit/fe4d256c07f72241ae60acd99426e79fc78e3544))
+* **api:** Add limit_cash_amount and limit_cash_count to VelocityLimit template ([cde6d09](https://github.com/lithic-com/lithic-node/commit/cde6d09649b94b094eb269247eff71246ee4d75d))
+* **api:** add PROGRAM scope to auth rule actions, entity types to cases ([3a236e3](https://github.com/lithic-com/lithic-node/commit/3a236e32c9472ad5c63ed5575b34ea3019096549))
+* **api:** add stablecoin lifecycle enum values to line items/payments/financial events ([ccda791](https://github.com/lithic-com/lithic-node/commit/ccda7914b31a68bf500bfe5552be23ec47077d38))
+* **api:** add STABLECOIN payment method and attributes to payments ([4296eb4](https://github.com/lithic-com/lithic-node/commit/4296eb4ce0357acb8dd6cfa53956699abf1b7f9f))
+* **api:** add STABLECOIN payment method, nullable method_attributes to payments ([f80554d](https://github.com/lithic-com/lithic-node/commit/f80554dd99299edb60d123eadd478aecf934b78c))
+* **api:** add STABLECOIN payment type to payments ([a55164c](https://github.com/lithic-com/lithic-node/commit/a55164c2281183f8b3c99ae2c1114ab7bc7d104c))
+
+
+### Chores
+
+* **internal:** codegen related update ([0c3e1dc](https://github.com/lithic-com/lithic-node/commit/0c3e1dccbee1e2e84b0284751f5a6b2c90d2f89d))
+
+
+### Documentation
+
+* **api:** clarify CVV field descriptions for AMEX cards ([a636964](https://github.com/lithic-com/lithic-node/commit/a63696438e8968a9966b045ac49e2bff37ea45d7))
+
 ## 0.145.0 (2026-07-30)
 
 Full Changelog: [v0.144.0...v0.145.0](https://github.com/lithic-com/lithic-node/compare/v0.144.0...v0.145.0)

api.md

@@ -628,6 +628,16 @@ Methods:
 
 - <code title="post /v1/external_bank_accounts/{external_bank_account_token}/micro_deposits">client.externalBankAccounts.microDeposits.<a href="./src/resources/external-bank-accounts/micro-deposits.ts">create</a>(externalBankAccountToken, { ...params }) -> MicroDepositCreateResponse</code>
 
+# BlockchainRecipients
+
+Types:
+
+- <code><a href="./src/resources/blockchain-recipients.ts">BlockchainRecipient</a></code>
+
+Methods:
+
+- <code title="post /v1/blockchain_recipients">client.blockchainRecipients.<a href="./src/resources/blockchain-recipients.ts">create</a>({ ...params }) -> BlockchainRecipient</code>
+
 # Payments
 
 Types:

package.json

@@ -1,6 +1,6 @@
 {
   "name": "lithic",
-  "version": "0.145.0",
+  "version": "0.146.0",
   "description": "The official TypeScript library for the Lithic API",
   "author": "Lithic <sdk-feedback@lithic.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "lithic-mcp",
-  "version": "0.145.0",
+  "version": "0.146.0",
   "description": "The official MCP Server for the Lithic API",
   "author": {
     "name": "Lithic",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lithic-mcp",
-  "version": "0.145.0",
+  "version": "0.146.0",
   "description": "The official MCP Server for the Lithic API",
   "author": "Lithic <sdk-feedback@lithic.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/code-tool-worker.ts

@@ -267,6 +267,7 @@ const fuse = new Fuse(
     'client.externalBankAccounts.unpause',
     'client.externalBankAccounts.update',
     'client.externalBankAccounts.microDeposits.create',
+    'client.blockchainRecipients.create',
     'client.payments.create',
     'client.payments.list',
     'client.payments.retrieve',

packages/mcp-server/src/methods.ts

@@ -965,6 +965,12 @@ export const sdkMethods: SdkMethod[] = [
     httpMethod: 'post',
     httpPath: '/v1/external_bank_accounts/{external_bank_account_token}/micro_deposits',
   },
+  {
+    clientCallName: 'client.blockchainRecipients.create',
+    fullyQualifiedName: 'blockchainRecipients.create',
+    httpMethod: 'post',
+    httpPath: '/v1/blockchain_recipients',
+  },
   {
     clientCallName: 'client.payments.create',
     fullyQualifiedName: 'payments.create',

packages/mcp-server/src/server.ts

@@ -29,7 +29,7 @@ export const newMcpServer = async ({
   new McpServer(
     {
       name: 'lithic_api',
-      version: '0.145.0',
+      version: '0.146.0',
     },
     {
       instructions: await getInstructions({ stainlessApiKey, customInstructionsPath }),

src/client.ts

@@ -44,6 +44,11 @@ import {
 } from './resources/accounts';
 import { AuthStreamEnrollment, AuthStreamSecret } from './resources/auth-stream-enrollment';
 import { Balance, BalanceListParams, Balances, BalancesSinglePage } from './resources/balances';
+import {
+  BlockchainRecipient,
+  BlockchainRecipientCreateParams,
+  BlockchainRecipients,
+} from './resources/blockchain-recipients';
 import {
   BookTransferCreateParams,
   BookTransferListParams,
@@ -1184,6 +1189,7 @@ export class Lithic {
   transactions: API.Transactions = new API.Transactions(this);
   responderEndpoints: API.ResponderEndpoints = new API.ResponderEndpoints(this);
   externalBankAccounts: API.ExternalBankAccounts = new API.ExternalBankAccounts(this);
+  blockchainRecipients: API.BlockchainRecipients = new API.BlockchainRecipients(this);
   payments: API.Payments = new API.Payments(this);
   threeDS: API.ThreeDS = new API.ThreeDS(this);
   reports: API.Reports = new API.Reports(this);
@@ -1222,6 +1228,7 @@ Lithic.FinancialAccounts = FinancialAccounts;
 Lithic.Transactions = Transactions;
 Lithic.ResponderEndpoints = ResponderEndpoints;
 Lithic.ExternalBankAccounts = ExternalBankAccounts;
+Lithic.BlockchainRecipients = BlockchainRecipients;
 Lithic.Payments = Payments;
 Lithic.ThreeDS = ThreeDS;
 Lithic.Reports = Reports;
@@ -1465,6 +1472,12 @@ export declare namespace Lithic {
     type ExternalBankAccountSetVerificationMethodParams as ExternalBankAccountSetVerificationMethodParams,
   };
 
+  export {
+    BlockchainRecipients as BlockchainRecipients,
+    type BlockchainRecipient as BlockchainRecipient,
+    type BlockchainRecipientCreateParams as BlockchainRecipientCreateParams,
+  };
+
   export {
     Payments as Payments,
     type Payment as Payment,

src/resources/auth-rules/v2/v2.ts

@@ -183,7 +183,7 @@ export namespace ACHPaymentUpdateAction {
     /**
      * The scope of the case to create
      */
-    scope: 'FINANCIAL_ACCOUNT';
+    scope: 'FINANCIAL_ACCOUNT' | 'PROGRAM';
 
     /**
      * Create a case for the payment
@@ -538,7 +538,7 @@ export namespace CardTransactionUpdateAction {
     /**
      * The scope of the case to create
      */
-    scope: 'CARD' | 'ACCOUNT';
+    scope: 'CARD' | 'ACCOUNT' | 'PROGRAM';
 
     /**
      * Create a case for the transaction
@@ -2468,6 +2468,23 @@ export interface VelocityLimitParams {
    */
   limit_amount?: number | null;
 
+  /**
+   * 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.
+   */
+  limit_cash_amount?: number | null;
+
+  /**
+   * 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).
+   */
+  limit_cash_count?: number | null;
+
   /**
    * 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
@@ -3099,7 +3116,7 @@ export namespace V2ListResultsResponse {
       /**
        * The scope of the case to create
        */
-      scope: 'CARD' | 'ACCOUNT';
+      scope: 'CARD' | 'ACCOUNT' | 'PROGRAM';
 
       /**
        * Create a case for the transaction
@@ -3192,7 +3209,7 @@ export namespace V2ListResultsResponse {
       /**
        * The scope of the case to create
        */
-      scope: 'FINANCIAL_ACCOUNT';
+      scope: 'FINANCIAL_ACCOUNT' | 'PROGRAM';
 
       /**
        * Create a case for the payment

src/resources/blockchain-recipients.ts

@@ -0,0 +1,148 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as ExternalBankAccountsAPI from './external-bank-accounts/external-bank-accounts';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class BlockchainRecipients extends APIResource {
+  /**
+   * Register a blockchain address as a withdrawal destination for a financial
+   * account
+   *
+   * The recipient is created with a `PENDING` verification state and cannot receive
+   * a payout until screening of the address completes. Registering an address that
+   * is already registered to the same financial account returns the existing
+   * recipient and its current verification state, rather than creating a second one
+   *
+   * @example
+   * ```ts
+   * const blockchainRecipient =
+   *   await client.blockchainRecipients.create({
+   *     account_token: 'dabadb3b-700c-41e3-8801-d5dfc84ebea0',
+   *     address: '0x45bfcf1a6289a0b77b4d3f7d12005a05949fd8c3',
+   *     chain: 'ETHEREUM',
+   *     owner: 'John Doe',
+   *     owner_type: 'INDIVIDUAL',
+   *     name: 'Cold wallet',
+   *   });
+   * ```
+   */
+  create(body: BlockchainRecipientCreateParams, options?: RequestOptions): APIPromise<BlockchainRecipient> {
+    return this._client.post('/v1/blockchain_recipients', { body, ...options });
+  }
+}
+
+export interface BlockchainRecipient {
+  /**
+   * A globally unique identifier for this blockchain recipient
+   */
+  token: string;
+
+  /**
+   * The financial account the blockchain recipient belongs to
+   */
+  account_token: string;
+
+  /**
+   * An optional tag or memo used by some chains to identify the destination of a
+   * transfer within a shared address
+   */
+  address_tag: string | null;
+
+  /**
+   * The blockchain network that the address belongs to
+   */
+  chain: string;
+
+  /**
+   * An ISO 8601 string representing when this blockchain recipient was created
+   */
+  created: string;
+
+  /**
+   * The identifier the recipient is registered under with the payment provider
+   */
+  external_id: string | null;
+
+  /**
+   * The nickname for this blockchain recipient
+   */
+  name: string | null;
+
+  /**
+   * Legal name of the business or individual who owns the blockchain address
+   */
+  owner: string;
+
+  /**
+   * Owner Type
+   */
+  owner_type: ExternalBankAccountsAPI.OwnerType;
+
+  /**
+   * Globally unique identifier for the program the blockchain recipient is
+   * associated with
+   */
+  program_id: string;
+
+  /**
+   * Account State
+   */
+  state: 'ENABLED' | 'CLOSED' | 'PAUSED';
+
+  /**
+   * An ISO 8601 string representing when this blockchain recipient was last updated
+   */
+  updated: string;
+
+  /**
+   * Verification State
+   */
+  verification_state: 'PENDING' | 'ENABLED' | 'FAILED_VERIFICATION' | 'INSUFFICIENT_FUNDS';
+}
+
+export interface BlockchainRecipientCreateParams {
+  /**
+   * The financial account the blockchain recipient belongs to
+   */
+  account_token: string;
+
+  /**
+   * The blockchain address funds will be withdrawn to
+   */
+  address: string;
+
+  /**
+   * The blockchain network that the address belongs to
+   */
+  chain: string;
+
+  /**
+   * Legal name of the business or individual who owns the blockchain address
+   */
+  owner: string;
+
+  /**
+   * Owner Type
+   */
+  owner_type: ExternalBankAccountsAPI.OwnerType;
+
+  /**
+   * An optional tag or memo used by some chains to identify the destination of a
+   * transfer within a shared address
+   */
+  address_tag?: string;
+
+  /**
+   * The nickname for this blockchain recipient
+   */
+  name?: string;
+}
+
+export declare namespace BlockchainRecipients {
+  export {
+    type BlockchainRecipient as BlockchainRecipient,
+    type BlockchainRecipientCreateParams as BlockchainRecipientCreateParams,
+  };
+}

src/resources/cards/cards.ts

@@ -437,7 +437,7 @@ export type NonPCICardsCursorPage = CursorPage<NonPCICard>;
  */
 export interface Card extends NonPCICard {
   /**
-   * 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
    */
   cvv?: string;