@coinbase/cdp-sdk 1.46.1 → 1.48.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (125) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +332 -0
  3. package/_cjs/actions/solana/sendTransaction.js +3 -0
  4. package/_cjs/actions/solana/sendTransaction.js.map +1 -1
  5. package/_cjs/actions/webhooks/createWebhookSubscription.js +48 -0
  6. package/_cjs/actions/webhooks/createWebhookSubscription.js.map +1 -0
  7. package/_cjs/actions/webhooks/index.js +6 -0
  8. package/_cjs/actions/webhooks/index.js.map +1 -0
  9. package/_cjs/client/cdp.js +5 -4
  10. package/_cjs/client/cdp.js.map +1 -1
  11. package/_cjs/client/end-user/endUser.js +19 -89
  12. package/_cjs/client/end-user/endUser.js.map +1 -1
  13. package/_cjs/client/end-user/toEndUserAccount.js +13 -43
  14. package/_cjs/client/end-user/toEndUserAccount.js.map +1 -1
  15. package/_cjs/client/solana/solana.js +2 -0
  16. package/_cjs/client/solana/solana.js.map +1 -1
  17. package/_cjs/client/webhooks/webhooks.js +58 -0
  18. package/_cjs/client/webhooks/webhooks.js.map +1 -0
  19. package/_cjs/index.js.map +1 -1
  20. package/_cjs/openapi-client/cdpApiClient.js +0 -32
  21. package/_cjs/openapi-client/cdpApiClient.js.map +1 -1
  22. package/_cjs/openapi-client/generated/coinbaseDeveloperPlatformAPIs.schemas.js +51 -11
  23. package/_cjs/openapi-client/generated/coinbaseDeveloperPlatformAPIs.schemas.js.map +1 -1
  24. package/_cjs/openapi-client/generated/{embedded-wallets-core-functionality/embedded-wallets-core-functionality.js → embedded-wallets/embedded-wallets.js} +37 -65
  25. package/_cjs/openapi-client/generated/embedded-wallets/embedded-wallets.js.map +1 -0
  26. package/_cjs/openapi-client/generated/evm-smart-accounts/evm-smart-accounts.js +2 -2
  27. package/_cjs/openapi-client/generated/evm-smart-accounts/evm-smart-accounts.js.map +1 -1
  28. package/_cjs/openapi-client/generated/sql-api/sql-api.js +12 -1
  29. package/_cjs/openapi-client/generated/sql-api/sql-api.js.map +1 -1
  30. package/_cjs/openapi-client/generated/webhooks/webhooks.js +32 -5
  31. package/_cjs/openapi-client/generated/webhooks/webhooks.js.map +1 -1
  32. package/_cjs/openapi-client/index.js +2 -2
  33. package/_cjs/openapi-client/index.js.map +1 -1
  34. package/_cjs/version.js +1 -1
  35. package/_esm/actions/solana/sendTransaction.js +3 -0
  36. package/_esm/actions/solana/sendTransaction.js.map +1 -1
  37. package/_esm/actions/webhooks/createWebhookSubscription.js +45 -0
  38. package/_esm/actions/webhooks/createWebhookSubscription.js.map +1 -0
  39. package/_esm/actions/webhooks/index.js +2 -0
  40. package/_esm/actions/webhooks/index.js.map +1 -0
  41. package/_esm/client/cdp.js +6 -5
  42. package/_esm/client/cdp.js.map +1 -1
  43. package/_esm/client/end-user/endUser.js +17 -87
  44. package/_esm/client/end-user/endUser.js.map +1 -1
  45. package/_esm/client/end-user/toEndUserAccount.js +13 -43
  46. package/_esm/client/end-user/toEndUserAccount.js.map +1 -1
  47. package/_esm/client/solana/solana.js +2 -0
  48. package/_esm/client/solana/solana.js.map +1 -1
  49. package/_esm/client/webhooks/webhooks.js +54 -0
  50. package/_esm/client/webhooks/webhooks.js.map +1 -0
  51. package/_esm/index.js.map +1 -1
  52. package/_esm/openapi-client/cdpApiClient.js +0 -32
  53. package/_esm/openapi-client/cdpApiClient.js.map +1 -1
  54. package/_esm/openapi-client/generated/coinbaseDeveloperPlatformAPIs.schemas.js +48 -8
  55. package/_esm/openapi-client/generated/coinbaseDeveloperPlatformAPIs.schemas.js.map +1 -1
  56. package/_esm/openapi-client/generated/{embedded-wallets-core-functionality/embedded-wallets-core-functionality.js → embedded-wallets/embedded-wallets.js} +36 -61
  57. package/_esm/openapi-client/generated/embedded-wallets/embedded-wallets.js.map +1 -0
  58. package/_esm/openapi-client/generated/evm-smart-accounts/evm-smart-accounts.js +2 -2
  59. package/_esm/openapi-client/generated/evm-smart-accounts/evm-smart-accounts.js.map +1 -1
  60. package/_esm/openapi-client/generated/sql-api/sql-api.js +10 -0
  61. package/_esm/openapi-client/generated/sql-api/sql-api.js.map +1 -1
  62. package/_esm/openapi-client/generated/webhooks/webhooks.js +30 -4
  63. package/_esm/openapi-client/generated/webhooks/webhooks.js.map +1 -1
  64. package/_esm/openapi-client/index.js +2 -2
  65. package/_esm/openapi-client/index.js.map +1 -1
  66. package/_esm/version.js +1 -1
  67. package/_types/actions/solana/sendTransaction.d.ts +2 -0
  68. package/_types/actions/solana/sendTransaction.d.ts.map +1 -1
  69. package/_types/actions/webhooks/createWebhookSubscription.d.ts +68 -0
  70. package/_types/actions/webhooks/createWebhookSubscription.d.ts.map +1 -0
  71. package/_types/actions/webhooks/index.d.ts +2 -0
  72. package/_types/actions/webhooks/index.d.ts.map +1 -0
  73. package/_types/client/cdp.d.ts +5 -6
  74. package/_types/client/cdp.d.ts.map +1 -1
  75. package/_types/client/end-user/endUser.d.ts +2 -52
  76. package/_types/client/end-user/endUser.d.ts.map +1 -1
  77. package/_types/client/end-user/endUser.types.d.ts +1 -63
  78. package/_types/client/end-user/endUser.types.d.ts.map +1 -1
  79. package/_types/client/end-user/toEndUserAccount.d.ts +0 -2
  80. package/_types/client/end-user/toEndUserAccount.d.ts.map +1 -1
  81. package/_types/client/solana/solana.d.ts +2 -0
  82. package/_types/client/solana/solana.d.ts.map +1 -1
  83. package/_types/client/solana/solana.types.d.ts +2 -0
  84. package/_types/client/solana/solana.types.d.ts.map +1 -1
  85. package/_types/client/webhooks/webhooks.d.ts +41 -0
  86. package/_types/client/webhooks/webhooks.d.ts.map +1 -0
  87. package/_types/index.d.ts +2 -1
  88. package/_types/index.d.ts.map +1 -1
  89. package/_types/openapi-client/cdpApiClient.d.ts.map +1 -1
  90. package/_types/openapi-client/generated/coinbaseDeveloperPlatformAPIs.schemas.d.ts +285 -85
  91. package/_types/openapi-client/generated/coinbaseDeveloperPlatformAPIs.schemas.d.ts.map +1 -1
  92. package/_types/openapi-client/generated/{embedded-wallets-core-functionality/embedded-wallets-core-functionality.d.ts → embedded-wallets/embedded-wallets.d.ts} +14 -32
  93. package/_types/openapi-client/generated/embedded-wallets/embedded-wallets.d.ts.map +1 -0
  94. package/_types/openapi-client/generated/evm-smart-accounts/evm-smart-accounts.d.ts +2 -2
  95. package/_types/openapi-client/generated/evm-smart-accounts/evm-smart-accounts.d.ts.map +1 -1
  96. package/_types/openapi-client/generated/sql-api/sql-api.d.ts +10 -1
  97. package/_types/openapi-client/generated/sql-api/sql-api.d.ts.map +1 -1
  98. package/_types/openapi-client/generated/webhooks/webhooks.d.ts +30 -5
  99. package/_types/openapi-client/generated/webhooks/webhooks.d.ts.map +1 -1
  100. package/_types/openapi-client/index.d.ts +16 -18
  101. package/_types/openapi-client/index.d.ts.map +1 -1
  102. package/_types/version.d.ts +1 -1
  103. package/actions/solana/sendTransaction.ts +3 -0
  104. package/actions/webhooks/createWebhookSubscription.ts +104 -0
  105. package/actions/webhooks/index.ts +6 -0
  106. package/client/cdp.ts +8 -8
  107. package/client/end-user/endUser.ts +55 -187
  108. package/client/end-user/endUser.types.ts +0 -72
  109. package/client/end-user/toEndUserAccount.ts +57 -152
  110. package/client/solana/solana.ts +2 -0
  111. package/client/solana/solana.types.ts +2 -0
  112. package/client/webhooks/webhooks.ts +61 -0
  113. package/index.ts +6 -4
  114. package/openapi-client/cdpApiClient.ts +0 -34
  115. package/openapi-client/generated/coinbaseDeveloperPlatformAPIs.schemas.ts +331 -93
  116. package/openapi-client/generated/{embedded-wallets-core-functionality/embedded-wallets-core-functionality.ts → embedded-wallets/embedded-wallets.ts} +45 -99
  117. package/openapi-client/generated/evm-smart-accounts/evm-smart-accounts.ts +3 -3
  118. package/openapi-client/generated/sql-api/sql-api.ts +19 -0
  119. package/openapi-client/generated/webhooks/webhooks.ts +42 -4
  120. package/openapi-client/index.ts +2 -2
  121. package/package.json +1 -1
  122. package/version.ts +1 -1
  123. package/_cjs/openapi-client/generated/embedded-wallets-core-functionality/embedded-wallets-core-functionality.js.map +0 -1
  124. package/_esm/openapi-client/generated/embedded-wallets-core-functionality/embedded-wallets-core-functionality.js.map +0 -1
  125. package/_types/openapi-client/generated/embedded-wallets-core-functionality/embedded-wallets-core-functionality.d.ts.map +0 -1
@@ -101,10 +101,32 @@ export interface TelegramAuthentication {
101
101
  /** The Telegram user's username. */
102
102
  username?: string;
103
103
  }
104
+ /**
105
+ * A blockchain address. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana).
106
+ * @minLength 1
107
+ * @maxLength 128
108
+ */
109
+ export type BlockchainAddress = string;
110
+ /**
111
+ * The type of authentication information.
112
+ */
113
+ export type SiweAuthenticationType = (typeof SiweAuthenticationType)[keyof typeof SiweAuthenticationType];
114
+ export declare const SiweAuthenticationType: {
115
+ readonly siwe: "siwe";
116
+ };
117
+ /**
118
+ * Information about an end user who authenticates using Sign In With Ethereum (EIP-4361).
119
+ */
120
+ export interface SiweAuthentication {
121
+ /** The type of authentication information. */
122
+ type: SiweAuthenticationType;
123
+ /** The ERC-55 checksummed Ethereum address of the end user. */
124
+ address: BlockchainAddress;
125
+ }
104
126
  /**
105
127
  * Information about how the end user is authenticated.
106
128
  */
107
- export type AuthenticationMethod = EmailAuthentication | SmsAuthentication | DeveloperJWTAuthentication | OAuth2Authentication | TelegramAuthentication;
129
+ export type AuthenticationMethod = EmailAuthentication | SmsAuthentication | DeveloperJWTAuthentication | OAuth2Authentication | TelegramAuthentication | SiweAuthentication;
108
130
  /**
109
131
  * The list of valid authentication methods linked to the end user.
110
132
  */
@@ -298,12 +320,6 @@ export interface Error {
298
320
  /** A link to the corresponding error documentation. */
299
321
  errorLink?: Url;
300
322
  }
301
- /**
302
- * A blockchain address. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana).
303
- * @minLength 1
304
- * @maxLength 128
305
- */
306
- export type BlockchainAddress = string;
307
323
  /**
308
324
  * The symbol of the asset (e.g., eth, usd, usdc, usdt).
309
325
  * @minLength 1
@@ -464,37 +480,6 @@ export interface EvmUserOperation {
464
480
  /** The list of receipts associated with the user operation. */
465
481
  receipts?: UserOperationReceipt[];
466
482
  }
467
- /**
468
- * The network the spend permission is on.
469
- */
470
- export type SpendPermissionNetwork = (typeof SpendPermissionNetwork)[keyof typeof SpendPermissionNetwork];
471
- export declare const SpendPermissionNetwork: {
472
- readonly base: "base";
473
- readonly "base-sepolia": "base-sepolia";
474
- readonly ethereum: "ethereum";
475
- readonly "ethereum-sepolia": "ethereum-sepolia";
476
- readonly optimism: "optimism";
477
- readonly arbitrum: "arbitrum";
478
- readonly avalanche: "avalanche";
479
- readonly polygon: "polygon";
480
- };
481
- /**
482
- * Request parameters for revoking a Spend Permission.
483
- */
484
- export interface RevokeSpendPermissionRequest {
485
- /**
486
- * The ID of the Temporary Wallet Secret that was used to sign the X-Wallet-Auth Header.
487
- * @pattern ^[a-zA-Z0-9-]{1,100}$
488
- */
489
- walletSecretId: string;
490
- network: SpendPermissionNetwork;
491
- /** The hash of the spend permission to revoke. */
492
- permissionHash: string;
493
- /** Whether to use the CDP Paymaster for the user operation. */
494
- useCdpPaymaster: boolean;
495
- /** The paymaster URL of the spend permission. */
496
- paymasterUrl?: Url;
497
- }
498
483
  export interface EvmAccount {
499
484
  /**
500
485
  * The 0x-prefixed, checksum EVM address.
@@ -570,6 +555,20 @@ export interface EvmSmartAccount {
570
555
  /** The UTC ISO 8601 timestamp at which the account was last updated. */
571
556
  updatedAt?: string;
572
557
  }
558
+ /**
559
+ * The network the spend permission is on.
560
+ */
561
+ export type SpendPermissionNetwork = (typeof SpendPermissionNetwork)[keyof typeof SpendPermissionNetwork];
562
+ export declare const SpendPermissionNetwork: {
563
+ readonly base: "base";
564
+ readonly "base-sepolia": "base-sepolia";
565
+ readonly ethereum: "ethereum";
566
+ readonly "ethereum-sepolia": "ethereum-sepolia";
567
+ readonly optimism: "optimism";
568
+ readonly arbitrum: "arbitrum";
569
+ readonly avalanche: "avalanche";
570
+ readonly polygon: "polygon";
571
+ };
573
572
  /**
574
573
  * Request parameters for creating a Spend Permission.
575
574
  */
@@ -647,7 +646,7 @@ export interface SpendPermissionResponseObject {
647
646
  /**
648
647
  * Request parameters for revoking a Spend Permission.
649
648
  */
650
- export interface EvmSpendPermissionsRevokeSpendPermissionRequest {
649
+ export interface RevokeSpendPermissionRequest {
651
650
  network: SpendPermissionNetwork;
652
651
  /** The hash of the spend permission to revoke. */
653
652
  permissionHash: string;
@@ -1249,8 +1248,11 @@ export declare const EvmNetworkCriterionNetworksItem: {
1249
1248
  readonly polygon: "polygon";
1250
1249
  readonly optimism: "optimism";
1251
1250
  readonly arbitrum: "arbitrum";
1251
+ readonly "arbitrum-sepolia": "arbitrum-sepolia";
1252
1252
  readonly zora: "zora";
1253
1253
  readonly bnb: "bnb";
1254
+ readonly world: "world";
1255
+ readonly "world-sepolia": "world-sepolia";
1254
1256
  };
1255
1257
  /**
1256
1258
  * The operator to use for the comparison. The transaction's intended `network` will be on the left-hand side of the operator, and the `networks` field will be on the right-hand side.
@@ -2097,6 +2099,27 @@ export interface SignEndUserEvmTypedDataRule {
2097
2099
  operation: SignEndUserEvmTypedDataRuleOperation;
2098
2100
  criteria: SignEndUserEvmTypedDataCriteria;
2099
2101
  }
2102
+ /**
2103
+ * Whether any attempts to sign a hash will be accepted or rejected. This rule does not accept any criteria.
2104
+ */
2105
+ export type SignEndUserEvmHashRuleAction = (typeof SignEndUserEvmHashRuleAction)[keyof typeof SignEndUserEvmHashRuleAction];
2106
+ export declare const SignEndUserEvmHashRuleAction: {
2107
+ readonly reject: "reject";
2108
+ readonly accept: "accept";
2109
+ };
2110
+ /**
2111
+ * The operation to which the rule applies.
2112
+ */
2113
+ export type SignEndUserEvmHashRuleOperation = (typeof SignEndUserEvmHashRuleOperation)[keyof typeof SignEndUserEvmHashRuleOperation];
2114
+ export declare const SignEndUserEvmHashRuleOperation: {
2115
+ readonly signEndUserEvmHash: "signEndUserEvmHash";
2116
+ };
2117
+ export interface SignEndUserEvmHashRule {
2118
+ /** Whether any attempts to sign a hash will be accepted or rejected. This rule does not accept any criteria. */
2119
+ action: SignEndUserEvmHashRuleAction;
2120
+ /** The operation to which the rule applies. */
2121
+ operation: SignEndUserEvmHashRuleOperation;
2122
+ }
2100
2123
  export type SignEndUserSolTransactionCriteriaItem = SolAddressCriterion | SolValueCriterion | SplAddressCriterion | SplValueCriterion | MintAddressCriterion | SolDataCriterion | ProgramIdCriterion;
2101
2124
  /**
2102
2125
  * A schema for specifying criteria for the signEndUserSolTransaction operation.
@@ -2180,7 +2203,7 @@ export interface SignEndUserSolMessageRule {
2180
2203
  /**
2181
2204
  * A rule that limits the behavior of an account.
2182
2205
  */
2183
- export type Rule = SignEvmTransactionRule | SendEvmTransactionRule | SignEvmMessageRule | SignEvmTypedDataRule | SignSolTransactionRule | SendSolTransactionRule | SignSolMessageRule | SignEvmHashRule | PrepareUserOperationRule | SendUserOperationRule | SignEndUserEvmTransactionRule | SendEndUserEvmTransactionRule | SignEndUserEvmMessageRule | SignEndUserEvmTypedDataRule | SignEndUserSolTransactionRule | SendEndUserSolTransactionRule | SignEndUserSolMessageRule;
2206
+ export type Rule = SignEvmTransactionRule | SendEvmTransactionRule | SignEvmMessageRule | SignEvmTypedDataRule | SignSolTransactionRule | SendSolTransactionRule | SignSolMessageRule | SignEvmHashRule | PrepareUserOperationRule | SendUserOperationRule | SignEndUserEvmTransactionRule | SendEndUserEvmTransactionRule | SignEndUserEvmMessageRule | SignEndUserEvmTypedDataRule | SignEndUserEvmHashRule | SignEndUserSolTransactionRule | SendEndUserSolTransactionRule | SignEndUserSolMessageRule;
2184
2207
  /**
2185
2208
  * The scope of the policy. Only one project-level policy can exist at any time.
2186
2209
  */
@@ -2377,6 +2400,45 @@ export interface OnchainDataResult {
2377
2400
  /** Metadata about query execution. */
2378
2401
  metadata?: OnchainDataResultMetadata;
2379
2402
  }
2403
+ /**
2404
+ * A human-readable description.
2405
+ * @minLength 0
2406
+ * @maxLength 500
2407
+ */
2408
+ export type Description = string;
2409
+ /**
2410
+ * Schema definition for a table column.
2411
+ */
2412
+ export interface OnchainDataColumnSchema {
2413
+ /** Column name. */
2414
+ name?: string;
2415
+ /** Column data type. */
2416
+ type?: string;
2417
+ /** Whether this column can contain NULL values. */
2418
+ nullable?: boolean;
2419
+ /** Human-readable description of the column. */
2420
+ description?: Description;
2421
+ /** The order of the column in the index. A lower number means the column is more important for the index and should be first in the query. */
2422
+ indexOrder?: number;
2423
+ }
2424
+ /**
2425
+ * Schema definition for a data table.
2426
+ */
2427
+ export interface OnchainDataTableSchema {
2428
+ /** The blockchain network database this table belongs to. */
2429
+ database?: string;
2430
+ /** Table name. */
2431
+ table?: string;
2432
+ /** Column definitions for this table. */
2433
+ columns?: OnchainDataColumnSchema[];
2434
+ }
2435
+ /**
2436
+ * Schema information for available blockchain data tables.
2437
+ */
2438
+ export interface OnchainDataSchemaResponse {
2439
+ /** List of available tables. */
2440
+ tables?: OnchainDataTableSchema[];
2441
+ }
2380
2442
  /**
2381
2443
  * Response containing token addresses that an account has received.
2382
2444
  */
@@ -2392,13 +2454,7 @@ export interface AccountTokenAddressesResponse {
2392
2454
  totalCount?: number;
2393
2455
  }
2394
2456
  /**
2395
- * A human-readable description.
2396
- * @minLength 0
2397
- * @maxLength 500
2398
- */
2399
- export type Description = string;
2400
- /**
2401
- * Optional metadata as key-value pairs. Use this to store additional structured information on a resource, such as customer IDs, order references, or any application-specific data. Up to 50 key/value pairs may be provided. Keys and values are both strings. Keys must be ≤ 40 characters; values must be ≤ 500 characters.
2457
+ * Optional metadata as key-value pairs. Use this to store additional structured information on a resource, such as customer IDs, order references, or any application-specific data. Up to 10 key/value pairs may be provided. Keys and values are both strings. Keys must be ≤ 40 characters; values must be ≤ 500 characters.
2402
2458
  */
2403
2459
  export interface Metadata {
2404
2460
  [key: string]: string;
@@ -2449,8 +2505,9 @@ export interface WebhookSubscriptionResponse {
2449
2505
  updatedAt?: string;
2450
2506
  /** Description of the webhook subscription. */
2451
2507
  description?: Description;
2452
- /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
2453
- service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
2508
+ /** Types of events to subscribe to. Event types follow a dot-separated format:
2509
+ service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created",
2510
+ "acceptance.payment_session.authorization_succeeded").
2454
2511
  */
2455
2512
  eventTypes: string[];
2456
2513
  /** Whether the subscription is enabled. */
@@ -2495,8 +2552,9 @@ export type WebhookSubscriptionRequestLabels = {
2495
2552
  export interface WebhookSubscriptionRequest {
2496
2553
  /** Description of the webhook subscription. */
2497
2554
  description?: Description;
2498
- /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
2499
- service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
2555
+ /** Types of events to subscribe to. Event types follow a dot-separated format:
2556
+ service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created",
2557
+ "acceptance.payment_session.authorization_succeeded").
2500
2558
  The subscription will only receive events matching these types AND the label filter(s).
2501
2559
  */
2502
2560
  eventTypes: string[];
@@ -2550,6 +2608,55 @@ export interface WebhookSubscriptionUpdateRequest {
2550
2608
  */
2551
2609
  labels?: WebhookSubscriptionUpdateRequestLabels;
2552
2610
  }
2611
+ /**
2612
+ * Details of the HTTP response received from the webhook target.
2613
+ */
2614
+ export interface WebhookEventResponseDetail {
2615
+ /** HTTP status code returned by the webhook target. */
2616
+ httpCode?: number;
2617
+ /** Round-trip time of the webhook delivery in milliseconds. */
2618
+ elapsedTimeMs?: number;
2619
+ /** Response body returned by the webhook target. */
2620
+ body?: string;
2621
+ /** Error name if the delivery failed (e.g., timeout, connection_refused). */
2622
+ errorName?: string;
2623
+ }
2624
+ /**
2625
+ * Current delivery status of the event.
2626
+ */
2627
+ export type WebhookEventResponseStatus = (typeof WebhookEventResponseStatus)[keyof typeof WebhookEventResponseStatus];
2628
+ export declare const WebhookEventResponseStatus: {
2629
+ readonly pending: "pending";
2630
+ readonly processing: "processing";
2631
+ readonly succeeded: "succeeded";
2632
+ readonly failed: "failed";
2633
+ readonly retrying: "retrying";
2634
+ };
2635
+ /**
2636
+ * Details of a webhook event delivery attempt for a subscription.
2637
+ */
2638
+ export interface WebhookEventResponse {
2639
+ /** Unique identifier for the webhook event. */
2640
+ eventId: string;
2641
+ /** The type of event that was delivered (e.g., "onchain.activity.detected"). */
2642
+ eventTypeName: string;
2643
+ /** Current delivery status of the event. */
2644
+ status: WebhookEventResponseStatus;
2645
+ /** Timestamp when the event delivery attempt was created. */
2646
+ createdAt: string;
2647
+ /** Timestamp when the event was successfully delivered. Only present if status is "succeeded". */
2648
+ succeededAt?: string;
2649
+ /** Number of delivery retry attempts so far. */
2650
+ retryCount: number;
2651
+ response?: WebhookEventResponseDetail;
2652
+ }
2653
+ /**
2654
+ * Response containing a list of webhook event delivery attempts.
2655
+ */
2656
+ export interface WebhookEventListResponse {
2657
+ /** The list of webhook event delivery attempts. */
2658
+ events: WebhookEventResponse[];
2659
+ }
2553
2660
  /**
2554
2661
  * The version of the x402 protocol.
2555
2662
  */
@@ -2671,11 +2778,12 @@ export interface X402ExactSolanaPayload {
2671
2778
  transaction: string;
2672
2779
  }
2673
2780
  /**
2674
- * The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`.
2781
+ * The scheme of the payment protocol to use. Supported schemes are `exact` and `upto`.
2675
2782
  */
2676
2783
  export type X402V2PaymentRequirementsScheme = (typeof X402V2PaymentRequirementsScheme)[keyof typeof X402V2PaymentRequirementsScheme];
2677
2784
  export declare const X402V2PaymentRequirementsScheme: {
2678
2785
  readonly exact: "exact";
2786
+ readonly upto: "upto";
2679
2787
  };
2680
2788
  /**
2681
2789
  * The optional additional scheme-specific payment info.
@@ -2687,7 +2795,7 @@ export type X402V2PaymentRequirementsExtra = {
2687
2795
  * The x402 protocol payment requirements that the resource server expects the client's payment payload to meet.
2688
2796
  */
2689
2797
  export interface X402V2PaymentRequirements {
2690
- /** The scheme of the payment protocol to use. Currently, the only supported scheme is `exact`. */
2798
+ /** The scheme of the payment protocol to use. Supported schemes are `exact` and `upto`. */
2691
2799
  scheme: X402V2PaymentRequirementsScheme;
2692
2800
  /** The network of the blockchain to send payment on in caip2 format. */
2693
2801
  network: string;
@@ -3019,6 +3127,7 @@ export interface X402SettlePaymentRejection {
3019
3127
  export type X402SupportedPaymentKindScheme = (typeof X402SupportedPaymentKindScheme)[keyof typeof X402SupportedPaymentKindScheme];
3020
3128
  export declare const X402SupportedPaymentKindScheme: {
3021
3129
  readonly exact: "exact";
3130
+ readonly upto: "upto";
3022
3131
  };
3023
3132
  /**
3024
3133
  * The network of the blockchain.
@@ -3311,6 +3420,8 @@ export type X402SettleResponseResponse = {
3311
3420
  transaction: string;
3312
3421
  /** The network where the settlement occurred. */
3313
3422
  network: string;
3423
+ /** The amount that was settled, in atomic units. */
3424
+ amount?: string;
3314
3425
  };
3315
3426
  /**
3316
3427
  * Unsuccessful payment settlement on the x402 protocol.
@@ -3354,14 +3465,18 @@ export type IdempotencyKeyParameter = string;
3354
3465
  section of our Authentication docs for more details on how to generate your Wallet Token.
3355
3466
 
3356
3467
  */
3357
- export type XDeveloperAuthParameter = string;
3468
+ export type XWalletAuthOptionalParameter = string;
3358
3469
  /**
3359
3470
  * A JWT signed using your Wallet Secret, encoded in base64. Refer to the
3360
3471
  [Generate Wallet Token](https://docs.cdp.coinbase.com/api-reference/v2/authentication#2-generate-wallet-token)
3361
3472
  section of our Authentication docs for more details on how to generate your Wallet Token.
3362
3473
 
3363
3474
  */
3364
- export type XWalletAuthOptionalParameter = string;
3475
+ export type XDeveloperAuthParameter = string;
3476
+ /**
3477
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3478
+ */
3479
+ export type ProjectIDOptionalParameter = string;
3365
3480
  /**
3366
3481
  * The number of resources to return per page.
3367
3482
  */
@@ -3472,23 +3587,12 @@ export type ImportEndUserBody = {
3472
3587
  /** The type of key being imported. Determines what type of account will be associated for the end user. */
3473
3588
  keyType: ImportEndUserBodyKeyType;
3474
3589
  };
3475
- export type SignEvmHashWithEndUserAccountBody = {
3476
- /** The arbitrary 32 byte hash to sign. */
3477
- hash: string;
3478
- /**
3479
- * The 0x-prefixed address of the EVM account belonging to the end user.
3480
- * @pattern ^0x[0-9a-fA-F]{40}$
3481
- */
3482
- address: string;
3590
+ export type SignEvmTransactionWithEndUserAccountParams = {
3483
3591
  /**
3484
- * Required when not using delegated signing. The ID of the Temporary Wallet Secret that was used to sign the X-Wallet-Auth Header.
3485
- * @pattern ^[a-zA-Z0-9-]{1,100}$
3592
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3593
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3486
3594
  */
3487
- walletSecretId?: string;
3488
- };
3489
- export type SignEvmHashWithEndUserAccount200 = {
3490
- /** The signature of the hash, as a 0x-prefixed hex string. */
3491
- signature: string;
3595
+ projectID?: ProjectIDOptionalParameter;
3492
3596
  };
3493
3597
  export type SignEvmTransactionWithEndUserAccountBody = {
3494
3598
  /**
@@ -3508,6 +3612,13 @@ export type SignEvmTransactionWithEndUserAccount200 = {
3508
3612
  /** The RLP-encoded signed transaction, as a 0x-prefixed hex string. */
3509
3613
  signedTransaction: string;
3510
3614
  };
3615
+ export type SendEvmTransactionWithEndUserAccountParams = {
3616
+ /**
3617
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3618
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3619
+ */
3620
+ projectID?: ProjectIDOptionalParameter;
3621
+ };
3511
3622
  /**
3512
3623
  * The network to send the transaction to.
3513
3624
  */
@@ -3521,6 +3632,9 @@ export declare const SendEvmTransactionWithEndUserAccountBodyNetwork: {
3521
3632
  readonly polygon: "polygon";
3522
3633
  readonly optimism: "optimism";
3523
3634
  readonly arbitrum: "arbitrum";
3635
+ readonly "arbitrum-sepolia": "arbitrum-sepolia";
3636
+ readonly world: "world";
3637
+ readonly "world-sepolia": "world-sepolia";
3524
3638
  };
3525
3639
  export type SendEvmTransactionWithEndUserAccountBody = {
3526
3640
  /**
@@ -3542,6 +3656,13 @@ export type SendEvmTransactionWithEndUserAccount200 = {
3542
3656
  /** The hash of the transaction, as a 0x-prefixed hex string. */
3543
3657
  transactionHash: string;
3544
3658
  };
3659
+ export type SendEvmAssetWithEndUserAccountParams = {
3660
+ /**
3661
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3662
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3663
+ */
3664
+ projectID?: ProjectIDOptionalParameter;
3665
+ };
3545
3666
  /**
3546
3667
  * The EVM network to send USDC on.
3547
3668
  */
@@ -3555,6 +3676,9 @@ export declare const SendEvmAssetWithEndUserAccountBodyNetwork: {
3555
3676
  readonly polygon: "polygon";
3556
3677
  readonly optimism: "optimism";
3557
3678
  readonly arbitrum: "arbitrum";
3679
+ readonly "arbitrum-sepolia": "arbitrum-sepolia";
3680
+ readonly world: "world";
3681
+ readonly "world-sepolia": "world-sepolia";
3558
3682
  };
3559
3683
  export type SendEvmAssetWithEndUserAccountBody = {
3560
3684
  /**
@@ -3592,6 +3716,13 @@ export type SendEvmAssetWithEndUserAccount200 = {
3592
3716
  */
3593
3717
  userOpHash?: string | null;
3594
3718
  };
3719
+ export type SignEvmMessageWithEndUserAccountParams = {
3720
+ /**
3721
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3722
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3723
+ */
3724
+ projectID?: ProjectIDOptionalParameter;
3725
+ };
3595
3726
  export type SignEvmMessageWithEndUserAccountBody = {
3596
3727
  /**
3597
3728
  * The 0x-prefixed address of the EVM account belonging to the end user.
@@ -3610,6 +3741,13 @@ export type SignEvmMessageWithEndUserAccount200 = {
3610
3741
  /** The signature of the message, as a 0x-prefixed hex string. */
3611
3742
  signature: string;
3612
3743
  };
3744
+ export type SignEvmTypedDataWithEndUserAccountParams = {
3745
+ /**
3746
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3747
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3748
+ */
3749
+ projectID?: ProjectIDOptionalParameter;
3750
+ };
3613
3751
  export type SignEvmTypedDataWithEndUserAccountBody = {
3614
3752
  /**
3615
3753
  * The 0x-prefixed address of the EVM account belonging to the end user.
@@ -3634,6 +3772,13 @@ export type RevokeDelegationForEndUserBody = {
3634
3772
  */
3635
3773
  walletSecretId?: string;
3636
3774
  };
3775
+ export type CreateEvmEip7702DelegationWithEndUserAccountParams = {
3776
+ /**
3777
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3778
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3779
+ */
3780
+ projectID?: ProjectIDOptionalParameter;
3781
+ };
3637
3782
  export type CreateEvmEip7702DelegationWithEndUserAccountBody = {
3638
3783
  /**
3639
3784
  * The 0x-prefixed address of the EVM account to delegate.
@@ -3653,6 +3798,13 @@ export type CreateEvmEip7702DelegationWithEndUserAccount201 = {
3653
3798
  /** The unique identifier for the delegation operation. Use this to poll the operation status. */
3654
3799
  delegationOperationId: string;
3655
3800
  };
3801
+ export type SendUserOperationWithEndUserAccountParams = {
3802
+ /**
3803
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3804
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3805
+ */
3806
+ projectID?: ProjectIDOptionalParameter;
3807
+ };
3656
3808
  export type SendUserOperationWithEndUserAccountBody = {
3657
3809
  network: EvmUserOperationNetwork;
3658
3810
  /** The list of calls to make from the Smart Account. */
@@ -3672,23 +3824,12 @@ export type SendUserOperationWithEndUserAccountBody = {
3672
3824
  */
3673
3825
  dataSuffix?: string;
3674
3826
  };
3675
- export type SignSolanaHashWithEndUserAccountBody = {
3676
- /** The arbitrary 32 byte hash to sign as base58 encoded string. */
3677
- hash: string;
3827
+ export type SignSolanaMessageWithEndUserAccountParams = {
3678
3828
  /**
3679
- * The base58 encoded address of the Solana account belonging to the end user.
3680
- * @pattern ^[1-9A-HJ-NP-Za-km-z]{32,44}$
3681
- */
3682
- address: string;
3683
- /**
3684
- * Required when not using delegated signing. The ID of the Temporary Wallet Secret that was used to sign the X-Wallet-Auth Header.
3685
- * @pattern ^[a-zA-Z0-9-]{1,100}$
3829
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3830
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3686
3831
  */
3687
- walletSecretId?: string;
3688
- };
3689
- export type SignSolanaHashWithEndUserAccount200 = {
3690
- /** The signature of the hash, as a base58 encoded string. */
3691
- signature: string;
3832
+ projectID?: ProjectIDOptionalParameter;
3692
3833
  };
3693
3834
  export type SignSolanaMessageWithEndUserAccountBody = {
3694
3835
  /**
@@ -3708,6 +3849,13 @@ export type SignSolanaMessageWithEndUserAccount200 = {
3708
3849
  /** The signature of the message, as a base58 encoded string. */
3709
3850
  signature: string;
3710
3851
  };
3852
+ export type SignSolanaTransactionWithEndUserAccountParams = {
3853
+ /**
3854
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3855
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3856
+ */
3857
+ projectID?: ProjectIDOptionalParameter;
3858
+ };
3711
3859
  export type SignSolanaTransactionWithEndUserAccountBody = {
3712
3860
  /**
3713
3861
  * The base58 encoded address of the Solana account belonging to the end user.
@@ -3726,6 +3874,13 @@ export type SignSolanaTransactionWithEndUserAccount200 = {
3726
3874
  /** The base64 encoded signed transaction. */
3727
3875
  signedTransaction: string;
3728
3876
  };
3877
+ export type SendSolanaTransactionWithEndUserAccountParams = {
3878
+ /**
3879
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3880
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3881
+ */
3882
+ projectID?: ProjectIDOptionalParameter;
3883
+ };
3729
3884
  /**
3730
3885
  * The Solana network to send the transaction to.
3731
3886
  */
@@ -3756,6 +3911,13 @@ export type SendSolanaTransactionWithEndUserAccount200 = {
3756
3911
  /** The base58 encoded transaction signature. */
3757
3912
  transactionSignature: string;
3758
3913
  };
3914
+ export type SendSolanaAssetWithEndUserAccountParams = {
3915
+ /**
3916
+ * The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).
3917
+ * @pattern ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
3918
+ */
3919
+ projectID?: ProjectIDOptionalParameter;
3920
+ };
3759
3921
  /**
3760
3922
  * The Solana network to send USDC on.
3761
3923
  */
@@ -3848,6 +4010,9 @@ export declare const SendEvmTransactionBodyNetwork: {
3848
4010
  readonly polygon: "polygon";
3849
4011
  readonly optimism: "optimism";
3850
4012
  readonly arbitrum: "arbitrum";
4013
+ readonly "arbitrum-sepolia": "arbitrum-sepolia";
4014
+ readonly world: "world";
4015
+ readonly "world-sepolia": "world-sepolia";
3851
4016
  };
3852
4017
  export type SendEvmTransactionBody = {
3853
4018
  /** The network to send the transaction to. */
@@ -4252,6 +4417,8 @@ export type SendSolanaTransactionBody = {
4252
4417
  network: SendSolanaTransactionBodyNetwork;
4253
4418
  /** The base64 encoded transaction to sign and send. This transaction can contain multiple instructions for native Solana batching. */
4254
4419
  transaction: string;
4420
+ /** Whether transaction fees should be sponsored by CDP. When true, CDP sponsors the transaction fees on behalf of the server wallet. When false, the server wallet is responsible for paying the transaction fees. */
4421
+ useCdpSponsor?: boolean;
4255
4422
  };
4256
4423
  export type SendSolanaTransaction200 = {
4257
4424
  /** The base58 encoded transaction signature. */
@@ -4294,6 +4461,21 @@ export type ListSolanaTokenBalances200AllOf = {
4294
4461
  balances: SolanaTokenBalance[];
4295
4462
  };
4296
4463
  export type ListSolanaTokenBalances200 = ListSolanaTokenBalances200AllOf & ListResponse;
4464
+ export type GetSQLSchemaParams = {
4465
+ /**
4466
+ * The name of the database to query. Defaults to "base" when not specified.
4467
+ */
4468
+ database?: GetSQLSchemaDatabase;
4469
+ /**
4470
+ * Get the schema for a specific table.
4471
+ */
4472
+ table?: string;
4473
+ };
4474
+ export type GetSQLSchemaDatabase = (typeof GetSQLSchemaDatabase)[keyof typeof GetSQLSchemaDatabase];
4475
+ export declare const GetSQLSchemaDatabase: {
4476
+ readonly base: "base";
4477
+ readonly base_sepolia: "base_sepolia";
4478
+ };
4297
4479
  export type ListDataTokenBalancesParams = {
4298
4480
  /**
4299
4481
  * The number of resources to return per page.
@@ -4321,6 +4503,24 @@ export type ListWebhookSubscriptionsParams = {
4321
4503
  */
4322
4504
  pageToken?: string;
4323
4505
  };
4506
+ export type ListWebhookSubscriptionEventsParams = {
4507
+ /**
4508
+ * Filter by a specific event ID.
4509
+ */
4510
+ eventId?: string;
4511
+ /**
4512
+ * Filter events created at or after this timestamp (RFC 3339 format).
4513
+ */
4514
+ minCreatedAt?: string;
4515
+ /**
4516
+ * Filter events created at or before this timestamp (RFC 3339 format).
4517
+ */
4518
+ maxCreatedAt?: string;
4519
+ /**
4520
+ * Filter by event type names (comma-separated).
4521
+ */
4522
+ eventTypeNames?: string;
4523
+ };
4324
4524
  export type VerifyX402PaymentBody = {
4325
4525
  x402Version: X402Version;
4326
4526
  paymentPayload: X402PaymentPayload;