@n1xyz/nord-ts 0.6.2 → 0.7.0

package/README.md

@@ -127,10 +127,29 @@ await user.placeOrder({
 ```
 
 Notes:
+
 - `quoteSize` is a positive decimal representing the desired quote amount.
 - The wire format encodes quote amount as a 128-bit value scaled by `price_decimals + size_decimals` of the target market.
 - At least one limit must be provided among `size`, `price`, or `quoteSize`.
 
+### RFQ fills and funding sampling
+
+`fillRfqOrder` always returns the normal RFQ fill result. For non-executable
+funding sampling, `filledSize` and `tradeId` are `null`:
+
+```typescript
+const result = await user.fillRfqOrder({ marketId, orderId, price });
+
+if (result.filledSize === null) {
+  // A price observation only; no trade, balance, or position change occurred.
+  console.log(result.orderId, result.makerAccountId);
+} else {
+  console.log(result.filledSize, result.tradeId);
+}
+```
+
+Real RFQ executions use the same result shape with both execution values set.
+
 ### Deposits and Withdrawals
 
 ```typescript

package/dist/actions.d.ts

@@ -1,8 +1,9 @@
 import Decimal from "decimal.js";
 import * as proto from "./gen/nord_pb";
+import * as core from "./gen/core_pb";
 import { paths } from "./gen/openapi";
 import { Client } from "openapi-fetch";
-import { FillMode, PlacementRequest, Side, TriggerKind } from "./types";
+import { type Duration, FillMode, PlacementRequest, Side, TriggerKind } from "./types";
 import { BigIntValue } from "./utils";
 import { PublicKey, Transaction } from "@solana/web3.js";
 type ReceiptKind = NonNullable<proto.Receipt["kind"]>;
@@ -14,7 +15,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 toProtoU128(value: BigIntValue): core.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>>;
@@ -23,16 +24,31 @@ export declare function createSession(client: Client<paths>, signMessage: (_: Ui
     sessionPubkey: PublicKey;
     signatureFraming: "hex" | "solanaTransaction";
     expiryTimestamp?: bigint;
+    refreshDeadline?: bigint;
     signTransactionFn: (tx: Transaction) => Promise<Transaction>;
 }): Promise<{
     actionId: bigint;
     sessionId: bigint;
+    expiry: bigint;
+    refreshDeadline?: bigint;
 }>;
 export declare function revokeSession(client: Client<paths>, signMessage: (_: Uint8Array) => Promise<Uint8Array>, currentTimestamp: bigint, nonce: number, params: {
     sessionId: BigIntValue;
 }): Promise<{
     actionId: bigint;
 }>;
+export declare function refreshSession(client: Client<paths>, signFn: (message: Uint8Array) => Promise<Uint8Array>, currentTimestamp: bigint, nonce: number, params: {
+    sessionId: BigIntValue;
+    newExpiry: bigint;
+}): Promise<{
+    actionId: bigint;
+    newExpiry: bigint;
+}>;
+export declare function selfRevokeSession(client: Client<paths>, signFn: (message: Uint8Array) => Promise<Uint8Array>, currentTimestamp: bigint, nonce: number, params: {
+    sessionId: BigIntValue;
+}): Promise<{
+    actionId: bigint;
+}>;
 export declare function createTakeAllPositionsInput(params: {
     sessionId: BigIntValue;
     targetAccountId: number;
@@ -68,6 +84,31 @@ export type AtomicSubaction = {
     clientOrderId: BigIntValue;
     delegatorAccountId?: number;
     placement?: PlacementRequest;
+} | {
+    kind: "reduceOrderLiquidation";
+    targetAccountId: number;
+    marketId: number;
+    delegatorAccountId?: number;
+    placement?: PlacementRequest;
+} | {
+    kind: "rfq";
+    marketId: number;
+    side: Side;
+    priceDecimals: number;
+    sizeDecimals: number;
+    price: Decimal.Value;
+    size: Decimal.Value;
+    timeout?: Duration;
+    clientOrderId?: BigIntValue;
+    delegatorAccountId?: number;
+} | {
+    kind: "rfqFill";
+    marketId: number;
+    orderId: BigIntValue;
+    priceDecimals: number;
+    price: Decimal.Value;
+    timeout?: Duration;
+    delegatorAccountId?: number;
 } | {
     kind: "addTrigger";
     marketId: number;
@@ -100,6 +141,7 @@ export type AtomicSubaction = {
     triggerId: BigIntValue;
     placement?: PlacementRequest;
 };
+export declare function atomicSubactionToProto(currentTimestamp: bigint, a: AtomicSubaction, omitDelegatorAccountId?: boolean): proto.AtomicSubaction;
 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,9 +3,9 @@ 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, 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, 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 } from "../websocket/Subscriber";
+import { OrderbookSubscription, TradeSubscription, CandleSubscription, RfqFillsSubscription } from "../websocket/Subscriber";
 /**
  * User subscription interface
  */
@@ -46,6 +46,7 @@ export declare class Nord {
      * @param deltas - Market symbols to subscribe to for orderbook delta updates
      * @param accounts - Account IDs to subscribe to for account updates
      * @param candles - Candle subscriptions with symbol and resolution
+     * @param rfqFills - Market symbols or market ids to subscribe to for RFQ fill requests
      * @param liquidations - Whether to subscribe to take-all liquidation updates
      * @returns A new WebSocket client with the requested subscriptions
      * @throws {NordError} If invalid subscription options are provided
@@ -64,7 +65,7 @@ export declare class Nord {
      *   trades: ["BTCUSDC", "ETHUSDC"]
      * });
      */
-    createWebSocketClient({ trades, deltas, accounts, candles, liquidations, }: Readonly<{
+    createWebSocketClient({ trades, deltas, accounts, candles, rfqFills, liquidations, }: Readonly<{
         trades?: string[];
         deltas?: string[];
         accounts?: number[];
@@ -72,6 +73,7 @@ export declare class Nord {
             symbol: string;
             resolution: CandleResolution;
         }>;
+        rfqFills?: MarketSymbol[];
         liquidations?: boolean;
     }>): NordWebSocketClient;
     private GET;
@@ -184,6 +186,7 @@ export declare class Nord {
      * @throws {NordError} If symbol is invalid
      */
     subscribeTrades(symbol: string): TradeSubscription;
+    subscribeRfqFills(market: MarketSymbol): RfqFillsSubscription;
     /**
      * Subscribe to account updates
      *

package/dist/client/NordAdmin.d.ts

@@ -8,6 +8,22 @@ export declare enum AclRole {
     MARKET_MANAGER = 2,
     ADMIN = 2147483648
 }
+/**
+ * Pyth Lazer ed25519 trusted signer configuration.
+ *
+ * This mirrors the Pyth Solana contract manager shape:
+ * `{ publicKey: string; expiresAt: bigint }`.
+ */
+export type PythLazerTrustedSigner = Readonly<{
+    /** Base58 Solana public key, or a `PublicKey` instance. */
+    publicKey: PublicKey;
+    /** Solana timestamp */
+    expiresAt: number;
+}>;
+export type PythLazerFeedSymbolInput = Readonly<{
+    feedId: number;
+    oracleSymbol: string;
+}>;
 /**
  * Administrative client capable of submitting privileged configuration actions.
  */
@@ -133,6 +149,45 @@ export declare class NordAdmin {
     }>): Promise<{
         actionId: bigint;
     } & proto.Receipt_OracleSymbolFeedResult>;
+    /**
+     * Configure the fixed Pyth Lazer ed25519 trusted signer set.
+     *
+     * The input must contain exactly five unique Solana public keys. Signer
+     * entries use the same external shape as Pyth's Solana contract manager:
+     * `{ publicKey: string; expiresAt: bigint }`.
+     *
+     * @param trustedSigners - Five ed25519 trusted signer entries
+     * @returns Action identifier and trusted signer receipt
+     * @throws {NordError} If the signer shape is invalid or submission fails
+     */
+    pythLazerSetTrustedSigners({ trustedSigners, }: Readonly<{
+        trustedSigners: readonly PythLazerTrustedSigner[];
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_PythLazerTrustedSignersSetResult>;
+    /**
+     * Link one or more Pyth Lazer feed ids to Nord oracle symbols.
+     *
+     * @param feeds - Feed id to oracle symbol mappings
+     * @returns Action identifier and feed-symbol receipt
+     * @throws {NordError} If the feed mapping shape is invalid or submission fails
+     */
+    pythLazerSetFeedSymbols({ feeds, }: Readonly<{
+        feeds: readonly PythLazerFeedSymbolInput[];
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_PythLazerFeedSymbolSetResult>;
+    /**
+     * Link a single Pyth Lazer feed id to a Nord oracle symbol.
+     *
+     * @param feedId - Pyth Lazer feed id
+     * @param oracleSymbol - Symbol resolved by the oracle adapter
+     * @returns Action identifier and feed-symbol receipt
+     * @throws {NordError} If the feed mapping shape is invalid or submission fails
+     */
+    pythLazerSetFeedSymbol({ feedId, oracleSymbol, }: PythLazerFeedSymbolInput): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_PythLazerFeedSymbolSetResult>;
     /**
      * Pause all trading activity on the exchange.
      *

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, PlacementRequest, VaultWithdrawRequestKind } from "../types";
+import { FillMode, Side, SPLTokenInfo, TriggerKind, SelfTradePrevention, PlacementRequest, VaultWithdrawRequestKind, type Duration, type RfqFillResult } from "../types";
 import * as proto from "../gen/nord_pb";
 import { BigIntValue } from "../utils";
 import { Nord } from "./Nord";
@@ -27,6 +27,28 @@ export type UserAtomicSubaction = {
     clientOrderId: BigIntValue;
     delegatorAccountId?: number;
     placement?: PlacementRequest;
+} | {
+    kind: "reduceOrderLiquidation";
+    targetAccountId: number;
+    marketId: number;
+    delegatorAccountId?: number;
+    placement?: PlacementRequest;
+} | {
+    kind: "rfq";
+    marketId: number;
+    side: Side;
+    price: Decimal.Value;
+    size: Decimal.Value;
+    timeout?: Duration;
+    clientOrderId?: BigIntValue;
+    delegatorAccountId?: number;
+} | {
+    kind: "rfqFill";
+    marketId: number;
+    orderId: BigIntValue;
+    price: Decimal.Value;
+    timeout?: Duration;
+    delegatorAccountId?: number;
 } | {
     kind: "addTrigger";
     marketId: number;
@@ -55,6 +77,7 @@ export type UserAtomicSubaction = {
     triggerId: BigIntValue;
     placement?: PlacementRequest;
 };
+export declare function decodeRfqFillResult(actionId: bigint, result: proto.Receipt_AtomicSubactionResultKind["inner"] | undefined): RfqFillResult;
 export interface NormalizedReceiptTrade {
     orderId: bigint;
     price: number;
@@ -107,7 +130,7 @@ export declare class NordUser {
             size: number;
             price: number;
             originalOrderSize: number;
-            clientOrderId: number | null;
+            clientOrderId: string | null;
         }[];
     };
     /** User positions by account ID */
@@ -241,7 +264,11 @@ export declare class NordUser {
      *
      * @throws {NordError} If the operation fails
      */
-    refreshSession(expiryTimestamp?: bigint): Promise<void>;
+    refreshSession(expiryTimestamp?: bigint, refreshDeadline?: bigint): Promise<{
+        sessionId: bigint;
+        expiry: bigint;
+        refreshDeadline?: bigint;
+    }>;
     /**
      * Revoke a session
      *
@@ -249,6 +276,33 @@ export declare class NordUser {
      * @throws {NordError} If the operation fails
      */
     revokeSession(sessionId: BigIntValue): Promise<void>;
+    /**
+     * Extend the CURRENT session's expiry in place, signed by the session key
+     * (no wallet popup). Unlike {@link refreshSession}, this keeps the same
+     * session id and does not require a wallet signature.
+     *
+     * The engine clamps the new expiry to the session's `refresh_deadline`
+     * (the hard bound chosen at session creation); once that deadline is reached,
+     * or if the session was created without one, a fresh {@link refreshSession}
+     * (wallet) is required.
+     *
+     * @param newExpiry - Desired new expiry (unix seconds). Defaults to now + TTL.
+     * @throws {NordError} If the operation fails
+     */
+    selfRefreshSession(newExpiry?: bigint): Promise<{
+        actionId: bigint;
+        newExpiry: bigint;
+    }>;
+    /**
+     * Revoke the CURRENT session itself, signed by the session key (no wallet
+     * popup). Safe logout: can only ever revoke this session. Clears the local
+     * session id on success.
+     *
+     * @throws {NordError} If the operation fails
+     */
+    selfRevoke(): Promise<{
+        actionId: bigint;
+    }>;
     /**
      * Checks if the session is valid
      * @private
@@ -351,6 +405,25 @@ export declare class NordUser {
         orderId: bigint;
         accountId: number;
     }>;
+    placeRfqOrder({ marketId, side, size, price, timeout, accountId, clientOrderId, }: Readonly<{
+        marketId: number;
+        side: Side;
+        size: Decimal.Value;
+        price: Decimal.Value;
+        timeout?: Duration;
+        accountId?: number;
+        clientOrderId?: BigIntValue;
+    }>): Promise<{
+        actionId: bigint;
+        orderId: bigint;
+    }>;
+    fillRfqOrder({ marketId, orderId, price, timeout, accountId, }: Readonly<{
+        marketId: number;
+        orderId: BigIntValue;
+        price: Decimal.Value;
+        timeout?: Duration;
+        accountId?: number;
+    }>): Promise<RfqFillResult>;
     /**
      * Cancel an order by client_order_id.
      *

package/dist/gen/core_pb.d.ts

@@ -0,0 +1,120 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file core.proto.
+ */
+export declare const file_core: GenFile;
+/**
+ * Helper struct to represent 128-bit
+ * unsigned values.
+ *
+ * @generated from message nord.U128
+ */
+export type U128 = Message<"nord.U128"> & {
+    /**
+     * lower 64 bits
+     *
+     * @generated from field: uint64 lo = 1;
+     */
+    lo: bigint;
+    /**
+     * upper 64 bits
+     *
+     * @generated from field: uint64 hi = 2;
+     */
+    hi: bigint;
+};
+/**
+ * Helper struct to represent 128-bit
+ * unsigned values.
+ *
+ * @generated from message nord.U128
+ */
+export type U128Json = {
+    /**
+     * lower 64 bits
+     *
+     * @generated from field: uint64 lo = 1;
+     */
+    lo?: string;
+    /**
+     * upper 64 bits
+     *
+     * @generated from field: uint64 hi = 2;
+     */
+    hi?: string;
+};
+/**
+ * Describes the message nord.U128.
+ * Use `create(U128Schema)` to create a new message.
+ */
+export declare const U128Schema: GenMessage<U128, {
+    jsonType: U128Json;
+}>;
+/**
+ * @generated from enum nord.Side
+ */
+export declare enum Side {
+    /**
+     * @generated from enum value: ASK = 0;
+     */
+    ASK = 0,
+    /**
+     * @generated from enum value: BID = 1;
+     */
+    BID = 1
+}
+/**
+ * @generated from enum nord.Side
+ */
+export type SideJson = "ASK" | "BID";
+/**
+ * Describes the enum nord.Side.
+ */
+export declare const SideSchema: GenEnum<Side, SideJson>;
+/**
+ * @generated from enum nord.MarketMode
+ */
+export declare enum MarketMode {
+    /**
+     * @generated from enum value: CLOB = 0;
+     */
+    CLOB = 0,
+    /**
+     * @generated from enum value: RFQ = 1;
+     */
+    RFQ = 1
+}
+/**
+ * @generated from enum nord.MarketMode
+ */
+export type MarketModeJson = "CLOB" | "RFQ";
+/**
+ * Describes the enum nord.MarketMode.
+ */
+export declare const MarketModeSchema: GenEnum<MarketMode, MarketModeJson>;
+/**
+ * @generated from enum nord.MarketRegime
+ */
+export declare enum MarketRegime {
+    /**
+     * @generated from enum value: MARKET_REGIME_NORMAL = 0;
+     */
+    NORMAL = 0,
+    /**
+     * @generated from enum value: MARKET_REGIME_POST_ONLY = 1;
+     */
+    POST_ONLY = 1,
+    /**
+     * @generated from enum value: MARKET_REGIME_TRADE_ONLY = 2;
+     */
+    TRADE_ONLY = 2
+}
+/**
+ * @generated from enum nord.MarketRegime
+ */
+export type MarketRegimeJson = "MARKET_REGIME_NORMAL" | "MARKET_REGIME_POST_ONLY" | "MARKET_REGIME_TRADE_ONLY";
+/**
+ * Describes the enum nord.MarketRegime.
+ */
+export declare const MarketRegimeSchema: GenEnum<MarketRegime, MarketRegimeJson>;