@coinbase/cdp-sdk 1.33.0 → 1.34.0

package/openapi-client/generated/onchain-data/onchain-data.ts

@@ -0,0 +1,103 @@
+/**
+ * Generated by orval v7.6.0 🍺
+ * Do not edit manually.
+ * Coinbase Developer Platform APIs
+ * The Coinbase Developer Platform APIs - leading the world's transition onchain.
+ * OpenAPI spec version: 2.0.0
+ */
+import type {
+  AccountTokenAddressesResponse,
+  ListDataTokenBalances200,
+  ListDataTokenBalancesParams,
+  ListEvmTokenBalancesNetwork,
+  OnchainDataQuery,
+  OnchainDataResult,
+} from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+
+import { cdpApiClient } from "../../cdpApiClient.js";
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+/**
+ * Run a read-only SQL query against indexed blockchain data including transactions, events, and decoded logs.
+
+This endpoint provides direct SQL access to comprehensive blockchain data across supported networks.
+Queries are executed against optimized data structures for high-performance analytics.
+
+### Allowed Queries
+
+  - Standard SQL syntax (ClickHouse dialect)
+  - Read-only queries (SELECT statements)
+  - No DDL or DML operations
+  - No cartesian products
+
+### Supported Tables
+
+  - `base.events` - Base mainnet decoded event logs with parameters, event signature, topics, and more.
+  - `base.transactions` - Base mainnet transaction data including hash, block number, gas usage.
+  - `base.blocks` - Base mainnet block information.
+  - `base.encoded_logs` - Encoded log data of event logs that aren't able to be decoded by our event decoder (ex: log0 opcode).
+  - `base.transfers` - All event logs with event signature `Transfer(address,address,uint256)`. ERC-20, ERC-721, and ERC-1155 transfers are all included.
+
+### Query Limits
+
+  - Maximum result set: 10,000 rows
+  - Query timeout: 30 seconds
+  - Maximum JOINs: 5
+
+ * @summary Run SQL Query
+ */
+export const runSQLQuery = (
+  onchainDataQuery: OnchainDataQuery,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<OnchainDataResult>(
+    {
+      url: `/v2/data/query/run`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: onchainDataQuery,
+    },
+    options,
+  );
+};
+/**
+ * Retrieve all ERC-20 token contract addresses that an account has ever received tokens from. 
+Analyzes transaction history to discover token interactions.
+
+ * @summary List token addresses for account
+ */
+export const listTokensForAccount = (
+  network: "base" | "base-sepolia",
+  address: string,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<AccountTokenAddressesResponse>(
+    { url: `/v2/data/evm/token-ownership/${network}/${address}`, method: "GET" },
+    options,
+  );
+};
+/**
+ * Lists the token balances of an EVM address on a given network. The balances include ERC-20 tokens and the native gas token (usually ETH). The response is paginated, and by default, returns 20 balances per page.
+
+**Note:** This endpoint provides <1 second freshness from chain tip, <500ms response latency for wallets with reasonable token history, and 99.9% uptime for production use.
+ * @summary List EVM token balances
+ */
+export const listDataTokenBalances = (
+  network: ListEvmTokenBalancesNetwork,
+  address: string,
+  params?: ListDataTokenBalancesParams,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<ListDataTokenBalances200>(
+    { url: `/v2/data/evm/token-balances/${network}/${address}`, method: "GET", params },
+    options,
+  );
+};
+export type RunSQLQueryResult = NonNullable<Awaited<ReturnType<typeof runSQLQuery>>>;
+export type ListTokensForAccountResult = NonNullable<
+  Awaited<ReturnType<typeof listTokensForAccount>>
+>;
+export type ListDataTokenBalancesResult = NonNullable<
+  Awaited<ReturnType<typeof listDataTokenBalances>>
+>;

package/openapi-client/generated/policy-engine/policy-engine.msw.ts

@@ -180,7 +180,18 @@ export const getListPoliciesResponseEvmNetworkCriterionMock = (
 ): EvmNetworkCriterion => ({
   ...{
     type: faker.helpers.arrayElement(["evmNetwork"] as const),
-    networks: faker.helpers.arrayElements(["base-sepolia", "base"] as const),
+    networks: faker.helpers.arrayElements([
+      "base-sepolia",
+      "base",
+      "ethereum",
+      "ethereum-sepolia",
+      "avalanche",
+      "polygon",
+      "optimism",
+      "arbitrum",
+      "zora",
+      "bnb",
+    ] as const),
     operator: faker.helpers.arrayElement(["in", "not in"] as const),
   },
   ...overrideResponse,
@@ -618,7 +629,18 @@ export const getCreatePolicyResponseEvmNetworkCriterionMock = (
 ): EvmNetworkCriterion => ({
   ...{
     type: faker.helpers.arrayElement(["evmNetwork"] as const),
-    networks: faker.helpers.arrayElements(["base-sepolia", "base"] as const),
+    networks: faker.helpers.arrayElements([
+      "base-sepolia",
+      "base",
+      "ethereum",
+      "ethereum-sepolia",
+      "avalanche",
+      "polygon",
+      "optimism",
+      "arbitrum",
+      "zora",
+      "bnb",
+    ] as const),
     operator: faker.helpers.arrayElement(["in", "not in"] as const),
   },
   ...overrideResponse,
@@ -1047,7 +1069,18 @@ export const getGetPolicyByIdResponseEvmNetworkCriterionMock = (
 ): EvmNetworkCriterion => ({
   ...{
     type: faker.helpers.arrayElement(["evmNetwork"] as const),
-    networks: faker.helpers.arrayElements(["base-sepolia", "base"] as const),
+    networks: faker.helpers.arrayElements([
+      "base-sepolia",
+      "base",
+      "ethereum",
+      "ethereum-sepolia",
+      "avalanche",
+      "polygon",
+      "optimism",
+      "arbitrum",
+      "zora",
+      "bnb",
+    ] as const),
     operator: faker.helpers.arrayElement(["in", "not in"] as const),
   },
   ...overrideResponse,
@@ -1476,7 +1509,18 @@ export const getUpdatePolicyResponseEvmNetworkCriterionMock = (
 ): EvmNetworkCriterion => ({
   ...{
     type: faker.helpers.arrayElement(["evmNetwork"] as const),
-    networks: faker.helpers.arrayElements(["base-sepolia", "base"] as const),
+    networks: faker.helpers.arrayElements([
+      "base-sepolia",
+      "base",
+      "ethereum",
+      "ethereum-sepolia",
+      "avalanche",
+      "polygon",
+      "optimism",
+      "arbitrum",
+      "zora",
+      "bnb",
+    ] as const),
     operator: faker.helpers.arrayElement(["in", "not in"] as const),
   },
   ...overrideResponse,

package/openapi-client/index.ts

@@ -9,6 +9,7 @@ export * from "./generated/faucets/faucets.js";
 export * from "./generated/policy-engine/policy-engine.js";
 export * from "./generated/payments-alpha/payments-alpha.js";
 export * from "./generated/onramp/onramp.js";
+export * from "./generated/onchain-data/onchain-data.js";
 
 import { configure } from "./cdpApiClient.js";
 import * as evm from "./generated/evm-accounts/evm-accounts.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cdp-sdk",
-  "version": "1.33.0",
+  "version": "1.34.0",
   "description": "SDK for interacting with the Coinbase Developer Platform Wallet API",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",

package/spend-permissions/types.ts

@@ -1,3 +1,4 @@
+import type { SpendPermissionNetwork } from "../openapi-client/index.js";
 import type { Address, Hex } from "../types/misc.js";
 
 /**
@@ -24,19 +25,48 @@ export type SpendPermission = {
   extraData: Hex;
 };
 
-/**
- * Networks that the SpendPermissionManager contract supports.
- * From https://github.com/coinbase/spend-permissions/blob/main/README.md#deployments
- */
-export type SpendPermissionNetworks =
-  | "base"
-  | "base-sepolia"
-  | "ethereum"
-  | "ethereum-sepolia"
-  | "optimism"
-  | "optimism-sepolia"
-  | "arbitrum"
-  | "avalanche"
-  | "binance"
-  | "polygon"
-  | "zora";
+export type SpendPermissionInput = Omit<
+  SpendPermission,
+  "token" | "salt" | "extraData" | "period" | "start" | "end"
+> & {
+  token: "eth" | "usdc" | Address;
+  salt?: bigint;
+  extraData?: Hex;
+  period?: number;
+  periodInDays?: number;
+  start?: Date;
+  end?: Date;
+};
+
+export interface CreateSpendPermissionOptions {
+  /** The spend permission. */
+  spendPermission: SpendPermissionInput;
+  /** The network. */
+  network: SpendPermissionNetwork;
+  /** The paymaster URL. */
+  paymasterUrl?: string;
+  /** The idempotency key. */
+  idempotencyKey?: string;
+}
+
+export interface ListSpendPermissionsOptions {
+  /** The address of the smart account. */
+  address: Address;
+  /** The page size to paginate through the spend permissions. */
+  pageSize?: number;
+  /** The page token to paginate through the spend permissions. */
+  pageToken?: string;
+}
+
+export interface RevokeSpendPermissionOptions {
+  /** The address of the smart account. */
+  address: Address;
+  /** The hash of the spend permission to revoke. */
+  permissionHash: Hex;
+  /** The network. */
+  network: SpendPermissionNetwork;
+  /** The paymaster URL. */
+  paymasterUrl?: string;
+  /** The idempotency key. */
+  idempotencyKey?: string;
+}

package/spend-permissions/utils.ts

@@ -0,0 +1,35 @@
+import { getErc20Address } from "../actions/evm/transfer/utils.js";
+import { UserInputValidationError } from "../errors.js";
+
+import type { Network } from "../actions/evm/transfer/types.js";
+import type { SpendPermissionNetwork } from "../openapi-client/index.js";
+import type { Address } from "../types/misc.js";
+
+/**
+ * Resolve the address of a token for a given network.
+ *
+ * @param token - The token symbol or contract address.
+ * @param network - The network to get the address for.
+ *
+ * @returns The address of the token.
+ */
+export function resolveTokenAddress(
+  token: "eth" | "usdc" | Address,
+  network: SpendPermissionNetwork,
+): Address {
+  if (token === "eth") {
+    return "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+  }
+
+  if (token === "usdc" && (network === "base" || network === "base-sepolia")) {
+    return getErc20Address(token, network as Network);
+  }
+
+  if (token === "usdc") {
+    throw new UserInputValidationError(
+      `Automatic token address lookup for ${token} is not supported on ${network}. Please provide the token address manually.`,
+    );
+  }
+
+  return token;
+}

package/version.ts

@@ -1 +1 @@
-export const version = "1.33.0";
+export const version = "1.34.0";