@coinbase-sample/prime-sdk-ts 0.7.0 → 0.8.0

package/dist/shared/validation.js

@@ -0,0 +1,380 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyValidator = exports.ValidationResult = void 0;
+exports.isValidUUID = isValidUUID;
+exports.validateRequiredUUID = validateRequiredUUID;
+exports.validateOptionalUUID = validateOptionalUUID;
+exports.validateRequiredString = validateRequiredString;
+exports.validateOptionalString = validateOptionalString;
+exports.createValidator = createValidator;
+exports.validate = validate;
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const errors_1 = require("../errors");
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Validation result that accumulates errors with fluent/builder pattern support
+ */
+class ValidationResult {
+    constructor() {
+        this.errors = [];
+    }
+    /**
+     * Add a validation error
+     */
+    addError(paramName, message, value) {
+        this.errors.push({ paramName, message, value });
+    }
+    /**
+     * Check if there are any validation errors
+     */
+    hasErrors() {
+        return this.errors.length > 0;
+    }
+    /**
+     * Get all validation errors
+     */
+    getErrors() {
+        return [...this.errors];
+    }
+    /**
+     * Validates that a required UUID parameter is present and valid.
+     * Returns this for method chaining.
+     *
+     * @example
+     * ```typescript
+     * validator
+     *   .validateRequiredUUID(request.portfolioId, 'portfolioId')
+     *   .validateRequiredUUID(request.orderId, 'orderId')
+     *   .check();
+     * ```
+     */
+    validateRequiredUUID(value, paramName) {
+        if (value === undefined || value === null || value === '') {
+            this.addError(paramName, 'is required and cannot be empty', value);
+            return this;
+        }
+        const trimmedValue = typeof value === 'string' ? value.trim() : value;
+        if (trimmedValue === '') {
+            this.addError(paramName, 'cannot be empty or whitespace only', value);
+            return this;
+        }
+        if (!isValidUUID(trimmedValue)) {
+            this.addError(paramName, 'must be a valid UUID', value);
+        }
+        return this;
+    }
+    /**
+     * Validates that an optional UUID parameter is valid if provided.
+     * Returns this for method chaining.
+     */
+    validateOptionalUUID(value, paramName) {
+        if (value === undefined || value === null || value === '') {
+            return this; // Optional, so undefined/null/empty is valid
+        }
+        const trimmedValue = typeof value === 'string' ? value.trim() : value;
+        if (trimmedValue !== '' && !isValidUUID(trimmedValue)) {
+            this.addError(paramName, 'must be a valid UUID if provided', value);
+        }
+        return this;
+    }
+    /**
+     * Validates that a required string parameter is present and not empty.
+     * Returns this for method chaining.
+     */
+    validateRequiredString(value, paramName) {
+        if (value === undefined || value === null || value === '') {
+            this.addError(paramName, 'is required and cannot be empty', value);
+            return this;
+        }
+        const trimmedValue = typeof value === 'string' ? value.trim() : value;
+        if (trimmedValue === '') {
+            this.addError(paramName, 'cannot be empty or whitespace only', value);
+        }
+        return this;
+    }
+    /**
+     * Validates that an optional string parameter is not empty if provided.
+     * Returns this for method chaining.
+     */
+    validateOptionalString(value, paramName) {
+        if (value === undefined || value === null) {
+            return this; // Optional, so undefined/null is valid
+        }
+        if (typeof value === 'string') {
+            const trimmedValue = value.trim();
+            if (value !== '' && trimmedValue === '') {
+                this.addError(paramName, 'cannot be whitespace only if provided', value);
+            }
+        }
+        return this;
+    }
+    /**
+     * Throw an exception if there are validation errors.
+     * Automatically detects the calling method name if no context is provided.
+     *
+     * @param contextMessage - Optional context message. If not provided, attempts to detect method name.
+     * @throws {CoinbasePrimeClientException} if there are validation errors
+     *
+     * @example
+     * ```typescript
+     * const validator = createValidator();
+     * validateRequiredUUID(validator, request.id, 'id');
+     * validator.throwIfInvalid(); // Automatically detects calling method
+     * ```
+     */
+    throwIfInvalid(contextMessage) {
+        if (this.hasErrors()) {
+            const errorDetails = this.errors
+                .map((err) => {
+                const valueInfo = err.value !== undefined ? ` (received: '${err.value}')` : '';
+                return `  - ${err.paramName}: ${err.message}${valueInfo}`;
+            })
+                .join('\n');
+            const prefix = contextMessage || this.getCallerContext();
+            throw new errors_1.CoinbasePrimeClientException(`${prefix}:\n${errorDetails}`);
+        }
+    }
+    /**
+     * Alias for throwIfInvalid() - more natural for fluent/builder pattern.
+     * Throw an exception if there are validation errors.
+     *
+     * @param contextMessage - Optional context message. If not provided, attempts to detect method name.
+     * @throws {CoinbasePrimeClientException} if there are validation errors
+     *
+     * @example
+     * ```typescript
+     * validator
+     *   .validateRequiredUUID(request.portfolioId, 'portfolioId')
+     *   .validateRequiredUUID(request.orderId, 'orderId')
+     *   .check(); // ✅ Fluent pattern
+     * ```
+     */
+    check(contextMessage) {
+        this.throwIfInvalid(contextMessage);
+    }
+    /**
+     * Attempts to extract the calling method name from the stack trace.
+     * This provides automatic context for validation errors.
+     * Falls back to 'Request validation failed' if method name cannot be determined.
+     */
+    getCallerContext() {
+        try {
+            const stack = new Error().stack;
+            if (stack) {
+                // Parse stack to find the calling method
+                const lines = stack.split('\n');
+                // Stack trace format:
+                // Line 0: Error
+                // Line 1: getCallerContext
+                // Line 2: throwIfInvalid
+                // Line 3: actual calling method (e.g., getOrder, listOnchainAddressBook)
+                const callerLine = lines[3];
+                // Try to match various stack trace formats
+                // Format: "at ClassName.methodName" or "at methodName" or "methodName@file.ts"
+                let match = callerLine.match(/at (?:\w+\.)?(\w+)/);
+                if (!match) {
+                    // Try Firefox/Safari format: methodName@file.ts:line:col
+                    match = callerLine.match(/^(\w+)@/);
+                }
+                if (match && match[1]) {
+                    const methodName = match[1];
+                    // Filter out common internal/utility method names
+                    if (!['async', 'Function', 'Object'].includes(methodName)) {
+                        return `${methodName} request validation failed`;
+                    }
+                }
+            }
+        }
+        catch (e) {
+            // Silently fail - stack parsing is best-effort
+            // This might happen in different JavaScript engines or minified code
+        }
+        return 'Request validation failed';
+    }
+}
+exports.ValidationResult = ValidationResult;
+/**
+ * Validates that a string is a valid UUID v4 format
+ */
+function isValidUUID(value) {
+    return UUID_REGEX.test(value);
+}
+/**
+ * Validates that a required UUID parameter is present and valid
+ */
+function validateRequiredUUID(validator, value, paramName) {
+    if (value === undefined || value === null || value === '') {
+        validator.addError(paramName, 'is required and cannot be empty', value);
+        return;
+    }
+    const trimmedValue = typeof value === 'string' ? value.trim() : value;
+    if (trimmedValue === '') {
+        validator.addError(paramName, 'cannot be empty or whitespace only', value);
+        return;
+    }
+    if (!isValidUUID(trimmedValue)) {
+        validator.addError(paramName, 'must be a valid UUID', value);
+    }
+}
+/**
+ * Validates that an optional UUID parameter is valid if provided
+ */
+function validateOptionalUUID(validator, value, paramName) {
+    if (value === undefined || value === null || value === '') {
+        return; // Optional, so undefined/null/empty is valid
+    }
+    const trimmedValue = typeof value === 'string' ? value.trim() : value;
+    if (trimmedValue !== '' && !isValidUUID(trimmedValue)) {
+        validator.addError(paramName, 'must be a valid UUID if provided', value);
+    }
+}
+/**
+ * Validates that a required string parameter is present and not empty
+ */
+function validateRequiredString(validator, value, paramName) {
+    if (value === undefined || value === null || value === '') {
+        validator.addError(paramName, 'is required and cannot be empty', value);
+        return;
+    }
+    const trimmedValue = typeof value === 'string' ? value.trim() : value;
+    if (trimmedValue === '') {
+        validator.addError(paramName, 'cannot be empty or whitespace only', value);
+    }
+}
+/**
+ * Validates that an optional string parameter is not empty if provided
+ */
+function validateOptionalString(validator, value, paramName) {
+    if (value === undefined || value === null) {
+        return; // Optional, so undefined/null is valid
+    }
+    if (typeof value === 'string') {
+        const trimmedValue = value.trim();
+        if (value !== '' && trimmedValue === '') {
+            validator.addError(paramName, 'cannot be whitespace only if provided', value);
+        }
+    }
+}
+/**
+ * Convenience function to create a new ValidationResult
+ */
+function createValidator() {
+    return new ValidationResult();
+}
+/**
+ * Creates a validator with property accessor support for automatic field name inference.
+ *
+ * @param source - The source object containing the fields to validate
+ *
+ * @example
+ * ```typescript
+ * validate(request)
+ *   .requiredUUID(r => r.portfolioId)
+ *   .requiredUUID(r => r.orderId)
+ *   .check();
+ * ```
+ */
+function validate(source) {
+    return new PropertyValidator(source);
+}
+/**
+ * Validator with property accessor support for automatic field name inference.
+ * Uses Proxy to track property accesses and extract field names automatically.
+ */
+class PropertyValidator {
+    constructor(source) {
+        this.validator = new ValidationResult();
+        this.source = source;
+    }
+    /**
+     * Validates that a required UUID field is present and valid.
+     * Automatically extracts the field name from the property accessor.
+     *
+     * @example
+     * ```typescript
+     * validate(request)
+     *   .requiredUUID(r => r.portfolioId)
+     *   .check();
+     * ```
+     */
+    requiredUUID(accessor) {
+        const { propertyName, value } = this.extractProperty(accessor);
+        this.validator.validateRequiredUUID(value, propertyName);
+        return this;
+    }
+    /**
+     * Validates that an optional UUID field is valid if provided.
+     */
+    optionalUUID(accessor) {
+        const { propertyName, value } = this.extractProperty(accessor);
+        this.validator.validateOptionalUUID(value, propertyName);
+        return this;
+    }
+    /**
+     * Validates that a required string field is present and not empty.
+     */
+    requiredString(accessor) {
+        const { propertyName, value } = this.extractProperty(accessor);
+        this.validator.validateRequiredString(value, propertyName);
+        return this;
+    }
+    /**
+     * Validates that an optional string field is not empty if provided.
+     */
+    optionalString(accessor) {
+        const { propertyName, value } = this.extractProperty(accessor);
+        this.validator.validateOptionalString(value, propertyName);
+        return this;
+    }
+    /**
+     * Throws if there are validation errors.
+     * Automatically detects the calling method name.
+     */
+    check(contextMessage) {
+        this.validator.throwIfInvalid(contextMessage);
+    }
+    /**
+     * Alias for check() for backward compatibility.
+     */
+    throwIfInvalid(contextMessage) {
+        this.validator.throwIfInvalid(contextMessage);
+    }
+    /**
+     * Extracts the property name and value from a property accessor function.
+     * Uses a Proxy to track which property was accessed.
+     */
+    extractProperty(accessor) {
+        let accessedProperty;
+        // Create a Proxy that tracks property accesses
+        const proxy = new Proxy(this.source, {
+            get(target, prop) {
+                if (typeof prop === 'string') {
+                    accessedProperty = prop;
+                    return target[prop];
+                }
+                return undefined;
+            },
+        });
+        // Call the accessor to trigger the Proxy
+        const value = accessor(proxy);
+        if (!accessedProperty) {
+            throw new Error('Unable to extract property name. Ensure the accessor accesses a property directly (e.g., r => r.fieldName)');
+        }
+        return { propertyName: accessedProperty, value };
+    }
+}
+exports.PropertyValidator = PropertyValidator;

package/dist/staking/index.js

@@ -115,5 +115,27 @@ class StakingService {
             return response.data;
         });
     }
+    previewUnstake(request, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const bodyParams = Object.assign(Object.assign({}, request), { portfolioId: undefined, walletId: undefined });
+            const response = yield this.client.request({
+                url: `portfolios/${request.portfolioId}/wallets/${request.walletId}/staking/unstake/preview`,
+                method: clients_1.Method.POST,
+                bodyParams,
+                callOptions: options,
+            });
+            return response.data;
+        });
+    }
+    getUnstakingStatus(request, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { portfolioId, walletId } = request;
+            const response = yield this.client.request({
+                url: `portfolios/${portfolioId}/wallets/${walletId}/staking/unstake/status`,
+                callOptions: options,
+            });
+            return response.data;
+        });
+    }
 }
 exports.StakingService = StakingService;

package/dist/types/activities/types.d.ts

@@ -24,6 +24,7 @@ export type ActivityFilters = Pagination & {
     statuses?: ActivityStatus[];
     startTime?: string;
     endTime?: string;
+    getNetworkUnifiedActivities?: boolean;
 };
 export type GetActivityRequest = {
     activityId: string;

package/dist/types/constants.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const VERSION = "0.7.0";
+export declare const VERSION = "0.7.1";
 export declare const API_BASE_PATH = "https://api.prime.coinbase.com/v1/";
 export declare const USER_AGENT: string;
 export declare const CB_ACCESS_KEY_HEADER = "X-CB-ACCESS-KEY";

package/dist/types/financing/index.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { IPrimeApiClient, CoinbaseCallOptions } from '../clients';
-import { ListExistingLocatesRequest, ListExistingLocatesResponse, ListInterestAccrualsRequest, ListInterestAccrualsResponse, ListPortfolioInterestAccrualsRequest, ListPortfolioInterestAccrualsResponse, ListMarginCallSummariesRequest, ListMarginCallSummariesResponse, ListMarginConversionsRequest, ListMarginConversionsResponse, GetEntityLocateAvailabilitiesRequest, GetEntityLocateAvailabilitiesResponse, GetMarginInformationRequest, GetMarginInformationResponse, GetPortfolioBuyingPowerRequest, GetPortfolioBuyingPowerResponse, GetPortfolioCreditInformationRequest, GetPortfolioCreditInformationResponse, GetPortfolioWithdrawalPowerRequest, GetPortfolioWithdrawalPowerResponse, GetTieredPricingFeesRequest, GetTieredPricingFeesResponse, GetFcmMarginCallDetailsRequest, GetFcmMarginCallDetailsResponse, GetFcmRiskLimitsRequest, GetFcmRiskLimitsResponse, CreateNewLocatesRequest, CreateNewLocatesResponse, GetCrossMarginOverviewRequest, GetCrossMarginOverviewResponse } from './types';
+import { ListExistingLocatesRequest, ListExistingLocatesResponse, ListInterestAccrualsRequest, ListInterestAccrualsResponse, ListPortfolioInterestAccrualsRequest, ListPortfolioInterestAccrualsResponse, ListMarginCallSummariesRequest, ListMarginCallSummariesResponse, ListMarginConversionsRequest, ListMarginConversionsResponse, GetEntityLocateAvailabilitiesRequest, GetEntityLocateAvailabilitiesResponse, GetMarginInformationRequest, GetMarginInformationResponse, GetPortfolioBuyingPowerRequest, GetPortfolioBuyingPowerResponse, GetPortfolioCreditInformationRequest, GetPortfolioCreditInformationResponse, GetPortfolioWithdrawalPowerRequest, GetPortfolioWithdrawalPowerResponse, GetTieredPricingFeesRequest, GetTieredPricingFeesResponse, GetFcmMarginCallDetailsRequest, GetFcmMarginCallDetailsResponse, GetFcmRiskLimitsRequest, GetFcmRiskLimitsResponse, CreateNewLocatesRequest, CreateNewLocatesResponse, GetCrossMarginOverviewRequest, GetCrossMarginOverviewResponse, ListTFObligationsRequest, ListTFObligationsResponse, ListFinancingEligibleAssetsRequest, ListFinancingEligibleAssetsResponse } from './types';
 export interface IFinancingService {
     listExistingLocates(request: ListExistingLocatesRequest, options?: CoinbaseCallOptions): Promise<ListExistingLocatesResponse>;
     listInterestAccruals(request: ListInterestAccrualsRequest, options?: CoinbaseCallOptions): Promise<ListInterestAccrualsResponse>;
@@ -31,6 +31,8 @@ export interface IFinancingService {
     getFcmRiskLimits(request: GetFcmRiskLimitsRequest, options?: CoinbaseCallOptions): Promise<GetFcmRiskLimitsResponse>;
     createNewLocates(request: CreateNewLocatesRequest, options?: CoinbaseCallOptions): Promise<CreateNewLocatesResponse>;
     getCrossMarginOverview(request: GetCrossMarginOverviewRequest, options?: CoinbaseCallOptions): Promise<GetCrossMarginOverviewResponse>;
+    listTFObligations(request: ListTFObligationsRequest, options?: CoinbaseCallOptions): Promise<ListTFObligationsResponse>;
+    listFinancingEligibleAssets(request?: ListFinancingEligibleAssetsRequest, options?: CoinbaseCallOptions): Promise<ListFinancingEligibleAssetsResponse>;
 }
 export declare class FinancingService implements IFinancingService {
     private client;
@@ -50,4 +52,6 @@ export declare class FinancingService implements IFinancingService {
     getFcmRiskLimits(request: GetFcmRiskLimitsRequest, options?: CoinbaseCallOptions): Promise<GetFcmRiskLimitsResponse>;
     createNewLocates(request: CreateNewLocatesRequest, options?: CoinbaseCallOptions): Promise<CreateNewLocatesResponse>;
     getCrossMarginOverview(request: GetCrossMarginOverviewRequest, options?: CoinbaseCallOptions): Promise<GetCrossMarginOverviewResponse>;
+    listTFObligations(request: ListTFObligationsRequest, options?: CoinbaseCallOptions): Promise<ListTFObligationsResponse>;
+    listFinancingEligibleAssets(request?: ListFinancingEligibleAssetsRequest, options?: CoinbaseCallOptions): Promise<ListFinancingEligibleAssetsResponse>;
 }

package/dist/types/financing/types.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { Brand } from '../shared/brand';
-import { GetExistingLocatesResponse, GetInterestAccrualsResponse, GetLocateAvailabilitiesResponse, GetMarginConversionsResponse, GetMarginSummariesResponse, GetMarginInformationResponse as internalGetMarginInformationResponse, GetBuyingPowerResponse, GetPostTradeCreditResponse, GetTFTieredPricingFeesResponse, GetWithdrawalPowerResponse, GetFcmMarginCallDetailsResponse as internalGetFcmMarginCallDetailsResponse, GetFcmRiskLimitsResponse as internalGetFcmRiskLimitsResponse, CreateNewLocatesResponse as internalCreateNewLocatesResponse, GetCrossMarginOverviewResponse as internalGetCrossMarginOverviewResponse } from '../model/';
+import { GetExistingLocatesResponse, GetInterestAccrualsResponse, GetLocateAvailabilitiesResponse, GetMarginConversionsResponse, GetMarginSummariesResponse, GetMarginInformationResponse as internalGetMarginInformationResponse, GetBuyingPowerResponse, GetPostTradeCreditResponse, GetTFTieredPricingFeesResponse, GetWithdrawalPowerResponse, GetFcmMarginCallDetailsResponse as internalGetFcmMarginCallDetailsResponse, GetFcmRiskLimitsResponse as internalGetFcmRiskLimitsResponse, CreateNewLocatesResponse as internalCreateNewLocatesResponse, GetCrossMarginOverviewResponse as internalGetCrossMarginOverviewResponse, ListTFObligationsResponse as internalListTFObligationsResponse, ListFinancingEligibleAssetsResponse as internalListFinancingEligibleAssetsResponse } from '../model/';
 export type ListExistingLocatesRequest = {
     portfolioId: string;
     locateIds?: string[];
@@ -95,3 +95,9 @@ export type GetCrossMarginOverviewRequest = {
     entityId: string;
 };
 export type GetCrossMarginOverviewResponse = Brand<internalGetCrossMarginOverviewResponse, 'GetCrossMarginOverviewResponse'>;
+export type ListTFObligationsRequest = {
+    entityId: string;
+};
+export type ListTFObligationsResponse = Brand<internalListTFObligationsResponse, 'ListTFObligationsResponse'>;
+export type ListFinancingEligibleAssetsRequest = Record<string, never>;
+export type ListFinancingEligibleAssetsResponse = Brand<internalListFinancingEligibleAssetsResponse, 'ListFinancingEligibleAssetsResponse'>;

package/dist/types/futures/index.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { CoinbaseCallOptions, IPrimeApiClient } from '../clients';
-import { ListEntityFuturesSweepsRequest, ListEntityFuturesSweepsResponse, GetEntityFuturesBalanceRequest, GetEntityFuturesBalanceResponse, GetEntityFuturesPositionsRequest, GetEntityFuturesPositionsResponse, ScheduleEntityFuturesSweepRequest, ScheduleEntityFuturesSweepResponse, UpdateEntityFuturesAutoSweepRequest, UpdateEntityFuturesAutoSweepResponse, CancelEntitySweepRequest, CancelEntitySweepResponse, GetEntityFuturesRiskLimitsRequest, GetEntityFuturesRiskLimitsResponse, GetEntityFuturesMarginCallDetailsRequest, GetEntityFuturesMarginCallDetailsResponse } from './types';
+import { ListEntityFuturesSweepsRequest, ListEntityFuturesSweepsResponse, GetEntityFuturesBalanceRequest, GetEntityFuturesBalanceResponse, GetEntityFuturesPositionsRequest, GetEntityFuturesPositionsResponse, ScheduleEntityFuturesSweepRequest, ScheduleEntityFuturesSweepResponse, UpdateEntityFuturesAutoSweepRequest, UpdateEntityFuturesAutoSweepResponse, CancelEntitySweepRequest, CancelEntitySweepResponse, GetEntityFuturesRiskLimitsRequest, GetEntityFuturesRiskLimitsResponse, GetEntityFuturesMarginCallDetailsRequest, GetEntityFuturesMarginCallDetailsResponse, GetFcmSettingsRequest, GetFcmSettingsResponse, SetFcmSettingsRequest, SetFcmSettingsResponse } from './types';
 export interface IFuturesService {
     listEntitySweeps(request: ListEntityFuturesSweepsRequest, options?: CoinbaseCallOptions): Promise<ListEntityFuturesSweepsResponse>;
     getEntityBalance(request: GetEntityFuturesBalanceRequest, options?: CoinbaseCallOptions): Promise<GetEntityFuturesBalanceResponse>;
@@ -24,6 +24,8 @@ export interface IFuturesService {
     cancelEntitySweep(request: CancelEntitySweepRequest, options?: CoinbaseCallOptions): Promise<CancelEntitySweepResponse>;
     getRiskLimits(request: GetEntityFuturesRiskLimitsRequest, options?: CoinbaseCallOptions): Promise<GetEntityFuturesRiskLimitsResponse>;
     getMarginCallDetails(request: GetEntityFuturesMarginCallDetailsRequest, options?: CoinbaseCallOptions): Promise<GetEntityFuturesMarginCallDetailsResponse>;
+    getFcmSettings(request: GetFcmSettingsRequest, options?: CoinbaseCallOptions): Promise<GetFcmSettingsResponse>;
+    setFcmSettings(request: SetFcmSettingsRequest, options?: CoinbaseCallOptions): Promise<SetFcmSettingsResponse>;
 }
 export declare class FuturesService implements IFuturesService {
     private client;
@@ -36,5 +38,7 @@ export declare class FuturesService implements IFuturesService {
     cancelEntitySweep(request: CancelEntitySweepRequest, options?: CoinbaseCallOptions): Promise<CancelEntitySweepResponse>;
     getRiskLimits(request: GetEntityFuturesRiskLimitsRequest, options?: CoinbaseCallOptions): Promise<GetEntityFuturesRiskLimitsResponse>;
     getMarginCallDetails(request: GetEntityFuturesMarginCallDetailsRequest, options?: CoinbaseCallOptions): Promise<GetEntityFuturesMarginCallDetailsResponse>;
+    getFcmSettings(request: GetFcmSettingsRequest, options?: CoinbaseCallOptions): Promise<GetFcmSettingsResponse>;
+    setFcmSettings(request: SetFcmSettingsRequest, options?: CoinbaseCallOptions): Promise<SetFcmSettingsResponse>;
 }
-export type { ListEntityFuturesSweepsRequest, ListEntityFuturesSweepsResponse, GetEntityFuturesBalanceRequest, GetEntityFuturesBalanceResponse, GetEntityFuturesPositionsRequest, GetEntityFuturesPositionsResponse, ScheduleEntityFuturesSweepRequest, ScheduleEntityFuturesSweepResponse, UpdateEntityFuturesAutoSweepRequest, UpdateEntityFuturesAutoSweepResponse, CancelEntitySweepRequest, CancelEntitySweepResponse, GetEntityFuturesRiskLimitsRequest, GetEntityFuturesRiskLimitsResponse, GetEntityFuturesMarginCallDetailsRequest, GetEntityFuturesMarginCallDetailsResponse, } from './types';
+export type { ListEntityFuturesSweepsRequest, ListEntityFuturesSweepsResponse, GetEntityFuturesBalanceRequest, GetEntityFuturesBalanceResponse, GetEntityFuturesPositionsRequest, GetEntityFuturesPositionsResponse, ScheduleEntityFuturesSweepRequest, ScheduleEntityFuturesSweepResponse, UpdateEntityFuturesAutoSweepRequest, UpdateEntityFuturesAutoSweepResponse, CancelEntitySweepRequest, CancelEntitySweepResponse, GetEntityFuturesRiskLimitsRequest, GetEntityFuturesRiskLimitsResponse, GetEntityFuturesMarginCallDetailsRequest, GetEntityFuturesMarginCallDetailsResponse, GetFcmSettingsRequest, GetFcmSettingsResponse, SetFcmSettingsRequest, SetFcmSettingsResponse, } from './types';

package/dist/types/futures/types.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { Brand } from '../shared/brand';
-import { GetFcmBalanceResponse, GetFuturesSweepsResponse, GetPositionsResponse, SetAutoSweepResponse, ScheduleFuturesSweepRequest, ScheduleFuturesSweepResponse, CancelFuturesSweepResponse, GetFcmRiskLimitsResponse, GetFcmMarginCallDetailsResponse } from '../model/';
+import { GetFcmBalanceResponse, GetFuturesSweepsResponse, GetPositionsResponse, SetAutoSweepResponse, ScheduleFuturesSweepRequest, ScheduleFuturesSweepResponse, CancelFuturesSweepResponse, GetFcmRiskLimitsResponse, GetFcmMarginCallDetailsResponse, GetFcmSettingsResponse as internalGetFcmSettingsResponse, SetFcmSettingsResponse as internalSetFcmSettingsResponse } from '../model/';
 export type ListEntityFuturesSweepsRequest = {
     entityId: string;
 };
@@ -49,3 +49,12 @@ export type GetEntityFuturesMarginCallDetailsRequest = {
     entityId: string;
 };
 export type GetEntityFuturesMarginCallDetailsResponse = Brand<GetFcmMarginCallDetailsResponse, 'GetEntityFuturesMarginCallDetailsResponse'>;
+export type GetFcmSettingsRequest = {
+    entityId: string;
+};
+export type GetFcmSettingsResponse = Brand<internalGetFcmSettingsResponse, 'GetFcmSettingsResponse'>;
+export type SetFcmSettingsRequest = {
+    entityId: string;
+    targetDerivativesExcess: string;
+};
+export type SetFcmSettingsResponse = Brand<internalSetFcmSettingsResponse, 'SetFcmSettingsResponse'>;

package/dist/types/index.d.ts

@@ -51,7 +51,7 @@ export type { AcceptQuoteRequest, AcceptQuoteResponse, CancelOrderRequest, Cance
 export type { GetPaymentMethodRequest, GetPaymentMethodResponse, ListEntityPaymentMethodsRequest, ListEntityPaymentMethodsResponse, } from './paymentMethods/types';
 export type { ListPortfoliosRequest, ListPortfoliosResponse, GetPortfolioCreditRequest, GetPortfolioCreditResponse, GetPortfolioRequest, GetPortfolioResponse, GetCounterpartyIdRequest, GetCounterpartyIdResponse, } from './portfolios/types';
 export type { ListAggregateEntityPositionsRequest, ListAggregateEntityPositionsResponse, ListEntityPositionsRequest, ListEntityPositionsResponse, } from './positions/types';
-export type { ListProductsRequest, ListProductsResponse, } from './products/types';
+export type { ListProductsRequest, ListProductsResponse, ListProductCandlesRequest, ListProductCandlesResponse, } from './products/types';
 export type { CreateStakeRequest, CreateStakeResponse, CreateUnstakeRequest, CreateUnstakeResponse, CreatePortfolioStakeRequest, CreatePortfolioStakeResponse, CreatePortfolioUnstakeRequest, CreatePortfolioUnstakeResponse, QueryTransactionValidatorsRequest, QueryTransactionValidatorsResponse, BaseQueryTransactionValidatorsResponse, ClaimRewardsRequest, ClaimRewardsResponse, } from './staking/types';
 export type { CreateConversionRequest, CreateConversionResponse, CreateOnchainTransactionRequest, CreateOnchainTransactionResponse, CreateTransferRequest, CreateTransferResponse, CreateWithdrawalRequest, CreateWithdrawalResponse, GetTransactionRequest, GetTransactionResponse, ListPortfolioTransactionsRequest, ListPortfolioTransactionsResponse, ListWalletTransactionsRequest, ListWalletTransactionsResponse, } from './transactions/types';
 export type { ListPortfolioUsersRequest, ListPortfolioUsersResponse, ListUsersRequest, ListUsersResponse, } from './users/types';

package/dist/types/model/Candle.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * This file is generated by Openapi Generator https://github.com/openapitools/openapi-generator
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ *  Do not edit the class manually.
+ */
+export type Candle = {
+    timestamp?: Date;
+    /**
+     * Opening price for the period
+     */
+    open?: string;
+    /**
+     * Highest price during the period
+     */
+    high?: string;
+    /**
+     * Lowest price during the period
+     */
+    low?: string;
+    /**
+     * Closing price for the period
+     */
+    close?: string;
+    /**
+     * Volume traded during the period
+     */
+    volume?: string;
+};

package/dist/types/model/CreateOrderRequest.d.ts

@@ -19,6 +19,7 @@
  */
 import { OrderSide } from './enums/OrderSide';
 import { OrderType } from './enums/OrderType';
+import { PegOffsetType } from './enums/PegOffsetType';
 import { TimeInForceType } from './enums/TimeInForceType';
 export type CreateOrderRequest = {
     productId: string;
@@ -42,7 +43,13 @@ export type CreateOrderRequest = {
     stopPrice?: string;
     settlCurrency?: string;
     /**
-     * Post-only flag - when true, the order will only be posted to the order book and not immediately matched. Only applicable to LIMIT orders with GTC or GTD time in force.  next: 20
+     * Post-only flag - when true, the order will only be posted to the order book and not immediately matched. Only applicable to LIMIT orders with GTC or GTD time in force.
      */
     postOnly?: boolean;
+    pegOffsetType?: PegOffsetType;
+    offset?: string;
+    /**
+     * next: 23
+     */
+    wigLevel?: string;
 };

package/dist/types/model/CreatePortfolioAddressBookEntryRequest.d.ts

@@ -17,6 +17,7 @@
  *
  *  Do not edit the class manually.
  */
+import { TravelRuleEntry } from './TravelRuleEntry';
 export type CreatePortfolioAddressBookEntryRequest = {
     /**
      * Crypto address to add
@@ -34,4 +35,9 @@ export type CreatePortfolioAddressBookEntryRequest = {
      * Account Identifier (memo/destination tag)
      */
     accountIdentifier?: string;
+    /**
+     * List of compatible chain IDs for the address, empty for Solana
+     */
+    chainIds?: Array<string>;
+    travelRuleData?: TravelRuleEntry;
 };

package/dist/types/model/DateOfBirth.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * This file is generated by Openapi Generator https://github.com/openapitools/openapi-generator
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ *  Do not edit the class manually.
+ */
+export type DateOfBirth = {
+    year?: number;
+    month?: number;
+    day?: number;
+};