feat(api): api update

Stainless-Generated-From: 0ac19c7d3ae4d98571327446f50c70bc063fe1bc

Author: builder-blobby[bot]

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 99
+configured_endpoints: 100

api.md

@@ -826,6 +826,14 @@ Methods:
 
 - <code title="post /v1/wallets/{wallet_id}/earn/ethereum/incentive/claim">client.wallets.earn.ethereum.incentive.<a href="./src/resources/wallets/earn/ethereum/incentive.ts">\_claim</a>(walletID, { ...params }) -> EarnIncentiveClaimActionResponse</code>
 
+## Payout
+
+### Fiat
+
+Methods:
+
+- <code title="post /v1/wallets/{wallet_id}/payout/fiat">client.wallets.payout.fiat.<a href="./src/resources/wallets/payout/fiat.ts">\_create</a>(walletID, { ...params }) -> PayoutResponse</code>
+
 ## Swap
 
 Methods:

src/resources/cards.ts

@@ -56,6 +56,11 @@ export type CardIssuingCancellationReason = 'lost' | 'stolen';
 export interface CardIssuingCardResponse {
   id: string;
 
+  /**
+   * The asset the card funds from. 'usdc' on EVM and Solana, 'path_usd' on Tempo.
+   */
+  asset: string;
+
   /**
    * USD balance of the card funding wallet on the configured chain, or null when
    * unavailable.
@@ -157,6 +162,12 @@ export interface CardIssuingConfigResponse {
  * Input for creating a virtual Stripe Issuing card for a Privy wallet.
  */
 export interface CardIssuingCreateCardInput {
+  /**
+   * The asset to fund the card. Must be 'usdc' on EVM and Solana, or 'path_usd' on
+   * Tempo.
+   */
+  asset: string;
+
   /**
    * A valid CAIP-2 chain ID (e.g. 'eip155:4217' for Tempo, 'eip155:1' for Ethereum).
    */

src/resources/intents.ts

@@ -17,8 +17,11 @@ import { path } from '../internal/utils/path';
  */
 export class Intents extends APIResource {
   /**
-   * List intents for an app. Returns a paginated list of intents with their current
-   * status and details.
+   * List intents for an app. Returns a paginated list with each intent's current
+   * status and details. Requests authenticated with an app secret can retrieve all
+   * intents for the app. Requests authenticated with a user token return only
+   * intents that the authenticated user created, must approve, or has signed. Query
+   * parameters only narrow this scoped result set.
    *
    * @example
    * ```ts
@@ -101,8 +104,11 @@ export class Intents extends APIResource {
   }
 
   /**
-   * Retrieve an intent by ID. Returns the intent details including its current
-   * status, authorization details, and execution result if applicable.
+   * Retrieve an intent by ID. Returns its current status, authorization details, and
+   * execution result when applicable. Requests authenticated with an app secret can
+   * retrieve any intent for the app. Requests authenticated with a user token can
+   * retrieve only intents that the authenticated user created, must approve, or has
+   * signed. Unrelated intents return a 404 response.
    *
    * @example
    * ```ts
@@ -1015,6 +1021,10 @@ export namespace WalletIntentResponse {
 }
 
 export interface IntentListParams extends CursorParams {
+  /**
+   * Filter by creator user ID. For user-token requests, Privy uses the authenticated
+   * user ID to scope intent visibility. This filter only narrows that scoped result.
+   */
   created_by_id?: string;
 
   current_user_has_signed?: 'true' | 'false';
@@ -1024,6 +1034,11 @@ export interface IntentListParams extends CursorParams {
    */
   intent_type?: IntentType;
 
+  /**
+   * Filter by a user whose approval is still pending. For user-token requests, Privy
+   * uses the authenticated user ID to scope intent visibility. This filter only
+   * narrows that scoped result.
+   */
   pending_member_id?: string;
 
   resource_id?: string;

src/resources/wallets/balance.ts

@@ -114,6 +114,7 @@ export interface BalanceGetParams {
     | 'tron'
     | 'zksync_era'
     | 'robinhood'
+    | 'tempo_testnet'
     | 'hoodi'
     | 'sepolia'
     | 'arbitrum_sepolia'
@@ -122,6 +123,7 @@ export interface BalanceGetParams {
     | 'linea_testnet'
     | 'optimism_sepolia'
     | 'polygon_amoy'
+    | 'bsc_testnet'
     | 'solana_devnet'
     | 'solana_testnet'
     | 'tron_nile'

src/resources/wallets/index.ts

@@ -52,6 +52,7 @@ export {
 export { Balance, type BalanceGetResponse, type BalanceGetParams } from './balance';
 export { DepositAccounts } from './deposit-accounts/index';
 export { Earn } from './earn/index';
+export { Payout } from './payout/index';
 export { Swap, type SwapExecuteParams, type SwapQuoteParams } from './swap';
 export { Transactions, type TransactionGetResponse, type TransactionGetParams } from './transactions';
 export {

src/resources/wallets/payout.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './payout/index';

src/resources/wallets/payout/fiat.ts

@@ -0,0 +1,93 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as FiatAPI from '../../fiat';
+import * as ActionsAPI from '../actions';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Operations related to fiat onramping and offramping
+ */
+export class Fiat extends APIResource {
+  /**
+   * Initiates a payout (crypto to fiat offramp) from a wallet to a previously
+   * registered external fiat account. Returns a pending wallet action; the crypto
+   * transfer and fiat settlement are processed asynchronously.
+   *
+   * @example
+   * ```ts
+   * const payoutResponse =
+   *   await client.wallets.payout.fiat._create('wallet_id', {
+   *     destination: { fiat_account_id: 'fiat_account_id' },
+   *     source: {
+   *       amount: 'amount',
+   *       asset: 'asset',
+   *       chain: 'chain',
+   *     },
+   *   });
+   * ```
+   */
+  _create(
+    walletID: string,
+    params: FiatCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<ActionsAPI.PayoutResponse> {
+    const {
+      'privy-authorization-signature': privyAuthorizationSignature,
+      'privy-idempotency-key': privyIdempotencyKey,
+      'privy-request-expiry': privyRequestExpiry,
+      ...body
+    } = params;
+    return this._client.post(path`/v1/wallets/${walletID}/payout/fiat`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(privyAuthorizationSignature != null ?
+            { 'privy-authorization-signature': privyAuthorizationSignature }
+          : undefined),
+          ...(privyIdempotencyKey != null ? { 'privy-idempotency-key': privyIdempotencyKey } : undefined),
+          ...(privyRequestExpiry != null ? { 'privy-request-expiry': privyRequestExpiry } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface FiatCreateParams {
+  /**
+   * Body param: The destination bank account for a payout.
+   */
+  destination: FiatAPI.PayoutDestination;
+
+  /**
+   * Body param: The source crypto asset, chain, and amount for a payout.
+   */
+  source: FiatAPI.PayoutSource;
+
+  /**
+   * Header param: Request authorization signature. If multiple signatures are
+   * required, they should be comma separated.
+   */
+  'privy-authorization-signature'?: string;
+
+  /**
+   * Header param: Idempotency keys ensure API requests are executed only once within
+   * a 24-hour window.
+   */
+  'privy-idempotency-key'?: string;
+
+  /**
+   * Header param: Request expiry. Value is a Unix timestamp in milliseconds
+   * representing the deadline by which the request must be processed.
+   */
+  'privy-request-expiry'?: string;
+}
+
+export declare namespace Fiat {
+  export { type FiatCreateParams as FiatCreateParams };
+}

src/resources/wallets/payout/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Fiat, type FiatCreateParams } from './fiat';
+export { Payout } from './payout';

src/resources/wallets/payout/payout.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as FiatAPI from './fiat';
+import { Fiat, FiatCreateParams } from './fiat';
+
+export class Payout extends APIResource {
+  fiat: FiatAPI.Fiat = new FiatAPI.Fiat(this._client);
+}
+
+Payout.Fiat = Fiat;
+
+export declare namespace Payout {
+  export { Fiat as Fiat, type FiatCreateParams as FiatCreateParams };
+}