@0xmonaco/core 1.0.16 → 1.0.21

package/dist/api/base.js

@@ -24,6 +24,16 @@ import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils";
 import { StatusCodes } from "http-status-codes";
 import { composeSigningString, keypairFromHex, sha256Hex, signMessage } from "../crypto/session";
 import { APIError } from "../errors";
+/**
+ * Product token sent as the `User-Agent` on every request. Monaco's edge
+ * rejects requests with an empty or absent `User-Agent`, so we set one
+ * explicitly to identify SDK traffic and keep it from being blocked.
+ *
+ * Note: `User-Agent` is a forbidden header in browsers — `fetch` silently
+ * ignores this value there and uses the browser's own (non-empty) UA. It
+ * only takes effect in server runtimes (Node/undici, Bun, Deno).
+ */
+const SDK_USER_AGENT = "@0xmonaco/core";
 export class BaseAPI {
     apiUrl;
     /** Active session keypair (raw bytes) used to sign authenticated requests. */
@@ -142,8 +152,12 @@ export class BaseAPI {
      */
     async executeRequest(url, endpoint, options, requestBody) {
         let response;
+        // Default the User-Agent (see SDK_USER_AGENT) while letting an explicit
+        // per-request header win. This is the single fetch site, so it covers the
+        // authenticated, backend, and public request paths.
+        const headers = { "User-Agent": SDK_USER_AGENT, ...options.headers };
         try {
-            response = await fetch(url, options);
+            response = await fetch(url, { ...options, headers });
         }
         catch (error) {
             throw new APIError(`Network request failed for ${endpoint}`, {

package/dist/api/index.d.ts

@@ -13,6 +13,7 @@ export * from "./market";
 export * from "./orderbook";
 export * from "./perp";
 export * from "./pitpass";
+export * from "./portfolio";
 export * from "./positions";
 export * from "./profile";
 export * from "./sub-accounts";

package/dist/api/index.js

@@ -13,6 +13,7 @@ export * from "./market";
 export * from "./orderbook";
 export * from "./perp";
 export * from "./pitpass";
+export * from "./portfolio";
 export * from "./positions";
 export * from "./profile";
 export * from "./sub-accounts";

package/dist/api/portfolio/api.d.ts

@@ -0,0 +1,9 @@
+import type { PortfolioAPI, PortfolioAssets, PortfolioMargin, PortfolioPerformance, PortfolioPeriodParams, PortfolioRealizedPnl, PortfolioSummary } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+export declare class PortfolioAPIImpl extends BaseAPI implements PortfolioAPI {
+    getSummary(params?: PortfolioPeriodParams): Promise<PortfolioSummary>;
+    getPerformance(params?: PortfolioPeriodParams): Promise<PortfolioPerformance>;
+    getRealizedPnl(params?: PortfolioPeriodParams): Promise<PortfolioRealizedPnl>;
+    getAssets(params?: PortfolioPeriodParams): Promise<PortfolioAssets>;
+    getMargin(): Promise<PortfolioMargin>;
+}

package/dist/api/portfolio/api.js

@@ -0,0 +1,25 @@
+import { BaseAPI } from "../base";
+const BASE_PATH = "/api/v1/accounts/me/portfolio";
+function withPeriod(path, params) {
+    if (!params?.period) {
+        return path;
+    }
+    return `${path}?${new URLSearchParams({ period: params.period })}`;
+}
+export class PortfolioAPIImpl extends BaseAPI {
+    async getSummary(params) {
+        return await this.makeAuthenticatedRequest(withPeriod(`${BASE_PATH}/summary`, params));
+    }
+    async getPerformance(params) {
+        return await this.makeAuthenticatedRequest(withPeriod(`${BASE_PATH}/performance`, params));
+    }
+    async getRealizedPnl(params) {
+        return await this.makeAuthenticatedRequest(withPeriod(`${BASE_PATH}/realized-pnl`, params));
+    }
+    async getAssets(params) {
+        return await this.makeAuthenticatedRequest(withPeriod(`${BASE_PATH}/assets`, params));
+    }
+    async getMargin() {
+        return await this.makeAuthenticatedRequest(`${BASE_PATH}/margin`);
+    }
+}

package/dist/api/portfolio/index.d.ts

@@ -0,0 +1 @@
+export { PortfolioAPIImpl } from "./api";

package/dist/api/portfolio/index.js

@@ -0,0 +1 @@
+export { PortfolioAPIImpl } from "./api";

package/dist/coverage.d.ts

@@ -38,8 +38,13 @@ export declare const COVERED: {
     get_orders: string;
     get_perp_market_config: string;
     get_perp_market_summary: string;
+    get_portfolio_assets: string;
     get_portfolio_chart: string;
+    get_portfolio_margin: string;
+    get_portfolio_performance: string;
+    get_portfolio_realized_pnl: string;
     get_portfolio_stats: string;
+    get_portfolio_summary: string;
     get_position: string;
     get_position_pnl_history: string;
     get_position_risk: string;
@@ -95,6 +100,5 @@ export declare const COVERED: {
 };
 /** operationId → reason it is intentionally not covered by @0xmonaco/core. */
 export declare const INTENTIONALLY_EXCLUDED: {
-    authenticate_backend: string;
     health_check: string;
 };

package/dist/coverage.js

@@ -38,8 +38,13 @@ export const COVERED = {
     get_orders: "getPaginatedOrders",
     get_perp_market_config: "getPerpMarketConfig",
     get_perp_market_summary: "getPerpMarketSummary",
+    get_portfolio_assets: "portfolio.getAssets",
     get_portfolio_chart: "getPortfolioChart",
+    get_portfolio_margin: "portfolio.getMargin",
+    get_portfolio_performance: "portfolio.getPerformance",
+    get_portfolio_realized_pnl: "portfolio.getRealizedPnl",
     get_portfolio_stats: "getPortfolioStats",
+    get_portfolio_summary: "portfolio.getSummary",
     get_position: "getPosition",
     get_position_pnl_history: "getPositionPnlHistory",
     get_position_risk: "getPositionRisk",
@@ -95,6 +100,5 @@ export const COVERED = {
 };
 /** operationId → reason it is intentionally not covered by @0xmonaco/core. */
 export const INTENTIONALLY_EXCLUDED = {
-    authenticate_backend: "Backend auth is header-based via setServerKey()/the x-server-key header, not an endpoint method (MON-1486).",
     health_check: "Infrastructure liveness probe (GET /health); not part of the data SDK surface.",
 };

package/dist/sdk.d.ts

@@ -1,4 +1,4 @@
-import type { ApplicationsAPI, AuthAPI, AuthState, DelegatedAgentsAPI, FaucetAPI, FeesAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PitpassAPI, PositionsAPI, ProfileAPI, SDKConfig, SubAccountsAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
+import type { ApplicationsAPI, AuthAPI, AuthState, DelegatedAgentsAPI, FaucetAPI, FeesAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PitpassAPI, PortfolioAPI, PositionsAPI, ProfileAPI, SDKConfig, SubAccountsAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
 import { type Address, type PublicClient, type TransactionReceipt, type WalletClient } from "viem";
 import { type MonacoWebSocket, OrderbookAPIImpl, TradesAPIImpl } from "./api";
 export declare class MonacoSDKImpl implements MonacoSDK {
@@ -13,6 +13,7 @@ export declare class MonacoSDKImpl implements MonacoSDK {
     market: MarketAPI;
     marginAccounts: MarginAccountsAPI;
     positions: PositionsAPI;
+    portfolio: PortfolioAPI;
     subAccounts: SubAccountsAPI;
     faucet: FaucetAPI;
     whitelist: WhitelistAPI;

package/dist/sdk.js

@@ -9,6 +9,7 @@ import { FeesAPIImpl } from "./api/fees";
 import { MarginAccountsAPIImpl } from "./api/margin-accounts";
 import { MarketAPIImpl } from "./api/market";
 import { PitpassAPIImpl } from "./api/pitpass";
+import { PortfolioAPIImpl } from "./api/portfolio";
 import { PositionsAPIImpl } from "./api/positions";
 import { ProfileAPIImpl } from "./api/profile";
 import { SubAccountsAPIImpl } from "./api/sub-accounts";
@@ -41,6 +42,7 @@ export class MonacoSDKImpl {
     market;
     marginAccounts;
     positions;
+    portfolio;
     subAccounts;
     faucet;
     whitelist;
@@ -69,6 +71,7 @@ export class MonacoSDKImpl {
         this.market.setSessionKeypair(credentials);
         this.marginAccounts.setSessionKeypair(credentials);
         this.positions.setSessionKeypair(credentials);
+        this.portfolio.setSessionKeypair(credentials);
         this.subAccounts.setSessionKeypair(credentials);
         this.faucet.setSessionKeypair(credentials);
         this.whitelist.setSessionKeypair(credentials);
@@ -106,6 +109,7 @@ export class MonacoSDKImpl {
         this.market.setServerKey(serverKey);
         this.marginAccounts.setServerKey(serverKey);
         this.positions.setServerKey(serverKey);
+        this.portfolio.setServerKey(serverKey);
         this.subAccounts.setServerKey(serverKey);
         this.faucet.setServerKey(serverKey);
         this.whitelist.setServerKey(serverKey);
@@ -162,6 +166,7 @@ export class MonacoSDKImpl {
         this.market = new MarketAPIImpl(apiUrl);
         this.marginAccounts = new MarginAccountsAPIImpl(apiUrl);
         this.positions = new PositionsAPIImpl(apiUrl);
+        this.portfolio = new PortfolioAPIImpl(apiUrl);
         this.subAccounts = new SubAccountsAPIImpl(apiUrl);
         this.faucet = new FaucetAPIImpl(apiUrl);
         this.whitelist = new WhitelistAPIImpl(apiUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.16",
+	"version": "1.0.21",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -23,8 +23,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.16",
-		"@0xmonaco/types": "1.0.16",
+		"@0xmonaco/contracts": "1.0.21",
+		"@0xmonaco/types": "1.0.21",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
 		"http-status-codes": "^2.3.0"