@n1xyz/nord-ts 0.0.4 → 0.0.5

package/dist/nord/core.js

@@ -1,97 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTimestamp = getTimestamp;
-exports.getActionNonce = getActionNonce;
-exports.getInfo = getInfo;
-exports.getAccount = getAccount;
-exports.initWebSocketClient = initWebSocketClient;
-const utils_1 = require("../utils");
-const NordError_1 = require("./utils/NordError");
-const index_1 = require("../websocket/index");
-/**
- * Get the current timestamp from the Nord server
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @returns Current timestamp as a bigint
- * @throws {NordError} If the request fails
- */
-async function getTimestamp(webServerUrl) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/timestamp`);
-        const data = await response.json();
-        return BigInt(data.timestamp);
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to get timestamp", { cause: error });
-    }
-}
-/**
- * Get the next action nonce from the Nord server
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @returns Next action nonce
- * @throws {NordError} If the request fails
- */
-async function getActionNonce(webServerUrl) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/action_nonce`);
-        const data = await response.json();
-        return data.nonce;
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to get action nonce", { cause: error });
-    }
-}
-/**
- * Get information about the Nord server
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @returns Information about markets and tokens
- * @throws {NordError} If the request fails
- */
-async function getInfo(webServerUrl) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/info`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to get info", { cause: error });
-    }
-}
-/**
- * Get account information
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param accountId - Account ID to get information for
- * @returns Account information
- * @throws {NordError} If the request fails
- */
-async function getAccount(webServerUrl, accountId) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/account?account_id=${accountId}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError(`Failed to get account ${accountId}`, { cause: error });
-    }
-}
-/**
- * Initialize a WebSocket client for Nord
- *
- * Connects to one of the specific Nord WebSocket endpoints:
- * - /ws/trades - For trade updates (default)
- * - /ws/deltas - For orderbook delta updates
- * - /ws/user - For user-specific updates
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param endpoint - Specific WebSocket endpoint to connect to (trades, deltas, or user)
- * @returns WebSocket client
- */
-function initWebSocketClient(webServerUrl, endpoint) {
-    // If no specific endpoint is provided, we'll connect to trades by default
-    const specificEndpoint = endpoint || 'trades';
-    const wsUrl = webServerUrl.replace(/^http/, "ws") + `/ws/${specificEndpoint}`;
-    const ws = new index_1.NordWebSocketClient(wsUrl);
-    ws.connect();
-    return ws;
-}

package/dist/nord/market.d.ts

@@ -1,36 +0,0 @@
-import { MarketsStatsResponse, OrderbookQuery, OrderbookResponse, TradesQuery, TradesResponse, UserAccountIdsQuery, UserAccountIdsResponse } from "../types";
-/**
- * Get market statistics
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @returns Market statistics response
- * @throws {NordError} If the request fails
- */
-export declare function marketsStats(webServerUrl: string): Promise<MarketsStatsResponse>;
-/**
- * Get trades for a market
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Trades query parameters
- * @returns Trades response
- * @throws {NordError} If the request fails
- */
-export declare function getTrades(webServerUrl: string, query: TradesQuery): Promise<TradesResponse>;
-/**
- * Get user account IDs
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - User account IDs query parameters
- * @returns User account IDs response
- * @throws {NordError} If the request fails
- */
-export declare function getUserAccountIds(webServerUrl: string, query: UserAccountIdsQuery): Promise<UserAccountIdsResponse>;
-/**
- * Get orderbook for a market
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Orderbook query parameters
- * @returns Orderbook response
- * @throws {NordError} If the request fails
- */
-export declare function getOrderbook(webServerUrl: string, query: OrderbookQuery): Promise<OrderbookResponse>;

package/dist/nord/market.js

@@ -1,90 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.marketsStats = marketsStats;
-exports.getTrades = getTrades;
-exports.getUserAccountIds = getUserAccountIds;
-exports.getOrderbook = getOrderbook;
-const utils_1 = require("../utils");
-const NordError_1 = require("./NordError");
-/**
- * Get market statistics
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @returns Market statistics response
- * @throws {NordError} If the request fails
- */
-async function marketsStats(webServerUrl) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/markets_stats`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to fetch markets stats", { cause: error });
-    }
-}
-/**
- * Get trades for a market
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Trades query parameters
- * @returns Trades response
- * @throws {NordError} If the request fails
- */
-async function getTrades(webServerUrl, query) {
-    try {
-        const params = new URLSearchParams();
-        params.append("accountId", query.accountId.toString());
-        if (query.since) {
-            params.append("since", query.since);
-        }
-        if (query.until) {
-            params.append("until", query.until);
-        }
-        if (query.pageId) {
-            params.append("pageId", query.pageId);
-        }
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/trades?${params.toString()}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to get trades", { cause: error });
-    }
-}
-/**
- * Get user account IDs
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - User account IDs query parameters
- * @returns User account IDs response
- * @throws {NordError} If the request fails
- */
-async function getUserAccountIds(webServerUrl, query) {
-    try {
-        const params = new URLSearchParams();
-        params.append("pubkey", query.pubkey);
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/user_account_ids?${params.toString()}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to get user account IDs", { cause: error });
-    }
-}
-/**
- * Get orderbook for a market
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Orderbook query parameters
- * @returns Orderbook response
- * @throws {NordError} If the request fails
- */
-async function getOrderbook(webServerUrl, query) {
-    try {
-        const params = new URLSearchParams();
-        params.append("symbol", query.symbol);
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/orderbook?${params.toString()}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to get orderbook", { cause: error });
-    }
-}

package/dist/nord/metrics.d.ts

@@ -1,67 +0,0 @@
-import { AggregateMetrics, PeakTpsPeriodUnit } from "../types";
-/**
- * Time periods for metrics queries
- */
-export declare enum MetricPeriod {
-    ONE_MINUTE = "1m",
-    FIVE_MINUTES = "5m",
-    FIFTEEN_MINUTES = "15m",
-    ONE_HOUR = "1h",
-    FOUR_HOURS = "4h",
-    ONE_DAY = "24h",
-    ONE_WEEK = "7d"
-}
-/**
- * Fetch aggregate metrics from the Nord API
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param txPeakTpsPeriod - Period for peak TPS calculation
- * @param txPeakTpsPeriodUnit - Unit for peak TPS period
- * @returns Aggregate metrics
- * @throws {NordError} If the request fails
- */
-export declare function aggregateMetrics(webServerUrl: string, txPeakTpsPeriod?: number, txPeakTpsPeriodUnit?: PeakTpsPeriodUnit): Promise<AggregateMetrics>;
-/**
- * Get current transactions per second
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param period - Time period for the query
- * @returns Current TPS value
- * @throws {NordError} If the request fails
- */
-export declare function getCurrentTps(webServerUrl: string, period?: string): Promise<number>;
-/**
- * Get peak transactions per second
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param period - Time period for the query
- * @returns Peak TPS value
- * @throws {NordError} If the request fails
- */
-export declare function getPeakTps(webServerUrl: string, period?: string): Promise<number>;
-/**
- * Get median transaction latency
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param period - Time period for the query
- * @returns Median latency in milliseconds
- * @throws {NordError} If the request fails
- */
-export declare function getMedianLatency(webServerUrl: string, period?: string): Promise<number>;
-/**
- * Get total transaction count
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @returns Total transaction count
- * @throws {NordError} If the request fails
- */
-export declare function getTotalTransactions(webServerUrl: string): Promise<number>;
-/**
- * Query Prometheus metrics
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param params - Prometheus query parameters
- * @returns Query result as a number
- * @throws {NordError} If the request fails
- */
-export declare function queryPrometheus(webServerUrl: string, params: string): Promise<number>;

package/dist/nord/metrics.js

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MetricPeriod = void 0;
-exports.aggregateMetrics = aggregateMetrics;
-exports.getCurrentTps = getCurrentTps;
-exports.getPeakTps = getPeakTps;
-exports.getMedianLatency = getMedianLatency;
-exports.getTotalTransactions = getTotalTransactions;
-exports.queryPrometheus = queryPrometheus;
-const types_1 = require("../types");
-const utils_1 = require("../utils");
-const NordError_1 = require("./NordError");
-/**
- * Time periods for metrics queries
- */
-var MetricPeriod;
-(function (MetricPeriod) {
-    MetricPeriod["ONE_MINUTE"] = "1m";
-    MetricPeriod["FIVE_MINUTES"] = "5m";
-    MetricPeriod["FIFTEEN_MINUTES"] = "15m";
-    MetricPeriod["ONE_HOUR"] = "1h";
-    MetricPeriod["FOUR_HOURS"] = "4h";
-    MetricPeriod["ONE_DAY"] = "24h";
-    MetricPeriod["ONE_WEEK"] = "7d";
-})(MetricPeriod || (exports.MetricPeriod = MetricPeriod = {}));
-/**
- * Fetch aggregate metrics from the Nord API
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param txPeakTpsPeriod - Period for peak TPS calculation
- * @param txPeakTpsPeriodUnit - Unit for peak TPS period
- * @returns Aggregate metrics
- * @throws {NordError} If the request fails
- */
-async function aggregateMetrics(webServerUrl, txPeakTpsPeriod = 1, txPeakTpsPeriodUnit = types_1.PeakTpsPeriodUnit.Day) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/metrics?tx_peak_tps_period=${txPeakTpsPeriod}&tx_peak_tps_period_unit=${txPeakTpsPeriodUnit}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to fetch aggregate metrics", { cause: error });
-    }
-}
-/**
- * Get current transactions per second
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param period - Time period for the query
- * @returns Current TPS value
- * @throws {NordError} If the request fails
- */
-async function getCurrentTps(webServerUrl, period = "1m") {
-    try {
-        return await queryPrometheus(webServerUrl, `sum(rate(nord_tx_count[${period}]))`);
-    }
-    catch (error) {
-        throw new NordError_1.NordError(`Failed to get current TPS for period ${period}`, { cause: error });
-    }
-}
-/**
- * Get peak transactions per second
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param period - Time period for the query
- * @returns Peak TPS value
- * @throws {NordError} If the request fails
- */
-async function getPeakTps(webServerUrl, period = "24h") {
-    try {
-        return await queryPrometheus(webServerUrl, `max_over_time(sum(rate(nord_tx_count[1m]))[${period}:])`);
-    }
-    catch (error) {
-        throw new NordError_1.NordError(`Failed to get peak TPS for period ${period}`, { cause: error });
-    }
-}
-/**
- * Get median transaction latency
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param period - Time period for the query
- * @returns Median latency in milliseconds
- * @throws {NordError} If the request fails
- */
-async function getMedianLatency(webServerUrl, period = "1m") {
-    try {
-        return await queryPrometheus(webServerUrl, `quantile_over_time(0.5, nord_tx_latency_ms[${period}])`);
-    }
-    catch (error) {
-        throw new NordError_1.NordError(`Failed to get median latency for period ${period}`, { cause: error });
-    }
-}
-/**
- * Get total transaction count
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @returns Total transaction count
- * @throws {NordError} If the request fails
- */
-async function getTotalTransactions(webServerUrl) {
-    try {
-        return await queryPrometheus(webServerUrl, "sum(nord_tx_count)");
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to get total transactions", { cause: error });
-    }
-}
-/**
- * Query Prometheus metrics
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param params - Prometheus query parameters
- * @returns Query result as a number
- * @throws {NordError} If the request fails
- */
-async function queryPrometheus(webServerUrl, params) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/prometheus?query=${encodeURIComponent(params)}`);
-        const data = await response.json();
-        return data.data.result[0]?.value[1] || 0;
-    }
-    catch (error) {
-        throw new NordError_1.NordError(`Failed to query Prometheus: ${params}`, { cause: error });
-    }
-}

package/dist/nord/queries.d.ts

@@ -1,81 +0,0 @@
-import { ActionQuery, ActionResponse, ActionsResponse, BlockQuery, BlockResponse, BlockSummaryResponse, RollmanActionResponse, RollmanActionsResponse, RollmanBlockResponse } from "../types";
-/**
- * Query a specific block
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Block query parameters
- * @returns Block response
- * @throws {NordError} If the request fails
- */
-export declare function queryBlock(webServerUrl: string, query: BlockQuery): Promise<BlockResponse>;
-/**
- * Query the last N blocks
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @returns Block response for the last N blocks
- * @throws {NordError} If the request fails
- */
-export declare function queryLastNBlocks(webServerUrl: string): Promise<BlockResponse>;
-/**
- * Query recent blocks
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param last_n - Number of recent blocks to query
- * @returns Block summary response
- * @throws {NordError} If the request fails
- */
-export declare function queryRecentBlocks(webServerUrl: string, last_n: number): Promise<BlockSummaryResponse>;
-/**
- * Query a specific action
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Action query parameters
- * @returns Action response
- * @throws {NordError} If the request fails
- */
-export declare function queryAction(webServerUrl: string, query: ActionQuery): Promise<ActionResponse>;
-/**
- * Query recent actions
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param last_n - Number of recent actions to query
- * @returns Actions response
- * @throws {NordError} If the request fails
- */
-export declare function queryRecentActions(webServerUrl: string, last_n: number): Promise<ActionsResponse>;
-/**
- * Query a block from Rollman
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Block query parameters
- * @returns Rollman block response
- * @throws {NordError} If the request fails
- */
-export declare function blockQueryRollman(webServerUrl: string, query: BlockQuery): Promise<RollmanBlockResponse>;
-/**
- * Query block summaries from Rollman
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param last_n - Number of recent blocks to query
- * @returns Block summary response
- * @throws {NordError} If the request fails
- */
-export declare function blockSummaryQueryRollman(webServerUrl: string, last_n: number): Promise<BlockSummaryResponse>;
-/**
- * Query an action from Rollman
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Action query parameters
- * @returns Rollman action response
- * @throws {NordError} If the request fails
- */
-export declare function actionQueryRollman(webServerUrl: string, query: ActionQuery): Promise<RollmanActionResponse>;
-/**
- * Query actions from Rollman
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param last_n - Number of recent actions to query
- * @returns Rollman actions response
- * @throws {NordError} If the request fails
- */
-export declare function actionsQueryRollman(webServerUrl: string, last_n: number): Promise<RollmanActionsResponse>;

package/dist/nord/queries.js

@@ -1,181 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryBlock = queryBlock;
-exports.queryLastNBlocks = queryLastNBlocks;
-exports.queryRecentBlocks = queryRecentBlocks;
-exports.queryAction = queryAction;
-exports.queryRecentActions = queryRecentActions;
-exports.blockQueryRollman = blockQueryRollman;
-exports.blockSummaryQueryRollman = blockSummaryQueryRollman;
-exports.actionQueryRollman = actionQueryRollman;
-exports.actionsQueryRollman = actionsQueryRollman;
-const utils_1 = require("../utils");
-const NordError_1 = require("./NordError");
-/**
- * Query a specific block
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Block query parameters
- * @returns Block response
- * @throws {NordError} If the request fails
- */
-async function queryBlock(webServerUrl, query) {
-    try {
-        const params = new URLSearchParams();
-        if (query.block_number !== undefined) {
-            params.append("block_height", query.block_number.toString());
-        }
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/block?${params.toString()}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to query block", { cause: error });
-    }
-}
-/**
- * Query the last N blocks
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @returns Block response for the last N blocks
- * @throws {NordError} If the request fails
- */
-async function queryLastNBlocks(webServerUrl) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/blocks`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to query last N blocks", { cause: error });
-    }
-}
-/**
- * Query recent blocks
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param last_n - Number of recent blocks to query
- * @returns Block summary response
- * @throws {NordError} If the request fails
- */
-async function queryRecentBlocks(webServerUrl, last_n) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/blocks_summary?last_n=${last_n}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError(`Failed to query recent blocks (last ${last_n})`, { cause: error });
-    }
-}
-/**
- * Query a specific action
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Action query parameters
- * @returns Action response
- * @throws {NordError} If the request fails
- */
-async function queryAction(webServerUrl, query) {
-    try {
-        const params = new URLSearchParams();
-        if (query.action_id !== undefined) {
-            params.append("action_id", query.action_id.toString());
-        }
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/action?${params.toString()}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to query action", { cause: error });
-    }
-}
-/**
- * Query recent actions
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param last_n - Number of recent actions to query
- * @returns Actions response
- * @throws {NordError} If the request fails
- */
-async function queryRecentActions(webServerUrl, last_n) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/actions?last_n=${last_n}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError(`Failed to query recent actions (last ${last_n})`, { cause: error });
-    }
-}
-/**
- * Query a block from Rollman
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Block query parameters
- * @returns Rollman block response
- * @throws {NordError} If the request fails
- */
-async function blockQueryRollman(webServerUrl, query) {
-    try {
-        const params = new URLSearchParams();
-        if (query.block_number !== undefined) {
-            params.append("block_height", query.block_number.toString());
-        }
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/rollman/block?${params.toString()}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to query Rollman block", { cause: error });
-    }
-}
-/**
- * Query block summaries from Rollman
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param last_n - Number of recent blocks to query
- * @returns Block summary response
- * @throws {NordError} If the request fails
- */
-async function blockSummaryQueryRollman(webServerUrl, last_n) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/rollman/blocks_summary?last_n=${last_n}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError(`Failed to query Rollman block summaries (last ${last_n})`, { cause: error });
-    }
-}
-/**
- * Query an action from Rollman
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param query - Action query parameters
- * @returns Rollman action response
- * @throws {NordError} If the request fails
- */
-async function actionQueryRollman(webServerUrl, query) {
-    try {
-        const params = new URLSearchParams();
-        if (query.action_id !== undefined) {
-            params.append("action_id", query.action_id.toString());
-        }
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/rollman/action?${params.toString()}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError("Failed to query Rollman action", { cause: error });
-    }
-}
-/**
- * Query actions from Rollman
- *
- * @param webServerUrl - Base URL for the Nord web server
- * @param last_n - Number of recent actions to query
- * @returns Rollman actions response
- * @throws {NordError} If the request fails
- */
-async function actionsQueryRollman(webServerUrl, last_n) {
-    try {
-        const response = await (0, utils_1.checkedFetch)(`${webServerUrl}/rollman/actions?last_n=${last_n}`);
-        return await response.json();
-    }
-    catch (error) {
-        throw new NordError_1.NordError(`Failed to query Rollman actions (last ${last_n})`, { cause: error });
-    }
-}