@coinbase/cdp-sdk 1.34.0 → 1.35.0

package/openapi-client/generated/x402-facilitator/x402-facilitator.msw.ts

@@ -0,0 +1,136 @@
+/**
+ * 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 { faker } from "@faker-js/faker";
+
+import { HttpResponse, delay, http } from "msw";
+
+import {
+  X402SettleErrorReason,
+  X402VerifyInvalidReason,
+  X402Version,
+} from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+import type {
+  X402SettleResponseResponse,
+  X402SupportedPaymentKindsResponseResponse,
+  X402VerifyResponseResponse,
+} from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+
+export const getVerifyX402PaymentResponseMock = (
+  overrideResponse: Partial<X402VerifyResponseResponse> = {},
+): X402VerifyResponseResponse => ({
+  isValid: faker.datatype.boolean(),
+  invalidReason: faker.helpers.arrayElement([
+    faker.helpers.arrayElement(Object.values(X402VerifyInvalidReason)),
+    undefined,
+  ]),
+  payer: faker.helpers.fromRegExp("^0x[a-fA-F0-9]{40}|[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$"),
+  ...overrideResponse,
+});
+
+export const getSettleX402PaymentResponseMock = (
+  overrideResponse: Partial<X402SettleResponseResponse> = {},
+): X402SettleResponseResponse => ({
+  success: faker.datatype.boolean(),
+  errorReason: faker.helpers.arrayElement([
+    faker.helpers.arrayElement(Object.values(X402SettleErrorReason)),
+    undefined,
+  ]),
+  payer: faker.helpers.fromRegExp("^0x[a-fA-F0-9]{40}|[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$"),
+  transaction: faker.helpers.fromRegExp(
+    "^0x[a-fA-F0-9]{40}|[A-Za-z0-9][A-Za-z0-9-]{0,34}[A-Za-z0-9]$",
+  ),
+  network: faker.string.alpha(20),
+  ...overrideResponse,
+});
+
+export const getSupportedX402PaymentKindsResponseMock = (
+  overrideResponse: Partial<X402SupportedPaymentKindsResponseResponse> = {},
+): X402SupportedPaymentKindsResponseResponse => ({
+  kinds: Array.from({ length: faker.number.int({ min: 1, max: 10 }) }, (_, i) => i + 1).map(() => ({
+    x402Version: faker.helpers.arrayElement(Object.values(X402Version)),
+    scheme: faker.helpers.arrayElement(["exact"] as const),
+    network: faker.helpers.arrayElement(["base-sepolia", "base"] as const),
+  })),
+  ...overrideResponse,
+});
+
+export const getVerifyX402PaymentMockHandler = (
+  overrideResponse?:
+    | X402VerifyResponseResponse
+    | ((
+        info: Parameters<Parameters<typeof http.post>[1]>[0],
+      ) => Promise<X402VerifyResponseResponse> | X402VerifyResponseResponse),
+) => {
+  return http.post("*/v2/x402/verify", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getVerifyX402PaymentResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+
+export const getSettleX402PaymentMockHandler = (
+  overrideResponse?:
+    | X402SettleResponseResponse
+    | ((
+        info: Parameters<Parameters<typeof http.post>[1]>[0],
+      ) => Promise<X402SettleResponseResponse> | X402SettleResponseResponse),
+) => {
+  return http.post("*/v2/x402/settle", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getSettleX402PaymentResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+
+export const getSupportedX402PaymentKindsMockHandler = (
+  overrideResponse?:
+    | X402SupportedPaymentKindsResponseResponse
+    | ((
+        info: Parameters<Parameters<typeof http.get>[1]>[0],
+      ) =>
+        | Promise<X402SupportedPaymentKindsResponseResponse>
+        | X402SupportedPaymentKindsResponseResponse),
+) => {
+  return http.get("*/v2/x402/supported", async info => {
+    await delay(0);
+
+    return new HttpResponse(
+      JSON.stringify(
+        overrideResponse !== undefined
+          ? typeof overrideResponse === "function"
+            ? await overrideResponse(info)
+            : overrideResponse
+          : getSupportedX402PaymentKindsResponseMock(),
+      ),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    );
+  });
+};
+export const getX402FacilitatorMock = () => [
+  getVerifyX402PaymentMockHandler(),
+  getSettleX402PaymentMockHandler(),
+  getSupportedX402PaymentKindsMockHandler(),
+];

package/openapi-client/generated/x402-facilitator/x402-facilitator.ts

@@ -0,0 +1,70 @@
+/**
+ * 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 {
+  SettleX402PaymentBody,
+  VerifyX402PaymentBody,
+  X402SettleResponseResponse,
+  X402SupportedPaymentKindsResponseResponse,
+  X402VerifyResponseResponse,
+} from "../coinbaseDeveloperPlatformAPIs.schemas.js";
+
+import { cdpApiClient } from "../../cdpApiClient.js";
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+/**
+ * Verify an x402 protocol payment with a specific scheme and network.
+ * @summary Verify a payment
+ */
+export const verifyX402Payment = (
+  verifyX402PaymentBody: VerifyX402PaymentBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<X402VerifyResponseResponse>(
+    {
+      url: `/v2/x402/verify`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: verifyX402PaymentBody,
+    },
+    options,
+  );
+};
+/**
+ * Settle an x402 protocol payment with a specific scheme and network.
+ * @summary Settle a payment
+ */
+export const settleX402Payment = (
+  settleX402PaymentBody: SettleX402PaymentBody,
+  options?: SecondParameter<typeof cdpApiClient>,
+) => {
+  return cdpApiClient<X402SettleResponseResponse>(
+    {
+      url: `/v2/x402/settle`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      data: settleX402PaymentBody,
+    },
+    options,
+  );
+};
+/**
+ * Get the supported x402 protocol payment schemes and networks that the facilitator is able to verify and settle payments for.
+ * @summary Get supported payment schemes and networks
+ */
+export const supportedX402PaymentKinds = (options?: SecondParameter<typeof cdpApiClient>) => {
+  return cdpApiClient<X402SupportedPaymentKindsResponseResponse>(
+    { url: `/v2/x402/supported`, method: "GET" },
+    options,
+  );
+};
+export type VerifyX402PaymentResult = NonNullable<Awaited<ReturnType<typeof verifyX402Payment>>>;
+export type SettleX402PaymentResult = NonNullable<Awaited<ReturnType<typeof settleX402Payment>>>;
+export type SupportedX402PaymentKindsResult = NonNullable<
+  Awaited<ReturnType<typeof supportedX402PaymentKinds>>
+>;

package/openapi-client/index.ts

@@ -10,13 +10,17 @@ 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";
+export * from "./generated/end-user-accounts/end-user-accounts.js";
+export * from "./generated/x402-facilitator/x402-facilitator.js";
 
 import { configure } from "./cdpApiClient.js";
+import * as endUserAccounts from "./generated/end-user-accounts/end-user-accounts.js";
 import * as evm from "./generated/evm-accounts/evm-accounts.js";
 import * as evmSmartAccounts from "./generated/evm-smart-accounts/evm-smart-accounts.js";
 import * as evmSwaps from "./generated/evm-swaps/evm-swaps.js";
 import * as evmTokenBalances from "./generated/evm-token-balances/evm-token-balances.js";
 import * as faucets from "./generated/faucets/faucets.js";
+import * as onchainData from "./generated/onchain-data/onchain-data.js";
 import * as payments from "./generated/payments-alpha/payments-alpha.js";
 import * as policies from "./generated/policy-engine/policy-engine.js";
 import * as solana from "./generated/solana-accounts/solana-accounts.js";
@@ -30,8 +34,10 @@ export const CdpOpenApiClient = {
   ...solana,
   ...solanaTokenBalances,
   ...faucets,
+  ...onchainData,
   ...policies,
   ...payments,
+  ...endUserAccounts,
   configure,
 };
 

package/package.json

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

package/policies/evmSchema.ts

@@ -69,25 +69,71 @@ export const EvmAddressCriterionSchema = z.object({
 export type EvmAddressCriterion = z.infer<typeof EvmAddressCriterionSchema>;
 
 /**
- * Enum for EVM Network values
+ * Enum for  PrepareUserOperation EVM Network values
+ */
+export const PrepareUserOperationEvmNetworkEnum = z.enum([
+  "base-sepolia",
+  "base",
+  "arbitrum",
+  "optimism",
+  "zora",
+  "polygon",
+  "bnb",
+  "avalanche",
+  "ethereum",
+  "ethereum-sepolia",
+]);
+
+export type PrepareUserOperationEvmNetwork = z.infer<typeof PrepareUserOperationEvmNetworkEnum>;
+
+/**
+ * Enum for SendEvmTransaction EVM Network values
  */
-export const EvmNetworkEnum = z.enum(["base", "base-sepolia"]);
+export const SendEvmTransactionEvmNetworkEnum = z.enum([
+  "base",
+  "base-sepolia",
+  "ethereum",
+  "ethereum-sepolia",
+  "avalanche",
+  "polygon",
+  "optimism",
+  "arbitrum",
+]);
+
 /**
  * Type representing the valid networks used with CDP transaction API's.
  */
-export type EvmNetwork = z.infer<typeof EvmNetworkEnum>;
+export type EvmNetwork = z.ZodUnion<
+  [typeof SendEvmTransactionEvmNetworkEnum, typeof PrepareUserOperationEvmNetworkEnum]
+>;
 
 /**
  * Schema for EVM network criterions
  */
-export const EvmNetworkCriterionSchema = z.object({
+export const SendEvmTransactionEvmNetworkCriterionSchema = z.object({
+  /** The type of criterion, must be "evmAddress" for EVM address-based rules. */
+  type: z.literal("evmNetwork"),
+  /**
+   * Array of EVM network identifiers to compare against.
+   * Either "base", "base-sepolia", "ethereum", "ethereum-sepolia", "avalanche", "polygon", "optimism", "arbitrum"
+   */
+  networks: z.array(SendEvmTransactionEvmNetworkEnum),
+  /**
+   * The operator to use for evaluating transaction network.
+   * "in" checks if a network is in the provided list.
+   * "not in" checks if a network is not in the provided list.
+   */
+  operator: EvmNetworkOperatorEnum,
+});
+
+export const PrepareUserOperationEvmNetworkCriterionSchema = z.object({
   /** The type of criterion, must be "evmAddress" for EVM address-based rules. */
   type: z.literal("evmNetwork"),
   /**
    * Array of EVM network identifiers to compare against.
-   * Either "base" or "base-sepolia"
+   * Either "base-sepolia", "base", "arbitrum", "optimism", "zora", "polygon", "bnb", "avalanche", "ethereum", "ethereum-sepolia"
    */
-  networks: z.array(EvmNetworkEnum),
+  networks: z.array(PrepareUserOperationEvmNetworkEnum),
   /**
    * The operator to use for evaluating transaction network.
    * "in" checks if a network is in the provided list.
@@ -95,7 +141,18 @@ export const EvmNetworkCriterionSchema = z.object({
    */
   operator: EvmNetworkOperatorEnum,
 });
-export type EvmNetworkCriterion = z.infer<typeof EvmNetworkCriterionSchema>;
+
+export const EvmNetworkCriterionSchema = z.union([
+  SendEvmTransactionEvmNetworkCriterionSchema,
+  PrepareUserOperationEvmNetworkCriterionSchema,
+]);
+
+export type EvmNetworkCriterion = z.ZodUnion<
+  [
+    typeof SendEvmTransactionEvmNetworkCriterionSchema,
+    typeof PrepareUserOperationEvmNetworkCriterionSchema,
+  ]
+>;
 
 /**
  * Schema for EVM message criterions
@@ -399,7 +456,7 @@ export const SendEvmTransactionCriteriaSchema = z
     z.discriminatedUnion("type", [
       EthValueCriterionSchema,
       EvmAddressCriterionSchema,
-      EvmNetworkCriterionSchema,
+      SendEvmTransactionEvmNetworkCriterionSchema,
       EvmDataCriterionSchema,
       NetUSDChangeCriterionSchema,
     ]),
@@ -418,7 +475,7 @@ export const PrepareUserOperationCriteriaSchema = z
     z.discriminatedUnion("type", [
       EthValueCriterionSchema,
       EvmAddressCriterionSchema,
-      EvmNetworkCriterionSchema,
+      PrepareUserOperationEvmNetworkCriterionSchema,
       EvmDataCriterionSchema,
     ]),
   )

package/version.ts

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