@privy-io/node 0.8.0 → 0.9.0

package/src/resources/index.ts

@@ -7,6 +7,7 @@ export {
   type AggregationWindow,
   type AggregationGroupBy,
   type Aggregation,
+  type AggregationInput,
 } from './aggregations';
 export { Analytics, type AnalyticsEventInput } from './analytics';
 export { Apps, type AppResponse } from './apps';
@@ -16,6 +17,28 @@ export {
   type PrivyOAuthProviderID,
   type CustomOAuthProviderID,
   type OAuthProviderID,
+  type OnrampProvider,
+  type GetFiatCustomerRequestInput,
+  type CreateOrUpdateFiatCustomerRequestInput,
+  type BridgeFiatCustomerResponse,
+  type BridgeSandboxFiatCustomerResponse,
+  type FiatCustomerResponse,
+  type BridgeDestinationAsset,
+  type BridgeSourceAsset,
+  type BridgeFiatVirtualAccountSource,
+  type BridgeFiatVirtualAccountDestination,
+  type BridgeFiatVirtualAccountRequest,
+  type BridgeSandboxFiatVirtualAccountRequest,
+  type FiatVirtualAccountRequest,
+  type BridgeUsdFiatVirtualAccountDepositInstructions,
+  type BridgeEurFiatVirtualAccountDepositInstructions,
+  type BridgeMxnFiatVirtualAccountDepositInstructions,
+  type BridgeBrlFiatVirtualAccountDepositInstructions,
+  type BridgeGbpFiatVirtualAccountDepositInstructions,
+  type BridgeFiatVirtualAccountDepositInstructions,
+  type BridgeFiatVirtualAccountResponse,
+  type BridgeSandboxFiatVirtualAccountResponse,
+  type FiatVirtualAccountResponse,
 } from './client-auth';
 export {
   KeyQuorums,
@@ -50,7 +73,6 @@ export { Transactions, type TransactionGetResponse } from './transactions';
 export {
   Users,
   type AuthenticatedUser,
-  type LinkedAccount,
   type User,
   type LinkedAccountEmail,
   type LinkedAccountPhone,
@@ -87,6 +109,7 @@ export {
   type CrossAppSmartWallet,
   type LinkedAccountCrossApp,
   type LinkedAccountAuthorizationKey,
+  type LinkedAccount,
   type LinkedAccountType,
   type CustomMetadata,
   type LinkedAccountWalletInput,
@@ -106,6 +129,7 @@ export {
   type LinkedAccountFarcasterInput,
   type LinkedAccountTelegramInput,
   type LinkedAccountCustomJwtInput,
+  type LinkedAccountPasskeyInput,
   type LinkedAccountInput,
   type UserBatchCreateInput,
   type SMSMfaMethod,
@@ -136,11 +160,11 @@ export {
 } from './users';
 export {
   Wallets,
+  type Wallet,
   type CurveSigningChainType,
+  type ExtendedChainType,
   type FirstClassChainType,
-  type Wallet,
   type WalletChainType,
-  type ExtendedChainType,
   type WalletCustodian,
   type CustodialWalletProvider,
   type CustodialWalletChainType,
@@ -148,6 +172,10 @@ export {
   type CustodialWallet,
   type HpkeImportConfig,
   type SuiCommandName,
+  type WalletBatchItemInput,
+  type WalletBatchCreateInput,
+  type WalletBatchCreateResult,
+  type WalletBatchCreateResponse,
   type EthereumPersonalSignRpcInput,
   type EthereumSignTransactionRpcInput,
   type EthereumSendTransactionRpcInput,
@@ -186,3 +214,51 @@ export {
   type WalletCreateWalletsWithRecoveryParams,
   type WalletsCursor,
 } from './wallets/wallets';
+export {
+  Webhooks,
+  type UserCreatedWebhookPayload,
+  type UserAuthenticatedWebhookPayload,
+  type UserLinkedAccountWebhookPayload,
+  type UserUnlinkedAccountWebhookPayload,
+  type UserUpdatedAccountWebhookPayload,
+  type UserTransferredAccountWebhookPayload,
+  type UserWalletCreatedWebhookPayload,
+  type TransactionBroadcastedWebhookPayload,
+  type TransactionConfirmedWebhookPayload,
+  type TransactionExecutionRevertedWebhookPayload,
+  type TransactionStillPendingWebhookPayload,
+  type TransactionFailedWebhookPayload,
+  type TransactionReplacedWebhookPayload,
+  type TransactionProviderErrorWebhookPayload,
+  type FundsDepositedWebhookPayload,
+  type FundsWithdrawnWebhookPayload,
+  type PrivateKeyExportWebhookPayload,
+  type WalletRecoverySetupWebhookPayload,
+  type WalletRecoveredWebhookPayload,
+  type MfaEnabledWebhookPayload,
+  type MfaDisabledWebhookPayload,
+  type KrakenEmbedVerificationCompletedWebhookPayload,
+  type KrakenEmbedVerificationFailedWebhookPayload,
+  type KrakenEmbedQuoteExecutedWebhookPayload,
+  type KrakenEmbedQuoteExecutionFailedWebhookPayload,
+  type KrakenEmbedQuoteCancelledWebhookPayload,
+  type KrakenEmbedUserVerifiedWebhookPayload,
+  type KrakenEmbedUserDisabledWebhookPayload,
+  type KrakenEmbedUserClosedWebhookPayload,
+} from './webhooks';
+export {
+  Yield,
+  type EthereumYieldProvider,
+  type EthereumYieldSweepType,
+  type EthereumYieldSweepStatus,
+  type EthereumYieldDepositInput,
+  type EthereumYieldWithdrawInput,
+  type EthereumYieldSweepResponse,
+  type EthereumVaultDetailsInput,
+  type EthereumYieldSweepIDInput,
+  type EthereumVaultResponse,
+  type EthereumVaultDetailsResponse,
+  type EthereumYieldPositionsInput,
+  type EthereumVaultPosition,
+  type EthereumYieldPositionResponse,
+} from './yield';

package/src/resources/policies.ts

@@ -1193,8 +1193,7 @@ export interface PolicyCreateParams {
   owner?: PolicyCreateParams.PublicKeyOwner | PolicyCreateParams.UserOwner | null;
 
   /**
-   * Body param: The key quorum ID to set as the owner of the resource. If you
-   * provide this, do not specify an owner.
+   * Body param
    */
   owner_id?: string | null;
 
@@ -1655,8 +1654,7 @@ export interface PolicyUpdateParams {
   owner?: PolicyUpdateParams.PublicKeyOwner | PolicyUpdateParams.UserOwner | null;
 
   /**
-   * Body param: The key quorum ID to set as the owner of the resource. If you
-   * provide this, do not specify an owner.
+   * Body param
    */
   owner_id?: string | null;
 

package/src/resources/users.ts

@@ -348,39 +348,6 @@ export interface AuthenticatedUser {
   oauth_tokens?: OAuthTokens;
 }
 
-/**
- * A linked account for the user.
- */
-export type LinkedAccount =
-  | LinkedAccountEmail
-  | LinkedAccountPhone
-  | LinkedAccountEthereum
-  | LinkedAccountSolana
-  | LinkedAccountSmartWallet
-  | LinkedAccountEthereumEmbeddedWallet
-  | LinkedAccountSolanaEmbeddedWallet
-  | LinkedAccountBitcoinSegwitEmbeddedWallet
-  | LinkedAccountBitcoinTaprootEmbeddedWallet
-  | LinkedAccountCurveSigningEmbeddedWallet
-  | LinkedAccountGoogleOAuth
-  | LinkedAccountTwitterOAuth
-  | LinkedAccountDiscordOAuth
-  | LinkedAccountGitHubOAuth
-  | LinkedAccountSpotifyOAuth
-  | LinkedAccountInstagramOAuth
-  | LinkedAccountTiktokOAuth
-  | LinkedAccountLineOAuth
-  | LinkedAccountTwitchOAuth
-  | LinkedAccountLinkedInOAuth
-  | LinkedAccountAppleOAuth
-  | LinkedAccountCustomOAuth
-  | LinkedAccountCustomJwt
-  | LinkedAccountFarcaster
-  | LinkedAccountPasskey
-  | LinkedAccountTelegram
-  | LinkedAccountCrossApp
-  | LinkedAccountAuthorizationKey;
-
 /**
  * A Privy user object.
  */
@@ -1201,6 +1168,39 @@ export interface LinkedAccountAuthorizationKey {
   verified_at: number;
 }
 
+/**
+ * A linked account for the user.
+ */
+export type LinkedAccount =
+  | LinkedAccountEmail
+  | LinkedAccountPhone
+  | LinkedAccountEthereum
+  | LinkedAccountSolana
+  | LinkedAccountSmartWallet
+  | LinkedAccountEthereumEmbeddedWallet
+  | LinkedAccountSolanaEmbeddedWallet
+  | LinkedAccountBitcoinSegwitEmbeddedWallet
+  | LinkedAccountBitcoinTaprootEmbeddedWallet
+  | LinkedAccountCurveSigningEmbeddedWallet
+  | LinkedAccountGoogleOAuth
+  | LinkedAccountTwitterOAuth
+  | LinkedAccountDiscordOAuth
+  | LinkedAccountGitHubOAuth
+  | LinkedAccountSpotifyOAuth
+  | LinkedAccountInstagramOAuth
+  | LinkedAccountTiktokOAuth
+  | LinkedAccountLineOAuth
+  | LinkedAccountTwitchOAuth
+  | LinkedAccountLinkedInOAuth
+  | LinkedAccountAppleOAuth
+  | LinkedAccountCustomOAuth
+  | LinkedAccountCustomJwt
+  | LinkedAccountFarcaster
+  | LinkedAccountPasskey
+  | LinkedAccountTelegram
+  | LinkedAccountCrossApp
+  | LinkedAccountAuthorizationKey;
+
 /**
  * The possible types of linked accounts.
  */
@@ -1454,6 +1454,21 @@ export interface LinkedAccountCustomJwtInput {
   type: 'custom_auth';
 }
 
+/**
+ * The payload for importing a passkey account.
+ */
+export interface LinkedAccountPasskeyInput {
+  credential_device_type: 'singleDevice' | 'multiDevice';
+
+  credential_id: string;
+
+  credential_public_key: string;
+
+  credential_username: string;
+
+  type: 'passkey';
+}
+
 /**
  * The input for adding a linked account to a user.
  */
@@ -1474,7 +1489,8 @@ export type LinkedAccountInput =
   | LinkedAccountLinkedInInput
   | LinkedAccountFarcasterInput
   | LinkedAccountTelegramInput
-  | LinkedAccountCustomJwtInput;
+  | LinkedAccountCustomJwtInput
+  | LinkedAccountPasskeyInput;
 
 /**
  * The payload for batch creating users.
@@ -1762,7 +1778,6 @@ export interface UserUnlinkLinkedAccountParams {
 export declare namespace Users {
   export {
     type AuthenticatedUser as AuthenticatedUser,
-    type LinkedAccount as LinkedAccount,
     type User as User,
     type LinkedAccountEmail as LinkedAccountEmail,
     type LinkedAccountPhone as LinkedAccountPhone,
@@ -1799,6 +1814,7 @@ export declare namespace Users {
     type CrossAppSmartWallet as CrossAppSmartWallet,
     type LinkedAccountCrossApp as LinkedAccountCrossApp,
     type LinkedAccountAuthorizationKey as LinkedAccountAuthorizationKey,
+    type LinkedAccount as LinkedAccount,
     type LinkedAccountType as LinkedAccountType,
     type CustomMetadata as CustomMetadata,
     type LinkedAccountWalletInput as LinkedAccountWalletInput,
@@ -1818,6 +1834,7 @@ export declare namespace Users {
     type LinkedAccountFarcasterInput as LinkedAccountFarcasterInput,
     type LinkedAccountTelegramInput as LinkedAccountTelegramInput,
     type LinkedAccountCustomJwtInput as LinkedAccountCustomJwtInput,
+    type LinkedAccountPasskeyInput as LinkedAccountPasskeyInput,
     type LinkedAccountInput as LinkedAccountInput,
     type UserBatchCreateInput as UserBatchCreateInput,
     type SMSMfaMethod as SMSMfaMethod,

package/src/resources/wallets/balance.ts

@@ -13,11 +13,14 @@ export class Balance extends APIResource {
    * ```ts
    * const balance = await client.wallets.balance.get(
    *   'wallet_id',
-   *   { asset: 'usdc', chain: 'ethereum' },
    * );
    * ```
    */
-  get(walletID: string, query: BalanceGetParams, options?: RequestOptions): APIPromise<BalanceGetResponse> {
+  get(
+    walletID: string,
+    query: BalanceGetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BalanceGetResponse> {
     return this._client.get(path`/v1/wallets/${walletID}/balance`, { query, ...options });
   }
 }
@@ -28,7 +31,7 @@ export interface BalanceGetResponse {
 
 export namespace BalanceGetResponse {
   export interface Balance {
-    asset: 'usdc' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol';
+    asset: 'usdc' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol' | (string & {});
 
     chain:
       | 'ethereum'
@@ -57,7 +60,14 @@ export namespace BalanceGetResponse {
 }
 
 export interface BalanceGetParams {
-  asset:
+  /**
+   * The token contract address(es) to query in format "chain:address" (e.g.,
+   * "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" or
+   * "solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v").
+   */
+  token?: string | Array<string>;
+
+  asset?:
     | 'usdc'
     | 'eth'
     | 'pol'
@@ -67,7 +77,7 @@ export interface BalanceGetParams {
     | 'sol'
     | Array<'usdc' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol'>;
 
-  chain:
+  chain?:
     | 'ethereum'
     | 'arbitrum'
     | 'base'

package/src/resources/wallets/index.ts

@@ -4,11 +4,11 @@ export { Balance, type BalanceGetResponse, type BalanceGetParams } from './balan
 export { Transactions, type TransactionGetResponse, type TransactionGetParams } from './transactions';
 export {
   Wallets,
+  type Wallet,
   type CurveSigningChainType,
+  type ExtendedChainType,
   type FirstClassChainType,
-  type Wallet,
   type WalletChainType,
-  type ExtendedChainType,
   type WalletCustodian,
   type CustodialWalletProvider,
   type CustodialWalletChainType,
@@ -16,6 +16,10 @@ export {
   type CustodialWallet,
   type HpkeImportConfig,
   type SuiCommandName,
+  type WalletBatchItemInput,
+  type WalletBatchCreateInput,
+  type WalletBatchCreateResult,
+  type WalletBatchCreateResponse,
   type EthereumPersonalSignRpcInput,
   type EthereumSignTransactionRpcInput,
   type EthereumSendTransactionRpcInput,

package/src/resources/wallets/transactions.ts

@@ -61,7 +61,7 @@ export namespace TransactionGetResponse {
 
   export namespace Transaction {
     export interface UnionMember0 {
-      asset: 'usdc' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol';
+      asset: 'usdc' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol' | (string & {});
 
       chain:
         | 'ethereum'
@@ -99,7 +99,7 @@ export namespace TransactionGetResponse {
     }
 
     export interface UnionMember1 {
-      asset: 'usdc' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol';
+      asset: 'usdc' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol' | (string & {});
 
       chain:
         | 'ethereum'

package/src/resources/wallets/wallets.ts

@@ -270,26 +270,6 @@ export class Wallets extends APIResource {
 
 export type WalletsCursor = Cursor<Wallet>;
 
-/**
- * The wallet chain types that support curve-based signing.
- */
-export type CurveSigningChainType =
-  | 'cosmos'
-  | 'stellar'
-  | 'sui'
-  | 'aptos'
-  | 'movement'
-  | 'tron'
-  | 'bitcoin-segwit'
-  | 'near'
-  | 'ton'
-  | 'starknet';
-
-/**
- * The wallet chain types that offer first class support.
- */
-export type FirstClassChainType = 'ethereum' | 'solana';
-
 /**
  * A wallet managed by Privy's wallet infrastructure.
  */
@@ -362,11 +342,9 @@ export namespace Wallet {
 }
 
 /**
- * The wallet chain types.
+ * The wallet chain types that support curve-based signing.
  */
-export type WalletChainType =
-  | 'ethereum'
-  | 'solana'
+export type CurveSigningChainType =
   | 'cosmos'
   | 'stellar'
   | 'sui'
@@ -376,8 +354,7 @@ export type WalletChainType =
   | 'bitcoin-segwit'
   | 'near'
   | 'ton'
-  | 'starknet'
-  | 'spark';
+  | 'starknet';
 
 /**
  * The wallet chain types that are not first class chains.
@@ -395,6 +372,29 @@ export type ExtendedChainType =
   | 'starknet'
   | 'spark';
 
+/**
+ * The wallet chain types that offer first class support.
+ */
+export type FirstClassChainType = 'ethereum' | 'solana';
+
+/**
+ * The wallet chain types.
+ */
+export type WalletChainType =
+  | 'ethereum'
+  | 'solana'
+  | 'cosmos'
+  | 'stellar'
+  | 'sui'
+  | 'aptos'
+  | 'movement'
+  | 'tron'
+  | 'bitcoin-segwit'
+  | 'near'
+  | 'ton'
+  | 'starknet'
+  | 'spark';
+
 /**
  * Information about the custodian managing this wallet.
  */
@@ -518,6 +518,139 @@ export interface HpkeImportConfig {
  */
 export type SuiCommandName = 'TransferObjects' | 'SplitCoins' | 'MergeCoins';
 
+/**
+ * Input for a single wallet in a batch creation request.
+ */
+export interface WalletBatchItemInput {
+  /**
+   * The wallet chain types.
+   */
+  chain_type: WalletChainType;
+
+  /**
+   * Additional signers for the wallet.
+   */
+  additional_signers?: Array<WalletBatchItemInput.AdditionalSigner>;
+
+  /**
+   * The owner of the resource. If you provide this, do not specify an owner_id as it
+   * will be generated automatically. When updating a wallet, you can set the owner
+   * to null to remove the owner.
+   */
+  owner?: WalletBatchItemInput.PublicKeyOwner | WalletBatchItemInput.UserOwner | null;
+
+  /**
+   * The key quorum ID to set as the owner of the resource. If you provide this, do
+   * not specify an owner.
+   */
+  owner_id?: string;
+
+  /**
+   * List of policy IDs for policies that should be enforced on the wallet.
+   * Currently, only one policy is supported per wallet.
+   */
+  policy_ids?: Array<string>;
+}
+
+export namespace WalletBatchItemInput {
+  export interface AdditionalSigner {
+    signer_id: string;
+
+    /**
+     * The array of policy IDs that will be applied to wallet requests. If specified,
+     * this will override the base policy IDs set on the wallet.
+     */
+    override_policy_ids?: Array<string>;
+  }
+
+  /**
+   * The P-256 public key of the owner of the resource, in base64-encoded DER format.
+   * If you provide this, do not specify an owner_id as it will be generated
+   * automatically.
+   */
+  export interface PublicKeyOwner {
+    public_key: string;
+  }
+
+  /**
+   * The user ID of the owner of the resource. The user must already exist, and this
+   * value must start with "did:privy:". If you provide this, do not specify an
+   * owner_id as it will be generated automatically.
+   */
+  export interface UserOwner {
+    user_id: string;
+  }
+}
+
+/**
+ * Request body for batch wallet creation.
+ */
+export interface WalletBatchCreateInput {
+  /**
+   * Array of wallet creation requests. Minimum 1, maximum 100.
+   */
+  wallets: Array<WalletBatchItemInput>;
+}
+
+/**
+ * A single result from a batch wallet creation operation.
+ */
+export type WalletBatchCreateResult =
+  | WalletBatchCreateResult.WalletBatchCreateSuccess
+  | WalletBatchCreateResult.WalletBatchCreateFailure;
+
+export namespace WalletBatchCreateResult {
+  /**
+   * A successful wallet creation result within a batch operation.
+   */
+  export interface WalletBatchCreateSuccess {
+    /**
+     * The index of the wallet in the original request array.
+     */
+    index: number;
+
+    success: true;
+
+    /**
+     * A wallet managed by Privy's wallet infrastructure.
+     */
+    wallet: WalletsAPI.Wallet;
+  }
+
+  /**
+   * A failed wallet creation result within a batch operation.
+   */
+  export interface WalletBatchCreateFailure {
+    /**
+     * A PrivyErrorCode string identifying the error type (e.g., "invalid_data",
+     * "resource_conflict").
+     */
+    code: string;
+
+    /**
+     * A human-readable error message with details about what went wrong.
+     */
+    error: string;
+
+    /**
+     * The index of the wallet in the original request array.
+     */
+    index: number;
+
+    success: false;
+  }
+}
+
+/**
+ * Response for a batch wallet creation request.
+ */
+export interface WalletBatchCreateResponse {
+  /**
+   * Array of results for each wallet creation request, in the same order as input.
+   */
+  results: Array<WalletBatchCreateResult>;
+}
+
 /**
  * Executes the EVM `personal_sign` RPC (EIP-191) to sign a message.
  */
@@ -1303,11 +1436,21 @@ export namespace WalletCreateParams {
 }
 
 export interface WalletListParams extends CursorParams {
+  /**
+   * Filter wallets by authorization public key. Returns wallets owned by key quorums
+   * that include the specified P-256 public key (base64-encoded DER format). Cannot
+   * be used together with user_id.
+   */
+  authorization_key?: string;
+
   /**
    * The wallet chain types.
    */
   chain_type?: WalletChainType;
 
+  /**
+   * Filter wallets by user ID. Cannot be used together with authorization_key.
+   */
   user_id?: string;
 }
 
@@ -2148,8 +2291,7 @@ export interface WalletUpdateParams {
   owner?: WalletUpdateParams.PublicKeyOwner | WalletUpdateParams.UserOwner | null;
 
   /**
-   * Body param: The key quorum ID to set as the owner of the resource. If you
-   * provide this, do not specify an owner.
+   * Body param
    */
   owner_id?: string | null;
 
@@ -2274,11 +2416,11 @@ Wallets.Balance = Balance;
 
 export declare namespace Wallets {
   export {
+    type Wallet as Wallet,
     type CurveSigningChainType as CurveSigningChainType,
+    type ExtendedChainType as ExtendedChainType,
     type FirstClassChainType as FirstClassChainType,
-    type Wallet as Wallet,
     type WalletChainType as WalletChainType,
-    type ExtendedChainType as ExtendedChainType,
     type WalletCustodian as WalletCustodian,
     type CustodialWalletProvider as CustodialWalletProvider,
     type CustodialWalletChainType as CustodialWalletChainType,
@@ -2286,6 +2428,10 @@ export declare namespace Wallets {
     type CustodialWallet as CustodialWallet,
     type HpkeImportConfig as HpkeImportConfig,
     type SuiCommandName as SuiCommandName,
+    type WalletBatchItemInput as WalletBatchItemInput,
+    type WalletBatchCreateInput as WalletBatchCreateInput,
+    type WalletBatchCreateResult as WalletBatchCreateResult,
+    type WalletBatchCreateResponse as WalletBatchCreateResponse,
     type EthereumPersonalSignRpcInput as EthereumPersonalSignRpcInput,
     type EthereumSignTransactionRpcInput as EthereumSignTransactionRpcInput,
     type EthereumSendTransactionRpcInput as EthereumSendTransactionRpcInput,