feat(api): api update

Stainless-Generated-From: 85248fb1eaae8f868292172b2d793495f23c32d7

Author: builder-blobby[bot]

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 97
+configured_endpoints: 99

api.md

@@ -360,6 +360,8 @@ Methods:
 
 - <code title="post /v1/wallets/{wallet_id}/earn/ethereum/deposit">client.wallets.earn.ethereum.<a href="./src/resources/wallets/earn/ethereum/ethereum.ts">\_deposit</a>(walletID, { ...params }) -> EarnDepositActionResponse</code>
 - <code title="post /v1/wallets/{wallet_id}/earn/ethereum/withdraw">client.wallets.earn.ethereum.<a href="./src/resources/wallets/earn/ethereum/ethereum.ts">\_withdraw</a>(walletID, { ...params }) -> EarnWithdrawActionResponse</code>
+- <code title="get /v1/earn/ethereum/vaults/{vault_id}">client.wallets.earn.ethereum.<a href="./src/resources/wallets/earn/ethereum/ethereum.ts">vaultDetails</a>(vaultID) -> EthereumEarnVaultDetailsResponse</code>
+- <code title="get /v1/wallets/{wallet_id}/earn/ethereum/vaults">client.wallets.earn.ethereum.<a href="./src/resources/wallets/earn/ethereum/ethereum.ts">vaultPosition</a>(walletID, { ...params }) -> EthereumEarnPositionResponse</code>
 
 #### Incentive
 

src/resources/apps/apps.ts

@@ -188,6 +188,11 @@ export interface AppResponse {
 
   legacy_wallet_ui_config: boolean;
 
+  /**
+   * The legal name of the company that operates the app.
+   */
+  legal_name: string | null;
+
   line_oauth: boolean;
 
   linkedin_oauth: boolean;

src/resources/cards.ts

@@ -74,6 +74,11 @@ export interface CardIssuingCardResponse {
    */
   chain_id: AppsAPI.Caip2;
 
+  /**
+   * Unix timestamp, in seconds, of when the card was created.
+   */
+  created_at: number;
+
   /**
    * Card expiration month from 1 to 12, or null when unavailable.
    */

src/resources/wallets/deposit-accounts/crypto.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
-import * as WalletAutomationsAPI from '../../wallet-automations';
 import * as WalletsAPI from '../wallets';
 import { APIPromise } from '../../../core/api-promise';
 import { buildHeaders } from '../../../internal/headers';
@@ -87,18 +86,16 @@ export declare namespace CryptoCreateParams {
 
   export interface CreateCryptoDepositAccountWithRouteRequestBody {
     /**
-     * Body param: A destination asset spec accepting either raw identifiers
-     * (asset_address, caip2) or human-readable aliases (asset, chain). Exactly one of
-     * asset_address or asset must be provided; exactly one of caip2 or chain must be
-     * provided.
+     * Body param: An asset on a chain. Uses a human-readable alias (usdc, base) when
+     * one is on file, otherwise the raw asset address and CAIP-2.
      */
-    destination: WalletAutomationsAPI.AutomationDestinationAssetInput;
+    destination: WalletsAPI.CryptoDepositAsset;
 
     /**
-     * Body param: Which assets to include/exclude for an automation trigger (input
-     * form with alias support).
+     * Body param: Which assets a deposit address accepts. Asset and chain use
+     * human-readable aliases when known.
      */
-    source: WalletAutomationsAPI.AutomationAssetFilterInput;
+    source: WalletsAPI.CryptoDepositAssetFilter;
 
     /**
      * Header param: Request authorization signature. If multiple signatures are

src/resources/wallets/earn/earn.ts

@@ -2,7 +2,12 @@
 
 import { APIResource } from '../../../core/resource';
 import * as EthereumAPI from './ethereum/ethereum';
-import { Ethereum, EthereumDepositParams, EthereumWithdrawParams } from './ethereum/ethereum';
+import {
+  Ethereum,
+  EthereumDepositParams,
+  EthereumVaultPositionParams,
+  EthereumWithdrawParams,
+} from './ethereum/ethereum';
 
 export class Earn extends APIResource {
   _ethereum: EthereumAPI.Ethereum = new EthereumAPI.Ethereum(this._client);
@@ -15,5 +20,6 @@ export declare namespace Earn {
     Ethereum as Ethereum,
     type EthereumDepositParams as EthereumDepositParams,
     type EthereumWithdrawParams as EthereumWithdrawParams,
+    type EthereumVaultPositionParams as EthereumVaultPositionParams,
   };
 }

src/resources/wallets/earn/ethereum/ethereum.ts

@@ -96,6 +96,46 @@ export class Ethereum extends APIResource {
       ]),
     });
   }
+
+  /**
+   * Retrieve detailed information about an earn vault, including current APY and
+   * liquidity.
+   *
+   * @example
+   * ```ts
+   * const ethereumEarnVaultDetailsResponse =
+   *   await client.wallets.earn.ethereum.vaultDetails(
+   *     'vault_id',
+   *   );
+   * ```
+   */
+  vaultDetails(
+    vaultID: string,
+    options?: RequestOptions,
+  ): APIPromise<ActionsAPI.EthereumEarnVaultDetailsResponse> {
+    return this._client.get(path`/v1/earn/ethereum/vaults/${vaultID}`, options);
+  }
+
+  /**
+   * Retrieve a wallet's current position in a specific earn vault, including
+   * deposit/withdraw totals and current onchain vault shares.
+   *
+   * @example
+   * ```ts
+   * const ethereumEarnPositionResponse =
+   *   await client.wallets.earn.ethereum.vaultPosition(
+   *     'wallet_id',
+   *     { vault_id: 'vault_id' },
+   *   );
+   * ```
+   */
+  vaultPosition(
+    walletID: string,
+    query: EthereumVaultPositionParams,
+    options?: RequestOptions,
+  ): APIPromise<ActionsAPI.EthereumEarnPositionResponse> {
+    return this._client.get(path`/v1/wallets/${walletID}/earn/ethereum/vaults`, { query, ...options });
+  }
 }
 
 export interface EthereumDepositParams {
@@ -184,12 +224,25 @@ export interface EthereumWithdrawParams {
   'privy-request-expiry'?: string;
 }
 
+export interface EthereumVaultPositionParams {
+  /**
+   * The vault ID to get position for.
+   */
+  vault_id: string;
+
+  /**
+   * Include archived wallets in lookup. Defaults to false.
+   */
+  include_archived?: boolean;
+}
+
 Ethereum.Incentive = Incentive;
 
 export declare namespace Ethereum {
   export {
     type EthereumDepositParams as EthereumDepositParams,
     type EthereumWithdrawParams as EthereumWithdrawParams,
+    type EthereumVaultPositionParams as EthereumVaultPositionParams,
   };
 
   export { Incentive as Incentive, type IncentiveClaimParams as IncentiveClaimParams };

src/resources/wallets/earn/ethereum/index.ts

@@ -1,4 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Ethereum, type EthereumDepositParams, type EthereumWithdrawParams } from './ethereum';
+export {
+  Ethereum,
+  type EthereumDepositParams,
+  type EthereumWithdrawParams,
+  type EthereumVaultPositionParams,
+} from './ethereum';
 export { Incentive, type IncentiveClaimParams } from './incentive';

src/resources/wallets/earn/index.ts

@@ -1,4 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Earn } from './earn';
-export { Ethereum, type EthereumDepositParams, type EthereumWithdrawParams } from './ethereum/index';
+export {
+  Ethereum,
+  type EthereumDepositParams,
+  type EthereumWithdrawParams,
+  type EthereumVaultPositionParams,
+} from './ethereum/index';

src/resources/wallets/wallets.ts

@@ -749,17 +749,16 @@ export interface CreateCryptoDepositAccountWithConfigRequestBody {
  */
 export interface CreateCryptoDepositAccountWithRouteRequestBody {
   /**
-   * A destination asset spec accepting either raw identifiers (asset_address, caip2)
-   * or human-readable aliases (asset, chain). Exactly one of asset_address or asset
-   * must be provided; exactly one of caip2 or chain must be provided.
+   * An asset on a chain. Uses a human-readable alias (usdc, base) when one is on
+   * file, otherwise the raw asset address and CAIP-2.
    */
-  destination: WalletAutomationsAPI.AutomationDestinationAssetInput;
+  destination: CryptoDepositAsset;
 
   /**
-   * Which assets to include/exclude for an automation trigger (input form with alias
-   * support).
+   * Which assets a deposit address accepts. Asset and chain use human-readable
+   * aliases when known.
    */
-  source: WalletAutomationsAPI.AutomationAssetFilterInput;
+  source: CryptoDepositAssetFilter;
 }
 
 /**
@@ -794,9 +793,10 @@ export interface CryptoDepositAsset {
   asset: string;
 
   /**
-   * Known alias (base) or CAIP-2.
+   * Known alias (base) or CAIP-2. Omit on a source value to match every supported
+   * chain for that asset.
    */
-  chain: string;
+  chain?: string;
 }
 
 /**