@coinbase-sample/prime-sdk-ts 0.4.1 → 0.5.0

package/dist/shared/paginatedResponse.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * 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.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseExtractors = void 0;
+exports.createPaginatedResponse = createPaginatedResponse;
+exports.getDefaultPaginationOptions = getDefaultPaginationOptions;
+exports.getQueryParams = getQueryParams;
+const constants_1 = require("../constants");
+/**
+ * Validates that a number is a positive integer
+ */
+function validatePositiveInteger(value, defaultValue) {
+    if (value === undefined || value === null)
+        return defaultValue;
+    const num = Number(value);
+    if (!Number.isInteger(num) || num <= 0) {
+        throw new Error(`Value must be a positive integer, got: ${value}`);
+    }
+    return num;
+}
+/**
+ * Factory function to create enhanced response objects with pagination methods
+ */
+function createPaginatedResponse(responseData, apiCall, baseRequest, dataExtractor, options) {
+    var _a, _b;
+    const paginationMethods = {
+        __apiCall: apiCall,
+        __baseRequest: baseRequest,
+        __dataExtractor: dataExtractor,
+        __config: {
+            defaultLimit: 25,
+            maxPages: (_a = options === null || options === void 0 ? void 0 : options.maxPages) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_MAX_PAGES,
+            maxItems: (_b = options === null || options === void 0 ? void 0 : options.maxItems) !== null && _b !== void 0 ? _b : constants_1.DEFAULT_MAX_ITEMS,
+        },
+        __currentPage: 1,
+        __totalItemsFetched: 0,
+        hasNext() {
+            var _a, _b, _c, _d;
+            const pagination = this.pagination;
+            const hasApiNext = (_b = (_a = pagination === null || pagination === void 0 ? void 0 : pagination.has_next) !== null && _a !== void 0 ? _a : pagination === null || pagination === void 0 ? void 0 : pagination.hasNext) !== null && _b !== void 0 ? _b : false;
+            // Check if API has more pages
+            if (!hasApiNext) {
+                return false;
+            }
+            // Check if we've reached the max pages limit
+            if (this.__currentPage >= ((_c = this.__config.maxPages) !== null && _c !== void 0 ? _c : constants_1.DEFAULT_MAX_PAGES)) {
+                return false;
+            }
+            // Check if we've reached the max items limit
+            if (this.__totalItemsFetched >=
+                ((_d = this.__config.maxItems) !== null && _d !== void 0 ? _d : constants_1.DEFAULT_MAX_ITEMS)) {
+                return false;
+            }
+            return true;
+        },
+        getNextCursor() {
+            const pagination = this.pagination;
+            return pagination === null || pagination === void 0 ? void 0 : pagination.nextCursor;
+        },
+        next(options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                if (options === null || options === void 0 ? void 0 : options.maxPages) {
+                    this.__config.maxPages = validatePositiveInteger(options.maxPages, constants_1.DEFAULT_MAX_PAGES);
+                }
+                if (options === null || options === void 0 ? void 0 : options.maxItems) {
+                    this.__config.maxItems = validatePositiveInteger(options.maxItems, constants_1.DEFAULT_MAX_ITEMS);
+                }
+                if (!this.hasNext()) {
+                    return null;
+                }
+                const request = Object.assign(Object.assign({}, this.__baseRequest), { cursor: this.getNextCursor(), limit: (_b = (_a = this.__baseRequest) === null || _a === void 0 ? void 0 : _a.limit) !== null && _b !== void 0 ? _b : this.__config.defaultLimit });
+                const nextResponse = yield this.__apiCall(request, options);
+                if (nextResponse) {
+                    // Update pagination tracking
+                    nextResponse.__currentPage = this.__currentPage + 1;
+                    const nextData = this.__dataExtractor(nextResponse);
+                    nextResponse.__totalItemsFetched =
+                        this.__totalItemsFetched + nextData.length;
+                }
+                return nextResponse;
+            });
+        },
+        fetchAll(options, progressCallback) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                const allData = [];
+                let currentResponse = this;
+                let pageCount = 1;
+                let totalItems = 0;
+                if (options === null || options === void 0 ? void 0 : options.maxPages) {
+                    this.__config.maxPages = validatePositiveInteger(options.maxPages, constants_1.DEFAULT_MAX_PAGES);
+                }
+                if (options === null || options === void 0 ? void 0 : options.maxItems) {
+                    this.__config.maxItems = validatePositiveInteger(options.maxItems, constants_1.DEFAULT_MAX_ITEMS);
+                }
+                // Add current page data
+                const currentData = this.__dataExtractor(currentResponse);
+                allData.push(...currentData);
+                totalItems += currentData.length;
+                progressCallback === null || progressCallback === void 0 ? void 0 : progressCallback(pageCount, totalItems);
+                // Fetch remaining pages
+                while (currentResponse.hasNext() &&
+                    pageCount < ((_a = this.__config.maxPages) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_MAX_PAGES) &&
+                    totalItems < ((_b = this.__config.maxItems) !== null && _b !== void 0 ? _b : constants_1.DEFAULT_MAX_ITEMS)) {
+                    const nextResponse = yield currentResponse.next(this.__config);
+                    if (!nextResponse)
+                        break;
+                    pageCount++;
+                    const nextData = this.__dataExtractor(nextResponse);
+                    allData.push(...nextData);
+                    totalItems += nextData.length;
+                    progressCallback === null || progressCallback === void 0 ? void 0 : progressCallback(pageCount, totalItems);
+                    currentResponse = nextResponse;
+                }
+                return allData;
+            });
+        },
+    };
+    // Initialize tracking for the first page
+    const currentPageData = dataExtractor(responseData);
+    paginationMethods.__totalItemsFetched = currentPageData.length;
+    return Object.assign(responseData, paginationMethods);
+}
+/**
+ * Common data extractors for typical API responses
+ */
+exports.ResponseExtractors = {
+    activities: (response) => response.activities || [],
+    addresses: (response) => response.addresses || [],
+    allocations: (response) => response.allocations || [],
+    balances: (response) => response.balances || [],
+    fills: (response) => response.fills || [],
+    invoices: (response) => response.invoices || [],
+    orders: (response) => response.orders || [],
+    positions: (response) => response.positions || [],
+    products: (response) => response.products || [],
+    portfolios: (response) => response.portfolios || [],
+    transactions: (response) => response.transactions || [],
+    users: (response) => response.users || [],
+    wallets: (response) => response.wallets || [],
+};
+/**
+ * Get the default pagination options for a client
+ */
+function getDefaultPaginationOptions(client, options) {
+    var _a, _b;
+    return Object.assign(Object.assign({}, options), { maxPages: (_a = options === null || options === void 0 ? void 0 : options.maxPages) !== null && _a !== void 0 ? _a : client.getMaxPages(), maxItems: (_b = options === null || options === void 0 ? void 0 : options.maxItems) !== null && _b !== void 0 ? _b : client.getMaxItems() });
+}
+function getQueryParams(client, request) {
+    let queryParams = {};
+    if (request.limit) {
+        queryParams.limit = request.limit;
+    }
+    if (request.cursor) {
+        queryParams.cursor = request.cursor;
+    }
+    if (!queryParams.limit) {
+        queryParams.limit = client.getDefaultPaginationLimit();
+    }
+    return queryParams;
+}

package/dist/shared/pagination.js

@@ -1,2 +1,17 @@
 "use strict";
+/**
+ * Copyright 2024-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.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/shared/toCamelCase.js

@@ -1,4 +1,19 @@
 "use strict";
+/**
+ * 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.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toCamelCase = toCamelCase;
 function toCamelCase(obj, seen = new WeakSet()) {

package/dist/transactions/index.js

@@ -26,6 +26,7 @@ exports.TransactionsService = void 0;
  * limitations under the License.
  */
 const core_ts_1 = require("@coinbase-sample/core-ts");
+const paginatedResponse_1 = require("../shared/paginatedResponse");
 class TransactionsService {
     constructor(client) {
         this.client = client;
@@ -42,23 +43,37 @@ class TransactionsService {
     listPortfolioTransactions(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParams = Object.assign(Object.assign({}, request), { portfolioId: undefined });
+            if (!queryParams.limit) {
+                queryParams.limit = this.client.getDefaultPaginationLimit();
+            }
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/transactions`,
                 queryParams,
                 callOptions: options,
             });
-            return response.data;
+            const responseData = response.data;
+            // Merge client defaults with call options
+            const paginationOptions = (0, paginatedResponse_1.getDefaultPaginationOptions)(this.client, options);
+            // Enhance the response with pagination methods
+            return (0, paginatedResponse_1.createPaginatedResponse)(responseData, this.listPortfolioTransactions.bind(this), request, paginatedResponse_1.ResponseExtractors.transactions, paginationOptions);
         });
     }
     listWalletTransactions(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParams = Object.assign(Object.assign({}, request), { portfolioId: undefined, walletId: undefined });
+            if (!queryParams.limit) {
+                queryParams.limit = this.client.getDefaultPaginationLimit();
+            }
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/wallets/${request.walletId}/transactions`,
                 queryParams,
                 callOptions: options,
             });
-            return response.data;
+            const responseData = response.data;
+            // Merge client defaults with call options
+            const paginationOptions = (0, paginatedResponse_1.getDefaultPaginationOptions)(this.client, options);
+            // Enhance the response with pagination methods
+            return (0, paginatedResponse_1.createPaginatedResponse)(responseData, this.listWalletTransactions.bind(this), request, paginatedResponse_1.ResponseExtractors.transactions, paginationOptions);
         });
     }
     createConversion(request, options) {

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

@@ -13,10 +13,11 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { ActivityCategory, ActivityStatus } from '../model/enums/';
 import { GetActivityResponse as internalGet, GetEntityActivitiesResponse, GetPortfolioActivitiesResponse, GetPortfolioActivityResponse as internalGetPortAct } from '../model/';
 import { Pagination } from '../shared/pagination';
+import { BasePaginatedRequest, PaginatedResponseMethods } from '../shared/paginatedResponse';
 export type ActivityFilters = Pagination & {
     symbols?: string[];
     categories?: ActivityCategory[];
@@ -32,11 +33,13 @@ export type ListEntityActivitiesRequest = Pagination & ActivityFilters & {
     entityId: string;
     activityLevel?: string;
 };
-export type ListEntityActivitiesResponse = GetEntityActivitiesResponse;
+export type BaseListEntityActivitiesResponse = GetEntityActivitiesResponse;
+export type ListEntityActivitiesResponse = BaseListEntityActivitiesResponse & PaginatedResponseMethods<ListEntityActivitiesRequest & BasePaginatedRequest, BaseListEntityActivitiesResponse, any>;
 export type ListPortfolioActivitiesRequest = Pagination & ActivityFilters & {
     portfolioId: string;
 };
-export type ListPortfolioActivitiesResponse = Brand<GetPortfolioActivitiesResponse, 'ListPortfolioActivitiesResponse'>;
+export type BaseListPortfolioActivitiesResponse = Brand<GetPortfolioActivitiesResponse, 'ListPortfolioActivitiesResponse'>;
+export type ListPortfolioActivitiesResponse = BaseListPortfolioActivitiesResponse & PaginatedResponseMethods<ListPortfolioActivitiesRequest & BasePaginatedRequest, BaseListPortfolioActivitiesResponse, any>;
 export type GetPortfolioActivitiesRequest = {
     portfolioId: string;
     activityId: string;

package/dist/types/addressBooks/types.d.ts

@@ -13,15 +13,17 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { GetPortfolioAddressBookResponse, CreatePortfolioAddressBookEntryRequest, CreatePortfolioAddressBookEntryResponse } from '../model/';
 import { Pagination } from '../shared/pagination';
+import { BasePaginatedRequest, PaginatedResponseMethods } from '../shared/paginatedResponse';
 export type ListAddressBooksRequest = Pagination & {
     portfolioId: string;
     currencySymbol?: string;
     search?: string;
 };
-export type ListAddressBooksResponse = Brand<GetPortfolioAddressBookResponse, 'ListAddressBooksResponse'>;
+export type BaseListAddressBooksResponse = Brand<GetPortfolioAddressBookResponse, 'ListAddressBooksResponse'>;
+export type ListAddressBooksResponse = BaseListAddressBooksResponse & PaginatedResponseMethods<ListAddressBooksRequest & BasePaginatedRequest, BaseListAddressBooksResponse, any>;
 export type CreateAddressBookRequest = CreatePortfolioAddressBookEntryRequest & {
     portfolioId: string;
 };

package/dist/types/allocations/types.d.ts

@@ -13,10 +13,11 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { CreateAllocationRequest as internalCreate, CreateAllocationResponse as internalResponse, CreateNetAllocationResponse as internalNetCreate, GetPortfolioAllocationsResponse, GetAllocationResponse as internalGet, GetAllocationsByClientNettingIdResponse } from '../model/';
 import { OrderSide } from '../model/enums/';
 import { Pagination } from '../shared/pagination';
+import { BasePaginatedRequest, PaginatedResponseMethods } from '../shared/paginatedResponse';
 export type CreateAllocationRequest = Brand<internalCreate, 'CreateAllocationRequest'>;
 export type CreateAllocationResponse = Brand<internalResponse, 'CreateAllocationResponse'>;
 export type CreateNetAllocationRequest = Brand<internalCreate, 'CreateNetAllocationRequest'>;
@@ -28,7 +29,8 @@ export type ListPortfolioAllocationsRequest = Pagination & {
     startDate?: string;
     endDate?: string;
 };
-export type ListPortfolioAllocationsResponse = Brand<GetPortfolioAllocationsResponse, 'ListPortfolioAllocationsResponse'>;
+export type BaseListPortfolioAllocationsResponse = Brand<GetPortfolioAllocationsResponse, 'ListPortfolioAllocationsResponse'>;
+export type ListPortfolioAllocationsResponse = BaseListPortfolioAllocationsResponse & PaginatedResponseMethods<ListPortfolioAllocationsRequest & BasePaginatedRequest, BaseListPortfolioAllocationsResponse, any>;
 export type ListNetAllocationsRequest = {
     portfolioId: string;
     nettingId: string;

package/dist/types/assets/types.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { GetEntityAssetsResponse } from '../model/';
 export type ListAssetsRequest = {
     entityId: string;

package/dist/types/balances/types.d.ts

@@ -13,9 +13,10 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { PortfolioBalanceType, VisibilityStatus } from '../model/enums/';
 import { GetPortfolioBalancesResponse, GetWalletBalanceResponse as internalGetResp, ListWeb3WalletBalancesResponse, ListEntityBalancesResponse as internalListEntityBalances } from '../model/';
+import { BasePaginatedRequest, PaginatedResponseMethods } from '../shared/paginatedResponse';
 export type ListPortfolioBalancesRequest = {
     portfolioId: string;
     symbol: string;
@@ -34,7 +35,8 @@ export type ListOnchainWalletBalancesRequest = {
     cursor?: string;
     limit?: number;
 };
-export type ListOnchainWalletBalancesResponse = Brand<ListWeb3WalletBalancesResponse, 'ListOnchainWalletBalancesResponse'>;
+export type BaseListOnchainWalletBalancesResponse = Brand<ListWeb3WalletBalancesResponse, 'ListOnchainWalletBalancesResponse'>;
+export type ListOnchainWalletBalancesResponse = BaseListOnchainWalletBalancesResponse & PaginatedResponseMethods<ListOnchainWalletBalancesRequest & BasePaginatedRequest, BaseListOnchainWalletBalancesResponse, any>;
 export type ListEntityBalancesRequest = {
     entityId: string;
     symbols?: string;
@@ -42,4 +44,5 @@ export type ListEntityBalancesRequest = {
     limit?: number;
     aggregationType?: PortfolioBalanceType;
 };
-export type ListEntityBalancesResponse = Brand<internalListEntityBalances, 'ListEntityBalancesResponse'>;
+export type BaseListEntityBalancesResponse = Brand<internalListEntityBalances, 'ListEntityBalancesResponse'>;
+export type ListEntityBalancesResponse = BaseListEntityBalancesResponse & PaginatedResponseMethods<ListEntityBalancesRequest & BasePaginatedRequest, BaseListEntityBalancesResponse, any>;

package/dist/types/client.d.ts

@@ -13,8 +13,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { CoinbaseClient } from '@coinbase-sample/core-ts';
+import { CoinbaseClient, CoinbaseHttpClientRetryOptions } from '@coinbase-sample/core-ts';
 import { CoinbasePrimeCredentials } from './credentials';
 export declare class CoinbasePrimeClient extends CoinbaseClient {
-    constructor(credentials?: CoinbasePrimeCredentials, apiBasePath?: string);
+    constructor(credentials?: CoinbasePrimeCredentials, apiBasePath?: string, options?: CoinbaseHttpClientRetryOptions);
 }

package/dist/types/commission/types.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { GetPortfolioCommissionResponse as internalGet } from '../model/';
 export type GetPortfolioCommissionRequest = {
     portfolioId: string;

package/dist/types/constants.d.ts

@@ -20,3 +20,6 @@ export declare const CB_ACCESS_KEY_HEADER = "X-CB-ACCESS-KEY";
 export declare const CB_ACCESS_PHRASE_HEADER = "X-CB-ACCESS-PASSPHRASE";
 export declare const CB_ACCESS_SIGNATURE_HEADER = "X-CB-ACCESS-SIGNATURE";
 export declare const CB_ACCESS_TIMESTAMP_HEADER = "X-CB-ACCESS-TIMESTAMP";
+export declare const DEFAULT_PAGINATION_LIMIT = 25;
+export declare const DEFAULT_MAX_PAGES = 100;
+export declare const DEFAULT_MAX_ITEMS = 10000;

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

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { GetExistingLocatesResponse, GetInterestAccrualsResponse, GetLocateAvailabilitiesResponse, GetMarginConversionsResponse, GetMarginSummariesResponse, GetMarginInformationResponse as internalGetMarginInformationResponse, GetBuyingPowerResponse, GetPostTradeCreditResponse, GetTFTieredPricingFeesResponse, GetWithdrawalPowerResponse, CreateNewLocatesResponse as internalCreateNewLocatesResponse } from '../model/';
 export type ListExistingLocatesRequest = {
     portfolioId: string;

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

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { GetFcmBalanceResponse, GetFuturesSweepsResponse, GetPositionsResponse, SetAutoSweepResponse, ScheduleFuturesSweepRequest, ScheduleFuturesSweepResponse, CancelFuturesSweepResponse } from '../model/';
 export type ListEntityFuturesSweepsRequest = {
     entityId: string;

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

@@ -17,10 +17,10 @@ import { CoinbaseCallOptions } from '@coinbase-sample/core-ts';
 import { CoinbasePrimeClient } from '../client';
 import { ListInvoicesRequest, ListInvoicesResponse } from './types';
 export interface IInvoicesService {
-    listInvoicess(request: ListInvoicesRequest, options?: CoinbaseCallOptions): Promise<ListInvoicesResponse>;
+    listInvoices(request: ListInvoicesRequest, options?: CoinbaseCallOptions): Promise<ListInvoicesResponse>;
 }
 export declare class InvoicesService implements IInvoicesService {
     private client;
     constructor(client: CoinbasePrimeClient);
-    listInvoicess(request: ListInvoicesRequest, options?: CoinbaseCallOptions): Promise<ListInvoicesResponse>;
+    listInvoices(request: ListInvoicesRequest, options?: CoinbaseCallOptions): Promise<ListInvoicesResponse>;
 }

package/dist/types/invoices/types.d.ts

@@ -13,9 +13,15 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { GetInvoicesResponse } from '../model/';
-export type ListInvoicesRequest = {
+import { BasePaginatedRequest, PaginatedResponseMethods } from '../shared/paginatedResponse';
+import { Pagination } from '../shared/pagination';
+export type ListInvoicesRequest = Pagination & {
     entityId: string;
+    states?: string[];
+    billingYear?: string;
+    billingMonth?: string;
 };
-export type ListInvoicesResponse = Brand<GetInvoicesResponse, 'ListInvoicesResponse'>;
+export type BaseListInvoicesResponse = Brand<GetInvoicesResponse, 'ListInvoicesResponse'>;
+export type ListInvoicesResponse = BaseListInvoicesResponse & PaginatedResponseMethods<ListInvoicesRequest & BasePaginatedRequest, BaseListInvoicesResponse, any>;

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

@@ -19,7 +19,7 @@
  */
 export type Commission = {
     /**
-     * Hardcode type to all_in. When we support cost+, we will have cost_plus type
+     * Fee model (all_in or cost_plus)
      */
     type?: string;
     /**

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

@@ -27,7 +27,7 @@ export type CreateOnchainTransactionRequestEvmParams = {
      */
     disableDynamicNonce?: boolean;
     /**
-     * Transaction ID to replace (for speed-up/cancel operations). Common use cases: 1) Gas Price Adjustments: When a transaction is stuck due to low gas price, a new transaction with the same nonce but higher gas price can be submitted to replace it. 2) Transaction Cancellation: A user might want to cancel a pending transaction by replacing it with a new transaction (often a 0-value transfer to themselves with higher gas price). Note: When using this field, the disable_dynamic_nonce option must be set to false because the nonce will be automatically managed by the system.
+     * Transaction ID to replace (for speed-up/cancel operations). Common use cases: 1) Gas Price Adjustments: When a transaction is stuck due to low gas price, a new transaction with the same nonce but higher gas price can be submitted to replace it. 2) Transaction Cancellation: A user might want to cancel a pending transaction by replacing it with a new transaction (often a 0-value transfer to themselves with higher gas price). Note: When using this field, the disable_dynamic_nonce option must be set to false because the nonce would be automatically managed by the system.
      */
     replacedTransactionId?: string;
     /**

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

@@ -0,0 +1,25 @@
+/**
+ * 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 CreateWalletDepositAddressRequest = {
+    /**
+     * The network name and type
+     */
+    networkId: string;
+};

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

@@ -32,7 +32,7 @@ export type Fill = {
      */
     productId?: string;
     /**
-     * The client product ID of the fill indicating the settlement currency
+     * The client product ID of the fill indictating the settlment currency
      */
     clientProductId?: string;
     side?: OrderSide;

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

@@ -0,0 +1,25 @@
+/**
+ * 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.
+ */
+import { BlockchainAddress } from './BlockchainAddress';
+import { PaginatedResponse } from './PaginatedResponse';
+export type ListWalletAddressesResponse = {
+    addresses: Array<BlockchainAddress>;
+    pagination: PaginatedResponse;
+};

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

@@ -107,7 +107,7 @@ export type Order = {
      */
     userContext?: string;
     /**
-     * The client product ID of the fill indicating the settlement currency
+     * The client product ID of the fill indictating the settlment currency
      */
     clientProductId?: string;
 };

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

@@ -24,4 +24,12 @@ export type TransferLocation = {
      * The value of the transfer location: payment method ID, wallet ID or crypto address
      */
     value?: string;
+    /**
+     * The crypto address of the transfer location
+     */
+    address?: string;
+    /**
+     * The tag/memo of the address, if applicable -- required for certain assets (e.g. XRP, XLM, etc.)
+     */
+    accountIdentifier?: string;
 };

package/dist/types/model/enums/TransactionStatus.d.ts

@@ -18,7 +18,7 @@
  *  Do not edit the class manually.
  */
 /**
- * - UNKNOWN_TRANSACTION_STATUS: An Unknown Transaction status  - TRANSACTION_CREATED: The Transaction has been created and is awaiting Consensus approval This is a non-terminal status  - TRANSACTION_REQUESTED: The Transaction has reached User Consensus and is awaiting Coinbase Prime approval This is a non-terminal status  - TRANSACTION_APPROVED: The Transaction has been authorized by Coinbase Prime This is a non-terminal status  - TRANSACTION_GASSING: The transaction is awaiting blockchain resources for broadcast This is a non-terminal status  - TRANSACTION_GASSED: The transaction has received blockchain resources for broadcasting This is a non-terminal status  - TRANSACTION_PROVISIONED: The transaction has been provisioned and is awaiting planning This is a non-terminal status  - TRANSACTION_PLANNED: The transaction has been constructed.  This is a non-terminal status  - TRANSACTION_PROCESSING: The transaction is currently processing and awaiting finalization This is a non-terminal status  - TRANSACTION_RESTORED: The transaction has been broadcasted to the network. This is a non-terminal status  - TRANSACTION_DONE: The transaction has confirmed on-chain and finished.  This is a terminal status  - TRANSACTION_IMPORT_PENDING: The transaction deposit has been detected and is awaiting finalization. This is a non-terminal status  - TRANSACTION_IMPORTED: The transaction deposit and reward has been detected. This is a terminal status  - TRANSACTION_CANCELLED: The transaction has been cancelled This is a terminal status  - TRANSACTION_REJECTED: The transaction was rejected before construction and broadcasting. This is a terminal status  - TRANSACTION_DELAYED: The transaction s taking longer than expected to confirm on-chain. This is a non-terminal status  - TRANSACTION_RETRIED: The transaction has been recreated and retried, this occurs when network congestion results in transfers becoming extremely delayed due to insufficient fees or network resources such as CPU, RAM, or NET This is a terminal status  - TRANSACTION_FAILED: The transaction failed on-chain (the fee was spent but the operation failed). This is a terminal status  - TRANSACTION_EXPIRED: The transaction has expired. This is a terminal status  - TRANSACTION_BROADCASTING: The transaction is currently broadcasting to the cryptocurrency network. This is a non-terminal status  - OTHER_TRANSACTION_STATUS: The transaction has reached an OTHER status. This is a non-terminal status  - TRANSACTION_CONSTRUCTED: The transaction  bctx is constructed but not yet broadcasting on chain This is a non-terminal status
+ * - UNKNOWN_TRANSACTION_STATUS: An Unknown Transaction status  - TRANSACTION_CREATED: The Transaction has been created and is awaiting Consensus approval This is a non-terminal status  - TRANSACTION_REQUESTED: The Transaction has reached User Consensus and is awaiting Coinbase Prime approval This is a non-terminal status  - TRANSACTION_APPROVED: The Transaction has been authorized by Coinbase Prime This is a non-terminal status  - TRANSACTION_GASSING: The transaction is awaiting blockchain resources for broadcast This is a non-terminal status  - TRANSACTION_GASSED: The transaction has received blockchain resources for broadcasting This is a non-terminal status  - TRANSACTION_PROVISIONED: The transaction has been provisioned and is awaiting planning This is a non-terminal status  - TRANSACTION_PLANNED: The transaction has been constructed. This is a non-terminal status  - TRANSACTION_PROCESSING: The transaction is currently processing and awaiting finalization This is a non-terminal status  - TRANSACTION_RESTORED: The transaction has been broadcasted to the network. This is a non-terminal status  - TRANSACTION_DONE: The transaction has confirmed on-chain and finished. This is a terminal status  - TRANSACTION_IMPORT_PENDING: The transaction deposit has been detected and is awaiting finalization. This is a non-terminal status  - TRANSACTION_IMPORTED: The transaction deposit and reward has been detected. This is a terminal status  - TRANSACTION_CANCELLED: The transaction has been cancelled This is a terminal status  - TRANSACTION_REJECTED: The transaction was rejected before construction and broadcasting. This is a terminal status  - TRANSACTION_DELAYED: The transaction s taking longer than expected to confirm on-chain. This is a non-terminal status  - TRANSACTION_RETRIED: The transaction has been recreated and retried, this occurs when network congestion results in transfers becoming extremely delayed due to insufficient fees or network resources such as CPU, RAM, or NET This is a terminal status  - TRANSACTION_FAILED: The transaction failed on-chain (the fee was spent but the operation failed). This is a terminal status  - TRANSACTION_EXPIRED: The transaction has expired. This is a terminal status  - TRANSACTION_BROADCASTING: The transaction is currently broadcasting to the cryptocurrency network. This is a non-terminal status  - OTHER_TRANSACTION_STATUS: The transaction has reached an OTHER status. This is a non-terminal status  - TRANSACTION_CONSTRUCTED: The transaction  bctx is constructed but not yet broadcasting on chain This is a non-terminal status
  */
 export declare enum TransactionStatus {
     UnknownTransactionStatus = "UNKNOWN_TRANSACTION_STATUS",

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

@@ -101,6 +101,7 @@ export type { ListAggregateEntityPositionsResponse } from './ListAggregateEntity
 export type { ListEntityBalancesResponse } from './ListEntityBalancesResponse';
 export type { ListEntityPositionsResponse } from './ListEntityPositionsResponse';
 export type { ListOnchainAddressGroupsResponse } from './ListOnchainAddressGroupsResponse';
+export type { ListWalletAddressesResponse } from './ListWalletAddressesResponse';
 export type { ListWeb3WalletBalancesResponse } from './ListWeb3WalletBalancesResponse';
 export type { LoanInfo } from './LoanInfo';
 export type { Locate } from './Locate';
@@ -158,6 +159,7 @@ export type { CreateNewLocatesRequest } from './CreateNewLocatesRequest';
 export type { CreateOnchainTransactionRequest } from './CreateOnchainTransactionRequest';
 export type { CreateOrderRequest } from './CreateOrderRequest';
 export type { CreatePortfolioAddressBookEntryRequest } from './CreatePortfolioAddressBookEntryRequest';
+export type { CreateWalletDepositAddressRequest } from './CreateWalletDepositAddressRequest';
 export type { CreateWalletRequest } from './CreateWalletRequest';
 export type { CreateWalletWithdrawalRequest } from './CreateWalletWithdrawalRequest';
 export type { OrderPreviewRequest } from './OrderPreviewRequest';

package/dist/types/onchainAddressBook/types.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Brand } from 'src/shared/brand';
+import { Brand } from '../shared/brand';
 import { ListOnchainAddressGroupsResponse as listInt, AddressGroup, ActivityCreationResponse } from '../model/';
 export type ListOnchainAddressBookRequest = {
     portfolioId: string;