@0xmonaco/core 0.8.22 → 1.0.3

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

@@ -167,6 +167,7 @@ export declare const perpRoutes: {
             tradingPairId?: string;
             page?: number;
             pageSize?: number;
+            reductionOnly?: boolean;
         }) => string;
         readonly pnlHistory: (positionId: string, params: {
             interval: string;

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/vault/api.d.ts

@@ -211,12 +211,16 @@ export declare class VaultAPIImpl extends BaseAPI implements VaultAPI {
      *
      * @param assetId - The asset identifier (UUID) to withdraw
      * @param amount - The raw token amount to withdraw (as bigint)
-     * @param autoWait - Whether to automatically wait for transaction confirmation (defaults to true)
+     * @param autoWait - When `true` (default) polls for the merkle-proof calldata
+     *   and submits the on-chain `executeWithdrawal` transaction, then waits for
+     *   confirmation. When `false`, returns `{ withdrawalIndex, status: "awaiting_proof" }`
+     *   immediately after the POST — skipping both the calldata poll and the
+     *   on-chain submission. Use `retryWithdrawal(withdrawalIndex)` to finish later.
      * @param sourceOrRetry - Source ledger (`"spot"` or `"margin"`) or legacy retry options
      * @param retry - Polling cadence/timeout while waiting for the proof when a source is supplied
      * @returns Promise resolving to a [`WithdrawResult`]: on success the submitted
-     *   transaction plus `withdrawalIndex`; on poll-timeout `{ withdrawalIndex,
-     *   status: "awaiting_proof" }`.
+     *   transaction plus `withdrawalIndex`; on poll-timeout or `autoWait=false`
+     *   returns `{ withdrawalIndex, status: "awaiting_proof" }`.
      * @throws {APIError} When the asset is not found or the initiate request is rejected
      * @throws {ContractError} When the on-chain submission fails
      * @throws {InvalidConfigError} When wallet account is not available

package/dist/api/vault/api.js

@@ -382,12 +382,16 @@ export class VaultAPIImpl extends BaseAPI {
      *
      * @param assetId - The asset identifier (UUID) to withdraw
      * @param amount - The raw token amount to withdraw (as bigint)
-     * @param autoWait - Whether to automatically wait for transaction confirmation (defaults to true)
+     * @param autoWait - When `true` (default) polls for the merkle-proof calldata
+     *   and submits the on-chain `executeWithdrawal` transaction, then waits for
+     *   confirmation. When `false`, returns `{ withdrawalIndex, status: "awaiting_proof" }`
+     *   immediately after the POST — skipping both the calldata poll and the
+     *   on-chain submission. Use `retryWithdrawal(withdrawalIndex)` to finish later.
      * @param sourceOrRetry - Source ledger (`"spot"` or `"margin"`) or legacy retry options
      * @param retry - Polling cadence/timeout while waiting for the proof when a source is supplied
      * @returns Promise resolving to a [`WithdrawResult`]: on success the submitted
-     *   transaction plus `withdrawalIndex`; on poll-timeout `{ withdrawalIndex,
-     *   status: "awaiting_proof" }`.
+     *   transaction plus `withdrawalIndex`; on poll-timeout or `autoWait=false`
+     *   returns `{ withdrawalIndex, status: "awaiting_proof" }`.
      * @throws {APIError} When the asset is not found or the initiate request is rejected
      * @throws {ContractError} When the on-chain submission fails
      * @throws {InvalidConfigError} When wallet account is not available
@@ -440,7 +444,14 @@ export class VaultAPIImpl extends BaseAPI {
                 source,
             }),
         });
-        // 2. Poll for the executeWithdrawal calldata until the proof is confirmed.
+        // 2. When autoWait=false the caller wants the index immediately so it can
+        // finish on-chain later via retryWithdrawal(index). Skip the calldata poll
+        // entirely — the proof never lands this early, and the 5-minute default
+        // would block the wallet prompt indefinitely (the MACH1 bug).
+        if (!autoWait) {
+            return { withdrawalIndex, status: "awaiting_proof" };
+        }
+        // 3. Poll for the executeWithdrawal calldata until the proof is confirmed.
         // The vault address comes back with it, keeping calldata + target contract
         // in lockstep.
         const poll = await this.pollWithdrawalCalldata(withdrawalIndex, retryOptions);

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;
@@ -85,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",
@@ -85,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.22",
+	"version": "1.0.3",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -23,8 +23,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "0.8.22",
-		"@0xmonaco/types": "0.8.22",
+		"@0xmonaco/contracts": "1.0.3",
+		"@0xmonaco/types": "1.0.3",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
 		"http-status-codes": "^2.3.0"