@0xmonaco/core 0.8.21 → 0.8.22-develop.efb9dc9

package/dist/api/auth/api.d.ts

@@ -71,7 +71,7 @@ export declare class AuthAPIImpl extends BaseAPI implements AuthAPI {
      * console.log(`User ID: ${authResult.user.id}`);
      * ```
      */
-    authenticate(clientId: string): Promise<AuthState>;
+    authenticate(clientId: string, referralCode?: string): Promise<AuthState>;
     /**
      * Signs a challenge message using the wallet client.
      *
@@ -137,7 +137,7 @@ export declare class AuthAPIImpl extends BaseAPI implements AuthAPI {
      * console.log(`Session public key: ${authResult.sessionPublicKey}`);
      * ```
      */
-    verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials): Promise<AuthState>;
+    verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials, referralCode?: string): Promise<AuthState>;
     /**
      * Extends the current session's expiry.
      *

package/dist/api/auth/api.js

@@ -77,7 +77,7 @@ export class AuthAPIImpl extends BaseAPI {
      * console.log(`User ID: ${authResult.user.id}`);
      * ```
      */
-    async authenticate(clientId) {
+    async authenticate(clientId, referralCode) {
         if (!this.walletClient) {
             throw new InvalidConfigError("Wallet client not set. Connect a wallet first.", "walletClient");
         }
@@ -96,8 +96,8 @@ export class AuthAPIImpl extends BaseAPI {
         const challenge = await this.createChallenge(account.address, clientId, session.publicKey);
         // 3. Sign the challenge message with the wallet
         const signature = await this.signChallenge(challenge.message);
-        // 4. Verify signature, registering the session public key
-        return await this.verifySignature(account.address, signature, challenge.nonce, clientId, session);
+        // 4. Verify signature, registering the session public key (and optional referral)
+        return await this.verifySignature(account.address, signature, challenge.nonce, clientId, session, referralCode);
     }
     /**
      * Signs a challenge message using the wallet client.
@@ -192,7 +192,7 @@ export class AuthAPIImpl extends BaseAPI {
      * console.log(`Session public key: ${authResult.sessionPublicKey}`);
      * ```
      */
-    async verifySignature(address, signature, nonce, clientId, session) {
+    async verifySignature(address, signature, nonce, clientId, session, referralCode) {
         const responseBody = await this.makePublicRequest("/api/v1/auth/verify", {
             method: "POST",
             body: JSON.stringify({
@@ -202,6 +202,7 @@ export class AuthAPIImpl extends BaseAPI {
                 clientId: clientId,
                 chainId: this.chain.id,
                 sessionPublicKey: session.publicKey,
+                ...(referralCode ? { referralCode } : {}),
             }),
         });
         return {

package/dist/api/index.d.ts

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

package/dist/api/index.js

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

package/dist/api/perp/routes.d.ts

@@ -168,6 +168,11 @@ export declare const perpRoutes: {
             page?: number;
             pageSize?: number;
         }) => string;
+        readonly pnlHistory: (positionId: string, params: {
+            interval: string;
+            startTime?: number;
+            endTime?: number;
+        }) => string;
     };
     readonly marginAccounts: {
         readonly list: (params?: {

package/dist/api/perp/routes.js

@@ -93,6 +93,7 @@ export const perpRoutes = {
         reduceMargin: (positionId) => `${API_V1}/positions/${encodeSegment(positionId)}/margin/reduce`,
         attachTpSl: (positionId) => `${API_V1}/positions/${encodeSegment(positionId)}/tp-sl`,
         history: (params) => withQuery(`${API_V1}/positions/history`, params),
+        pnlHistory: (positionId, params) => withQuery(`${API_V1}/positions/${encodeSegment(positionId)}/pnl/history`, params),
     },
     marginAccounts: {
         list: (params) => withQuery(`${API_V1}/margin/accounts`, params),

package/dist/api/pitpass/api.d.ts

@@ -0,0 +1,56 @@
+/**
+ * PitPass TraderCode API Implementation
+ *
+ * Provides methods for the PitPass referral system: reading your wallet-derived
+ * TraderCode, a public lookup to validate a referral code at sign-up, reading
+ * your accrued rewards balance, and transferring rewards into a tradeable balance.
+ *
+ * `getMyTraderCode` and `getRewardsBalance` require authentication.
+ * `getTraderCodeInfo` is public (no auth required).
+ * `transferRewards` requires authentication.
+ *
+ * @example
+ * ```typescript
+ * // Read your own code (authenticated)
+ * const { code } = await sdk.pitpass.getMyTraderCode();
+ * console.log(`Share code: Monaco - ${code}`);
+ *
+ * // Validate a referral code at sign-up (public)
+ * const info = await sdk.pitpass.getTraderCodeInfo("0xabc...");
+ * console.log(`Referrer code: ${info.code}`);
+ *
+ * // Read accrued rewards balance (authenticated)
+ * const { balances } = await sdk.pitpass.getRewardsBalance();
+ * for (const b of balances) {
+ *   console.log(`${b.token}: ${b.available}`);
+ * }
+ *
+ * // Transfer rewards into trading balance (authenticated)
+ * const result = await sdk.pitpass.transferRewards({
+ *   token: "0xusdc...",
+ *   amount: "1000000",
+ * });
+ * console.log(`Rewards remaining: ${result.rewardsBalance}`);
+ * ```
+ */
+import type { GetRewardsBalanceResponse, PitpassAPI, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
+    /**
+     * Return the authenticated caller's TraderCode (their normalized wallet address).
+     */
+    getMyTraderCode(): Promise<TraderCodeResponse>;
+    /**
+     * Public lookup of a TraderCode by wallet address.
+     * Accepts the bare address or the `Monaco - <address>` display form.
+     */
+    getTraderCodeInfo(code: string): Promise<TraderCodeInfoResponse>;
+    /**
+     * Return the caller's current PitPass rewards-bucket balances.
+     */
+    getRewardsBalance(): Promise<GetRewardsBalanceResponse>;
+    /**
+     * Transfer earned PitPass rewards into a trading balance.
+     */
+    transferRewards(params: TransferRewardsParams): Promise<TransferRewardsResponse>;
+}

package/dist/api/pitpass/api.js

@@ -0,0 +1,69 @@
+/**
+ * PitPass TraderCode API Implementation
+ *
+ * Provides methods for the PitPass referral system: reading your wallet-derived
+ * TraderCode, a public lookup to validate a referral code at sign-up, reading
+ * your accrued rewards balance, and transferring rewards into a tradeable balance.
+ *
+ * `getMyTraderCode` and `getRewardsBalance` require authentication.
+ * `getTraderCodeInfo` is public (no auth required).
+ * `transferRewards` requires authentication.
+ *
+ * @example
+ * ```typescript
+ * // Read your own code (authenticated)
+ * const { code } = await sdk.pitpass.getMyTraderCode();
+ * console.log(`Share code: Monaco - ${code}`);
+ *
+ * // Validate a referral code at sign-up (public)
+ * const info = await sdk.pitpass.getTraderCodeInfo("0xabc...");
+ * console.log(`Referrer code: ${info.code}`);
+ *
+ * // Read accrued rewards balance (authenticated)
+ * const { balances } = await sdk.pitpass.getRewardsBalance();
+ * for (const b of balances) {
+ *   console.log(`${b.token}: ${b.available}`);
+ * }
+ *
+ * // Transfer rewards into trading balance (authenticated)
+ * const result = await sdk.pitpass.transferRewards({
+ *   token: "0xusdc...",
+ *   amount: "1000000",
+ * });
+ * console.log(`Rewards remaining: ${result.rewardsBalance}`);
+ * ```
+ */
+import { TransferRewardsParamsSchema, validate } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+export class PitpassAPIImpl extends BaseAPI {
+    /**
+     * Return the authenticated caller's TraderCode (their normalized wallet address).
+     */
+    async getMyTraderCode() {
+        return await this.makeAuthenticatedRequest("/api/v1/pitpass/codes/me", { method: "GET" });
+    }
+    /**
+     * Public lookup of a TraderCode by wallet address.
+     * Accepts the bare address or the `Monaco - <address>` display form.
+     */
+    async getTraderCodeInfo(code) {
+        const encoded = encodeURIComponent(code.trim());
+        return await this.makePublicRequest(`/api/v1/pitpass/codes/${encoded}`, { method: "GET" });
+    }
+    /**
+     * Return the caller's current PitPass rewards-bucket balances.
+     */
+    async getRewardsBalance() {
+        return await this.makeAuthenticatedRequest("/api/v1/pitpass/rewards/balance", { method: "GET" });
+    }
+    /**
+     * Transfer earned PitPass rewards into a trading balance.
+     */
+    async transferRewards(params) {
+        const validated = validate(TransferRewardsParamsSchema, params);
+        return await this.makeAuthenticatedRequest("/api/v1/pitpass/rewards/transfer", {
+            method: "POST",
+            body: JSON.stringify({ token: validated.token, amount: validated.amount }),
+        });
+    }
+}

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

@@ -0,0 +1,6 @@
+/**
+ * PitPass API Module
+ *
+ * Exports the PitPass TraderCode API implementation.
+ */
+export { PitpassAPIImpl } from "./api";

package/dist/api/pitpass/index.js

@@ -0,0 +1,6 @@
+/**
+ * PitPass API Module
+ *
+ * Exports the PitPass TraderCode API implementation.
+ */
+export { PitpassAPIImpl } from "./api";

package/dist/api/positions/api.d.ts

@@ -1,4 +1,4 @@
-import type { AddPositionMarginRequest, AttachPositionTpSlRequest, AttachPositionTpSlResponse, BatchCloseAllRequest, BatchCloseAllResponse, ClosePositionRequest, ClosePositionResponse, GetPositionResponse, ListPositionHistoryParams, ListPositionHistoryResponse, ListPositionsParams, ListPositionsResponse, PositionMarginResponse, PositionRisk, PositionsAPI, ReducePositionMarginRequest } from "@0xmonaco/types";
+import type { AddPositionMarginRequest, AttachPositionTpSlRequest, AttachPositionTpSlResponse, BatchCloseAllRequest, BatchCloseAllResponse, ClosePositionRequest, ClosePositionResponse, GetPositionPnlHistoryParams, GetPositionPnlHistoryResponse, GetPositionResponse, ListPositionHistoryParams, ListPositionHistoryResponse, ListPositionsParams, ListPositionsResponse, PositionMarginResponse, PositionRisk, PositionsAPI, ReducePositionMarginRequest } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class PositionsAPIImpl extends BaseAPI implements PositionsAPI {
     listPositions(params?: ListPositionsParams): Promise<ListPositionsResponse>;
@@ -10,4 +10,5 @@ export declare class PositionsAPIImpl extends BaseAPI implements PositionsAPI {
     reducePositionMargin(positionId: string, request: ReducePositionMarginRequest): Promise<PositionMarginResponse>;
     attachPositionTpSl(positionId: string, request: AttachPositionTpSlRequest): Promise<AttachPositionTpSlResponse>;
     listPositionHistory(params?: ListPositionHistoryParams): Promise<ListPositionHistoryResponse>;
+    getPositionPnlHistory(positionId: string, params: GetPositionPnlHistoryParams): Promise<GetPositionPnlHistoryResponse>;
 }

package/dist/api/positions/api.js

@@ -1,4 +1,4 @@
-import { AddPositionMarginSchema, AttachPositionTpSlSchema, BatchCloseAllSchema, ClosePositionSchema, GetPositionRiskSchema, GetPositionSchema, ListPositionHistorySchema, ListPositionsSchema, ReducePositionMarginSchema, validate, } from "@0xmonaco/types";
+import { AddPositionMarginSchema, AttachPositionTpSlSchema, BatchCloseAllSchema, ClosePositionSchema, GetPositionPnlHistorySchema, GetPositionRiskSchema, GetPositionSchema, ListPositionHistorySchema, ListPositionsSchema, ReducePositionMarginSchema, validate, } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 import { perpRoutes } from "../perp";
 export class PositionsAPIImpl extends BaseAPI {
@@ -95,4 +95,8 @@ export class PositionsAPIImpl extends BaseAPI {
         }
         return await this.makeAuthenticatedRequest(perpRoutes.positions.history(params));
     }
+    async getPositionPnlHistory(positionId, params) {
+        validate(GetPositionPnlHistorySchema, { positionId, params });
+        return await this.makeAuthenticatedRequest(perpRoutes.positions.pnlHistory(positionId, params));
+    }
 }

package/dist/coverage.d.ts

@@ -29,6 +29,9 @@ export declare const COVERED: {
     get_market_metadata: string;
     get_market_stats: string;
     get_my_fee_tier: string;
+    get_my_trader_code: string;
+    get_rewards_balance: string;
+    get_trader_code_info: string;
     get_open_interest: string;
     get_order_by_id: string;
     get_orderbook_snapshot: string;
@@ -38,6 +41,7 @@ export declare const COVERED: {
     get_portfolio_chart: string;
     get_portfolio_stats: string;
     get_position: string;
+    get_position_pnl_history: string;
     get_position_risk: string;
     get_parent_margin_account_movements: string;
     get_parent_margin_account_summary: string;
@@ -84,6 +88,7 @@ export declare const COVERED: {
     transfer_collateral_to_margin_account: string;
     transfer_collateral_to_parent_margin_account: string;
     transfer_collateral_to_risk_bucket: string;
+    transfer_rewards: string;
     update_sub_account_limit: string;
     upsert_delegated_agent: string;
     verify_signature: string;

package/dist/coverage.js

@@ -29,6 +29,9 @@ export const COVERED = {
     get_market_metadata: "getMarketMetadata",
     get_market_stats: "getMarketStats",
     get_my_fee_tier: "getMyFeeTier",
+    get_my_trader_code: "pitpass.getMyTraderCode",
+    get_rewards_balance: "pitpass.getRewardsBalance",
+    get_trader_code_info: "pitpass.getTraderCodeInfo",
     get_open_interest: "getOpenInterest",
     get_order_by_id: "getOrder",
     get_orderbook_snapshot: "getOrderbook",
@@ -38,6 +41,7 @@ export const COVERED = {
     get_portfolio_chart: "getPortfolioChart",
     get_portfolio_stats: "getPortfolioStats",
     get_position: "getPosition",
+    get_position_pnl_history: "getPositionPnlHistory",
     get_position_risk: "getPositionRisk",
     get_parent_margin_account_movements: "getParentMarginAccountMovements",
     get_parent_margin_account_summary: "getParentMarginAccountSummary",
@@ -84,6 +88,7 @@ export const COVERED = {
     transfer_collateral_to_margin_account: "transferCollateralToMarginAccount",
     transfer_collateral_to_parent_margin_account: "transferCollateralToParentMarginAccount",
     transfer_collateral_to_risk_bucket: "transferCollateralToRiskBucket",
+    transfer_rewards: "pitpass.transferRewards",
     update_sub_account_limit: "subAccounts.updateLimit",
     upsert_delegated_agent: "upsertDelegatedAgent",
     verify_signature: "verifySignature",

package/dist/sdk.d.ts

@@ -1,4 +1,4 @@
-import type { ApplicationsAPI, AuthAPI, AuthState, DelegatedAgentsAPI, FaucetAPI, FeesAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PositionsAPI, ProfileAPI, SDKConfig, SubAccountsAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
+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 Address, type PublicClient, type TransactionReceipt, type WalletClient } from "viem";
 import { type MonacoWebSocket, OrderbookAPIImpl, TradesAPIImpl } from "./api";
 export declare class MonacoSDKImpl implements MonacoSDK {
@@ -6,6 +6,7 @@ export declare class MonacoSDKImpl implements MonacoSDK {
     delegatedAgents: DelegatedAgentsAPI;
     applications: ApplicationsAPI;
     fees: FeesAPI;
+    pitpass: PitpassAPI;
     vault: VaultAPI;
     withdrawals: WithdrawalsAPI;
     trading: TradingAPI;

package/dist/sdk.js

@@ -8,6 +8,7 @@ import { FaucetAPIImpl } from "./api/faucet";
 import { FeesAPIImpl } from "./api/fees";
 import { MarginAccountsAPIImpl } from "./api/margin-accounts";
 import { MarketAPIImpl } from "./api/market";
+import { PitpassAPIImpl } from "./api/pitpass";
 import { PositionsAPIImpl } from "./api/positions";
 import { ProfileAPIImpl } from "./api/profile";
 import { SubAccountsAPIImpl } from "./api/sub-accounts";
@@ -33,6 +34,7 @@ export class MonacoSDKImpl {
     delegatedAgents;
     applications;
     fees;
+    pitpass;
     vault;
     withdrawals;
     trading;
@@ -60,6 +62,7 @@ export class MonacoSDKImpl {
         this.delegatedAgents.setSessionKeypair(credentials);
         this.applications.setSessionKeypair(credentials);
         this.fees.setSessionKeypair(credentials);
+        this.pitpass.setSessionKeypair(credentials);
         this.vault.setSessionKeypair(credentials);
         this.withdrawals.setSessionKeypair(credentials);
         this.trading.setSessionKeypair(credentials);
@@ -96,6 +99,7 @@ export class MonacoSDKImpl {
         this.delegatedAgents.setServerKey(serverKey);
         this.applications.setServerKey(serverKey);
         this.fees.setServerKey(serverKey);
+        this.pitpass.setServerKey(serverKey);
         this.vault.setServerKey(serverKey);
         this.withdrawals.setServerKey(serverKey);
         this.trading.setServerKey(serverKey);
@@ -164,6 +168,7 @@ export class MonacoSDKImpl {
         this.auth = new AuthAPIImpl(this.walletClient, this.chain, apiUrl);
         this.delegatedAgents = new DelegatedAgentsAPIImpl(apiUrl);
         this.fees = new FeesAPIImpl(apiUrl);
+        this.pitpass = new PitpassAPIImpl(apiUrl);
         this.profile = new ProfileAPIImpl(apiUrl);
         this.vault = new VaultAPIImpl(this.publicClient, this.walletClient, this.chain, this.applications, this.profile, apiUrl);
         this.withdrawals = new WithdrawalsAPIImpl(apiUrl);

package/package.json

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