@coinbase/cdp-sdk 1.38.6 → 1.39.0

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

@@ -58,10 +58,33 @@ export interface DeveloperJWTAuthentication {
     /** The unique identifier for the end user that is captured in the `sub` claim of the JWT. */
     sub: string;
 }
+/**
+ * The type of OAuth2 provider.
+ */
+export type OAuth2ProviderType = (typeof OAuth2ProviderType)[keyof typeof OAuth2ProviderType];
+export declare const OAuth2ProviderType: {
+    readonly google: "google";
+    readonly apple: "apple";
+    readonly x: "x";
+};
+/**
+ * Information about an end user who authenticates using a third-party provider.
+ */
+export interface OAuth2Authentication {
+    type: OAuth2ProviderType;
+    /** The unique identifier for the end user that is captured in the `sub` claim of the JWT. */
+    sub: string;
+    /** The email address of the end user contained within the user's ID token, if available from third-party OAuth2 provider's token exchange. */
+    email?: string;
+    /** The full name of the end user if available from third-party OAuth2 provider's token exchange. */
+    name?: string;
+    /** The username of the end user if available from third-party OAuth2 provider's token exchange. */
+    username?: string;
+}
 /**
  * Information about how the end user is authenticated.
  */
-export type AuthenticationMethod = EmailAuthentication | SmsAuthentication | DeveloperJWTAuthentication;
+export type AuthenticationMethod = EmailAuthentication | SmsAuthentication | DeveloperJWTAuthentication | OAuth2Authentication;
 /**
  * The list of valid authentication methods linked to the end user.
  */
@@ -82,6 +105,8 @@ export interface EndUser {
     evmSmartAccounts: string[];
     /** The list of Solana accounts associated with the end user. Currently, only one Solana account is supported per end user. */
     solanaAccounts: string[];
+    /** The date and time when the end user was created, in ISO 8601 format. */
+    createdAt: string;
 }
 export interface ListResponse {
     /** The token for the next page of items, if any. */
@@ -122,7 +147,22 @@ export declare const ErrorType: {
     readonly recipient_allowlist_violation: "recipient_allowlist_violation";
     readonly recipient_allowlist_pending: "recipient_allowlist_pending";
     readonly travel_rules_recipient_violation: "travel_rules_recipient_violation";
+    readonly transfer_amount_out_of_bounds: "transfer_amount_out_of_bounds";
+    readonly transfer_recipient_address_invalid: "transfer_recipient_address_invalid";
+    readonly transfer_quote_expired: "transfer_quote_expired";
+    readonly mfa_already_enrolled: "mfa_already_enrolled";
+    readonly mfa_invalid_code: "mfa_invalid_code";
+    readonly mfa_flow_expired: "mfa_flow_expired";
+    readonly mfa_required: "mfa_required";
+    readonly mfa_not_enrolled: "mfa_not_enrolled";
 };
+/**
+ * A valid HTTP or HTTPS URL.
+ * @minLength 11
+ * @maxLength 2048
+ * @pattern ^https?://.*$
+ */
+export type Url = string;
 /**
  * An error response including the code for the type of error and a human-readable message describing the error.
  */
@@ -133,7 +173,7 @@ export interface Error {
     /** A unique identifier for the request that generated the error. This can be used to help debug issues with the API. */
     correlationId?: string;
     /** A link to the corresponding error documentation. */
-    errorLink?: string;
+    errorLink?: Url;
 }
 export interface EvmAccount {
     /**
@@ -360,7 +400,7 @@ export interface CreateSpendPermissionRequest {
     /** Arbitrary data to include in the permission. */
     extraData?: string;
     /** The paymaster URL of the spend permission. */
-    paymasterUrl?: string;
+    paymasterUrl?: Url;
 }
 /**
  * The core spend permission.
@@ -414,7 +454,7 @@ export interface RevokeSpendPermissionRequest {
     /** The hash of the spend permission to revoke. */
     permissionHash: string;
     /** The paymaster URL of the spend permission. */
-    paymasterUrl?: string;
+    paymasterUrl?: Url;
 }
 /**
  * The network on which to perform the swap.
@@ -1849,6 +1889,20 @@ export interface SolanaTokenBalance {
     amount: SolanaTokenAmount;
     token: SolanaToken;
 }
+/**
+ * Enables control over how often queries need to be fully re-executed on the backing store.
+This can be useful in scenarios where API calls might be made frequently, API latency is critical, and some freshness lag (ex: 750ms, 2s, 5s) is tolerable.
+By default, each query result is returned from cache so long as the result is from an identical query and less than 500ms old. This freshness tolerance can be modified upwards, to a maximum of 900000ms (i.e. 900s, 15m).
+
+ */
+export type OnchainDataQueryCache = {
+    /**
+     * The maximum tolerable staleness of the query result cache in milliseconds. If a previous execution result of an identical query is older than this age, the query will be re-executed. If the data is less than this age, the result will be returned from cache.
+     * @minimum 500
+     * @maximum 900000
+     */
+    maxAgeMs?: number;
+};
 /**
  * Request to execute a SQL query against indexed blockchain data.
  */
@@ -1856,9 +1910,14 @@ export interface OnchainDataQuery {
     /**
      * SQL query to execute against the indexed blockchain data.
      * @minLength 1
-     * @maxLength 50000
+     * @maxLength 100000
      */
     sql: string;
+    /** Enables control over how often queries need to be fully re-executed on the backing store.
+  This can be useful in scenarios where API calls might be made frequently, API latency is critical, and some freshness lag (ex: 750ms, 2s, 5s) is tolerable.
+  By default, each query result is returned from cache so long as the result is from an identical query and less than 500ms old. This freshness tolerance can be modified upwards, to a maximum of 900000ms (i.e. 900s, 15m).
+   */
+    cache?: OnchainDataQueryCache;
 }
 /**
  * Row data with column names as keys.
@@ -1910,8 +1969,10 @@ export type OnchainDataResultSchema = {
  * Metadata about query execution.
  */
 export type OnchainDataResultMetadata = {
-    /** Whether the result was served from cache. */
+    /** Whether the result was served from the query result cache. */
     cached?: boolean;
+    /** When the query result was executed against the backing store in RFC 3339 format. */
+    executionTimestamp?: string;
     /** Query execution time in milliseconds. */
     executionTimeMs?: number;
     /** Number of rows returned. */
@@ -1943,6 +2004,223 @@ export interface AccountTokenAddressesResponse {
      */
     totalCount?: number;
 }
+/**
+ * Additional headers to include in webhook requests.
+ */
+export type WebhookTargetHeaders = {
+    [key: string]: string;
+};
+/**
+ * Target configuration for webhook delivery.
+Specifies the destination URL and any custom headers to include in webhook requests.
+
+ */
+export interface WebhookTarget {
+    /** The webhook URL to deliver events to. */
+    url: Url;
+    /** Additional headers to include in webhook requests. */
+    headers?: WebhookTargetHeaders;
+}
+/**
+ * Additional metadata for the subscription.
+ */
+export type WebhookSubscriptionResponseMetadata = {
+    /** Secret for webhook signature validation.
+  
+  **Note:** Webhooks are in beta and this interface is subject to change.
+   */
+    secret?: string;
+};
+/**
+ * Multi-label filters using total overlap logic. Total overlap means the subscription only triggers when events contain ALL these key-value pairs.
+Present when subscription uses multi-label format.
+
+ */
+export type WebhookSubscriptionResponseLabels = {
+    [key: string]: string;
+};
+/**
+ * Response containing webhook subscription details.
+ */
+export interface WebhookSubscriptionResponse {
+    /** When the subscription was created. */
+    createdAt: string;
+    /** Description of the webhook subscription. */
+    description?: string;
+    /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
+  service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
+   */
+    eventTypes: string[];
+    /** Whether the subscription is enabled. */
+    isEnabled: boolean;
+    /** Additional metadata for the subscription. */
+    metadata?: WebhookSubscriptionResponseMetadata;
+    /** Unique identifier for the subscription. */
+    subscriptionId: string;
+    target: WebhookTarget;
+    /** Label key for filtering events. Present when subscription uses traditional single-label format.
+     */
+    labelKey?: string;
+    /** Label value for filtering events. Present when subscription uses traditional single-label format.
+     */
+    labelValue?: string;
+    /** Multi-label filters using total overlap logic. Total overlap means the subscription only triggers when events contain ALL these key-value pairs.
+  Present when subscription uses multi-label format.
+   */
+    labels?: WebhookSubscriptionResponseLabels;
+}
+/**
+ * Response containing a list of webhook subscriptions.
+ */
+export type WebhookSubscriptionListResponseAllOf = {
+    /** The list of webhook subscriptions. */
+    subscriptions: WebhookSubscriptionResponse[];
+};
+export type WebhookSubscriptionListResponse = WebhookSubscriptionListResponseAllOf & ListResponse;
+/**
+ * Additional metadata for the subscription.
+ */
+export type WebhookSubscriptionRequestMetadata = {
+    [key: string]: unknown;
+};
+/**
+ * Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when
+an event contains ALL the key-value pairs specified here. Additional labels on
+the event are allowed and will not prevent matching.
+NOTE: Use either labels OR (labelKey + labelValue), not both.
+
+ */
+export type WebhookSubscriptionRequestLabels = {
+    [key: string]: string;
+};
+/**
+ * Request to create a new webhook subscription with support for both traditional single-label
+and multi-label filtering formats.
+
+ */
+export type WebhookSubscriptionRequest = (unknown & {
+    /** Description of the webhook subscription. */
+    description?: string;
+    /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
+service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
+The subscription will only receive events matching these types AND the label filter(s).
+*/
+    eventTypes?: string[];
+    /** Whether the subscription is enabled. */
+    isEnabled?: boolean;
+    target?: WebhookTarget;
+    /** Additional metadata for the subscription. */
+    metadata?: WebhookSubscriptionRequestMetadata;
+    /** Label key for filtering events. Each subscription filters on exactly one (labelKey, labelValue) pair
+in addition to the event types. Only events matching both the event types AND this label filter will be delivered.
+NOTE: Use either (labelKey + labelValue) OR labels, not both.
+*/
+    labelKey?: string;
+    /** Label value for filtering events. Must correspond to the labelKey (e.g., contract address for contract_address key).
+Only events with this exact label value will be delivered.
+NOTE: Use either (labelKey + labelValue) OR labels, not both.
+*/
+    labelValue?: string;
+    /** Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when
+an event contains ALL the key-value pairs specified here. Additional labels on
+the event are allowed and will not prevent matching.
+NOTE: Use either labels OR (labelKey + labelValue), not both.
+*/
+    labels?: WebhookSubscriptionRequestLabels;
+}) | (unknown & {
+    /** Description of the webhook subscription. */
+    description?: string;
+    /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
+service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
+The subscription will only receive events matching these types AND the label filter(s).
+*/
+    eventTypes?: string[];
+    /** Whether the subscription is enabled. */
+    isEnabled?: boolean;
+    target?: WebhookTarget;
+    /** Additional metadata for the subscription. */
+    metadata?: WebhookSubscriptionRequestMetadata;
+    /** Label key for filtering events. Each subscription filters on exactly one (labelKey, labelValue) pair
+in addition to the event types. Only events matching both the event types AND this label filter will be delivered.
+NOTE: Use either (labelKey + labelValue) OR labels, not both.
+*/
+    labelKey?: string;
+    /** Label value for filtering events. Must correspond to the labelKey (e.g., contract address for contract_address key).
+Only events with this exact label value will be delivered.
+NOTE: Use either (labelKey + labelValue) OR labels, not both.
+*/
+    labelValue?: string;
+    /** Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when
+an event contains ALL the key-value pairs specified here. Additional labels on
+the event are allowed and will not prevent matching.
+NOTE: Use either labels OR (labelKey + labelValue), not both.
+*/
+    labels?: WebhookSubscriptionRequestLabels;
+});
+/**
+ * Additional metadata for the subscription.
+ */
+export type WebhookSubscriptionUpdateRequestMetadata = {
+    [key: string]: unknown;
+};
+/**
+ * Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when
+an event contains ALL the key-value pairs specified here. Use either labels OR (labelKey + labelValue), not both.
+
+ */
+export type WebhookSubscriptionUpdateRequestLabels = {
+    [key: string]: string;
+};
+/**
+ * Request to update an existing webhook subscription. The update format must match
+the original subscription format (traditional or multi-label).
+
+ */
+export type WebhookSubscriptionUpdateRequest = (unknown & {
+    /** Description of the webhook subscription. */
+    description?: string;
+    /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
+service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
+*/
+    eventTypes?: string[];
+    /** Whether the subscription is enabled. */
+    isEnabled?: boolean;
+    target?: WebhookTarget;
+    /** Additional metadata for the subscription. */
+    metadata?: WebhookSubscriptionUpdateRequestMetadata;
+    /** Label key for filtering events. Use either (labelKey + labelValue) OR labels, not both.
+     */
+    labelKey?: string;
+    /** Label value for filtering events. Use either (labelKey + labelValue) OR labels, not both.
+     */
+    labelValue?: string;
+    /** Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when
+an event contains ALL the key-value pairs specified here. Use either labels OR (labelKey + labelValue), not both.
+*/
+    labels?: WebhookSubscriptionUpdateRequestLabels;
+}) | (unknown & {
+    /** Description of the webhook subscription. */
+    description?: string;
+    /** Types of events to subscribe to. Event types follow a three-part dot-separated format:
+service.resource.verb (e.g., "onchain.activity.detected", "wallet.activity.detected", "onramp.transaction.created").
+*/
+    eventTypes?: string[];
+    /** Whether the subscription is enabled. */
+    isEnabled?: boolean;
+    target?: WebhookTarget;
+    /** Additional metadata for the subscription. */
+    metadata?: WebhookSubscriptionUpdateRequestMetadata;
+    /** Label key for filtering events. Use either (labelKey + labelValue) OR labels, not both.
+     */
+    labelKey?: string;
+    /** Label value for filtering events. Use either (labelKey + labelValue) OR labels, not both.
+     */
+    labelValue?: string;
+    /** Multi-label filters using total overlap logic. Total overlap means the subscription will only trigger when
+an event contains ALL the key-value pairs specified here. Use either labels OR (labelKey + labelValue), not both.
+*/
+    labels?: WebhookSubscriptionUpdateRequestLabels;
+});
 /**
  * The version of the x402 protocol.
  */
@@ -2062,7 +2340,7 @@ export interface X402PaymentRequirements {
     /** The maximum amount required to pay for the resource in atomic units of the payment asset. */
     maxAmountRequired: string;
     /** The URL of the resource to pay for. */
-    resource: string;
+    resource: Url;
     /** The description of the resource. */
     description: string;
     /** The MIME type of the resource response. */
@@ -2104,6 +2382,7 @@ export declare const X402VerifyInvalidReason: {
     readonly invalid_payment_requirements: "invalid_payment_requirements";
     readonly invalid_payload: "invalid_payload";
     readonly invalid_exact_evm_payload_authorization_value: "invalid_exact_evm_payload_authorization_value";
+    readonly invalid_exact_evm_payload_authorization_value_too_low: "invalid_exact_evm_payload_authorization_value_too_low";
     readonly invalid_exact_evm_payload_authorization_valid_after: "invalid_exact_evm_payload_authorization_valid_after";
     readonly invalid_exact_evm_payload_authorization_valid_before: "invalid_exact_evm_payload_authorization_valid_before";
     readonly invalid_exact_evm_payload_authorization_typed_data_message: "invalid_exact_evm_payload_authorization_typed_data_message";
@@ -2129,6 +2408,8 @@ export declare const X402VerifyInvalidReason: {
     readonly invalid_exact_svm_payload_transaction_sender_ata_not_found: "invalid_exact_svm_payload_transaction_sender_ata_not_found";
     readonly invalid_exact_svm_payload_transaction_simulation_failed: "invalid_exact_svm_payload_transaction_simulation_failed";
     readonly invalid_exact_svm_payload_transaction_transfer_to_incorrect_ata: "invalid_exact_svm_payload_transaction_transfer_to_incorrect_ata";
+    readonly invalid_exact_svm_payload_transaction_fee_payer_included_in_instruction_accounts: "invalid_exact_svm_payload_transaction_fee_payer_included_in_instruction_accounts";
+    readonly invalid_exact_svm_payload_transaction_fee_payer_transferring_funds: "invalid_exact_svm_payload_transaction_fee_payer_transferring_funds";
 };
 /**
  * The reason the payment settlement errored on the x402 protocol.
@@ -2271,8 +2552,8 @@ export declare const OnrampPaymentLinkType: {
 Please refer to the [Onramp docs](https://docs.cdp.coinbase.com/onramp-&-offramp/onramp-apis/onramp-overview) for details on how to integrate with the different payment link types.
  */
 export interface OnrampPaymentLink {
-    /** The URL to the hosted widget the user should be redirected to. For certain payment link types you can append your  own redirect_url query parameter to this URL to ensure the user is redirected back to your app after the widget completes. */
-    url: string;
+    /** The URL to the hosted widget the user should be redirected to. For certain payment link types you can append your own redirect_url query parameter to this URL to ensure the user is redirected back to your app after the widget completes. */
+    url: Url;
     paymentLinkType: OnrampPaymentLinkType;
 }
 /**
@@ -2292,7 +2573,7 @@ export declare const OnrampQuotePaymentMethodTypeId: {
  */
 export interface OnrampSession {
     /** Ready-to-use onramp URL. */
-    onrampUrl: string;
+    onrampUrl: Url;
 }
 /**
  * Quote information with pricing details for the crypto purchase.
@@ -2410,6 +2691,42 @@ Refer to our [Idempotency docs](https://docs.cdp.coinbase.com/api-reference/v2/i
 
  */
 export type IdempotencyKeyParameter = string;
+/**
+ * The number of resources to return per page.
+ */
+export type PageSizeParameter = number;
+/**
+ * The token for the next page of resources, if any.
+ */
+export type PageTokenParameter = string;
+/**
+ * Configuration for creating an EVM account for the end user.
+ */
+export type CreateEndUserBodyEvmAccount = {
+    /** If true, creates an EVM smart account and a default EVM EOA account as the owner. If false, only a EVM EOA account is created. */
+    createSmartAccount?: boolean;
+};
+/**
+ * Configuration for creating a Solana account for the end user.
+ */
+export type CreateEndUserBodySolanaAccount = {
+    /** Only false is a valid option since currently smart accounts on Solana are not supported. */
+    createSmartAccount?: boolean;
+};
+export type CreateEndUserBody = {
+    /**
+     * A stable, unique identifier for the end user. The `userId` must be unique across all end users in the developer's CDP Project. It must be between 1 and 100 characters long and can only contain alphanumeric characters and hyphens.
+  
+  If `userId` is not provided in the request, the server will generate a random UUID.
+     * @pattern ^[a-zA-Z0-9-]{1,100}$
+     */
+    userId?: string;
+    authenticationMethods: AuthenticationMethods;
+    /** Configuration for creating an EVM account for the end user. */
+    evmAccount?: CreateEndUserBodyEvmAccount;
+    /** Configuration for creating a Solana account for the end user. */
+    solanaAccount?: CreateEndUserBodySolanaAccount;
+};
 export type ListEndUsersParams = {
     /**
      * The number of end users to return per page.
@@ -2443,13 +2760,13 @@ export type ValidateEndUserAccessTokenBody = {
 };
 export type ListEvmAccountsParams = {
     /**
-     * The number of accounts to return per page.
+     * The number of resources to return per page.
      */
-    pageSize?: number;
+    pageSize?: PageSizeParameter;
     /**
-     * The token for the next page of accounts, if any.
+     * The token for the next page of resources, if any.
      */
-    pageToken?: string;
+    pageToken?: PageTokenParameter;
 };
 export type ListEvmAccounts200AllOf = {
     /** The list of EVM accounts. */
@@ -2538,13 +2855,13 @@ export type SignEvmTypedData200 = {
 };
 export type ListEvmSmartAccountsParams = {
     /**
-     * The number of accounts to return per page.
+     * The number of resources to return per page.
      */
-    pageSize?: number;
+    pageSize?: PageSizeParameter;
     /**
-     * The token for the next page of accounts, if any.
+     * The token for the next page of resources, if any.
      */
-    pageToken?: string;
+    pageToken?: PageTokenParameter;
 };
 export type ListEvmSmartAccounts200AllOf = {
     /** The list of Smart Accounts. */
@@ -2608,14 +2925,14 @@ export type PrepareUserOperationBody = {
     /** The list of calls to make from the Smart Account. */
     calls: EvmCall[];
     /** The URL of the paymaster to use for the user operation. */
-    paymasterUrl?: string;
+    paymasterUrl?: Url;
 };
 export type PrepareAndSendUserOperationBody = {
     network: EvmUserOperationNetwork;
     /** The list of calls to make from the Smart Account. */
     calls: EvmCall[];
     /** The URL of the paymaster to use for the user operation. */
-    paymasterUrl?: string;
+    paymasterUrl?: Url;
 };
 export type SendUserOperationBody = {
     /** The hex-encoded signature of the user operation. This should be a 65-byte signature consisting of the `r`, `s`, and `v` values of the ECDSA signature. Note that the `v` value should conform to the `personal_sign` standard, which means it should be 27 or 28. */
@@ -2687,13 +3004,13 @@ export type CreateEvmSwapQuoteBody = {
 };
 export type ListEvmTokenBalancesParams = {
     /**
-     * The number of balances to return per page.
+     * The number of resources to return per page.
      */
-    pageSize?: number;
+    pageSize?: PageSizeParameter;
     /**
-     * The token for the next page of balances. Will be empty if there are no more balances to fetch.
+     * The token for the next page of resources, if any.
      */
-    pageToken?: string;
+    pageToken?: PageTokenParameter;
 };
 export type ListEvmTokenBalances200AllOf = {
     /** The list of EVM token balances. */
@@ -2737,13 +3054,13 @@ export type RequestEvmFaucet200 = {
 };
 export type ListPoliciesParams = {
     /**
-     * The number of policies to return per page.
+     * The number of resources to return per page.
      */
-    pageSize?: number;
+    pageSize?: PageSizeParameter;
     /**
-     * The token for the next page of policies, if any.
+     * The token for the next page of resources, if any.
      */
-    pageToken?: string;
+    pageToken?: PageTokenParameter;
     /**
      * The scope of the policies to return. If `project`, the response will include exactly one policy, which is the project-level policy. If `account`, the response will include all account-level policies for the developer's CDP Project.
      */
@@ -2791,13 +3108,13 @@ export type UpdatePolicyBody = {
 };
 export type ListSolanaAccountsParams = {
     /**
-     * The number of accounts to return per page.
+     * The number of resources to return per page.
      */
-    pageSize?: number;
+    pageSize?: PageSizeParameter;
     /**
-     * The token for the next page of accounts, if any.
+     * The token for the next page of resources, if any.
      */
-    pageToken?: string;
+    pageToken?: PageTokenParameter;
 };
 export type ListSolanaAccounts200AllOf = {
     /** The list of Solana accounts. */
@@ -2930,19 +3247,29 @@ export type ListSolanaTokenBalances200AllOf = {
 export type ListSolanaTokenBalances200 = ListSolanaTokenBalances200AllOf & ListResponse;
 export type ListDataTokenBalancesParams = {
     /**
-     * The number of balances to return per page.
+     * The number of resources to return per page.
      */
-    pageSize?: number;
+    pageSize?: PageSizeParameter;
     /**
-     * The token for the next page of balances. Will be empty if there are no more balances to fetch.
+     * The token for the next page of resources, if any.
      */
-    pageToken?: string;
+    pageToken?: PageTokenParameter;
 };
 export type ListDataTokenBalances200AllOf = {
     /** The list of EVM token balances. */
     balances: TokenBalance[];
 };
 export type ListDataTokenBalances200 = ListDataTokenBalances200AllOf & ListResponse;
+export type ListWebhookSubscriptionsParams = {
+    /**
+     * The number of subscriptions to return per page.
+     */
+    pageSize?: number;
+    /**
+     * The token for the next page of subscriptions, if any.
+     */
+    pageToken?: string;
+};
 export type VerifyX402PaymentBody = {
     x402Version: X402Version;
     paymentPayload: X402PaymentPayload;
@@ -3021,10 +3348,14 @@ export type CreateOnrampSessionBody = {
     country?: string;
     /** The ISO 3166-2 two letter state code (e.g. NY). Only required for US. */
     subdivision?: string;
-    /** URL to redirect the user to when they successfully complete a transaction. This URL will be  embedded in the returned onramp URL as a query parameter. */
-    redirectUrl?: string;
+    /** URL to redirect the user to when they successfully complete a transaction. This URL will be embedded in the returned onramp URL as a query parameter. */
+    redirectUrl?: Url;
     /** The IP address of the end user requesting the onramp transaction. */
     clientIp?: string;
+    /** A unique string that represents the user in your app. This can be used to link individual transactions  together so you can retrieve the transaction history for your users. Prefix this string with “sandbox-”  (e.g. "sandbox-user-1234") to perform a sandbox transaction which will allow you to test your integration  without any real transfer of funds.
+  
+  This value can be used with with [Onramp User Transactions API](https://docs.cdp.coinbase.com/api-reference/rest-api/onramp-offramp/get-onramp-transactions-by-id) to retrieve all transactions created by the user. */
+    partnerUserRef?: string;
 };
 export type CreateOnrampSession201 = {
     session: OnrampSession;