@n1xyz/nord-ts 0.1.7 → 0.1.8

package/dist/nord/index.d.ts

@@ -1,11 +0,0 @@
-export { Nord } from "./client/Nord";
-export { NordUser } from "./client/NordUser";
-export { NordAdmin, AclRole } from "./client/NordAdmin";
-export { NordClient } from "./client/NordClient";
-export type { NordClientParams } from "./client/NordClient";
-export type { CreateTokenParams, CreateMarketParams, PythSetWormholeGuardiansParams, PythSetSymbolFeedParams, FreezeMarketParams, UnfreezeMarketParams, } from "./client/NordAdmin";
-export { NordError } from "./utils/NordError";
-export * from "./api/core";
-export * from "./api/metrics";
-export * from "./api/actions";
-export * from "./models/Subscriber";

package/dist/nord/index.js

@@ -1,36 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NordError = exports.NordClient = exports.AclRole = exports.NordAdmin = exports.NordUser = exports.Nord = void 0;
-// Export main client classes
-var Nord_1 = require("./client/Nord");
-Object.defineProperty(exports, "Nord", { enumerable: true, get: function () { return Nord_1.Nord; } });
-var NordUser_1 = require("./client/NordUser");
-Object.defineProperty(exports, "NordUser", { enumerable: true, get: function () { return NordUser_1.NordUser; } });
-var NordAdmin_1 = require("./client/NordAdmin");
-Object.defineProperty(exports, "NordAdmin", { enumerable: true, get: function () { return NordAdmin_1.NordAdmin; } });
-Object.defineProperty(exports, "AclRole", { enumerable: true, get: function () { return NordAdmin_1.AclRole; } });
-var NordClient_1 = require("./client/NordClient");
-Object.defineProperty(exports, "NordClient", { enumerable: true, get: function () { return NordClient_1.NordClient; } });
-// Export utility classes
-var NordError_1 = require("./utils/NordError");
-Object.defineProperty(exports, "NordError", { enumerable: true, get: function () { return NordError_1.NordError; } });
-// Export API modules
-__exportStar(require("./api/core"), exports);
-__exportStar(require("./api/metrics"), exports);
-__exportStar(require("./api/actions"), exports);
-// Export models
-__exportStar(require("./models/Subscriber"), exports);

package/dist/nord/models/Subscriber.d.ts

@@ -1,37 +0,0 @@
-import { EventEmitter } from "events";
-import { Account, DeltaEvent, OrderbookResponse, SubscriberConfig, StreamTrade, Trades } from "../../types";
-/**
- * Subscriber class for handling WebSocket subscriptions
- */
-export declare class Subscriber {
-    streamURL: string;
-    buffer: (DeltaEvent | Trades | Account)[];
-    maxBufferLen: number;
-    /**
-     * Create a new Subscriber instance
-     * @param config Subscriber configuration
-     */
-    constructor(config: SubscriberConfig);
-    /**
-     * Subscribe to WebSocket events
-     */
-    subscribe(): void;
-}
-/**
- * Interface for orderbook subscription
- */
-export interface OrderbookSubscription extends EventEmitter {
-    on(event: "message", listener: (data: OrderbookResponse) => void): this;
-    on(event: "error", listener: (error: Error) => void): this;
-    close(): void;
-    removeAllListeners(event?: string): this;
-}
-/**
- * Interface for trade subscription
- */
-export interface TradeSubscription extends EventEmitter {
-    on(event: "message", listener: (data: StreamTrade[]) => void): this;
-    on(event: "error", listener: (error: Error) => void): this;
-    close(): void;
-    removeAllListeners(event?: string): this;
-}

package/dist/nord/models/Subscriber.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Subscriber = void 0;
-const utils_1 = require("../../utils");
-/**
- * Subscriber class for handling WebSocket subscriptions
- */
-class Subscriber {
-    /**
-     * Create a new Subscriber instance
-     * @param config Subscriber configuration
-     */
-    constructor(config) {
-        this.streamURL = config.streamURL;
-        this.buffer = [];
-        this.maxBufferLen = config.maxBufferLen ?? utils_1.MAX_BUFFER_LEN;
-    }
-    /**
-     * Subscribe to WebSocket events
-     */
-    subscribe() {
-        // TODO: Implement subscription logic
-    }
-}
-exports.Subscriber = Subscriber;

package/dist/nord/utils/NordError.d.ts

@@ -1,35 +0,0 @@
-/**
- * Options for creating a NordError
- */
-export interface NordErrorOptions {
-    /** The original error that caused this error */
-    cause?: unknown;
-    /** HTTP status code (if applicable) */
-    statusCode?: number;
-    /** Additional error details */
-    details?: Record<string, unknown>;
-}
-/**
- * Custom error class for Nord-related errors
- */
-export declare class NordError extends Error {
-    /** The original error that caused this error */
-    readonly cause?: unknown;
-    /** HTTP status code (if applicable) */
-    readonly statusCode?: number;
-    /** Additional error details */
-    readonly details?: Record<string, unknown>;
-    /**
-     * Create a new NordError
-     *
-     * @param message - Error message
-     * @param options - Error options
-     */
-    constructor(message: string, options?: NordErrorOptions);
-    /**
-     * Convert the error to a string representation
-     *
-     * @returns String representation of the error
-     */
-    toString(): string;
-}

package/dist/nord/utils/NordError.js

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NordError = void 0;
-/**
- * Custom error class for Nord-related errors
- */
-class NordError extends Error {
-    /**
-     * Create a new NordError
-     *
-     * @param message - Error message
-     * @param options - Error options
-     */
-    constructor(message, options = {}) {
-        super(message);
-        this.name = "NordError";
-        this.cause = options.cause;
-        this.statusCode = options.statusCode;
-        this.details = options.details;
-        // Capture stack trace
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, NordError);
-        }
-        // Handle nested errors
-        if (this.cause instanceof Error) {
-            this.stack =
-                this.stack + "\nCaused by: " + (this.cause.stack || this.cause.message);
-        }
-    }
-    /**
-     * Convert the error to a string representation
-     *
-     * @returns String representation of the error
-     */
-    toString() {
-        let result = `${this.name}: ${this.message}`;
-        if (this.statusCode) {
-            result += `  \nstatus: ${this.statusCode}`;
-        }
-        if (this.details && Object.keys(this.details).length > 0) {
-            result += `  \ndetails: ${JSON.stringify(this.details, null, 2)}`;
-        }
-        if (this.cause) {
-            result += `  \ncause: ${this.cause.toString()}`;
-        }
-        return result;
-    }
-}
-exports.NordError = NordError;

package/src/actions.ts

@@ -1,333 +0,0 @@
-import Decimal from "decimal.js";
-import * as proto from "./gen/nord_pb";
-import { paths } from "./gen/openapi";
-import { Client } from "openapi-fetch";
-import { create } from "@bufbuild/protobuf";
-import { FillMode, fillModeToProtoFillMode, Side, QuoteSize } from "./types";
-import {
-  assert,
-  BigIntValue,
-  decodeLengthDelimited,
-  SESSION_TTL,
-  toScaledU64,
-  signUserPayload,
-} from "./utils";
-import { sizeDelimitedEncode } from "@bufbuild/protobuf/wire";
-import { NordError } from "./error";
-import { PublicKey, Transaction } from "@solana/web3.js";
-
-type ReceiptKind = NonNullable<proto.Receipt["kind"]>;
-type ExtractReceiptKind<K extends ReceiptKind["case"]> = Extract<
-  ReceiptKind,
-  { case: K }
->;
-
-export function formatReceiptError(receipt: proto.Receipt): string {
-  if (receipt.kind?.case === "err") {
-    const err = receipt.kind.value;
-    return proto.Error[err] ?? err.toString();
-  }
-  return receipt.kind?.case ?? "unknown";
-}
-
-export function expectReceiptKind<K extends ReceiptKind["case"]>(
-  receipt: proto.Receipt,
-  expected: K,
-  action: string,
-): asserts receipt is proto.Receipt & { kind: ExtractReceiptKind<K> } {
-  if (receipt.kind?.case !== expected) {
-    const label = formatReceiptError(receipt);
-    throw new NordError(`Failed to ${action}: ${label}`);
-  }
-}
-
-async function sessionSign(
-  signFn: (message: Uint8Array) => Promise<Uint8Array>,
-  message: Uint8Array,
-): Promise<Uint8Array> {
-  const signature = await signFn(message);
-  return new Uint8Array([...message, ...signature]);
-}
-
-// Helper to create an action with common fields
-export function createAction(
-  currentTimestamp: bigint,
-  nonce: number,
-  kind: proto.Action["kind"],
-): proto.Action {
-  return create(proto.ActionSchema, {
-    currentTimestamp,
-    nonce,
-    kind,
-  });
-}
-
-export async function sendAction(
-  client: Client<paths>,
-  makeSignedMessage: (message: Uint8Array) => Promise<Uint8Array>,
-  action: proto.Action,
-): Promise<proto.Receipt> {
-  const body = await prepareAction(action, makeSignedMessage);
-
-  const response = await client.POST("/action", {
-    params: {
-      header: {
-        "content-type": "application/octet-stream",
-      },
-    },
-    body: body,
-    // NOTE: openapi-fetch ignores headers and types/const headers in schema, and always assume all things are JSON
-    // to handle multi type bodies, need these overrides and later adhoc parsing
-    bodySerializer: (body) => body,
-    parseAs: "stream",
-  });
-
-  if (response.error) {
-    throw new Error(
-      `Failed to ${action.kind.case}, HTTP status ${JSON.stringify(response.error)}`,
-    );
-  }
-
-  const rawResp = new Uint8Array(await response.response.bytes());
-
-  const resp: proto.Receipt = decodeLengthDelimited(
-    rawResp,
-    proto.ReceiptSchema,
-  );
-
-  if (resp.kind?.case === "err") {
-    throw new Error(
-      `Could not execute ${action.kind.case}, reason: ${proto.Error[resp.kind.value]}`,
-    );
-  }
-
-  return resp;
-}
-
-// Given action and signature function, prepare the signed message to send to server as `body`.
-// `makeSignedMessage` must include the original message and signature.
-export async function prepareAction(
-  action: proto.Action,
-  makeSignedMessage: (message: Uint8Array) => Promise<Uint8Array>,
-) {
-  const encoded = sizeDelimitedEncode(proto.ActionSchema, action);
-  // NOTE(agent): keep in sync with MAX_ENCODED_ACTION_SIZE in Rust code
-  const MAX_ENCODED_ACTION_SIZE = 1024;
-  if (encoded.byteLength > MAX_ENCODED_ACTION_SIZE) {
-    console.warn("Encoded message:", encoded);
-    throw new Error(
-      `Encoded message size (${encoded.byteLength} bytes) is greater than max payload size (${MAX_ENCODED_ACTION_SIZE} bytes).`,
-    );
-  }
-  const body = await makeSignedMessage(encoded);
-  if (body.byteLength > MAX_ENCODED_ACTION_SIZE) {
-    console.warn("Encoded length:", encoded.byteLength);
-    throw new Error(
-      `Signed message size (${body.byteLength} bytes) is greater than max payload size (${MAX_ENCODED_ACTION_SIZE} bytes).`,
-    );
-  }
-  return body;
-}
-
-export async function createSession(
-  client: Client<paths>,
-  signTransaction: (tx: Transaction) => Promise<Transaction>,
-  currentTimestamp: bigint,
-  nonce: number,
-  params: {
-    userPubkey: PublicKey;
-    sessionPubkey: PublicKey;
-    // If not specified, set to current moment plus default session TTL
-    expiryTimestamp?: bigint;
-  },
-): Promise<{ actionId: bigint; sessionId: bigint }> {
-  let expiry = 0n;
-
-  if (params.expiryTimestamp !== undefined) {
-    expiry = params.expiryTimestamp;
-    assert(
-      expiry > currentTimestamp,
-      "Cannot set expiry timestamp in the past",
-    );
-  } else {
-    expiry = currentTimestamp + SESSION_TTL;
-  }
-
-  const action = createAction(currentTimestamp, nonce, {
-    case: "createSession",
-    value: create(proto.Action_CreateSessionSchema, {
-      userPubkey: params.userPubkey.toBytes(),
-      blstPubkey: params.sessionPubkey.toBytes(),
-      expiryTimestamp: expiry,
-    }),
-  });
-
-  const resp = await sendAction(
-    client,
-    async (payload) => {
-      return new Uint8Array([
-        ...payload,
-        ...(await signUserPayload({
-          payload,
-          user: params.userPubkey,
-          signTransaction,
-        })),
-      ]);
-    },
-    action,
-  );
-
-  if (resp.kind?.case === "createSessionResult") {
-    return {
-      actionId: resp.actionId,
-      sessionId: resp.kind.value.sessionId,
-    };
-  } else {
-    throw new Error(`Unexpected receipt kind ${resp.kind?.case}`);
-  }
-}
-
-export async function revokeSession(
-  client: Client<paths>,
-  signTransaction: (tx: Transaction) => Promise<Transaction>,
-  currentTimestamp: bigint,
-  nonce: number,
-  params: {
-    sessionId: BigIntValue;
-    userPubkey: PublicKey;
-  },
-): Promise<{ actionId: bigint }> {
-  const action = createAction(currentTimestamp, nonce, {
-    case: "revokeSession",
-    value: create(proto.Action_RevokeSessionSchema, {
-      sessionId: BigInt(params.sessionId),
-    }),
-  });
-
-  const resp = await sendAction(
-    client,
-    async (payload) => {
-      return new Uint8Array([
-        ...payload,
-        ...(await signUserPayload({
-          payload,
-          user: params.userPubkey,
-          signTransaction,
-        })),
-      ]);
-    },
-    action,
-  );
-
-  return { actionId: resp.actionId };
-}
-
-export type AtomicSubaction =
-  | {
-      kind: "place";
-      // Market and order parameters – identical semantics to placeOrder()
-      marketId: number;
-      side: Side;
-      fillMode: FillMode;
-      isReduceOnly: boolean;
-      // decimals for scaling
-      sizeDecimals: number;
-      priceDecimals: number;
-      // at least one of the three has to be specified; 0 treated as "not set"
-      size?: Decimal.Value;
-      price?: Decimal.Value;
-      quoteSize?: QuoteSize;
-      clientOrderId?: BigIntValue;
-    }
-  | {
-      kind: "cancel";
-      orderId: BigIntValue;
-    };
-
-export async function atomic(
-  client: Client<paths>,
-  signFn: (message: Uint8Array) => Promise<Uint8Array>,
-  currentTimestamp: bigint,
-  nonce: number,
-  params: {
-    sessionId: BigIntValue;
-    accountId?: number;
-    actions: AtomicSubaction[];
-  },
-): Promise<{
-  actionId: bigint;
-  results: proto.Receipt_AtomicSubactionResultKind[];
-}> {
-  assert(
-    params.actions.length > 0 && params.actions.length <= 4,
-    "Atomic action must contain between 1 and 4 sub-actions",
-  );
-
-  const subactions: proto.AtomicSubactionKind[] = params.actions.map((a) => {
-    if (a.kind === "place") {
-      const price = toScaledU64(a.price ?? 0, a.priceDecimals);
-      const size = toScaledU64(a.size ?? 0, a.sizeDecimals);
-      const scaledQuote = a.quoteSize
-        ? a.quoteSize.toWire(a.priceDecimals, a.sizeDecimals)
-        : undefined;
-
-      // Require at least one limit to be set (non-zero size, non-zero price, or quoteSize)
-      assert(
-        price > 0n || size > 0n || scaledQuote !== undefined,
-        "OrderLimit must include at least one of: size, price, or quoteSize",
-      );
-
-      const tradeOrPlace: proto.TradeOrPlace = create(
-        proto.TradeOrPlaceSchema,
-        {
-          marketId: a.marketId,
-          orderType: create(proto.OrderTypeSchema, {
-            side: a.side === Side.Bid ? proto.Side.BID : proto.Side.ASK,
-            fillMode: fillModeToProtoFillMode(a.fillMode),
-            isReduceOnly: a.isReduceOnly,
-          }),
-          limit: create(proto.OrderLimitSchema, {
-            price,
-            size,
-            quoteSize:
-              scaledQuote === undefined
-                ? undefined
-                : create(proto.QuoteSizeSchema, {
-                    size: scaledQuote.size,
-                    price: scaledQuote.price,
-                  }),
-          }),
-          clientOrderId:
-            a.clientOrderId === undefined ? undefined : BigInt(a.clientOrderId),
-        },
-      );
-      return create(proto.AtomicSubactionKindSchema, {
-        inner: { case: "tradeOrPlace", value: tradeOrPlace },
-      });
-    }
-    return create(proto.AtomicSubactionKindSchema, {
-      inner: {
-        case: "cancelOrder",
-        value: create(proto.CancelOrderSchema, { orderId: BigInt(a.orderId) }),
-      },
-    });
-  });
-
-  const action = createAction(currentTimestamp, nonce, {
-    case: "atomic",
-    value: create(proto.AtomicSchema, {
-      sessionId: BigInt(params.sessionId),
-      accountId: params.accountId, // optional
-      actions: subactions,
-    }),
-  });
-
-  const resp = await sendAction(client, (m) => sessionSign(signFn, m), action);
-  if (resp.kind?.case === "atomic") {
-    return {
-      actionId: resp.actionId,
-      results: resp.kind.value.results,
-    };
-  }
-  throw new Error(`Unexpected receipt kind ${resp.kind?.case}`);
-}