@privy-io/node 0.10.1 → 0.11.0

package/src/public-api/services/wallets.ts

@@ -1,10 +1,12 @@
 import { PrivyAPI } from '../../client';
+import { APIPromise } from '../../core/api-promise';
 import { PrivyAPIError } from '../../core/error';
 import { generateAuthorizationSignatures } from '../../lib/authorization';
 import { setupHPKERecipient, setupHPKESender } from '../../lib/cryptography';
 import { entropyToBytes } from '../../lib/wallet-entropy';
 import {
   Wallet,
+  WalletCreateParams,
   WalletExportParams,
   WalletRawSignParams,
   WalletRawSignResponse,
@@ -39,6 +41,16 @@ export class PrivyWalletsService extends Wallets {
     return this.solanaService;
   }
 
+  public override create({
+    idempotency_key: idempotencyKey,
+    ...params
+  }: PrivyWalletsService.CreateInput): APIPromise<Wallet> {
+    return super.create({
+      ...params,
+      ...(idempotencyKey && { 'privy-idempotency-key': idempotencyKey }),
+    });
+  }
+
   public async rpc<Params extends PrivyWalletsService.RpcInput>(
     walletId: string,
     params: Params,
@@ -218,6 +230,8 @@ export class PrivyWalletsService extends Wallets {
  * @see {@link PrivyWalletsService} class.
  */
 export namespace PrivyWalletsService {
+  /** The input type for the {@link PrivyWalletsService.create} method. */
+  export type CreateInput = Prettify<WithIdempotency<WalletCreateParams>>;
   /** The input type for the {@link PrivyWalletsService.rpc} method. */
   export type RpcInput = Prettify<WithIdempotency<WithAuthorization<WalletRpcParams>>>;
   /** The input type for the {@link PrivyWalletsService.rawSign} method. */

package/src/resources/accounts.ts

@@ -65,19 +65,44 @@ export interface AccountWalletConfigurationItem {
   custody?: WalletsAPI.WalletCustodian;
 }
 
+/**
+ * An optional display name for the account.
+ */
+export type AccountDisplayName = string;
+
+/**
+ * Configuration for the wallets on this account.
+ */
+export type AccountWalletsConfiguration = Array<AccountWalletConfigurationItem>;
+
 /**
  * Input for creating a digital asset account.
  */
 export interface CreateAccountInput {
   /**
-   * Configuration for wallets to create.
+   * Configuration for the wallets on this account.
    */
-  wallets_configuration: Array<AccountWalletConfigurationItem>;
+  wallets_configuration: AccountWalletsConfiguration;
 
   /**
    * An optional display name for the account.
    */
-  display_name?: string;
+  display_name?: AccountDisplayName;
+}
+
+/**
+ * Input for updating a digital asset account.
+ */
+export interface UpdateAccountInput {
+  /**
+   * An optional display name for the account.
+   */
+  display_name?: AccountDisplayName;
+
+  /**
+   * Configuration for the wallets on this account.
+   */
+  wallets_configuration?: AccountWalletsConfiguration;
 }
 
 /**
@@ -95,12 +120,201 @@ export interface AccountsListResponse {
   next_cursor: string | null;
 }
 
+/**
+ * A digital asset account with its aggregated balance across all wallets and
+ * chains.
+ */
+export interface AssetAccountWithBalance {
+  /**
+   * The account ID.
+   */
+  id: string;
+
+  balance: AssetAccountWithBalance.Balance;
+
+  /**
+   * An optional display name for the account.
+   */
+  display_name: string | null;
+
+  /**
+   * The wallets belonging to this account.
+   */
+  wallets: Array<AccountWallet>;
+}
+
+export namespace AssetAccountWithBalance {
+  export interface Balance {
+    /**
+     * The individual asset balances, each computed across all supported chains.
+     */
+    assets: Array<Balance.Asset>;
+
+    /**
+     * The total balance across all assets.
+     */
+    total: Balance.Total;
+  }
+
+  export namespace Balance {
+    export interface Asset {
+      /**
+       * The amount of the asset held, denominated in the unit of the asset itself, with
+       * 1 decimal of precision.
+       */
+      amount: string;
+
+      /**
+       * The price of the asset in the provided currency.
+       */
+      price: Asset.Price;
+
+      /**
+       * The symbol of the asset (e.g. USDC, ETH).
+       */
+      symbol: string;
+    }
+
+    export namespace Asset {
+      /**
+       * The price of the asset in the provided currency.
+       */
+      export interface Price {
+        /**
+         * The currency code.
+         */
+        currency: 'usd';
+
+        /**
+         * The monetary value as a string.
+         */
+        value: string;
+      }
+    }
+
+    /**
+     * The total balance across all assets.
+     */
+    export interface Total {
+      /**
+       * The currency code.
+       */
+      currency: 'usd';
+
+      /**
+       * The monetary value as a string.
+       */
+      value: string;
+    }
+  }
+}
+
+/**
+ * Paginated list of digital asset accounts for the dashboard.
+ */
+export interface AccountsDashboardListResponse {
+  /**
+   * The list of accounts, with balances included for dashboard display.
+   */
+  data: Array<AssetAccountWithBalance>;
+
+  /**
+   * Cursor for fetching the next page of results, or null if no more results.
+   */
+  next_cursor: string | null;
+}
+
+/**
+ * The balance of a digital asset account, aggregated across all wallets and
+ * supported chains.
+ */
+export interface AccountBalanceResponse {
+  /**
+   * The individual asset balances, each computed across all supported chains.
+   */
+  assets: Array<AccountBalanceResponse.Asset>;
+
+  /**
+   * The total balance across all assets.
+   */
+  total: AccountBalanceResponse.Total;
+}
+
+export namespace AccountBalanceResponse {
+  export interface Asset {
+    /**
+     * The amount of the asset held, denominated in the unit of the asset itself, with
+     * 1 decimal of precision.
+     */
+    amount: string;
+
+    /**
+     * The price of the asset in the provided currency.
+     */
+    price: Asset.Price;
+
+    /**
+     * The symbol of the asset (e.g. USDC, ETH).
+     */
+    symbol: string;
+  }
+
+  export namespace Asset {
+    /**
+     * The price of the asset in the provided currency.
+     */
+    export interface Price {
+      /**
+       * The currency code.
+       */
+      currency: 'usd';
+
+      /**
+       * The monetary value as a string.
+       */
+      value: string;
+    }
+  }
+
+  /**
+   * The total balance across all assets.
+   */
+  export interface Total {
+    /**
+     * The currency code.
+     */
+    currency: 'usd';
+
+    /**
+     * The monetary value as a string.
+     */
+    value: string;
+  }
+}
+
+/**
+ * Query parameters for the account balance endpoint.
+ */
+export interface AccountBalanceParams {
+  /**
+   * When set to true, returns balances from testnet chains instead of mainnets.
+   */
+  testnet_mode?: 'true' | 'false';
+}
+
 export declare namespace Accounts {
   export {
     type AccountWallet as AccountWallet,
     type AccountResponse as AccountResponse,
     type AccountWalletConfigurationItem as AccountWalletConfigurationItem,
+    type AccountDisplayName as AccountDisplayName,
+    type AccountWalletsConfiguration as AccountWalletsConfiguration,
     type CreateAccountInput as CreateAccountInput,
+    type UpdateAccountInput as UpdateAccountInput,
     type AccountsListResponse as AccountsListResponse,
+    type AssetAccountWithBalance as AssetAccountWithBalance,
+    type AccountsDashboardListResponse as AccountsDashboardListResponse,
+    type AccountBalanceResponse as AccountBalanceResponse,
+    type AccountBalanceParams as AccountBalanceParams,
   };
 }

package/src/resources/apps/allowlist.ts

@@ -0,0 +1,126 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AppsAPI from './apps';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Operations related to app settings and allowlist management
+ */
+export class Allowlist extends APIResource {
+  /**
+   * Add a new entry to the allowlist for an app. The allowlist must be enabled.
+   *
+   * @example
+   * ```ts
+   * const allowlistEntry = await client.apps.allowlist.create(
+   *   'app_id',
+   *   { type: 'email', value: 'batman@privy.io' },
+   * );
+   * ```
+   */
+  create(
+    appID: string,
+    body: AllowlistCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<AppsAPI.AllowlistEntry> {
+    return this._client.post(path`/v1/apps/${appID}/allowlist`, { body, ...options });
+  }
+
+  /**
+   * Get all allowlist entries for an app. Returns the list of users allowed to
+   * access the app when the allowlist is enabled.
+   *
+   * @example
+   * ```ts
+   * const allowlistEntries = await client.apps.allowlist.list(
+   *   'app_id',
+   * );
+   * ```
+   */
+  list(appID: string, options?: RequestOptions): APIPromise<AllowlistListResponse> {
+    return this._client.get(path`/v1/apps/${appID}/allowlist`, options);
+  }
+
+  /**
+   * Remove an entry from the allowlist for an app. The allowlist must be enabled.
+   *
+   * @example
+   * ```ts
+   * const allowlistDeletionResponse =
+   *   await client.apps.allowlist.delete('app_id', {
+   *     type: 'email',
+   *     value: 'batman@privy.io',
+   *   });
+   * ```
+   */
+  delete(
+    appID: string,
+    body: AllowlistDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<AppsAPI.AllowlistDeletionResponse> {
+    return this._client.delete(path`/v1/apps/${appID}/allowlist`, { body, ...options });
+  }
+}
+
+export type AllowlistListResponse = Array<AppsAPI.AllowlistEntry>;
+
+export type AllowlistCreateParams =
+  | AllowlistCreateParams.EmailInviteInput
+  | AllowlistCreateParams.WalletInviteInput
+  | AllowlistCreateParams.PhoneInviteInput;
+
+export declare namespace AllowlistCreateParams {
+  export interface EmailInviteInput {
+    type: 'email';
+
+    value: string;
+  }
+
+  export interface WalletInviteInput {
+    type: 'wallet';
+
+    value: string;
+  }
+
+  export interface PhoneInviteInput {
+    type: 'phone';
+
+    value: string;
+  }
+}
+
+export type AllowlistDeleteParams =
+  | AllowlistDeleteParams.EmailInviteInput
+  | AllowlistDeleteParams.WalletInviteInput
+  | AllowlistDeleteParams.PhoneInviteInput;
+
+export declare namespace AllowlistDeleteParams {
+  export interface EmailInviteInput {
+    type: 'email';
+
+    value: string;
+  }
+
+  export interface WalletInviteInput {
+    type: 'wallet';
+
+    value: string;
+  }
+
+  export interface PhoneInviteInput {
+    type: 'phone';
+
+    value: string;
+  }
+}
+
+export declare namespace Allowlist {
+  export {
+    type AllowlistListResponse as AllowlistListResponse,
+    type AllowlistCreateParams as AllowlistCreateParams,
+    type AllowlistDeleteParams as AllowlistDeleteParams,
+  };
+}