@coinbase/cdp-sdk 1.9.0 → 1.11.0

package/client/evm/evm.types.ts

@@ -34,6 +34,7 @@ export type EvmClientInterface = Omit<
   typeof OpenApiEvmMethods,
   | "createEvmAccount" // mapped to createAccount
   | "createEvmSmartAccount" // mapped to createSmartAccount
+  | "importEvmAccount" // mapped to importAccount
   | "getEvmAccount" // mapped to getAccount
   | "getEvmAccountByName" // mapped to getAccount
   | "getEvmSmartAccount" // mapped to getSmartAccount
@@ -55,6 +56,7 @@ export type EvmClientInterface = Omit<
 > & {
   createAccount: (options: CreateServerAccountOptions) => Promise<ServerAccount>;
   createSmartAccount: (options: CreateSmartAccountOptions) => Promise<SmartAccount>;
+  importAccount: (options: ImportServerAccountOptions) => Promise<ServerAccount>;
   getAccount: (options: GetServerAccountOptions) => Promise<ServerAccount>;
   getSmartAccount: (options: GetSmartAccountOptions) => Promise<SmartAccount>;
   getOrCreateAccount: (options: GetOrCreateServerAccountOptions) => Promise<ServerAccount>;
@@ -143,10 +145,24 @@ export interface UserOperation {
 export interface CreateServerAccountOptions {
   /** The name of the account. */
   name?: string;
+  /** The policy ID to apply to the account. */
+  accountPolicy?: string;
   /** The idempotency key. */
   idempotencyKey?: string;
 }
 
+/**
+ * Options for importing an EVM server account.
+ */
+export interface ImportServerAccountOptions {
+  /** The name of the account. */
+  name?: string;
+  /** The idempotency key. */
+  idempotencyKey?: string;
+  /** The private key of the account. */
+  privateKey: Hex;
+}
+
 /**
  * Options for getting an EVM account.
  */

package/client/solana/solana.ts

@@ -56,7 +56,10 @@ export class SolanaClient implements SolanaClientInterface {
    */
   async createAccount(options: CreateAccountOptions = {}): Promise<SolanaAccount> {
     const openApiAccount = await CdpOpenApiClient.createSolanaAccount(
-      options,
+      {
+        name: options.name,
+        accountPolicy: options.accountPolicy,
+      },
       options.idempotencyKey,
     );
 

package/client/solana/solana.types.ts

@@ -40,6 +40,8 @@ export interface SignatureResult {
 export interface CreateAccountOptions {
   /** The name of the account. */
   name?: string;
+  /** The policy ID to apply to the account. */
+  accountPolicy?: string;
   /** The idempotency key. */
   idempotencyKey?: string;
 }

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

@@ -578,6 +578,236 @@ Account names are guaranteed to be unique across all Solana accounts in the deve
   policies?: string[];
 }
 
+/**
+ * The action of the payment method.
+ */
+export type PaymentRailAction = (typeof PaymentRailAction)[keyof typeof PaymentRailAction];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const PaymentRailAction = {
+  source: "source",
+  target: "target",
+} as const;
+
+/**
+ * The type of payment method.
+ */
+export type PaymentMethodType = (typeof PaymentMethodType)[keyof typeof PaymentMethodType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const PaymentMethodType = {
+  card: "card",
+  fiat_account: "fiat_account",
+} as const;
+
+/**
+ * The limit for this payment method being used as a source for transfers.
+ */
+export type PaymentMethodLimitsSourceLimit = {
+  /** The amount of the limit. */
+  amount?: string;
+  /** The currency of the limit. */
+  currency?: string;
+};
+
+/**
+ * The limit for this payment method being used as a target for transfers.
+ */
+export type PaymentMethodLimitsTargetLimit = {
+  /** The amount of the limit. */
+  amount?: string;
+  /** The currency of the limit. */
+  currency?: string;
+};
+
+/**
+ * The limits of the payment method.
+ */
+export type PaymentMethodLimits = {
+  /** The limit for this payment method being used as a source for transfers. */
+  sourceLimit?: PaymentMethodLimitsSourceLimit;
+  /** The limit for this payment method being used as a target for transfers. */
+  targetLimit?: PaymentMethodLimitsTargetLimit;
+};
+
+/**
+ * The fiat payment method object.
+ */
+export interface PaymentMethod {
+  /**
+   * The ID of the payment method which previously was added.
+   * @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}$
+   */
+  id: string;
+  /** The type of payment method. */
+  type: PaymentMethodType;
+  /** The currency of the payment method. */
+  currency: string;
+  /** The actions for the payment method. */
+  actions: PaymentRailAction[];
+  /** The limits of the payment method. */
+  limits?: PaymentMethodLimits;
+}
+
+/**
+ * The networks of the asset.
+ */
+export type CryptoRailNetworksItem = {
+  /** The name of the network. */
+  name?: string;
+  /** The chain ID of the network. */
+  chainId?: number;
+  /** The contract address of the asset on the network. */
+  contractAddress?: string;
+};
+
+/**
+ * The crypto rails available.
+ */
+export interface CryptoRail {
+  /** The currency symbol of the asset. */
+  currency: string;
+  /** The name of the asset. */
+  name: string;
+  /** All available networks of the asset. */
+  networks: CryptoRailNetworksItem[];
+  /** The actions for the crypto rail. */
+  actions: PaymentRailAction[];
+}
+
+/**
+ * The fiat payment method request object.
+ */
+export interface PaymentMethodRequest {
+  /**
+   * The ID of the payment method.
+   * @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}$
+   */
+  id: string;
+}
+
+/**
+ * The source of the transfer.
+ */
+export type TransferSource = PaymentMethodRequest;
+
+/**
+ * The crypto rail input object which specifies the symbol, network, and address which is the source or destination wallet address.
+ */
+export interface CryptoRailAddress {
+  /** The symbol of the currency of the payment rail. */
+  currency: string;
+  /** The network of the payment rail. */
+  network: string;
+  /** The address of the payment rail. This is the source or destination wallet address. It is not a contract address. */
+  address: string;
+}
+
+/**
+ * The target of the transfer.
+ */
+export type TransferTarget = CryptoRailAddress;
+
+/**
+ * The type of fee.
+ */
+export type FeeType = (typeof FeeType)[keyof typeof FeeType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const FeeType = {
+  exchange_fee: "exchange_fee",
+  network_fee: "network_fee",
+} as const;
+
+/**
+ * The fee for the transfer.
+ */
+export interface Fee {
+  /** The type of fee. */
+  type: FeeType;
+  /** The amount of the fee. */
+  amount: string;
+  /** The currency of the fee. */
+  currency: string;
+  /** The description of the fee. */
+  description?: string;
+}
+
+/**
+ * The type of the source of the transfer.
+ */
+export type TransferSourceType = (typeof TransferSourceType)[keyof typeof TransferSourceType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const TransferSourceType = {
+  payment_method: "payment_method",
+} as const;
+
+/**
+ * The type of the target of the transfer.
+ */
+export type TransferTargetType = (typeof TransferTargetType)[keyof typeof TransferTargetType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const TransferTargetType = {
+  crypto_rail: "crypto_rail",
+} as const;
+
+/**
+ * The status of the transfer.
+ */
+export type TransferStatus = (typeof TransferStatus)[keyof typeof TransferStatus];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const TransferStatus = {
+  created: "created",
+  pending: "pending",
+  started: "started",
+  completed: "completed",
+  failed: "failed",
+} as const;
+
+/**
+ * The transfer object.
+ */
+export interface Transfer {
+  /**
+   * The ID of the transfer.
+   * @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}$
+   */
+  id: string;
+  /** The type of the source of the transfer. */
+  sourceType: TransferSourceType;
+  /** The source of the transfer. */
+  source: PaymentMethodRequest;
+  /** The type of the target of the transfer. */
+  targetType: TransferTargetType;
+  /** The target of the transfer. */
+  target: CryptoRailAddress;
+  /** The amount the source will transfer. */
+  sourceAmount: string;
+  /** The currency the source will transfer. */
+  sourceCurrency: string;
+  /** The amount the target will receive. */
+  targetAmount: string;
+  /** The currency the target will receive. */
+  targetCurrency: string;
+  /** The amount the customer put in to transfer. */
+  userAmount: string;
+  /** The currency the customer put in to transfer. */
+  userCurrency: string;
+  /** The fees for the transfer. */
+  fees: Fee[];
+  /** The status of the transfer. */
+  status: TransferStatus;
+  /** The UTC date and time in ISO 8601 format the transfer was created. */
+  createdAt: string;
+  /** The UTC date and time in ISO 8601 format the transfer was updated. */
+  updatedAt: string;
+  /** The transaction hash or transaction signature of the transfer. */
+  transactionHash?: string;
+}
+
 /**
  * Internal server error.
  */
@@ -645,6 +875,11 @@ Account names must be unique across all EVM accounts in the developer's CDP Proj
    * @pattern ^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
    */
   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}$
+   */
+  accountPolicy?: string;
 };
 
 export type UpdateEvmAccountBody = {
@@ -744,6 +979,18 @@ export type CreateEvmSmartAccountBody = {
   owners: string[];
 };
 
+export type ImportEvmAccountBody = {
+  /** The base64-encoded, encrypted private key of the EVM account. The private key must be encrypted using the CDP SDK's encryption scheme. */
+  encryptedPrivateKey: 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;
+};
+
 /**
  * The network to prepare the user operation for.
  */
@@ -924,6 +1171,11 @@ Account names must be unique across all Solana accounts in the developer's CDP P
    * @pattern ^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$
    */
   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}$
+   */
+  accountPolicy?: string;
 };
 
 export type UpdateSolanaAccountBody = {
@@ -986,3 +1238,51 @@ export type RequestSolanaFaucet200 = {
   /** The signature identifying the transaction that requested the funds. */
   transactionSignature: string;
 };
+
+export type GetCryptoRailsParams = {
+  /**
+   * Comma separated list of networks to filter the rails by.
+   */
+  networks?: string;
+};
+
+/**
+ * The type of the source of the transfer.
+ */
+export type CreatePaymentTransferQuoteBodySourceType =
+  (typeof CreatePaymentTransferQuoteBodySourceType)[keyof typeof CreatePaymentTransferQuoteBodySourceType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const CreatePaymentTransferQuoteBodySourceType = {
+  payment_method: "payment_method",
+} as const;
+
+/**
+ * The type of the target of the transfer.
+ */
+export type CreatePaymentTransferQuoteBodyTargetType =
+  (typeof CreatePaymentTransferQuoteBodyTargetType)[keyof typeof CreatePaymentTransferQuoteBodyTargetType];
+
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const CreatePaymentTransferQuoteBodyTargetType = {
+  crypto_rail: "crypto_rail",
+} as const;
+
+export type CreatePaymentTransferQuoteBody = {
+  /** The type of the source of the transfer. */
+  sourceType: CreatePaymentTransferQuoteBodySourceType;
+  source: TransferSource;
+  /** The type of the target of the transfer. */
+  targetType: CreatePaymentTransferQuoteBodyTargetType;
+  target: TransferTarget;
+  /** The amount of the transfer, which is either for the source currency to buy, or the target currency to receive. */
+  amount: string;
+  /** The currency of the transfer. This can be specified as the source currency, which would be used to buy, or else the target currency, which is how much will be received. */
+  currency: string;
+  /** Whether to execute the transfer. If true, the transfer will be committed and executed. If false, the quote will be generated and returned. */
+  execute?: boolean;
+};
+
+export type CreatePaymentTransferQuote201 = {
+  transfer: Transfer;
+};

package/openapi-client/generated/evm-accounts/evm-accounts.msw.ts

@@ -138,6 +138,25 @@ export const getSignEvmTypedDataResponseMock = (
   overrideResponse: Partial<SignEvmTypedData200> = {},
 ): SignEvmTypedData200 => ({ signature: faker.string.alpha(20), ...overrideResponse });
 
+export const getImportEvmAccountResponseMock = (
+  overrideResponse: Partial<EvmAccount> = {},
+): EvmAccount => ({
+  address: faker.helpers.fromRegExp("^0x[0-9a-fA-F]{40}$"),
+  name: faker.helpers.arrayElement([
+    faker.helpers.fromRegExp("^[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$"),
+    undefined,
+  ]),
+  policies: faker.helpers.arrayElement([
+    Array.from({ length: faker.number.int({ min: 1, max: 10 }) }, (_, i) => i + 1).map(() =>
+      faker.helpers.fromRegExp(
+        "^[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}$",
+      ),
+    ),
+    undefined,
+  ]),
+  ...overrideResponse,
+});
+
 export const getListEvmAccountsMockHandler = (
   overrideResponse?:
     | ListEvmAccounts200
@@ -359,6 +378,27 @@ export const getSignEvmTypedDataMockHandler = (
     );
   });
 };
+
+export const getImportEvmAccountMockHandler = (
+  overrideResponse?:
+    | EvmAccount
+    | ((info: Parameters<Parameters<typeof http.post>[1]>[0]) => Promise<EvmAccount> | EvmAccount),
+) => {
+  return http.post("*/v2/evm/accounts/import", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getImportEvmAccountResponseMock(),
+      ),
+      { status: 201, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
 export const getEvmAccountsMock = () => [
   getListEvmAccountsMockHandler(),
   getCreateEvmAccountMockHandler(),
@@ -370,4 +410,5 @@ export const getEvmAccountsMock = () => [
   getSignEvmHashMockHandler(),
   getSignEvmMessageMockHandler(),
   getSignEvmTypedDataMockHandler(),
+  getImportEvmAccountMockHandler(),
 ];

package/openapi-client/generated/evm-accounts/evm-accounts.ts

@@ -9,6 +9,7 @@ import type {
   CreateEvmAccountBody,
   EIP712Message,
   EvmAccount,
+  ImportEvmAccountBody,
   ListEvmAccounts200,
   ListEvmAccountsParams,
   SendEvmTransaction200,
@@ -223,6 +224,24 @@ export const signEvmTypedData = (
     options,
   );
 };
+/**
+ * Import an existing EVM account into the developer's CDP Project. This API should be called from the [CDP SDK](https://github.com/coinbase/cdp-sdk) to ensure that the associated private key is properly encrypted.
+ * @summary Import an EVM account
+ */
+export const importEvmAccount = (
+  importEvmAccountBody: ImportEvmAccountBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<EvmAccount>(
+    {
+      url: `/v2/evm/accounts/import`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: importEvmAccountBody,
+    },
+    options,
+  );
+};
 export type ListEvmAccountsResult = NonNullable<Awaited<ReturnType<typeof listEvmAccounts>>>;
 export type CreateEvmAccountResult = NonNullable<Awaited<ReturnType<typeof createEvmAccount>>>;
 export type GetEvmAccountResult = NonNullable<Awaited<ReturnType<typeof getEvmAccount>>>;
@@ -235,3 +254,4 @@ export type SignEvmTransactionResult = NonNullable<Awaited<ReturnType<typeof sig
 export type SignEvmHashResult = NonNullable<Awaited<ReturnType<typeof signEvmHash>>>;
 export type SignEvmMessageResult = NonNullable<Awaited<ReturnType<typeof signEvmMessage>>>;
 export type SignEvmTypedDataResult = NonNullable<Awaited<ReturnType<typeof signEvmTypedData>>>;
+export type ImportEvmAccountResult = NonNullable<Awaited<ReturnType<typeof importEvmAccount>>>;

package/openapi-client/generated/index.msw.ts

@@ -1,6 +1,7 @@
+export * from "./evm-token-balances/evm-token-balances.msw.js";
+export * from "./evm-accounts/evm-accounts.msw.js";
 export * from "./faucets/faucets.msw.js";
+export * from "./solana-accounts/solana-accounts.msw.js";
+export * from "./payments-alpha/payments-alpha.msw.js";
 export * from "./policy-engine/policy-engine.msw.js";
-export * from "./evm-accounts/evm-accounts.msw.js";
 export * from "./evm-smart-accounts/evm-smart-accounts.msw.js";
-export * from "./evm-token-balances/evm-token-balances.msw.js";
-export * from "./solana-accounts/solana-accounts.msw.js";