@n1xyz/nord-ts 0.0.4 → 0.0.5

package/dist/nord/Nord.d.ts

@@ -1,249 +0,0 @@
-import { Account, ActionQuery, ActionResponse, ActionsResponse, AggregateMetrics, BlockQuery, BlockResponse, BlockSummaryResponse, Info, Market, MarketsStatsResponse, NordConfig, OrderbookQuery, OrderbookResponse, PeakTpsPeriodUnit, RollmanActionResponse, RollmanActionsResponse, RollmanBlockResponse, Token, TokenInfo, TradesQuery, TradesResponse, UserAccountIdsQuery, UserAccountIdsResponse } from "../types";
-import { NordWebSocketClient } from "../websocket/index";
-import { OrderbookSubscription, TradeSubscription } from "./Subscriber";
-/**
- * Main Nord client class for interacting with the Nord API
- */
-export declare class Nord {
-    /** Base URL for the Nord web server */
-    readonly webServerUrl: string;
-    /** Token information */
-    readonly tokenInfos: TokenInfo[];
-    /** Solana program ID */
-    readonly solanaProgramId?: string;
-    /** Solana RPC URL */
-    readonly solanaUrl?: string;
-    /** Available markets */
-    markets: Market[];
-    /** Available tokens */
-    tokens: Token[];
-    /** WebSocket client for real-time updates */
-    private readonly ws;
-    /**
-     * Create a new Nord client instance
-     *
-     * @param config - Configuration options for the Nord client
-     * @throws {Error} If required configuration is missing
-     */
-    constructor({ webServerUrl, tokenInfos, solanaProgramId, solanaUrl, }: NordConfig);
-    /**
-     * Get the current timestamp from the Nord server
-     *
-     * @returns Current timestamp as a bigint
-     * @throws {NordError} If the request fails
-     */
-    getTimestamp(): Promise<bigint>;
-    /**
-     * Get the next action nonce from the Nord server
-     *
-     * @returns Next action nonce
-     * @throws {NordError} If the request fails
-     */
-    getActionNonce(): Promise<number>;
-    /**
-     * Fetch information about Nord markets and tokens
-     *
-     * @throws {NordError} If the request fails
-     */
-    fetchNordInfo(): Promise<void>;
-    /**
-     * Initialize a new Nord client
-     *
-     * @param nordConfig - Configuration options for the Nord client
-     * @returns Initialized Nord client
-     * @throws {NordError} If initialization fails
-     */
-    static initNord(nordConfig: NordConfig): Promise<Nord>;
-    /**
-     * Get market statistics
-     *
-     * @returns Market statistics response
-     * @throws {NordError} If the request fails
-     */
-    marketsStats(): Promise<MarketsStatsResponse>;
-    /**
-     * Query a specific block
-     *
-     * @param query - Block query parameters
-     * @returns Block response
-     * @throws {NordError} If the request fails
-     */
-    queryBlock(query: BlockQuery): Promise<BlockResponse>;
-    /**
-     * Query the last N blocks
-     *
-     * @returns Block response for the last N blocks
-     * @throws {NordError} If the request fails
-     */
-    queryLastNBlocks(): Promise<BlockResponse>;
-    /**
-     * Query recent blocks
-     *
-     * @param last_n - Number of recent blocks to query
-     * @returns Block summary response
-     * @throws {NordError} If the request fails
-     */
-    queryRecentBlocks(last_n: number): Promise<BlockSummaryResponse>;
-    /**
-     * Query a specific action
-     *
-     * @param query - Action query parameters
-     * @returns Action response
-     * @throws {NordError} If the request fails
-     */
-    queryAction(query: ActionQuery): Promise<ActionResponse>;
-    /**
-     * Query recent actions
-     *
-     * @param last_n - Number of recent actions to query
-     * @returns Actions response
-     * @throws {NordError} If the request fails
-     */
-    queryRecentActions(last_n: number): Promise<ActionsResponse>;
-    /**
-     * Fetch aggregate metrics from the Nord API
-     *
-     * @param txPeakTpsPeriod - Period for peak TPS calculation
-     * @param txPeakTpsPeriodUnit - Unit for peak TPS period
-     * @returns Aggregate metrics
-     * @throws {NordError} If the request fails
-     */
-    aggregateMetrics(txPeakTpsPeriod?: number, txPeakTpsPeriodUnit?: PeakTpsPeriodUnit): Promise<AggregateMetrics>;
-    /**
-     * Get current transactions per second
-     *
-     * @param period - Time period for the query
-     * @returns Current TPS value
-     * @throws {NordError} If the request fails
-     */
-    getCurrentTps(period?: string): Promise<any>;
-    /**
-     * Get peak transactions per second
-     *
-     * @param period - Time period for the query
-     * @returns Peak TPS value
-     * @throws {NordError} If the request fails
-     */
-    getPeakTps(period?: string): Promise<any>;
-    /**
-     * Get median transaction latency
-     *
-     * @param period - Time period for the query
-     * @returns Median latency in milliseconds
-     * @throws {NordError} If the request fails
-     */
-    getMedianLatency(period?: string): Promise<any>;
-    /**
-     * Get total transaction count
-     *
-     * @returns Total transaction count
-     * @throws {NordError} If the request fails
-     */
-    getTotalTransactions(): Promise<any>;
-    /**
-     * Query a block from Rollman
-     *
-     * @param query - Block query parameters
-     * @returns Rollman block response
-     * @throws {NordError} If the request fails
-     */
-    blockQueryRollman(query: BlockQuery): Promise<RollmanBlockResponse>;
-    /**
-     * Query block summaries from Rollman
-     *
-     * @param last_n - Number of recent blocks to query
-     * @returns Block summary response
-     * @throws {NordError} If the request fails
-     */
-    blockSummaryQueryRollman(last_n: number): Promise<BlockSummaryResponse>;
-    /**
-     * Query an action from Rollman
-     *
-     * @param query - Action query parameters
-     * @returns Rollman action response
-     * @throws {NordError} If the request fails
-     */
-    actionQueryRollman(query: ActionQuery): Promise<RollmanActionResponse>;
-    /**
-     * Query actions from Rollman
-     *
-     * @param last_n - Number of recent actions to query
-     * @returns Rollman actions response
-     * @throws {NordError} If the request fails
-     */
-    actionsQueryRollman(last_n: number): Promise<RollmanActionsResponse>;
-    /**
-     * Query Prometheus metrics
-     *
-     * @param params - Prometheus query parameters
-     * @returns Query result as a number
-     * @throws {NordError} If the request fails
-     */
-    queryPrometheus(params: string): Promise<number>;
-    /**
-     * Get the WebSocket client
-     *
-     * @returns WebSocket client
-     */
-    getWebSocketClient(): NordWebSocketClient;
-    /**
-     * Subscribe to orderbook updates for a market
-     *
-     * @param symbol - Market symbol
-     * @returns Orderbook subscription
-     */
-    subscribeOrderbook(symbol: string): OrderbookSubscription;
-    /**
-     * Subscribe to trade updates for a market
-     *
-     * @param symbol - Market symbol
-     * @returns Trade subscription
-     */
-    subscribeTrades(symbol: string): TradeSubscription;
-    /**
-     * Get trades for a market
-     *
-     * @param query - Trades query parameters
-     * @returns Trades response
-     * @throws {NordError} If the request fails
-     */
-    getTrades(query: TradesQuery): Promise<TradesResponse>;
-    /**
-     * Get user account IDs
-     *
-     * @param query - User account IDs query parameters
-     * @returns User account IDs response
-     * @throws {NordError} If the request fails
-     */
-    getUserAccountIds(query: UserAccountIdsQuery): Promise<UserAccountIdsResponse>;
-    /**
-     * Get orderbook for a market
-     *
-     * @param query - Orderbook query parameters
-     * @returns Orderbook response
-     * @throws {NordError} If the request fails
-     */
-    getOrderbook(query: OrderbookQuery): Promise<OrderbookResponse>;
-    /**
-     * Get information about the Nord server
-     *
-     * @returns Information about markets and tokens
-     * @throws {NordError} If the request fails
-     */
-    getInfo(): Promise<Info>;
-    /**
-     * Get account information
-     *
-     * @param accountId - Account ID to get information for
-     * @returns Account information
-     * @throws {NordError} If the request fails
-     */
-    getAccount(accountId: number): Promise<Account>;
-    /**
-     * Get market statistics (alias for marketsStats for backward compatibility)
-     *
-     * @deprecated Use marketsStats instead
-     * @returns Market statistics response
-     */
-    getMarketStats(): Promise<MarketsStatsResponse>;
-}

package/dist/nord/Nord.js

@@ -1,388 +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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Nord = void 0;
-const events_1 = require("events");
-const types_1 = require("../types");
-const NordError_1 = require("./NordError");
-const core = __importStar(require("./core"));
-const metrics = __importStar(require("./metrics"));
-const queries = __importStar(require("./queries"));
-const market = __importStar(require("./market"));
-/**
- * Main Nord client class for interacting with the Nord API
- */
-class Nord {
-    /**
-     * Create a new Nord client instance
-     *
-     * @param config - Configuration options for the Nord client
-     * @throws {Error} If required configuration is missing
-     */
-    constructor({ webServerUrl, tokenInfos, solanaProgramId, solanaUrl, }) {
-        /** Available markets */
-        this.markets = [];
-        /** Available tokens */
-        this.tokens = [];
-        if (!webServerUrl) {
-            throw new NordError_1.NordError("webServerUrl is required");
-        }
-        this.webServerUrl = webServerUrl;
-        this.tokenInfos = tokenInfos || [];
-        this.solanaProgramId = solanaProgramId;
-        this.solanaUrl = solanaUrl;
-        // Initialize WebSocket client
-        this.ws = core.initWebSocketClient(webServerUrl);
-    }
-    /**
-     * Get the current timestamp from the Nord server
-     *
-     * @returns Current timestamp as a bigint
-     * @throws {NordError} If the request fails
-     */
-    async getTimestamp() {
-        return core.getTimestamp(this.webServerUrl);
-    }
-    /**
-     * Get the next action nonce from the Nord server
-     *
-     * @returns Next action nonce
-     * @throws {NordError} If the request fails
-     */
-    async getActionNonce() {
-        return core.getActionNonce(this.webServerUrl);
-    }
-    /**
-     * Fetch information about Nord markets and tokens
-     *
-     * @throws {NordError} If the request fails
-     */
-    async fetchNordInfo() {
-        try {
-            const info = await core.getInfo(this.webServerUrl);
-            this.markets = info.markets;
-            this.tokens = info.tokens;
-        }
-        catch (error) {
-            throw new NordError_1.NordError("Failed to fetch Nord info", { cause: error });
-        }
-    }
-    /**
-     * Initialize a new Nord client
-     *
-     * @param nordConfig - Configuration options for the Nord client
-     * @returns Initialized Nord client
-     * @throws {NordError} If initialization fails
-     */
-    static async initNord(nordConfig) {
-        const nord = new Nord(nordConfig);
-        await nord.fetchNordInfo();
-        return nord;
-    }
-    /**
-     * Get market statistics
-     *
-     * @returns Market statistics response
-     * @throws {NordError} If the request fails
-     */
-    async marketsStats() {
-        return market.marketsStats(this.webServerUrl);
-    }
-    /**
-     * Query a specific block
-     *
-     * @param query - Block query parameters
-     * @returns Block response
-     * @throws {NordError} If the request fails
-     */
-    async queryBlock(query) {
-        return queries.queryBlock(this.webServerUrl, query);
-    }
-    /**
-     * Query the last N blocks
-     *
-     * @returns Block response for the last N blocks
-     * @throws {NordError} If the request fails
-     */
-    async queryLastNBlocks() {
-        return queries.queryLastNBlocks(this.webServerUrl);
-    }
-    /**
-     * Query recent blocks
-     *
-     * @param last_n - Number of recent blocks to query
-     * @returns Block summary response
-     * @throws {NordError} If the request fails
-     */
-    async queryRecentBlocks(last_n) {
-        return queries.queryRecentBlocks(this.webServerUrl, last_n);
-    }
-    /**
-     * Query a specific action
-     *
-     * @param query - Action query parameters
-     * @returns Action response
-     * @throws {NordError} If the request fails
-     */
-    async queryAction(query) {
-        return queries.queryAction(this.webServerUrl, query);
-    }
-    /**
-     * Query recent actions
-     *
-     * @param last_n - Number of recent actions to query
-     * @returns Actions response
-     * @throws {NordError} If the request fails
-     */
-    async queryRecentActions(last_n) {
-        return queries.queryRecentActions(this.webServerUrl, last_n);
-    }
-    /**
-     * Fetch aggregate metrics from the Nord API
-     *
-     * @param txPeakTpsPeriod - Period for peak TPS calculation
-     * @param txPeakTpsPeriodUnit - Unit for peak TPS period
-     * @returns Aggregate metrics
-     * @throws {NordError} If the request fails
-     */
-    async aggregateMetrics(txPeakTpsPeriod = 1, txPeakTpsPeriodUnit = types_1.PeakTpsPeriodUnit.Day) {
-        return metrics.aggregateMetrics(this.webServerUrl, txPeakTpsPeriod, txPeakTpsPeriodUnit);
-    }
-    /**
-     * Get current transactions per second
-     *
-     * @param period - Time period for the query
-     * @returns Current TPS value
-     * @throws {NordError} If the request fails
-     */
-    async getCurrentTps(period = "1m") {
-        return metrics.getCurrentTps(this.webServerUrl, period);
-    }
-    /**
-     * Get peak transactions per second
-     *
-     * @param period - Time period for the query
-     * @returns Peak TPS value
-     * @throws {NordError} If the request fails
-     */
-    async getPeakTps(period = "24h") {
-        return metrics.getPeakTps(this.webServerUrl, period);
-    }
-    /**
-     * Get median transaction latency
-     *
-     * @param period - Time period for the query
-     * @returns Median latency in milliseconds
-     * @throws {NordError} If the request fails
-     */
-    async getMedianLatency(period = "1m") {
-        return metrics.getMedianLatency(this.webServerUrl, period);
-    }
-    /**
-     * Get total transaction count
-     *
-     * @returns Total transaction count
-     * @throws {NordError} If the request fails
-     */
-    async getTotalTransactions() {
-        return metrics.getTotalTransactions(this.webServerUrl);
-    }
-    /**
-     * Query a block from Rollman
-     *
-     * @param query - Block query parameters
-     * @returns Rollman block response
-     * @throws {NordError} If the request fails
-     */
-    async blockQueryRollman(query) {
-        return queries.blockQueryRollman(this.webServerUrl, query);
-    }
-    /**
-     * Query block summaries from Rollman
-     *
-     * @param last_n - Number of recent blocks to query
-     * @returns Block summary response
-     * @throws {NordError} If the request fails
-     */
-    async blockSummaryQueryRollman(last_n) {
-        return queries.blockSummaryQueryRollman(this.webServerUrl, last_n);
-    }
-    /**
-     * Query an action from Rollman
-     *
-     * @param query - Action query parameters
-     * @returns Rollman action response
-     * @throws {NordError} If the request fails
-     */
-    async actionQueryRollman(query) {
-        return queries.actionQueryRollman(this.webServerUrl, query);
-    }
-    /**
-     * Query actions from Rollman
-     *
-     * @param last_n - Number of recent actions to query
-     * @returns Rollman actions response
-     * @throws {NordError} If the request fails
-     */
-    async actionsQueryRollman(last_n) {
-        return queries.actionsQueryRollman(this.webServerUrl, last_n);
-    }
-    /**
-     * Query Prometheus metrics
-     *
-     * @param params - Prometheus query parameters
-     * @returns Query result as a number
-     * @throws {NordError} If the request fails
-     */
-    async queryPrometheus(params) {
-        return metrics.queryPrometheus(this.webServerUrl, params);
-    }
-    /**
-     * Get the WebSocket client
-     *
-     * @returns WebSocket client
-     */
-    getWebSocketClient() {
-        return this.ws;
-    }
-    /**
-     * Subscribe to orderbook updates for a market
-     *
-     * @param symbol - Market symbol
-     * @returns Orderbook subscription
-     */
-    subscribeOrderbook(symbol) {
-        const subscription = new events_1.EventEmitter();
-        const handleDelta = (update) => {
-            if (update.market_symbol === symbol) {
-                subscription.emit("message", {
-                    asks: update.asks,
-                    bids: update.bids,
-                    market_symbol: update.market_symbol,
-                    last_update_id: update.last_update_id,
-                });
-            }
-        };
-        this.ws.on("delta", handleDelta);
-        this.ws.subscribe([`deltas@${symbol}`]);
-        subscription.close = () => {
-            this.ws.unsubscribe([`deltas@${symbol}`]);
-            this.ws.removeAllListeners("delta");
-            subscription.removeAllListeners();
-        };
-        return subscription;
-    }
-    /**
-     * Subscribe to trade updates for a market
-     *
-     * @param symbol - Market symbol
-     * @returns Trade subscription
-     */
-    subscribeTrades(symbol) {
-        const subscription = new events_1.EventEmitter();
-        const handleTrade = (update) => {
-            if (update.market_symbol === symbol) {
-                subscription.emit("message", update.trades);
-            }
-        };
-        this.ws.on("trade", handleTrade);
-        this.ws.subscribe([`trades@${symbol}`]);
-        subscription.close = () => {
-            this.ws.unsubscribe([`trades@${symbol}`]);
-            this.ws.removeAllListeners("trade");
-            subscription.removeAllListeners();
-        };
-        return subscription;
-    }
-    /**
-     * Get trades for a market
-     *
-     * @param query - Trades query parameters
-     * @returns Trades response
-     * @throws {NordError} If the request fails
-     */
-    async getTrades(query) {
-        return market.getTrades(this.webServerUrl, query);
-    }
-    /**
-     * Get user account IDs
-     *
-     * @param query - User account IDs query parameters
-     * @returns User account IDs response
-     * @throws {NordError} If the request fails
-     */
-    async getUserAccountIds(query) {
-        return market.getUserAccountIds(this.webServerUrl, query);
-    }
-    /**
-     * Get orderbook for a market
-     *
-     * @param query - Orderbook query parameters
-     * @returns Orderbook response
-     * @throws {NordError} If the request fails
-     */
-    async getOrderbook(query) {
-        return market.getOrderbook(this.webServerUrl, query);
-    }
-    /**
-     * Get information about the Nord server
-     *
-     * @returns Information about markets and tokens
-     * @throws {NordError} If the request fails
-     */
-    async getInfo() {
-        return core.getInfo(this.webServerUrl);
-    }
-    /**
-     * Get account information
-     *
-     * @param accountId - Account ID to get information for
-     * @returns Account information
-     * @throws {NordError} If the request fails
-     */
-    async getAccount(accountId) {
-        return core.getAccount(this.webServerUrl, accountId);
-    }
-    /**
-     * Get market statistics (alias for marketsStats for backward compatibility)
-     *
-     * @deprecated Use marketsStats instead
-     * @returns Market statistics response
-     */
-    async getMarketStats() {
-        return this.marketsStats();
-    }
-}
-exports.Nord = Nord;

package/dist/nord/NordError.d.ts

@@ -1,23 +0,0 @@
-/**
- * Custom error class for Nord-related errors
- * Extends the standard Error class with additional context
- */
-export declare class NordError extends Error {
-    /** The original error that caused this error, if any */
-    readonly cause?: unknown;
-    /**
-     * Create a new NordError
-     *
-     * @param message - Error message
-     * @param options - Additional error options
-     */
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-    /**
-     * Get a string representation of the error including the cause if available
-     *
-     * @returns String representation of the error
-     */
-    toString(): string;
-}

package/dist/nord/NordError.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NordError = void 0;
-/**
- * Custom error class for Nord-related errors
- * Extends the standard Error class with additional context
- */
-class NordError extends Error {
-    /**
-     * Create a new NordError
-     *
-     * @param message - Error message
-     * @param options - Additional error options
-     */
-    constructor(message, options) {
-        super(message);
-        // Set the prototype explicitly to ensure instanceof works correctly
-        Object.setPrototypeOf(this, NordError.prototype);
-        // Set the name to the class name for better error messages
-        this.name = 'NordError';
-        // Store the cause if provided
-        if (options?.cause) {
-            this.cause = options.cause;
-        }
-        // Capture stack trace
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, NordError);
-        }
-    }
-    /**
-     * Get a string representation of the error including the cause if available
-     *
-     * @returns String representation of the error
-     */
-    toString() {
-        let result = `${this.name}: ${this.message}`;
-        if (this.cause) {
-            if (this.cause instanceof Error) {
-                result += `\nCaused by: ${this.cause.toString()}`;
-            }
-            else {
-                result += `\nCaused by: ${String(this.cause)}`;
-            }
-        }
-        return result;
-    }
-}
-exports.NordError = NordError;