@n1xyz/nord-ts 0.7.2 → 0.7.4

package/dist/actions.d.ts

@@ -2,7 +2,7 @@ import Decimal from "decimal.js";
 import * as proto from "./gen/nord_pb";
 import { paths } from "./gen/openapi";
 import { Client } from "openapi-fetch";
-import { type Duration, FillMode, PlacementRequest, Side, TriggerKind } from "./types";
+import { type Duration, FillMode, Side, TriggerKind } from "./types";
 import { BigIntValue } from "./utils";
 import { PublicKey, Transaction } from "@solana/web3.js";
 type ReceiptKind = NonNullable<proto.Receipt["kind"]>;
@@ -58,7 +58,21 @@ export declare function takeAllPositions(client: Client<paths>, signFn: (message
 }): Promise<{
     actionId: bigint;
 } & proto.Receipt_TakeAllPositionsResult>;
-export type AtomicSubaction = {
+export type AtomicSelfTarget = {
+    targetAccountId?: never;
+    useKey?: never;
+};
+export type AtomicDelegatedTarget = {
+    targetAccountId: number;
+    useKey?: false;
+};
+export type AtomicKeyedTarget = {
+    targetAccountId: number;
+    useKey: true;
+};
+export type AtomicTarget = AtomicSelfTarget | AtomicDelegatedTarget | AtomicKeyedTarget;
+export type AtomicSelfOrKeyedTarget = AtomicSelfTarget | AtomicKeyedTarget;
+export type AtomicSubaction = (AtomicTarget & ({
     kind: "place";
     marketId: number;
     side: Side;
@@ -70,26 +84,17 @@ export type AtomicSubaction = {
     price?: Decimal.Value;
     quoteSize?: Decimal.Value;
     clientOrderId?: BigIntValue;
-    delegatorAccountId?: number;
-    placement?: PlacementRequest;
     referrer?: BigIntValue;
 } | {
     kind: "cancel";
     orderId: BigIntValue;
-    delegatorAccountId?: number;
-    placement?: PlacementRequest;
 } | {
     kind: "cancelByClientId";
     clientOrderId: BigIntValue;
-    delegatorAccountId?: number;
-    placement?: PlacementRequest;
-} | {
+})) | (AtomicDelegatedTarget & {
     kind: "reduceOrderLiquidation";
-    targetAccountId: number;
     marketId: number;
-    delegatorAccountId?: number;
-    placement?: PlacementRequest;
-} | {
+}) | (AtomicSelfOrKeyedTarget & ({
     kind: "rfq";
     marketId: number;
     side: Side;
@@ -99,15 +104,19 @@ export type AtomicSubaction = {
     size: Decimal.Value;
     timeout?: Duration;
     clientOrderId?: BigIntValue;
-    delegatorAccountId?: number;
+    minimalFill?: Decimal.Value;
+    isReduceOnly?: boolean;
 } | {
     kind: "rfqFill";
     marketId: number;
     orderId: BigIntValue;
     priceDecimals: number;
+    sizeDecimals: number;
     price: Decimal.Value;
     timeout?: Duration;
-    delegatorAccountId?: number;
+    minimumSize?: Decimal.Value;
+    maximumSize?: Decimal.Value;
+    isReduceOnly?: boolean;
 } | {
     kind: "addTrigger";
     marketId: number;
@@ -119,7 +128,6 @@ export type AtomicSubaction = {
     limitPrice?: Decimal.Value;
     limitBaseSize?: Decimal.Value;
     limitQuoteSize?: Decimal.Value;
-    placement?: PlacementRequest;
     referrer?: BigIntValue;
 } | {
     kind: "editTrigger";
@@ -133,14 +141,17 @@ export type AtomicSubaction = {
     limitPrice?: Decimal.Value;
     limitBaseSize?: Decimal.Value;
     limitQuoteSize?: Decimal.Value;
-    placement?: PlacementRequest;
 } | {
     kind: "removeTrigger";
     marketId: number;
     triggerId: BigIntValue;
-    placement?: PlacementRequest;
-};
-export declare function atomicSubactionToProto(currentTimestamp: bigint, a: AtomicSubaction, omitDelegatorAccountId?: boolean): proto.AtomicSubaction;
+}));
+export declare function atomicSubactionToProto(currentTimestamp: bigint, a: AtomicSubaction): proto.AtomicSubaction;
+export declare function createAtomicAction(currentTimestamp: bigint, nonce: number, params: {
+    sessionId: BigIntValue;
+    accountId?: number;
+    actions: AtomicSubaction[];
+}): proto.Action;
 export declare function atomic(client: Client<paths>, signFn: (message: Uint8Array) => Promise<Uint8Array>, currentTimestamp: bigint, nonce: number, params: {
     sessionId: BigIntValue;
     accountId?: number;

package/dist/client/Nord.d.ts

@@ -3,7 +3,7 @@ import { Connection, PublicKey } from "@solana/web3.js";
 import { EventEmitter } from "events";
 import { Client } from "openapi-fetch";
 import type { paths } from "../gen/openapi.ts";
-import { Account, AccountPnlInfoPage, AccountPositionInfoPage, AccountPnlSummaryResult, ActionIdSubActionIdMarketIdCursor, AtomicActionId, GetAccountPositionHistoryQuery, GetAccountPnlQuery, PagedQuery, ActionResponse, MarketsInfo, Market, MarketSymbol, MarketStats, NordConfig, OrderbookQuery, OrderbookResponse, FeeTierConfig, Token, TradesResponse, User, AccountTriggerInfo, TriggerPlaceHistoryPage, TriggerFinaliseHistoryPage, WithdrawalHistoryPage, FeeTierId, AccountFeeTierPage, PageResultStringOrderInfo, PageResultStringTrade, OrderInfoFromApi, TokenStats, FillRole, AdminInfo, AccountVolumeInfo, GetAccountVolumeQuery, CandleResolution, TakeAllInfo, MarketsLiveInfo, MarketLiveInfo } from "../types";
+import { Account, AccountPnlInfoPage, AccountPositionInfoPage, AccountPnlSummaryResult, AccountPositionSummaryResult, ActionIdSubActionIdMarketIdCursor, AtomicActionId, GetAccountPositionHistoryQuery, GetAccountPnlQuery, GetAccountPositionSummaryQuery, PagedQuery, ActionResponse, MarketsInfo, Market, MarketSymbol, MarketStats, NordConfig, OrderbookQuery, OrderbookResponse, FeeTierConfig, Token, TradesResponse, User, AccountTriggerInfo, TriggerPlaceHistoryPage, TriggerFinaliseHistoryPage, WithdrawalHistoryPage, FeeTierId, AccountFeeTierPage, PageResultStringOrderInfo, PageResultStringTrade, OrderInfoFromApi, TokenStats, FillRole, AdminInfo, AccountVolumeInfo, GetAccountVolumeQuery, CandleResolution, TakeAllInfo, MarketsLiveInfo, MarketLiveInfo } from "../types";
 import { NordWebSocketClient } from "../websocket/index";
 import { OrderbookSubscription, TradeSubscription, CandleSubscription, RfqFillsSubscription } from "../websocket/Subscriber";
 /**
@@ -26,8 +26,9 @@ export declare class Nord {
     tokens: Token[];
     /** Map of symbol to market_id */
     private symbolToMarketId;
-    /** Proton client for proton related operations */
-    protonClient: ProtonClient;
+    /** Configuration and lazily initialized client for proton operations. */
+    private readonly protonConfig;
+    private protonClientPromise?;
     /** HTTP client for Nord operations */
     readonly httpClient: Client<paths>;
     /**
@@ -39,6 +40,13 @@ export declare class Nord {
      * @throws {Error} If required configuration is missing
      */
     private constructor();
+    /**
+     * Get the Proton client, initializing it on first use.
+     *
+     * Concurrent callers share the same initialization attempt. A failed attempt
+     * is not cached, allowing a later call to retry after Proton recovers.
+     */
+    getProtonClient(): Promise<ProtonClient>;
     /**
      * Create a WebSocket client with specific subscriptions
      *
@@ -352,6 +360,15 @@ export declare class Nord {
      */
     getAccountPositionHistory(accountId: number, { since, until, marketId, pageSize, startInclusive, }?: Readonly<Partial<GetAccountPositionHistoryQuery>>): Promise<AccountPositionInfoPage>;
     getAccountPnlSummary(accountId: number, { since, until, marketId }?: Readonly<Partial<GetAccountPnlQuery>>): Promise<AccountPnlSummaryResult>;
+    /**
+     * get per-market position pnl totals for an account.
+     *
+     * @param accountId - account id to query
+     * @param marketId - optional perpetual market id to restrict the result
+     * @returns per-market trading and funding pnl with materializer progress
+     * @throws {NordError} if the request fails
+     */
+    getAccountPositionSummary(accountId: number, { marketId }?: Readonly<Partial<GetAccountPositionSummaryQuery>>): Promise<AccountPositionSummaryResult>;
     getMarketsLive(): Promise<MarketsLiveInfo>;
     getMarketLive({ marketId, }: Readonly<{
         marketId: number;

package/dist/client/NordAdmin.d.ts

@@ -1,7 +1,6 @@
 import { PublicKey, Transaction } from "@solana/web3.js";
 import * as proto from "../gen/nord_pb";
 import { Nord } from "./Nord";
-import { FeeTierConfig } from "../gen/nord_pb";
 import Decimal from "decimal.js";
 export declare enum AclRole {
     FEE_MANAGER = 1,
@@ -242,8 +241,9 @@ export declare class NordAdmin {
     unpause(): Promise<{
         actionId: bigint;
     }>;
-    setBackstopAccount({ accountId, }: Readonly<{
+    setBackstopAccount({ accountId, marketMode, }: Readonly<{
         accountId: number;
+        marketMode?: proto.MarketMode;
     }>): Promise<{
         actionId: bigint;
     } & proto.Receipt_BackstopAccountSet>;
@@ -332,28 +332,19 @@ export declare class NordAdmin {
      * @returns Action identifier and fee tier addition receipt
      * @throws {NordError} If the action submission fails or the new tier exceeds the maximum range (0-15).
      */
-    addFeeTier({ config, }: Readonly<{
-        config: FeeTierConfig;
+    addFeeTier({ marketType, config, }: Readonly<{
+        marketType?: proto.MarketType;
+        config: proto.FeeTierTypeConfig;
     }>): Promise<{
         actionId: bigint;
-    } & proto.Receipt_FeeTierAdded>;
-    /**
-     * Update an existing fee tier with new maker/taker rates.
-     *
-     * Tier identifiers must already exist; attempting to update a missing tier
-     * causes the action to fail.
-     *
-     * @param tierId - Existing fee tier identifier to update
-     * @param config - Replacement configuration for the tier
-     * @returns Action identifier and fee tier update receipt
-     * @throws {NordError} If the action submission fails or the tier ID exceeds the configured range.
-     */
-    updateFeeTier({ tierId, config, }: Readonly<{
+    } & proto.Receipt_FeeTierTypeAdded>;
+    updateFeeTier({ tierId, marketType, config, }: Readonly<{
         tierId: number;
-        config: FeeTierConfig;
+        marketType?: proto.MarketType;
+        config: proto.FeeTierTypeConfig;
     }>): Promise<{
         actionId: bigint;
-    } & proto.Receipt_FeeTierUpdated>;
+    } & proto.Receipt_FeeTierTypeUpdated>;
     /**
      * Assign a fee tier to one or more accounts.
      *
@@ -366,9 +357,13 @@ export declare class NordAdmin {
      * @returns Action identifier and accounts-tier receipt
      * @throws {NordError} If the tier id exceeds the configured range or an account id is invalid.
      */
-    updateAccountsTier(accounts: number[], tierId: number): Promise<{
+    updateAccountsTier({ accounts, tierId, marketType, }: Readonly<{
+        accounts: number[];
+        tierId: number;
+        marketType?: proto.MarketType;
+    }>): Promise<{
         actionId: bigint;
-    } & proto.Receipt_AccountsTierUpdated>;
+    } & proto.Receipt_AccountsFeeTierTypeModeUpdated>;
     feeVaultTransfer({ recipient, tokenId, amount, }: Readonly<{
         recipient: number;
         tokenId: number;

package/dist/client/NordUser.d.ts

@@ -1,10 +1,11 @@
 import { PublicKey, Transaction, SendOptions } from "@solana/web3.js";
 import Decimal from "decimal.js";
-import { FillMode, Side, SPLTokenInfo, TriggerKind, SelfTradePrevention, PlacementRequest, VaultWithdrawRequestKind, type Duration, type RfqFillResult } from "../types";
+import { FillMode, Side, SPLTokenInfo, TriggerKind, SelfTradePrevention, VaultWithdrawRequestKind, type Duration, type RfqFillResult } from "../types";
 import * as proto from "../gen/nord_pb";
 import { BigIntValue } from "../utils";
+import { AtomicDelegatedTarget, AtomicSelfOrKeyedTarget, AtomicTarget } from "../actions";
 import { Nord } from "./Nord";
-export type UserAtomicSubaction = {
+export type UserAtomicSubaction = (AtomicTarget & ({
     kind: "place";
     marketId: number;
     side: Side;
@@ -14,26 +15,17 @@ export type UserAtomicSubaction = {
     price?: Decimal.Value;
     quoteSize?: Decimal.Value;
     clientOrderId?: BigIntValue;
-    delegatorAccountId?: number;
-    placement?: PlacementRequest;
     referrer?: BigIntValue;
 } | {
     kind: "cancel";
     orderId: BigIntValue;
-    delegatorAccountId?: number;
-    placement?: PlacementRequest;
 } | {
     kind: "cancelByClientId";
     clientOrderId: BigIntValue;
-    delegatorAccountId?: number;
-    placement?: PlacementRequest;
-} | {
+})) | (AtomicDelegatedTarget & {
     kind: "reduceOrderLiquidation";
-    targetAccountId: number;
     marketId: number;
-    delegatorAccountId?: number;
-    placement?: PlacementRequest;
-} | {
+}) | (AtomicSelfOrKeyedTarget & ({
     kind: "rfq";
     marketId: number;
     side: Side;
@@ -41,14 +33,17 @@ export type UserAtomicSubaction = {
     size: Decimal.Value;
     timeout?: Duration;
     clientOrderId?: BigIntValue;
-    delegatorAccountId?: number;
+    minimalFill?: Decimal.Value;
+    isReduceOnly?: boolean;
 } | {
     kind: "rfqFill";
     marketId: number;
     orderId: BigIntValue;
     price: Decimal.Value;
     timeout?: Duration;
-    delegatorAccountId?: number;
+    minimumSize?: Decimal.Value;
+    maximumSize?: Decimal.Value;
+    isReduceOnly?: boolean;
 } | {
     kind: "addTrigger";
     marketId: number;
@@ -58,7 +53,6 @@ export type UserAtomicSubaction = {
     limitPrice?: Decimal.Value;
     limitBaseSize?: Decimal.Value;
     limitQuoteSize?: Decimal.Value;
-    placement?: PlacementRequest;
     referrer?: BigIntValue;
 } | {
     kind: "editTrigger";
@@ -70,13 +64,11 @@ export type UserAtomicSubaction = {
     limitPrice?: Decimal.Value;
     limitBaseSize?: Decimal.Value;
     limitQuoteSize?: Decimal.Value;
-    placement?: PlacementRequest;
 } | {
     kind: "removeTrigger";
     marketId: number;
     triggerId: BigIntValue;
-    placement?: PlacementRequest;
-};
+}));
 export declare function decodeRfqFillResult(actionId: bigint, result: proto.Receipt_AtomicSubactionResultKind["inner"] | undefined): RfqFillResult;
 export interface NormalizedReceiptTrade {
     orderId: bigint;
@@ -94,6 +86,11 @@ export interface NormalizedTakeAllPosition {
     settlementPrice: number;
     bankruptcyPrice: number;
 }
+export interface NormalizedTakeAllTakerResult {
+    takerAccountId: number;
+    takenBalances: NormalizedTakeAllBalance[];
+    takenPositions: NormalizedTakeAllPosition[];
+}
 /**
  * User class for interacting with the Nord protocol
  */
@@ -405,7 +402,7 @@ export declare class NordUser {
         orderId: bigint;
         accountId: number;
     }>;
-    placeRfqOrder({ marketId, side, size, price, timeout, accountId, clientOrderId, }: Readonly<{
+    placeRfqOrder({ marketId, side, size, price, timeout, accountId, clientOrderId, minimalFill, isReduceOnly, }: Readonly<{
         marketId: number;
         side: Side;
         size: Decimal.Value;
@@ -413,16 +410,21 @@ export declare class NordUser {
         timeout?: Duration;
         accountId?: number;
         clientOrderId?: BigIntValue;
+        minimalFill?: Decimal.Value;
+        isReduceOnly?: boolean;
     }>): Promise<{
         actionId: bigint;
         orderId: bigint;
     }>;
-    fillRfqOrder({ marketId, orderId, price, timeout, accountId, }: Readonly<{
+    fillRfqOrder({ marketId, orderId, price, timeout, accountId, minimumSize, maximumSize, isReduceOnly, }: Readonly<{
         marketId: number;
         orderId: BigIntValue;
         price: Decimal.Value;
         timeout?: Duration;
         accountId?: number;
+        minimumSize?: BigIntValue;
+        maximumSize?: BigIntValue;
+        isReduceOnly?: boolean;
     }>): Promise<RfqFillResult>;
     /**
      * Cancel an order by client_order_id.
@@ -441,9 +443,7 @@ export declare class NordUser {
         targetAccountId: number;
     }>): Promise<{
         actionId: bigint;
-        takerAccountId: number;
-        takenBalances: NormalizedTakeAllBalance[];
-        takenPositions: NormalizedTakeAllPosition[];
+        takers: NormalizedTakeAllTakerResult[];
     }>;
     /**
      * Add a trigger for the current session