@privy-io/node 0.8.0 → 0.10.0

package/src/resources/index.ts

@@ -1,5 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Accounts,
+  type AccountWallet,
+  type AccountResponse,
+  type AccountWalletConfigurationItem,
+  type CreateAccountInput,
+} from './accounts';
 export {
   Aggregations,
   type AggregationMethod,
@@ -7,6 +14,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,7 +24,32 @@ export {
   type PrivyOAuthProviderID,
   type CustomOAuthProviderID,
   type OAuthProviderID,
+  type BridgeOnrampProvider,
+  type OnrampProvider,
+  type GetFiatCustomerRequestInput,
+  type CreateOrUpdateFiatCustomerRequestInput,
+  type BridgeFiatRejectionReason,
+  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 { Intents, type IntentAuthorizationKeyQuorumMember, type IntentAuthorizationMember } from './intents';
 export {
   KeyQuorums,
   type KeyQuorum,
@@ -50,7 +83,6 @@ export { Transactions, type TransactionGetResponse } from './transactions';
 export {
   Users,
   type AuthenticatedUser,
-  type LinkedAccount,
   type User,
   type LinkedAccountEmail,
   type LinkedAccountPhone,
@@ -87,6 +119,7 @@ export {
   type CrossAppSmartWallet,
   type LinkedAccountCrossApp,
   type LinkedAccountAuthorizationKey,
+  type LinkedAccount,
   type LinkedAccountType,
   type CustomMetadata,
   type LinkedAccountWalletInput,
@@ -106,6 +139,7 @@ export {
   type LinkedAccountFarcasterInput,
   type LinkedAccountTelegramInput,
   type LinkedAccountCustomJwtInput,
+  type LinkedAccountPasskeyInput,
   type LinkedAccountInput,
   type UserBatchCreateInput,
   type SMSMfaMethod,
@@ -136,11 +170,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 +182,10 @@ export {
   type CustodialWallet,
   type HpkeImportConfig,
   type SuiCommandName,
+  type WalletBatchItemInput,
+  type WalletBatchCreateInput,
+  type WalletBatchCreateResult,
+  type WalletBatchCreateResponse,
   type EthereumPersonalSignRpcInput,
   type EthereumSignTransactionRpcInput,
   type EthereumSendTransactionRpcInput,
@@ -186,3 +224,57 @@ 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,
+  type YieldDepositConfirmedWebhookPayload,
+  type YieldWithdrawConfirmedWebhookPayload,
+} from './webhooks';
+export {
+  Yield,
+  type EvmCaip2ChainID,
+  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,
+  type EthereumYieldClaimInput,
+  type EthereumYieldClaimReward,
+  type EthereumYieldClaimResponse,
+} from './yield';

package/src/resources/intents.ts

@@ -0,0 +1,138 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as IntentsAPI from './intents';
+
+export class Intents extends APIResource {}
+
+/**
+ * A leaf member (user or key) of a nested key quorum in an intent authorization.
+ */
+export type IntentAuthorizationKeyQuorumMember =
+  | IntentAuthorizationKeyQuorumMember.UserMember
+  | IntentAuthorizationKeyQuorumMember.KeyMember;
+
+export namespace IntentAuthorizationKeyQuorumMember {
+  export interface UserMember {
+    /**
+     * Whether this member has signed the intent
+     */
+    has_signed: boolean;
+
+    type: 'user';
+
+    /**
+     * User ID of the key quorum member
+     */
+    user_id: string;
+
+    /**
+     * Display name for the user (email, etc)
+     */
+    display_name?: string;
+  }
+
+  export interface KeyMember {
+    /**
+     * Whether this key has signed the intent
+     */
+    has_signed: boolean;
+
+    /**
+     * Public key of the key quorum member
+     */
+    public_key: string;
+
+    type: 'key';
+
+    /**
+     * Display name for the key (if any)
+     */
+    display_name?: string;
+  }
+}
+
+/**
+ * A member of an intent authorization quorum. Can be a user, key, or nested key
+ * quorum.
+ */
+export type IntentAuthorizationMember =
+  | IntentAuthorizationMember.UserMember
+  | IntentAuthorizationMember.KeyMember
+  | IntentAuthorizationMember.KeyQuorumMember;
+
+export namespace IntentAuthorizationMember {
+  export interface UserMember {
+    /**
+     * Whether this member has signed the intent
+     */
+    has_signed: boolean;
+
+    type: 'user';
+
+    /**
+     * User ID of the key quorum member
+     */
+    user_id: string;
+
+    /**
+     * Display name for the user (email, etc)
+     */
+    display_name?: string;
+  }
+
+  export interface KeyMember {
+    /**
+     * Whether this key has signed the intent
+     */
+    has_signed: boolean;
+
+    /**
+     * Public key of the key quorum member
+     */
+    public_key: string;
+
+    type: 'key';
+
+    /**
+     * Display name for the key (if any)
+     */
+    display_name?: string;
+  }
+
+  export interface KeyQuorumMember {
+    /**
+     * Whether this child key quorum has fulfilled its threshold
+     */
+    has_signed: boolean;
+
+    /**
+     * ID of the child key quorum member
+     */
+    key_quorum_id: string;
+
+    /**
+     * Members of this child quorum
+     */
+    members: Array<IntentsAPI.IntentAuthorizationKeyQuorumMember>;
+
+    /**
+     * Number of signatures required from this child quorum
+     */
+    threshold: number;
+
+    type: 'key_quorum';
+
+    /**
+     * Display name for the child key quorum (if any)
+     */
+    display_name?: string;
+  }
+}
+
+export declare namespace Intents {
+  export {
+    type IntentAuthorizationKeyQuorumMember as IntentAuthorizationKeyQuorumMember,
+    type IntentAuthorizationMember as IntentAuthorizationMember,
+  };
+}

package/src/resources/key-quorums.ts

@@ -105,6 +105,11 @@ export interface KeyQuorum {
 
   display_name?: string;
 
+  /**
+   * List of nested key quorum IDs that are members of this key quorum.
+   */
+  key_quorum_ids?: Array<string>;
+
   user_ids?: Array<string>;
 }
 
@@ -132,6 +137,12 @@ export interface KeyQuorumCreateParams {
 
   display_name?: string;
 
+  /**
+   * List of key quorum IDs that should be members of this key quorum. Key quorums
+   * can only be nested 1 level deep.
+   */
+  key_quorum_ids?: Array<string>;
+
   /**
    * List of P-256 public keys of the keys that should be authorized to sign on the
    * key quorum, in base64-encoded DER format.
@@ -165,6 +176,12 @@ export interface KeyQuorumUpdateParams {
    */
   display_name?: string;
 
+  /**
+   * Body param: List of key quorum IDs that should be members of this key quorum.
+   * Key quorums can only be nested 1 level deep.
+   */
+  key_quorum_ids?: Array<string>;
+
   /**
    * Body param: List of P-256 public keys of the keys that should be authorized to
    * sign on the key quorum, in base64-encoded DER format.

package/src/resources/policies.ts

@@ -417,7 +417,7 @@ export namespace Policy {
     }
 
     /**
-     * Allowed contract addresses for eth_signAuthorization requests.
+     * Allowed contract addresses for eth_sign7702Authorization requests.
      */
     export interface Ethereum7702AuthorizationCondition {
       field: 'contract';
@@ -689,7 +689,7 @@ export namespace PolicyCreateRuleResponse {
   }
 
   /**
-   * Allowed contract addresses for eth_signAuthorization requests.
+   * Allowed contract addresses for eth_sign7702Authorization requests.
    */
   export interface Ethereum7702AuthorizationCondition {
     field: 'contract';
@@ -895,7 +895,7 @@ export namespace PolicyUpdateRuleResponse {
   }
 
   /**
-   * Allowed contract addresses for eth_signAuthorization requests.
+   * Allowed contract addresses for eth_sign7702Authorization requests.
    */
   export interface Ethereum7702AuthorizationCondition {
     field: 'contract';
@@ -1091,7 +1091,7 @@ export namespace PolicyGetRuleResponse {
   }
 
   /**
-   * Allowed contract addresses for eth_signAuthorization requests.
+   * Allowed contract addresses for eth_sign7702Authorization requests.
    */
   export interface Ethereum7702AuthorizationCondition {
     field: 'contract';
@@ -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;
 
@@ -1326,7 +1325,7 @@ export namespace PolicyCreateParams {
     }
 
     /**
-     * Allowed contract addresses for eth_signAuthorization requests.
+     * Allowed contract addresses for eth_sign7702Authorization requests.
      */
     export interface Ethereum7702AuthorizationCondition {
       field: 'contract';
@@ -1547,7 +1546,7 @@ export namespace PolicyCreateRuleParams {
   }
 
   /**
-   * Allowed contract addresses for eth_signAuthorization requests.
+   * Allowed contract addresses for eth_sign7702Authorization requests.
    */
   export interface Ethereum7702AuthorizationCondition {
     field: 'contract';
@@ -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;
 
@@ -1811,7 +1809,7 @@ export namespace PolicyUpdateParams {
     }
 
     /**
-     * Allowed contract addresses for eth_signAuthorization requests.
+     * Allowed contract addresses for eth_sign7702Authorization requests.
      */
     export interface Ethereum7702AuthorizationCondition {
       field: 'contract';
@@ -2019,7 +2017,7 @@ export namespace PolicyUpdateRuleParams {
   }
 
   /**
-   * Allowed contract addresses for eth_signAuthorization requests.
+   * Allowed contract addresses for eth_sign7702Authorization requests.
    */
   export interface Ethereum7702AuthorizationCondition {
     field: 'contract';

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'