@n1xyz/nord-ts 0.5.1 → 0.6.1

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 { FillMode, Side, TriggerKind } from "./types";
+import { FillMode, PlacementRequest, Side, TriggerKind } from "./types";
 import { BigIntValue } from "./utils";
 import { PublicKey, Transaction } from "@solana/web3.js";
 type ReceiptKind = NonNullable<proto.Receipt["kind"]>;
@@ -14,6 +14,7 @@ export declare function expectReceiptKind<K extends ReceiptKind["case"]>(receipt
     kind: ExtractReceiptKind<K>;
 };
 export declare function buildLimits(marketPriceDecimals: number, marketSizeDecimals: number, limitPrice?: Decimal.Value, limitBaseSize?: Decimal.Value, limitQuoteSize?: Decimal.Value): proto.OrderLimit | undefined;
+export declare function toProtoU128(value: BigIntValue): proto.U128;
 export declare function createAction(currentTimestamp: bigint, nonce: number, kind: proto.Action["kind"]): proto.Action;
 export declare function sendAction(client: Client<paths>, makeSignedMessage: (message: Uint8Array) => Promise<Uint8Array>, action: proto.Action): Promise<proto.Receipt>;
 export declare function prepareAction(action: proto.Action, makeSignedMessage: (message: Uint8Array) => Promise<Uint8Array>): Promise<Uint8Array<ArrayBufferLike>>;
@@ -55,14 +56,18 @@ export type AtomicSubaction = {
     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;
 } | {
     kind: "addTrigger";
     marketId: number;
@@ -74,6 +79,8 @@ export type AtomicSubaction = {
     limitPrice?: Decimal.Value;
     limitBaseSize?: Decimal.Value;
     limitQuoteSize?: Decimal.Value;
+    placement?: PlacementRequest;
+    referrer?: BigIntValue;
 } | {
     kind: "editTrigger";
     triggerId: BigIntValue;
@@ -86,10 +93,12 @@ 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 atomic(client: Client<paths>, signFn: (message: Uint8Array) => Promise<Uint8Array>, currentTimestamp: bigint, nonce: number, params: {
     sessionId: BigIntValue;

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, AtomicActionId, GetAccountPnlQuery, PagedQuery, ActionResponse, MarketsInfo, Market, 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, ActionIdSubActionIdMarketIdCursor, AtomicActionId, GetAccountPositionHistoryQuery, GetAccountPnlQuery, PagedQuery, ActionResponse, MarketsInfo, Market, 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 } from "../websocket/Subscriber";
 /**
@@ -321,7 +321,10 @@ export declare class Nord {
      * @returns Page of PnL entries ordered from latest to oldest
      * @throws {NordError} If the request fails
      */
-    getAccountPnl(accountId: number, { since, until, startInclusive, pageSize, }?: Readonly<Partial<PagedQuery>>): Promise<AccountPnlInfoPage>;
+    getAccountPnl(accountId: number, { since, until, startInclusive, pageSize, }?: Readonly<Partial<GetAccountPnlQuery> & {
+        startInclusive?: ActionIdSubActionIdMarketIdCursor;
+        pageSize?: number;
+    }>): Promise<AccountPnlInfoPage>;
     /**
      * Get profit and loss totals for an account over a time window.
      *
@@ -344,9 +347,7 @@ export declare class Nord {
      * @returns History of position updates
      * @throws {NordError} If the request fails
      */
-    getAccountPositionHistory(accountId: number, { since, until, marketId, pageSize, startInclusive, }?: Readonly<Partial<GetAccountPnlQuery & Omit<PagedQuery, "startInclusive">> & {
-        startInclusive?: string;
-    }>): Promise<AccountPositionInfoPage>;
+    getAccountPositionHistory(accountId: number, { since, until, marketId, pageSize, startInclusive, }?: Readonly<Partial<GetAccountPositionHistoryQuery>>): Promise<AccountPositionInfoPage>;
     getAccountPnlSummary(accountId: number, { since, until, marketId }?: Readonly<Partial<GetAccountPnlQuery>>): Promise<AccountPnlSummaryResult>;
     getMarketsLive(): Promise<MarketsLiveInfo>;
     getMarketLive({ marketId, }: Readonly<{

package/dist/client/NordAdmin.d.ts

@@ -156,6 +156,24 @@ export declare class NordAdmin {
     }>): Promise<{
         actionId: bigint;
     } & proto.Receipt_BackstopAccountSet>;
+    createVault({ manager, config, }: Readonly<{
+        manager: PublicKey;
+        config: proto.VaultConfig;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.CreateVaultReceipt>;
+    updateVaultConfig({ vaultId, configPatch, }: Readonly<{
+        vaultId: number;
+        configPatch: proto.VaultConfigPatch;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.UpdateVaultConfigReceipt>;
+    setVaultManager({ vaultId, manager, }: Readonly<{
+        vaultId: number;
+        manager: PublicKey;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.SetVaultManagerReceipt>;
     /**
      * Freeze an individual market, preventing new trades and orders.
      *
@@ -180,6 +198,24 @@ export declare class NordAdmin {
     }>): Promise<{
         actionId: bigint;
     } & proto.Receipt_MarketFreezeUpdated>;
+    /**
+     * Prepare a production delisting clear for an admin-frozen market.
+     *
+     * Only a super admin or market manager can submit this action. The market must
+     * already be frozen by an admin action. This cancels every open order and
+     * closes all positions at the provided clearance price mantissa.
+     *
+     * @param marketId - Target admin-frozen market identifier
+     * @param clearancePrice - Settlement price mantissa used for closing positions
+     * @returns Action identifier and clear-market receipt
+     * @throws {NordError} If the action submission fails
+     */
+    clearMarket({ marketId, clearancePrice, }: Readonly<{
+        marketId: number;
+        clearancePrice: bigint;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_ClearMarketResult>;
     /**
      * Append a new fee tier to the account bracket configuration.
      *

package/dist/client/NordUser.d.ts

@@ -1,6 +1,6 @@
 import { PublicKey, Transaction, SendOptions } from "@solana/web3.js";
 import Decimal from "decimal.js";
-import { FillMode, Side, SPLTokenInfo, TriggerKind, SelfTradePrevention } from "../types";
+import { FillMode, Side, SPLTokenInfo, TriggerKind, SelfTradePrevention, PlacementRequest, VaultWithdrawRequestKind } from "../types";
 import * as proto from "../gen/nord_pb";
 import { BigIntValue } from "../utils";
 import { Nord } from "./Nord";
@@ -15,14 +15,18 @@ export type UserAtomicSubaction = {
     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;
 } | {
     kind: "addTrigger";
     marketId: number;
@@ -32,6 +36,8 @@ export type UserAtomicSubaction = {
     limitPrice?: Decimal.Value;
     limitBaseSize?: Decimal.Value;
     limitQuoteSize?: Decimal.Value;
+    placement?: PlacementRequest;
+    referrer?: BigIntValue;
 } | {
     kind: "editTrigger";
     triggerId: BigIntValue;
@@ -42,10 +48,12 @@ export type UserAtomicSubaction = {
     limitPrice?: Decimal.Value;
     limitBaseSize?: Decimal.Value;
     limitQuoteSize?: Decimal.Value;
+    placement?: PlacementRequest;
 } | {
     kind: "removeTrigger";
     marketId: number;
     triggerId: BigIntValue;
+    placement?: PlacementRequest;
 };
 export interface NormalizedReceiptTrade {
     orderId: bigint;
@@ -233,7 +241,7 @@ export declare class NordUser {
      *
      * @throws {NordError} If the operation fails
      */
-    refreshSession(): Promise<void>;
+    refreshSession(expiryTimestamp?: bigint): Promise<void>;
     /**
      * Revoke a session
      *
@@ -262,6 +270,29 @@ export declare class NordUser {
     }>): Promise<{
         actionId: bigint;
     }>;
+    vaultDeposit({ vaultId, amount, }: Readonly<{
+        vaultId: number;
+        amount: Decimal.Value;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.VaultDepositReceipt>;
+    vaultWithdrawRequest({ vaultId, kind, amount, }: Readonly<{
+        vaultId: number;
+        kind: VaultWithdrawRequestKind;
+        amount: Decimal.Value;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.VaultWithdrawReceipt>;
+    vaultWithdrawClaim({ vaultId, }: Readonly<{
+        vaultId: number;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.VaultWithdrawReceipt>;
+    vaultSyncEpochs({ vaultId, }: Readonly<{
+        vaultId: number;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.VaultSyncEpochsReceipt>;
     /**
      * Place an order on the exchange
      *
@@ -274,10 +305,11 @@ export declare class NordUser {
      * @param quoteSize - Quote-sized order representation
      * @param accountId - Account executing the order
      * @param clientOrderId - Optional client-specified identifier
+     * @param referrer - Optional referrer ID. Tracks which frontend/referral source placed order.
      * @returns Object containing actionId, orderId (if posted), fills, and reducedOrders (reduce-only orders fully or partially cancelled by maintenance)
      * @throws {NordError} If the operation fails
      */
-    placeOrder({ marketId, side, fillMode, isReduceOnly, size, price, quoteSize, selfTradePrevention, accountId, clientOrderId, }: Readonly<{
+    placeOrder({ marketId, side, fillMode, isReduceOnly, size, price, quoteSize, selfTradePrevention, accountId, clientOrderId, referrer, }: Readonly<{
         marketId: number;
         side: Side;
         fillMode: FillMode;
@@ -288,6 +320,7 @@ export declare class NordUser {
         selfTradePrevention?: SelfTradePrevention;
         accountId?: number;
         clientOrderId?: BigIntValue;
+        referrer?: BigIntValue;
     }>): Promise<{
         actionId: bigint;
         orderId?: bigint;
@@ -350,6 +383,7 @@ export declare class NordUser {
      * @param limitBaseSize - Optional base size limit used once the trigger fires
      * @param limitQuoteSize - Optional quote size limit used once the trigger fires
      * @param accountId - Account executing the trigger
+     * @param referrer - Optional referrer ID. Tracks which frontend/referral source placed trigger
      * @returns Object containing the actionId of the submitted trigger
      * @throws {NordError} If the operation fails
      *
@@ -359,7 +393,7 @@ export declare class NordUser {
      *
      * Max triggers per position: 16
      */
-    addTrigger({ marketId, side, kind, triggerPrice, limitPrice, limitBaseSize, limitQuoteSize, accountId, }: Readonly<{
+    addTrigger({ marketId, side, kind, triggerPrice, limitPrice, limitBaseSize, limitQuoteSize, accountId, referrer, }: Readonly<{
         marketId: number;
         side: Side;
         kind: TriggerKind;
@@ -368,6 +402,7 @@ export declare class NordUser {
         limitBaseSize?: Decimal.Value;
         limitQuoteSize?: Decimal.Value;
         accountId?: number;
+        referrer?: BigIntValue;
     }>): Promise<{
         actionId: bigint;
         triggerId: bigint;