@coinbase-sample/prime-sdk-ts 0.6.2 → 0.6.3

package/dist/shared/envUtils.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCredentialsFromEnv = createCredentialsFromEnv;
+/**
+ * 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 credentials_1 = require("../credentials");
+/**
+ * Shared utility function to create credentials from environment variables
+ * Used by both CoinbasePrimeClient and CoinbasePrimeClientWithServices
+ *
+ * Automatically attempts to load .env file if dotenv is available.
+ * If dotenv is not installed or .env file doesn't exist, falls back to
+ * using environment variables set directly.
+ *
+ * @advanced For custom scenarios. Most users should use Client.fromEnv() instead.
+ * @example
+ * ```typescript
+ * // Basic usage (recommended)
+ * const client = CoinbasePrimeClient.fromEnv();
+ *
+ * // Advanced usage (custom scenarios)
+ * const credentials = createCredentialsFromEnv();
+ * const client = new CoinbasePrimeClient(credentials, 'custom-url');
+ * ```
+ */
+function createCredentialsFromEnv() {
+    // Try to load .env file if dotenv is available (optional)
+    try {
+        require('dotenv').config();
+    }
+    catch (error) {
+        // dotenv not installed or .env file doesn't exist - that's fine
+        // Environment variables might be set directly via shell, Docker, CI/CD, etc.
+    }
+    const credsJson = process.env.PRIME_CREDENTIALS;
+    if (!credsJson) {
+        throw new Error('PRIME_CREDENTIALS environment variable is required. ' +
+            'Set it to a JSON string with AccessKey, SecretKey, and Passphrase. ' +
+            'You can set it directly (export PRIME_CREDENTIALS=\'{"AccessKey":"...","SecretKey":"...","Passphrase":"..."}\') ' +
+            'or create a .env file with PRIME_CREDENTIALS={"AccessKey":"...","SecretKey":"...","Passphrase":"..."}.');
+    }
+    let creds;
+    try {
+        creds = JSON.parse(credsJson);
+    }
+    catch (error) {
+        throw new Error('PRIME_CREDENTIALS must be valid JSON with AccessKey, SecretKey, and Passphrase fields.');
+    }
+    if (!creds.AccessKey || !creds.SecretKey || !creds.Passphrase) {
+        throw new Error('PRIME_CREDENTIALS must contain AccessKey, SecretKey, and Passphrase fields.');
+    }
+    return new credentials_1.CoinbasePrimeCredentials(creds.AccessKey, creds.SecretKey, creds.Passphrase);
+}

package/dist/staking/index.js

@@ -25,7 +25,7 @@ exports.StakingService = void 0;
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-const core_ts_1 = require("@coinbase-sample/core-ts");
+const clients_1 = require("../clients");
 class StakingService {
     constructor(client) {
         this.client = client;
@@ -35,7 +35,7 @@ class StakingService {
             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/initiate`,
-                method: core_ts_1.Method.POST,
+                method: clients_1.Method.POST,
                 bodyParams,
                 callOptions: options,
             });
@@ -47,7 +47,7 @@ class StakingService {
             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`,
-                method: core_ts_1.Method.POST,
+                method: clients_1.Method.POST,
                 bodyParams,
                 callOptions: options,
             });
@@ -59,7 +59,7 @@ class StakingService {
             const bodyParams = Object.assign(Object.assign({}, request), { portfolioId: undefined });
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/staking/initiate`,
-                method: core_ts_1.Method.POST,
+                method: clients_1.Method.POST,
                 bodyParams,
                 callOptions: options,
             });
@@ -71,7 +71,7 @@ class StakingService {
             const bodyParams = Object.assign(Object.assign({}, request), { portfolioId: undefined });
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/staking/unstake`,
-                method: core_ts_1.Method.POST,
+                method: clients_1.Method.POST,
                 bodyParams,
                 callOptions: options,
             });

package/dist/transactions/index.js

@@ -36,7 +36,7 @@ exports.TransactionsService = void 0;
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-const core_ts_1 = require("@coinbase-sample/core-ts");
+const clients_1 = require("../clients");
 const paginatedResponse_1 = require("../shared/paginatedResponse");
 class TransactionsService {
     constructor(client) {
@@ -91,7 +91,7 @@ class TransactionsService {
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/wallets/${request.walletId}/conversion`,
                 bodyParams,
-                method: core_ts_1.Method.POST,
+                method: clients_1.Method.POST,
                 callOptions: options,
             });
             return response.data;
@@ -103,7 +103,7 @@ class TransactionsService {
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/wallets/${request.walletId}/transfers`,
                 bodyParams,
-                method: core_ts_1.Method.POST,
+                method: clients_1.Method.POST,
                 callOptions: options,
             });
             return response.data;
@@ -115,7 +115,7 @@ class TransactionsService {
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/wallets/${request.walletId}/withdrawals`,
                 bodyParams,
-                method: core_ts_1.Method.POST,
+                method: clients_1.Method.POST,
                 callOptions: options,
             });
             return response.data;
@@ -127,7 +127,7 @@ class TransactionsService {
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/wallets/${request.walletId}/onchain_transaction`,
                 bodyParams,
-                method: core_ts_1.Method.POST,
+                method: clients_1.Method.POST,
                 callOptions: options,
             });
             return response.data;

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

@@ -13,8 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { CoinbaseCallOptions } from '@coinbase-sample/core-ts';
-import { CoinbasePrimeClient } from '../client';
+import { IPrimeApiClient, CoinbaseCallOptions } from '../clients';
 import { GetActivityRequest, GetActivityResponse, GetPortfolioActivitiesRequest, GetPortfolioActivityResponse, ListPortfolioActivitiesRequest, ListPortfolioActivitiesResponse, ListEntityActivitiesRequest, ListEntityActivitiesResponse } from './types';
 export interface IActivitiesService {
     getActivity(request: GetActivityRequest): Promise<GetActivityResponse>;
@@ -24,7 +23,7 @@ export interface IActivitiesService {
 }
 export declare class ActivitiesService implements IActivitiesService {
     private client;
-    constructor(client: CoinbasePrimeClient);
+    constructor(client: IPrimeApiClient);
     getActivity(request: GetActivityRequest, options?: CoinbaseCallOptions): Promise<GetActivityResponse>;
     getPortfolioActivity(request: GetPortfolioActivitiesRequest, options?: CoinbaseCallOptions): Promise<GetPortfolioActivityResponse>;
     listEntityActivities(request: ListEntityActivitiesRequest, options?: CoinbaseCallOptions): Promise<ListEntityActivitiesResponse>;

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

@@ -13,8 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { CoinbaseCallOptions } from '@coinbase-sample/core-ts';
-import { CoinbasePrimeClient } from '../client';
+import { CoinbaseCallOptions, IPrimeApiClient } from '../clients';
 import { ListAddressBooksRequest, ListAddressBooksResponse, CreateAddressBookRequest, CreateAddressBookResponse } from './types';
 export interface IAddressBooksService {
     listAddressBooks(request: ListAddressBooksRequest, options?: CoinbaseCallOptions): Promise<ListAddressBooksResponse>;
@@ -22,7 +21,7 @@ export interface IAddressBooksService {
 }
 export declare class AddressBooksService implements IAddressBooksService {
     private client;
-    constructor(client: CoinbasePrimeClient);
+    constructor(client: IPrimeApiClient);
     listAddressBooks(request: ListAddressBooksRequest, options?: CoinbaseCallOptions): Promise<ListAddressBooksResponse>;
     createAddressBook(request: CreateAddressBookRequest, options?: CoinbaseCallOptions): Promise<CreateAddressBookResponse>;
 }

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

@@ -13,8 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { CoinbaseCallOptions } from '@coinbase-sample/core-ts';
-import { CoinbasePrimeClient } from '../client';
+import { CoinbaseCallOptions, IPrimeApiClient } from '../clients';
 import { CreateAllocationRequest, CreateAllocationResponse, CreateNetAllocationRequest, CreateNetAllocationResponse, ListPortfolioAllocationsRequest, ListPortfolioAllocationsResponse, ListNetAllocationsRequest, ListNetAllocationsResponse, GetAllocationRequest, GetAllocationResponse } from './types';
 export interface IAllocationService {
     createAllocation(request: CreateAllocationRequest, options?: CoinbaseCallOptions): Promise<CreateAllocationResponse>;
@@ -25,7 +24,7 @@ export interface IAllocationService {
 }
 export declare class AllocationService implements IAllocationService {
     private client;
-    constructor(client: CoinbasePrimeClient);
+    constructor(client: IPrimeApiClient);
     createAllocation(request: CreateAllocationRequest, options?: CoinbaseCallOptions): Promise<CreateAllocationResponse>;
     createNetAllocation(request: CreateNetAllocationRequest, options?: CoinbaseCallOptions): Promise<CreateNetAllocationResponse>;
     listPortfolioAllocations(request: ListPortfolioAllocationsRequest, options?: CoinbaseCallOptions): Promise<ListPortfolioAllocationsResponse>;

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

@@ -13,14 +13,13 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { CoinbaseCallOptions } from '@coinbase-sample/core-ts';
-import { CoinbasePrimeClient } from '../client';
+import { IPrimeApiClient, CoinbaseCallOptions } from '../clients';
 import { ListAssetsRequest, ListAssetsResponse } from './types';
 export interface IAssetsService {
     listAssets(request: ListAssetsRequest, options?: CoinbaseCallOptions): Promise<ListAssetsResponse>;
 }
 export declare class AssetsService implements IAssetsService {
     private client;
-    constructor(client: CoinbasePrimeClient);
+    constructor(client: IPrimeApiClient);
     listAssets(request: ListAssetsRequest, options?: CoinbaseCallOptions): Promise<ListAssetsResponse>;
 }

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

@@ -13,8 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { CoinbaseCallOptions } from '@coinbase-sample/core-ts';
-import { CoinbasePrimeClient } from '../client';
+import { CoinbaseCallOptions, IPrimeApiClient } from '../clients';
 import { GetWalletBalanceRequest, GetWalletBalanceResponse, ListOnchainWalletBalancesRequest, ListOnchainWalletBalancesResponse, ListPortfolioBalancesRequest, ListPortfolioBalancesResponse, ListEntityBalancesRequest, ListEntityBalancesResponse } from './types';
 export interface IBalancesService {
     listPortfolioBalances(request: ListPortfolioBalancesRequest, options?: CoinbaseCallOptions): Promise<ListPortfolioBalancesResponse>;
@@ -24,7 +23,7 @@ export interface IBalancesService {
 }
 export declare class BalancesService implements IBalancesService {
     private client;
-    constructor(client: CoinbasePrimeClient);
+    constructor(client: IPrimeApiClient);
     listPortfolioBalances(request: ListPortfolioBalancesRequest, options?: CoinbaseCallOptions): Promise<ListPortfolioBalancesResponse>;
     getWalletBalance(request: GetWalletBalanceRequest, options?: CoinbaseCallOptions): Promise<GetWalletBalanceResponse>;
     listOnchainWalletBalances(request: ListOnchainWalletBalancesRequest, options?: CoinbaseCallOptions): Promise<ListOnchainWalletBalancesResponse>;

package/dist/types/client-manual.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 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.
+ */
+export { IPrimeApiClient, CoinbasePrimeClient, CoinbasePrimeClientConfig, CoinbaseClient, CoinbaseHttpClientRetryOptions, CoinbaseCallOptions, Method, CoinbaseClientException, CoinbaseError, CoinbaseResponse, TransformRequestFn, TransformResponseFn, } from './clients';
+export { CoinbasePrimeCredentials } from './credentials';
+export { createCredentialsFromEnv } from './shared/envUtils';
+export { ActivitiesService, IActivitiesService } from './activities';
+export { AddressBooksService, IAddressBooksService } from './addressBooks';
+export { AllocationService, IAllocationService } from './allocations';
+export { AssetsService, IAssetsService } from './assets';
+export { BalancesService, IBalancesService } from './balances';
+export { CommissionService, ICommissionService } from './commission';
+export { FinancingService, IFinancingService } from './financing';
+export { FuturesService, IFuturesService } from './futures';
+export { InvoicesService, IInvoicesService } from './invoices';
+export { OnchainAddressBookService } from './onchainAddressBook';
+export { OrdersService, IOrdersService } from './orders';
+export { PaymentMethodsService, IPaymentMethodsService, } from './paymentMethods';
+export { PortfoliosService, IPortfoliosService } from './portfolios';
+export { PositionsService, IPositionsService } from './positions';
+export { ProductsService, IProductsService } from './products';
+export { StakingService, IStakingService } from './staking';
+export { TransactionsService, ITransactionsService } from './transactions';
+export { UsersService, IUsersService } from './users';
+export { WalletsService, IWalletsService } from './wallets';
+export type * from './model/';
+export * from './model/enums/';
+export type { GetActivityRequest, GetActivityResponse, GetPortfolioActivitiesRequest, GetPortfolioActivityResponse, ListEntityActivitiesRequest, ListEntityActivitiesResponse, ListPortfolioActivitiesRequest, ListPortfolioActivitiesResponse, } from './activities/types';
+export type { CreateAddressBookRequest, CreateAddressBookResponse, ListAddressBooksRequest, ListAddressBooksResponse, } from './addressBooks/types';
+export type { CreateAllocationRequest, CreateAllocationResponse, CreateNetAllocationRequest, CreateNetAllocationResponse, ListNetAllocationsRequest, ListNetAllocationsResponse, ListPortfolioAllocationsRequest, ListPortfolioAllocationsResponse, GetAllocationRequest, GetAllocationResponse, } from './allocations/types';
+export type { ListAssetsRequest, ListAssetsResponse } from './assets/types';
+export type { GetWalletBalanceRequest, GetWalletBalanceResponse, ListOnchainWalletBalancesRequest, ListOnchainWalletBalancesResponse, ListPortfolioBalancesRequest, ListPortfolioBalancesResponse, ListEntityBalancesRequest, ListEntityBalancesResponse, } from './balances/types';
+export type { GetPortfolioCommissionRequest, GetPortfolioCommissionResponse, } from './commission/types';
+export type { AcceptQuoteRequest, AcceptQuoteResponse, CancelOrderRequest, CancelOrderResponse, CreateOrderPreviewRequest, CreateOrderPreviewResponse, CreateOrderRequest, CreateOrderResponse, CreateQuoteRequest, CreateQuoteResponse, GetOrderRequest, GetOrderResponse, GetOrderEditHistoryRequest, GetOrderEditHistoryResponse, ListOpenOrdersRequest, ListOpenOrdersResponse, ListOrderFillsRequest, ListOrderFillsResponse, ListPortfolioFillsRequest, ListPortfolioFillsResponse, ListPortfolioOrdersRequest, ListPortfolioOrdersResponse, } from './orders/types';
+export type { ListExistingLocatesRequest, ListExistingLocatesResponse, ListInterestAccrualsRequest, ListInterestAccrualsResponse, ListPortfolioInterestAccrualsRequest, ListPortfolioInterestAccrualsResponse, ListMarginCallSummariesRequest, ListMarginCallSummariesResponse, ListMarginConversionsRequest, ListMarginConversionsResponse, GetEntityLocateAvailabilitiesRequest, GetEntityLocateAvailabilitiesResponse, GetMarginInformationRequest, GetMarginInformationResponse, GetPortfolioBuyingPowerRequest, GetPortfolioBuyingPowerResponse, GetPortfolioCreditInformationRequest, GetPortfolioCreditInformationResponse, GetPortfolioWithdrawalPowerRequest, GetPortfolioWithdrawalPowerResponse, GetFcmMarginCallDetailsRequest, GetFcmMarginCallDetailsResponse, GetFcmRiskLimitsRequest, GetFcmRiskLimitsResponse, GetTieredPricingFeesRequest, GetTieredPricingFeesResponse, CreateNewLocatesRequest, CreateNewLocatesResponse, } from './financing/types';
+export type { CancelEntitySweepRequest, CancelEntitySweepResponse, GetEntityFuturesBalanceRequest, GetEntityFuturesBalanceResponse, GetEntityFuturesPositionsRequest, GetEntityFuturesPositionsResponse, ListEntityFuturesSweepsRequest, ListEntityFuturesSweepsResponse, ScheduleEntityFuturesSweepRequest, ScheduleEntityFuturesSweepResponse, UpdateEntityFuturesAutoSweepRequest, UpdateEntityFuturesAutoSweepResponse, } from './futures/types';
+export type { ListInvoicesRequest, ListInvoicesResponse, } from './invoices/types';
+export type { CreateOnchainAddressBookEntryRequest, CreateOnchainAddressBookEntryResponse, DeleteOnchainAddressBookEntryRequest, DeleteOnchainAddressBookEntryResponse, ListOnchainAddressBookRequest, ListOnchainAddressBookResponse, UpdateOnchainAddressBookEntryRequest, UpdateOnchainAddressBookEntryResponse, } from './onchainAddressBook/types';
+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 { CreateStakeRequest, CreateStakeResponse, CreateUnstakeRequest, CreateUnstakeResponse, CreatePortfolioStakeRequest, CreatePortfolioStakeResponse, CreatePortfolioUnstakeRequest, CreatePortfolioUnstakeResponse, } 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';
+export type { CreateWalletRequest, CreateWalletResponse, CreateWalletDepositAddressRequest, CreateWalletDepositAddressResponse, GetWalletDepositInstructionsRequest, GetWalletDepositInstructionsResponse, GetWalletRequest, GetWalletResponse, ListWalletAddressesRequest, ListWalletAddressesResponse, ListWalletsRequest, ListWalletsResponse, } from './wallets/types';

package/dist/types/client-modular.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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.
+ */
+export { IPrimeApiClient, CoinbasePrimeClientWithServices, CoinbasePrimeClientConfig, CoinbaseClient, CoinbaseHttpClientRetryOptions, CoinbaseCallOptions, Method, CoinbaseClientException, CoinbaseError, CoinbaseResponse, TransformRequestFn, TransformResponseFn, } from './clients';
+export { CoinbasePrimeCredentials } from './credentials';
+export { createCredentialsFromEnv } from './shared/envUtils';
+export type * from './model/';
+export * from './model/enums/';
+export type { IActivitiesService } from './activities';
+export type { IAddressBooksService } from './addressBooks';
+export type { IAllocationService } from './allocations';
+export type { IAssetsService } from './assets';
+export type { IBalancesService } from './balances';
+export type { ICommissionService } from './commission';
+export type { IFinancingService } from './financing';
+export type { IFuturesService } from './futures';
+export type { IInvoicesService } from './invoices';
+export type { OnchainAddressBookService } from './onchainAddressBook';
+export type { IOrdersService } from './orders';
+export type { IPaymentMethodsService } from './paymentMethods';
+export type { IPortfoliosService } from './portfolios';
+export type { IPositionsService } from './positions';
+export type { IProductsService } from './products';
+export type { IStakingService } from './staking';
+export type { ITransactionsService } from './transactions';
+export type { IUsersService } from './users';
+export type { IWalletsService } from './wallets';

package/dist/types/client-only.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export { CoinbasePrimeClient, CoinbasePrimeClientWithServices, CoinbasePrimeClientConfig, IPrimeApiClient, CoinbaseClient, CoinbaseHttpClientRetryOptions, CoinbaseCallOptions, Method, CoinbaseClientException, CoinbaseError, CoinbaseResponse, TransformRequestFn, TransformResponseFn, } from './clients';
+export { CoinbasePrimeCredentials } from './credentials';
+export { createCredentialsFromEnv } from './shared/envUtils';

package/dist/types/clients/client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+import { CoinbaseClient } from '@coinbase-sample/core-ts';
+import { CoinbasePrimeCredentials } from '../credentials';
+import type { CoinbasePrimeClientConfig, IPrimeApiClient } from './types';
+export declare class CoinbasePrimeClient extends CoinbaseClient implements IPrimeApiClient {
+    constructor(credentials?: CoinbasePrimeCredentials, apiBasePath?: string, options?: CoinbasePrimeClientConfig);
+    /**
+     * Create a client from environment variables
+     * Requires PRIME_CREDENTIALS environment variable with JSON containing:
+     * { "AccessKey": "...", "SecretKey": "...", "Passphrase": "..." }
+     */
+    static fromEnv(apiBaseUrl?: string, options?: CoinbasePrimeClientConfig): CoinbasePrimeClient;
+}

package/dist/types/clients/clientWithServices.d.ts

@@ -0,0 +1,229 @@
+/**
+ * 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.
+ */
+import { CoinbaseClient } from '@coinbase-sample/core-ts';
+import { CoinbasePrimeCredentials } from '../credentials';
+import type { CoinbasePrimeClientConfig, IPrimeApiClient } from './types';
+import { LazyServiceGetters } from './clientWithServicesTypes';
+import type { IActivitiesService } from '../activities';
+import type { IAddressBooksService } from '../addressBooks';
+import type { IAllocationService } from '../allocations';
+import type { IAssetsService } from '../assets';
+import type { IBalancesService } from '../balances';
+import type { ICommissionService } from '../commission';
+import type { IFinancingService } from '../financing';
+import type { IFuturesService } from '../futures';
+import type { IInvoicesService } from '../invoices';
+import type { OnchainAddressBookService } from '../onchainAddressBook';
+import type { IOrdersService } from '../orders';
+import type { IPaymentMethodsService } from '../paymentMethods';
+import type { IPortfoliosService } from '../portfolios';
+import type { IPositionsService } from '../positions';
+import type { IProductsService } from '../products';
+import type { IStakingService } from '../staking';
+import type { ITransactionsService } from '../transactions';
+import type { IUsersService } from '../users';
+import type { IWalletsService } from '../wallets';
+/**
+ * Enhanced Coinbase Prime Client with lazy-loaded service getters.
+ * Services are only instantiated when first accessed, improving tree-shaking
+ * and reducing initial bundle size.
+ */
+export declare class CoinbasePrimeClientWithServices extends CoinbaseClient implements LazyServiceGetters, IPrimeApiClient {
+    private _activitiesService?;
+    private _addressBooksService?;
+    private _allocationService?;
+    private _assetsService?;
+    private _balancesService?;
+    private _commissionService?;
+    private _financingService?;
+    private _futuresService?;
+    private _invoicesService?;
+    private _onchainAddressBookService?;
+    private _ordersService?;
+    private _paymentMethodsService?;
+    private _portfoliosService?;
+    private _positionsService?;
+    private _productsService?;
+    private _stakingService?;
+    private _transactionsService?;
+    private _usersService?;
+    private _walletsService?;
+    constructor(credentials?: CoinbasePrimeCredentials, apiBasePath?: string, options?: CoinbasePrimeClientConfig);
+    /**
+     * Create a client from environment variables
+     * Requires PRIME_CREDENTIALS environment variable with JSON containing:
+     * { "AccessKey": "...", "SecretKey": "...", "Passphrase": "..." }
+     */
+    static fromEnv(baseUrl?: string, options?: CoinbasePrimeClientConfig): CoinbasePrimeClientWithServices;
+    /**
+     * Lazy getter for ActivitiesService
+     * @example
+     * ```typescript
+     * const activities = await client.activities.listPortfolioActivities({ portfolioId });
+     * ```
+     */
+    get activities(): IActivitiesService;
+    /**
+     * Lazy getter for AddressBooksService
+     * @example
+     * ```typescript
+     * const addressBooks = await client.addressBooks.listAddressBooks({ portfolioId });
+     * ```
+     */
+    get addressBooks(): IAddressBooksService;
+    /**
+     * Lazy getter for AllocationService
+     * @example
+     * ```typescript
+     * const allocation = await client.allocations.createAllocation({ portfolioId, ... });
+     * ```
+     */
+    get allocations(): IAllocationService;
+    /**
+     * Lazy getter for AssetsService
+     * @example
+     * ```typescript
+     * const assets = await client.assets.listAssets({ entityId });
+     * ```
+     */
+    get assets(): IAssetsService;
+    /**
+     * Lazy getter for BalancesService
+     * @example
+     * ```typescript
+     * const balance = await client.balances.getWalletBalance({ portfolioId, walletId });
+     * ```
+     */
+    get balances(): IBalancesService;
+    /**
+     * Lazy getter for CommissionService
+     * @example
+     * ```typescript
+     * const commission = await client.commission.getPortfolioCommission({ portfolioId });
+     * ```
+     */
+    get commission(): ICommissionService;
+    /**
+     * Lazy getter for FinancingService
+     * @example
+     * ```typescript
+     * const buyingPower = await client.financing.getPortfolioBuyingPower({ portfolioId });
+     * ```
+     */
+    get financing(): IFinancingService;
+    /**
+     * Lazy getter for FuturesService
+     * @example
+     * ```typescript
+     * const positions = await client.futures.getEntityFuturesPositions({ entityId });
+     * ```
+     */
+    get futures(): IFuturesService;
+    /**
+     * Lazy getter for InvoicesService
+     * @example
+     * ```typescript
+     * const invoices = await client.invoices.listInvoices({ entityId });
+     * ```
+     */
+    get invoices(): IInvoicesService;
+    /**
+     * Lazy getter for OnchainAddressBookService
+     * @example
+     * ```typescript
+     * const addressBook = await client.onchainAddressBook.listOnchainAddressBook({ portfolioId });
+     * ```
+     */
+    get onchainAddressBook(): OnchainAddressBookService;
+    /**
+     * Lazy getter for OrdersService
+     * @example
+     * ```typescript
+     * const order = await client.orders.createOrder({
+     *   portfolioId: "123",
+     *   side: "BUY",
+     *   productId: "BTC-USD",
+     *   type: "MARKET",
+     *   baseQuantity: "0.001"
+     * });
+     * ```
+     */
+    get orders(): IOrdersService;
+    /**
+     * Lazy getter for PaymentMethodsService
+     * @example
+     * ```typescript
+     * const paymentMethods = await client.paymentMethods.listEntityPaymentMethods({ entityId });
+     * ```
+     */
+    get paymentMethods(): IPaymentMethodsService;
+    /**
+     * Lazy getter for PortfoliosService
+     * @example
+     * ```typescript
+     * const portfolios = await client.portfolios.listPortfolios();
+     * ```
+     */
+    get portfolios(): IPortfoliosService;
+    /**
+     * Lazy getter for PositionsService
+     * @example
+     * ```typescript
+     * const positions = await client.positions.listAggregateEntityPositions({ entityId });
+     * ```
+     */
+    get positions(): IPositionsService;
+    /**
+     * Lazy getter for ProductsService
+     * @example
+     * ```typescript
+     * const products = await client.products.listProducts({ portfolioId });
+     * ```
+     */
+    get products(): IProductsService;
+    /**
+     * Lazy getter for StakingService
+     * @example
+     * ```typescript
+     * const stake = await client.staking.createStake({ walletId, assetId, amount });
+     * ```
+     */
+    get staking(): IStakingService;
+    /**
+     * Lazy getter for TransactionsService
+     * @example
+     * ```typescript
+     * const transaction = await client.transactions.getTransaction({ portfolioId, transactionId });
+     * ```
+     */
+    get transactions(): ITransactionsService;
+    /**
+     * Lazy getter for UsersService
+     * @example
+     * ```typescript
+     * const users = await client.users.listUsers({ entityId });
+     * ```
+     */
+    get users(): IUsersService;
+    /**
+     * Lazy getter for WalletsService
+     * @example
+     * ```typescript
+     * const wallets = await client.wallets.listWallets({ portfolioId });
+     * ```
+     */
+    get wallets(): IWalletsService;
+}