@coinbase/cdp-sdk 1.13.0 → 1.15.0

package/_types/openapi-client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../openapi-client/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../openapi-client/index.ts"],"names":[],"mappings":"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"}

package/_types/utils/export.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Generates a new RSA key pair with 4096-bit private key.
+ * - Private key in PKCS1 DER format
+ * - Public key in PKIX/SPKI DER format
+ *
+ * @returns A promise that resolves to the generated key pair, or rejects with an error.
+ */
+export declare const generateExportEncryptionKeyPair: () => Promise<{
+    publicKey: string;
+    privateKey: string;
+}>;
+/**
+ * Decrypts a ciphertext using RSA-OAEP-SHA256.
+ * - Parses PKCS1 private key
+ * - Uses RSA-OAEP-SHA256 for decryption
+ * - Returns hex-encoded result
+ *
+ * @param b64PrivateKey - The base64-encoded private key in PKCS1 DER format.
+ * @param b64Cipher - The base64-encoded ciphertext.
+ * @returns The decrypted key hex string, or throws an error if decryption fails.
+ */
+export declare const decryptWithPrivateKey: (b64PrivateKey: string, b64Cipher: string) => string;
+/**
+ * Format a private key to a base58 string for easy import into Solana wallet apps.
+ *
+ * @param privateKey - The private key as a hex string
+ * @returns The formatted private key as a base58 string
+ */
+export declare const formatSolanaPrivateKey: (privateKey: string) => string;
+//# sourceMappingURL=export.d.ts.map

package/_types/utils/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../utils/export.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;eAE7B,MAAM;gBACL,MAAM;EA0BrB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAAI,eAAe,MAAM,EAAE,WAAW,MAAM,KAAG,MAsBhF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,YAAY,MAAM,KAAG,MAK3D,CAAC"}

package/_types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "1.13.0";
+export declare const version = "1.15.0";
 //# sourceMappingURL=version.d.ts.map

package/accounts/evm/toEvmServerAccount.ts

@@ -1,4 +1,4 @@
-import { type TransactionSerializable, serializeTransaction } from "viem";
+import { type TransactionSerializable, getTypesForEIP712Domain, serializeTransaction } from "viem";
 
 import { FundOptions, fund } from "../../actions/evm/fund/fund.js";
 import { Quote } from "../../actions/evm/fund/Quote.js";
@@ -84,6 +84,11 @@ export function toEvmServerAccount(
     },
 
     async signTypedData(message: EIP712Message) {
+      if (!message.types.EIP712Domain) {
+        message.types.EIP712Domain = getTypesForEIP712Domain({
+          domain: message.domain,
+        });
+      }
       const result = await apiClient.signEvmTypedData(options.account.address, message);
       return result.signature as Hex;
     },

package/actions/evm/listTokenBalances.ts

@@ -32,7 +32,7 @@ export interface EvmTokenAmount {
   /** The amount of the token in the smallest indivisible unit of the token. */
   amount: bigint;
   /** The number of decimals in the token. */
-  decimals: bigint;
+  decimals: number;
 }
 /**
  * An EVM token balance.
@@ -95,7 +95,7 @@ export async function listTokenBalances(
       },
       amount: {
         amount: BigInt(balance.amount.amount),
-        decimals: BigInt(balance.amount.decimals),
+        decimals: balance.amount.decimals,
       },
     };
   });

package/analytics.ts

@@ -1,6 +1,6 @@
 import md5 from "md5";
 
-import { APIError } from "./openapi-client/errors.js";
+import { APIError, HttpErrorType } from "./openapi-client/errors.js";
 import { version } from "./version.js";
 
 /**
@@ -184,7 +184,7 @@ function shouldTrackError(error: unknown): boolean {
     return false;
   }
 
-  if (error instanceof APIError) {
+  if (error instanceof APIError && error.errorType !== HttpErrorType.unexpected_error) {
     return false;
   }
 

package/client/cdp.ts

@@ -5,7 +5,7 @@ import { EvmClient } from "./evm/evm.js";
 import { PoliciesClient } from "./policies/policies.js";
 import { SolanaClient } from "./solana/solana.js";
 
-interface CdpClientOptions {
+export interface CdpClientOptions {
   /** The API key ID. */
   apiKeyId?: string;
   /** The API key secret. */

package/client/evm/evm.ts

@@ -1,50 +1,52 @@
-import { publicEncrypt, constants } from "crypto";
+import { constants, publicEncrypt } from "crypto";
 
 import { Address } from "viem";
 
 import { ImportEvmAccountPublicRSAKey } from "./constants.js";
 import {
   CreateServerAccountOptions,
-  GetServerAccountOptions,
-  ListServerAccountsOptions,
   CreateSmartAccountOptions,
-  WaitForUserOperationOptions,
-  SignHashOptions,
-  SignatureResult,
-  SignMessageOptions,
-  SignTransactionOptions,
-  GetSmartAccountOptions,
-  SmartAccount,
-  ServerAccount,
+  CreateSwapQuoteOptions,
+  CreateSwapQuoteResult,
   EvmClientInterface,
-  ListServerAccountResult,
-  PrepareUserOperationOptions,
-  UserOperation,
+  ExportServerAccountOptions,
+  GetOrCreateServerAccountOptions,
+  GetOrCreateSmartAccountOptions,
+  GetServerAccountOptions,
+  GetSmartAccountOptions,
+  GetSwapPriceOptions,
+  GetSwapPriceResult,
   GetUserOperationOptions,
+  ImportServerAccountOptions,
+  ListServerAccountResult,
+  ListServerAccountsOptions,
   ListSmartAccountResult,
   ListSmartAccountsOptions,
-  GetOrCreateServerAccountOptions,
+  PrepareUserOperationOptions,
+  ServerAccount,
+  SignatureResult,
+  SignHashOptions,
+  SignMessageOptions,
+  SignTransactionOptions,
   SignTypedDataOptions,
-  UpdateEvmAccountOptions,
-  ImportServerAccountOptions,
-  GetSwapPriceOptions,
-  CreateSwapQuoteOptions,
-  GetSwapPriceResult,
-  CreateSwapQuoteResult,
+  SmartAccount,
   SwapUnavailableResult,
+  UpdateEvmAccountOptions,
+  UserOperation,
+  WaitForUserOperationOptions,
 } from "./evm.types.js";
 import { toEvmServerAccount } from "../../accounts/evm/toEvmServerAccount.js";
 import { toEvmSmartAccount } from "../../accounts/evm/toEvmSmartAccount.js";
 import { getUserOperation } from "../../actions/evm/getUserOperation.js";
 import {
   listTokenBalances,
-  ListTokenBalancesResult,
   ListTokenBalancesOptions,
+  ListTokenBalancesResult,
 } from "../../actions/evm/listTokenBalances.js";
 import {
+  requestFaucet,
   RequestFaucetOptions,
   RequestFaucetResult,
-  requestFaucet,
 } from "../../actions/evm/requestFaucet.js";
 import { sendTransaction } from "../../actions/evm/sendTransaction.js";
 import {
@@ -62,10 +64,11 @@ import { Analytics } from "../../analytics.js";
 import { APIError } from "../../openapi-client/errors.js";
 import { CdpOpenApiClient } from "../../openapi-client/index.js";
 import { Hex } from "../../types/misc.js";
+import { decryptWithPrivateKey, generateExportEncryptionKeyPair } from "../../utils/export.js";
 
 import type {
-  TransactionResult,
   SendTransactionOptions,
+  TransactionResult,
 } from "../../actions/evm/sendTransaction.js";
 
 /**
@@ -212,6 +215,61 @@ export class EvmClient implements EvmClientInterface {
     }
   }
 
+  /**
+   * Exports a CDP EVM account's private key.
+   * It is important to store the private key in a secure place after it's exported.
+   *
+   * @param {ExportServerAccountOptions} options - Parameters for exporting the account.
+   * @param {string} [options.address] - The address of the account to export.
+   * @param {string} [options.name] - The name of the account to export.
+   * @param {string} [options.idempotencyKey] - An idempotency key.
+   *
+   * @returns A promise that resolves to the exported account’s 32-byte private key as a hex string, without the "0x" prefix.
+   *
+   * @example **With an address**
+   * ```ts
+   * const privateKey = await cdp.evm.exportAccount({
+   *   address: "0x1234567890123456789012345678901234567890",
+   * });
+   * ```
+   *
+   * @example **With a name**
+   * ```ts
+   * const privateKey = await cdp.evm.exportAccount({
+   *   name: "MyAccount",
+   * });
+   * ```
+   */
+  async exportAccount(options: ExportServerAccountOptions): Promise<string> {
+    const { publicKey, privateKey } = await generateExportEncryptionKeyPair();
+
+    const { encryptedPrivateKey } = await (async () => {
+      if (options.address) {
+        return CdpOpenApiClient.exportEvmAccount(
+          options.address,
+          {
+            exportEncryptionKey: publicKey,
+          },
+          options.idempotencyKey,
+        );
+      }
+
+      if (options.name) {
+        return CdpOpenApiClient.exportEvmAccountByName(
+          options.name,
+          {
+            exportEncryptionKey: publicKey,
+          },
+          options.idempotencyKey,
+        );
+      }
+
+      throw new Error("Either address or name must be provided");
+    })();
+
+    return decryptWithPrivateKey(privateKey, encryptedPrivateKey);
+  }
+
   /**
    * Creates a new CDP EVM smart account.
    *
@@ -261,6 +319,7 @@ export class EvmClient implements EvmClientInterface {
     const openApiSmartAccount = await CdpOpenApiClient.createEvmSmartAccount(
       {
         owners: [options.owner.address],
+        name: options.name,
       },
       options.idempotencyKey,
     );
@@ -326,7 +385,10 @@ export class EvmClient implements EvmClientInterface {
    * Gets a CDP EVM smart account.
    *
    * @param {GetSmartAccountOptions} options - Parameters for getting the smart account.
-   * @param {string} options.address - The address of the smart account to get.
+   * Either `address` or `name` must be provided.
+   * If both are provided, lookup will be done by `address` and `name` will be ignored.
+   * @param {string} [options.address] - The address of the smart account to get.
+   * @param {string} [options.name] - The name of the smart account to get.
    * @param {Account} options.owner - The owner of the smart account.
    * You must pass the signing-capable owner of the smart account so that the returned smart account
    * can be functional.
@@ -342,7 +404,14 @@ export class EvmClient implements EvmClientInterface {
    * ```
    */
   async getSmartAccount(options: GetSmartAccountOptions): Promise<SmartAccount> {
-    const openApiSmartAccount = await CdpOpenApiClient.getEvmSmartAccount(options.address);
+    const openApiSmartAccount = await (async () => {
+      if (options.address) {
+        return CdpOpenApiClient.getEvmSmartAccount(options.address);
+      } else if (options.name) {
+        return CdpOpenApiClient.getEvmSmartAccountByName(options.name);
+      }
+      throw new Error("Either address or name must be provided");
+    })();
 
     const smartAccount = toEvmSmartAccount(CdpOpenApiClient, {
       smartAccount: openApiSmartAccount,
@@ -395,6 +464,51 @@ export class EvmClient implements EvmClientInterface {
     }
   }
 
+  /**
+   * Gets a CDP EVM smart account, or creates one if it doesn't exist.
+   * This method first attempts to retrieve an existing smart account with the given parameters.
+   * If no account exists, it creates a new one with the specified owner.
+   *
+   * @param {GetOrCreateSmartAccountOptions} options - Configuration options for getting or creating the smart account.
+   * @param {string} [options.name] - The name of the smart account to get or create.
+   * @param {Account} options.owner - The owner of the smart account.
+   *
+   * @returns {Promise<SmartAccount>} A promise that resolves to the retrieved or newly created smart account.
+   *
+   * @example
+   * ```ts
+   * const smartAccount = await cdp.evm.getOrCreateSmartAccount({
+   *   name: "MySmartAccount",
+   *   owner: account,
+   * });
+   * ```
+   */
+  async getOrCreateSmartAccount(options: GetOrCreateSmartAccountOptions): Promise<SmartAccount> {
+    try {
+      const account = await this.getSmartAccount(options);
+      return account;
+    } catch (error) {
+      // If it failed because the account doesn't exist, create it
+      const doesAccountNotExist = error instanceof APIError && error.statusCode === 404;
+      if (doesAccountNotExist) {
+        try {
+          const account = await this.createSmartAccount(options);
+          return account;
+        } catch (error) {
+          // If it failed because the account already exists, throw an error
+          const doesAccountAlreadyExist = error instanceof APIError && error.statusCode === 409;
+          if (doesAccountAlreadyExist) {
+            const account = await this.getSmartAccount(options);
+            return account;
+          }
+          throw error;
+        }
+      }
+
+      throw error;
+    }
+  }
+
   /**
    * Gets the price for a swap between two tokens on an EVM network.
    *

package/client/evm/evm.types.ts

@@ -36,9 +36,12 @@ export type EvmClientInterface = Omit<
   | "createEvmAccount" // mapped to createAccount
   | "createEvmSmartAccount" // mapped to createSmartAccount
   | "importEvmAccount" // mapped to importAccount
+  | "exportEvmAccount" // mapped to exportAccount
+  | "exportEvmAccountByName" // mapped to exportAccount
   | "getEvmAccount" // mapped to getAccount
   | "getEvmAccountByName" // mapped to getAccount
   | "getEvmSmartAccount" // mapped to getSmartAccount
+  | "getEvmSmartAccountByName" // mapped to getSmartAccount
   | "getEvmSwapPrice" // mapped to getSwapPrice
   | "createEvmSwapQuote" // mapped to createSwapQuote
   | "getUserOperation"
@@ -56,10 +59,13 @@ export type EvmClientInterface = Omit<
   | "sendEvmTransaction" // mapped to sendTransaction
   | "signEvmTypedData" // mapped to signTypedData
   | "updateEvmAccount" // mapped to updateAccount
+  | "exportEvmAccount"
+  | "exportEvmAccountByName"
 > & {
   createAccount: (options: CreateServerAccountOptions) => Promise<ServerAccount>;
   createSmartAccount: (options: CreateSmartAccountOptions) => Promise<SmartAccount>;
   importAccount: (options: ImportServerAccountOptions) => Promise<ServerAccount>;
+  exportAccount: (options: ExportServerAccountOptions) => Promise<string>;
   getAccount: (options: GetServerAccountOptions) => Promise<ServerAccount>;
   getSmartAccount: (options: GetSmartAccountOptions) => Promise<SmartAccount>;
   getSwapPrice: (
@@ -321,6 +327,18 @@ export interface ImportServerAccountOptions {
   privateKey: Hex;
 }
 
+/**
+ * Options for exporting an EVM server account.
+ */
+export interface ExportServerAccountOptions {
+  /** The address of the account. */
+  address?: Address;
+  /** The name of the account. */
+  name?: string;
+  /** The idempotency key. */
+  idempotencyKey?: string;
+}
+
 /**
  * Options for getting an EVM account.
  */
@@ -336,9 +354,11 @@ export interface GetServerAccountOptions {
  */
 export interface GetSmartAccountOptions {
   /** The address of the account. */
-  address: Address;
+  address?: Address;
   /** The owner of the account. */
   owner: Account;
+  /** The name of the account. */
+  name?: string;
 }
 
 /**
@@ -349,6 +369,16 @@ export interface GetOrCreateServerAccountOptions {
   name: string;
 }
 
+/**
+ * Options for getting an EVM account, or creating one if it doesn't exist.
+ */
+export interface GetOrCreateSmartAccountOptions {
+  /** The name of the account. */
+  name: string;
+  /** The owner of the account. */
+  owner: Account;
+}
+
 /**
  * Options for listing EVM accounts.
  */
@@ -426,6 +456,8 @@ export interface CreateSmartAccountOptions {
   owner: Account;
   /** The idempotency key. */
   idempotencyKey?: string;
+  /** The name of the account. */
+  name?: string;
 }
 
 /**

package/client/solana/solana.ts

@@ -1,5 +1,6 @@
 import {
   CreateAccountOptions,
+  ExportAccountOptions,
   GetAccountOptions,
   GetOrCreateAccountOptions,
   ListAccountsOptions,
@@ -19,6 +20,11 @@ import { signTransaction } from "../../actions/solana/signTransaction.js";
 import { Analytics } from "../../analytics.js";
 import { APIError } from "../../openapi-client/errors.js";
 import { CdpOpenApiClient } from "../../openapi-client/index.js";
+import {
+  decryptWithPrivateKey,
+  formatSolanaPrivateKey,
+  generateExportEncryptionKeyPair,
+} from "../../utils/export.js";
 
 /**
  * The namespace containing all Solana methods.
@@ -72,6 +78,61 @@ export class SolanaClient implements SolanaClientInterface {
     return account;
   }
 
+  /**
+   * Exports a CDP Solana account's private key.
+   * It is important to store the private key in a secure place after it's exported.
+   *
+   * @param {ExportAccountOptions} options - Parameters for exporting the Solana account.
+   * @param {string} [options.address] - The address of the account.
+   * @param {string} [options.name] - The name of the account.
+   *
+   * @returns A promise that resolves to the exported account's full 64-byte private key as a base58 encoded string.
+   *
+   * @example **With an address**
+   * ```ts
+   * const privateKey = await cdp.solana.exportAccount({
+   *   address: "1234567890123456789012345678901234567890",
+   * });
+   * ```
+   *
+   * @example **With a name**
+   * ```ts
+   * const privateKey = await cdp.solana.exportAccount({
+   *   name: "MyAccount",
+   * });
+   * ```
+   */
+  async exportAccount(options: ExportAccountOptions): Promise<string> {
+    const { publicKey, privateKey } = await generateExportEncryptionKeyPair();
+
+    const { encryptedPrivateKey } = await (async () => {
+      if (options.address) {
+        return CdpOpenApiClient.exportSolanaAccount(
+          options.address,
+          {
+            exportEncryptionKey: publicKey,
+          },
+          options.idempotencyKey,
+        );
+      }
+
+      if (options.name) {
+        return CdpOpenApiClient.exportSolanaAccountByName(
+          options.name,
+          {
+            exportEncryptionKey: publicKey,
+          },
+          options.idempotencyKey,
+        );
+      }
+
+      throw new Error("Either address or name must be provided");
+    })();
+
+    const decryptedPrivateKey = decryptWithPrivateKey(privateKey, encryptedPrivateKey);
+    return formatSolanaPrivateKey(decryptedPrivateKey);
+  }
+
   /**
    * Gets a Solana account by its address.
    *

package/client/solana/solana.types.ts

@@ -15,8 +15,11 @@ export type SolanaClientInterface = Omit<
   | "signSolanaMessage" // mapped to signMessage
   | "signSolanaTransaction" // mapped to signTransaction
   | "updateSolanaAccount" // mapped to updateAccount
+  | "exportSolanaAccount" // mapped to exportAccount
+  | "exportSolanaAccountByName" // mapped to exportAccount
 > & {
   createAccount: (options: CreateAccountOptions) => Promise<Account>;
+  exportAccount: (options: ExportAccountOptions) => Promise<string>;
   getAccount: (options: GetAccountOptions) => Promise<Account>;
   getOrCreateAccount: (options: GetOrCreateAccountOptions) => Promise<Account>;
   updateAccount: (options: UpdateSolanaAccountOptions) => Promise<Account>;
@@ -46,6 +49,18 @@ export interface CreateAccountOptions {
   idempotencyKey?: string;
 }
 
+/**
+ * Options for exporting a Solana account.
+ */
+export interface ExportAccountOptions {
+  /** The address of the account. */
+  address?: string;
+  /** The name of the account. */
+  name?: string;
+  /** The idempotency key. */
+  idempotencyKey?: string;
+}
+
 /**
  * Options for getting a Solana account.
  */

package/openapi-client/cdpApiClient.ts

@@ -180,15 +180,30 @@ export const cdpApiClient = async <T>(
               `${ERROR_DOCS_PAGE_URL}`,
               error.cause,
             );
-          default:
+          default: {
+            let errorText = "";
+
+            if (error.response.data) {
+              try {
+                errorText = JSON.stringify(error.response.data);
+              } catch {
+                errorText = String(error.response.data);
+              }
+            }
+
+            const errorMessage = errorText
+              ? `An unexpected error occurred: ${errorText}`
+              : "An unexpected error occurred.";
+
             throw new APIError(
               statusCode,
               HttpErrorType.unexpected_error,
-              "An unexpected error occurred.",
+              errorMessage,
               undefined,
               `${ERROR_DOCS_PAGE_URL}`,
               error.cause,
             );
+          }
         }
       }
     }

package/openapi-client/generated/coinbaseDeveloperPlatformAPIs.schemas.ts

@@ -1258,8 +1258,8 @@ Account names must be unique across all EVM accounts in the developer's CDP Proj
    */
   name?: string;
   /**
-   * The ID of the account-level policy to apply to the account.
-   * @pattern ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
+   * The ID of the account-level policy to apply to the account, or an empty string to unset attached policy.
+   * @pattern (^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)|(^$)
    */
   accountPolicy?: string;
 };
@@ -1344,6 +1344,13 @@ export type ListEvmSmartAccounts200 = ListEvmSmartAccounts200AllOf & ListRespons
 export type CreateEvmSmartAccountBody = {
   /** Today, only a single owner can be set for a Smart Account, but this is an array to allow setting multiple owners in the future. */
   owners: string[];
+  /**
+   * An optional name for the account.
+Account names can consist of alphanumeric characters and hyphens, and be between 2 and 36 characters long.
+Account names must be unique across all EVM accounts in the developer's CDP Project.
+   * @pattern ^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
+   */
+  name?: string;
 };
 
 export type ImportEvmAccountBody = {
@@ -1358,6 +1365,26 @@ Account names must be unique across all EVM accounts in the developer's CDP Proj
   name?: string;
 };
 
+export type ExportEvmAccountBody = {
+  /** The base64-encoded, public part of the RSA key in DER format used to encrypt the account private key. */
+  exportEncryptionKey: string;
+};
+
+export type ExportEvmAccount200 = {
+  /** The base64-encoded, encrypted private key of the EVM account which is a 32 byte raw private key. The private key is encrypted in transport using the exportEncryptionKey in the request. */
+  encryptedPrivateKey: string;
+};
+
+export type ExportEvmAccountByNameBody = {
+  /** The base64-encoded, public part of the RSA key in DER format used to encrypt the account private key. */
+  exportEncryptionKey: string;
+};
+
+export type ExportEvmAccountByName200 = {
+  /** The base64-encoded, encrypted private key of the EVM account which is a 32 byte raw private key. The private key is encrypted in transport using the exportEncryptionKey in the request. */
+  encryptedPrivateKey: string;
+};
+
 /**
  * The network to prepare the user operation for.
  */
@@ -1463,6 +1490,7 @@ export type RequestEvmFaucetBodyNetwork =
 export const RequestEvmFaucetBodyNetwork = {
   "base-sepolia": "base-sepolia",
   "ethereum-sepolia": "ethereum-sepolia",
+  "ethereum-hoodi": "ethereum-hoodi",
 } as const;
 
 /**
@@ -1604,12 +1632,32 @@ Account names must be unique across all Solana accounts in the developer's CDP P
    */
   name?: string;
   /**
-   * The ID of the account-level policy to apply to the account.
-   * @pattern ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
+   * The ID of the account-level policy to apply to the account, or an empty string to unset attached policy.
+   * @pattern (^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)|(^$)
    */
   accountPolicy?: string;
 };
 
+export type ExportSolanaAccountBody = {
+  /** The base64-encoded, public part of the RSA key in DER format used to encrypt the account private key. */
+  exportEncryptionKey: string;
+};
+
+export type ExportSolanaAccount200 = {
+  /** The base64-encoded, encrypted private key of the Solana account which is a 32 byte raw private key. The private key is encrypted in transport using the exportEncryptionKey in the request. */
+  encryptedPrivateKey: string;
+};
+
+export type ExportSolanaAccountByNameBody = {
+  /** The base64-encoded, public part of the RSA key in DER format used to encrypt the account private key. */
+  exportEncryptionKey: string;
+};
+
+export type ExportSolanaAccountByName200 = {
+  /** The base64-encoded, encrypted private key of the Solana account which is a 32 byte raw private key. The private key is encrypted in transport using the exportEncryptionKey in the request. */
+  encryptedPrivateKey: string;
+};
+
 export type SignSolanaTransactionBody = {
   /** The base64 encoded transaction to sign. */
   transaction: string;