@n1xyz/nord-ts 0.0.4 → 0.0.5

package/dist/nord/types.d.ts

@@ -1,88 +0,0 @@
-import { EventEmitter } from "events";
-import Decimal from "decimal.js";
-import { Connection, Keypair, PublicKey } from '@solana/web3.js';
-import { FillMode, Side } from "../types";
-import { Nord } from "./Nord";
-import { OrderbookResponse, Trade } from "../types";
-/**
- * Parameters for creating a NordUser instance
- */
-export interface NordUserParams {
-    /** Nord client instance */
-    nord: Nord;
-    /** User's blockchain address */
-    address: string;
-    /** Function to sign messages with the user's wallet */
-    walletSignFn: (message: Uint8Array | string) => Promise<string>;
-    /** Function to sign messages with the user's session key */
-    sessionSignFn: (message: Uint8Array) => Promise<Uint8Array>;
-    /** Solana public key (optional) */
-    solanaPublicKey?: PublicKey | string;
-    /** Solana keypair (optional) */
-    keypair?: Keypair;
-    /** Solana connection (optional) */
-    connection?: Connection;
-}
-/**
- * Parameters for placing an order
- */
-export interface PlaceOrderParams {
-    /** Market ID */
-    marketId: number;
-    /** Order side (bid or ask) */
-    side: Side;
-    /** Fill mode (limit, market, etc.) */
-    fillMode: FillMode;
-    /** Whether the order is reduce-only */
-    isReduceOnly: boolean;
-    /** Order size */
-    size?: Decimal.Value;
-    /** Order price */
-    price?: Decimal.Value;
-    /** Quote size (for market orders) */
-    quoteSize?: Decimal.Value;
-    /** Account ID to place the order from */
-    accountId?: number;
-}
-/**
- * Parameters for transferring tokens between accounts
- */
-export interface TransferParams {
-    /** Recipient user */
-    to: any;
-    /** Token ID to transfer */
-    tokenId: number;
-    /** Amount to transfer */
-    amount: Decimal.Value;
-    /** Source account ID */
-    fromAccountId: number;
-    /** Destination account ID */
-    toAccountId: number;
-}
-/**
- * Parameters for creating a new account
- */
-export interface CreateAccountParams {
-    /** Token ID for initial funding */
-    tokenId: number;
-    /** Initial funding amount */
-    amount: Decimal.Value;
-}
-/**
- * Interface for orderbook subscription events
- */
-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 events
- */
-export interface TradeSubscription extends EventEmitter {
-    on(event: 'message', listener: (data: Trade[]) => void): this;
-    on(event: 'error', listener: (error: Error) => void): this;
-    close(): void;
-    removeAllListeners(event?: string): this;
-}

package/dist/nord/types.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/nord/websocket.d.ts

@@ -1,49 +0,0 @@
-import { DeltaEvent, Trades, Account } from "../types";
-import { OrderbookSubscription, TradeSubscription } from "./types";
-/**
- * Configuration for the Subscriber class
- */
-export interface SubscriberConfig {
-    /** WebSocket stream URL */
-    streamURL: string;
-    /** Maximum buffer length */
-    maxBufferLen?: number;
-}
-/**
- * Subscriber class for handling WebSocket subscriptions
- */
-export declare class Subscriber {
-    /** WebSocket stream URL */
-    streamURL: string;
-    /** Buffer for events */
-    buffer: (DeltaEvent | Trades | Account)[];
-    /** Maximum buffer length */
-    maxBufferLen: number;
-    /**
-     * Create a new Subscriber instance
-     * @param config Subscriber configuration
-     */
-    constructor(config: SubscriberConfig);
-    /**
-     * Subscribe to WebSocket events
-     */
-    subscribe(): void;
-}
-/**
- * Create an orderbook subscription
- *
- * @param ws - WebSocket client
- * @param symbol - Market symbol to subscribe to
- * @returns EventEmitter that emits orderbook updates
- */
-export declare function createOrderbookSubscription(ws: any, // Using 'any' to avoid circular dependency, will be NordWebSocketClient
-symbol: string): OrderbookSubscription;
-/**
- * Create a trade subscription
- *
- * @param ws - WebSocket client
- * @param symbol - Market symbol to subscribe to
- * @returns EventEmitter that emits trade updates
- */
-export declare function createTradeSubscription(ws: any, // Using 'any' to avoid circular dependency, will be NordWebSocketClient
-symbol: string): TradeSubscription;

package/dist/nord/websocket.js

@@ -1,107 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Subscriber = void 0;
-exports.createOrderbookSubscription = createOrderbookSubscription;
-exports.createTradeSubscription = createTradeSubscription;
-const events_1 = require("events");
-const ws_1 = __importDefault(require("ws"));
-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() {
-        const ws = new ws_1.default(this.streamURL);
-        ws.on("open", () => { });
-        ws.on("message", (rawData) => {
-            const message = rawData.toLocaleString();
-            const event = JSON.parse(message);
-            this.buffer.push(event);
-            if (this.buffer.length > this.maxBufferLen) {
-                this.buffer.shift();
-            }
-        });
-        ws.on("close", () => { });
-    }
-}
-exports.Subscriber = Subscriber;
-/**
- * Create an orderbook subscription
- *
- * @param ws - WebSocket client
- * @param symbol - Market symbol to subscribe to
- * @returns EventEmitter that emits orderbook updates
- */
-function createOrderbookSubscription(ws, // Using 'any' to avoid circular dependency, will be NordWebSocketClient
-symbol) {
-    if (!symbol) {
-        throw new Error("Market symbol is required for orderbook subscription");
-    }
-    const emitter = new events_1.EventEmitter();
-    // Add close method
-    emitter.close = () => {
-        ws.unsubscribe([`deltas@${symbol}`]);
-        emitter.removeAllListeners();
-    };
-    // Subscribe to the orderbook stream
-    ws.on('delta', (update) => {
-        if (update.market_symbol === symbol) {
-            const orderbookUpdate = {
-                symbol: update.market_symbol,
-                asks: update.asks,
-                bids: update.bids,
-                timestamp: update.timestamp
-            };
-            emitter.emit('message', orderbookUpdate);
-        }
-    });
-    ws.on('error', (error) => {
-        emitter.emit('error', error);
-    });
-    // Start the subscription
-    ws.subscribe([`deltas@${symbol}`]);
-    return emitter;
-}
-/**
- * Create a trade subscription
- *
- * @param ws - WebSocket client
- * @param symbol - Market symbol to subscribe to
- * @returns EventEmitter that emits trade updates
- */
-function createTradeSubscription(ws, // Using 'any' to avoid circular dependency, will be NordWebSocketClient
-symbol) {
-    const emitter = new events_1.EventEmitter();
-    // Add close method
-    emitter.close = () => {
-        ws.unsubscribe([`trades@${symbol}`]);
-        emitter.removeAllListeners();
-    };
-    // Subscribe to the trades stream
-    ws.on('trade', (update) => {
-        if (update.symbol === symbol) {
-            emitter.emit('message', update.trades);
-        }
-    });
-    ws.on('error', (error) => {
-        emitter.emit('error', error);
-    });
-    // Start the subscription
-    ws.subscribe([`trades@${symbol}`]);
-    return emitter;
-}

package/dist/operations/account.d.ts

@@ -1,58 +0,0 @@
-/**
- * Account-related operations
- * @module operations/account
- */
-import { NordClientConfig } from '../types/config';
-import { Account, Balance } from '../models';
-/**
- * Account operations implementation
- */
-export declare class AccountOperations {
-    /**
-     * Client configuration
-     */
-    private readonly config;
-    /**
-     * Create a new AccountOperations instance
-     *
-     * @param config - Client configuration
-     */
-    constructor(config: NordClientConfig);
-    /**
-     * Get account information
-     *
-     * @param accountId - Account ID
-     * @returns Promise resolving to account information
-     * @throws {NordValidationError} If the accountId parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    getAccount(accountId: number): Promise<Account>;
-    /**
-     * Get all accounts for a specific address
-     *
-     * @param address - User's blockchain address
-     * @returns Promise resolving to an array of account IDs
-     * @throws {NordValidationError} If the address parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    getAccounts(address: string): Promise<number[]>;
-    /**
-     * Get balance for a specific token in an account
-     *
-     * @param accountId - Account ID
-     * @param token - Token symbol (e.g., "BTC")
-     * @returns Promise resolving to balance information
-     * @throws {NordValidationError} If any parameters are invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    getBalance(accountId: number, token: string): Promise<Balance>;
-    /**
-     * Get all balances for an account
-     *
-     * @param accountId - Account ID
-     * @returns Promise resolving to an array of balances
-     * @throws {NordValidationError} If the accountId parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    getBalances(accountId: number): Promise<Balance[]>;
-}

package/dist/operations/account.js

@@ -1,112 +0,0 @@
-"use strict";
-/**
- * Account-related operations
- * @module operations/account
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AccountOperations = void 0;
-const errors_1 = require("../utils/errors");
-const http_1 = require("../utils/http");
-const endpoints_1 = require("../constants/endpoints");
-/**
- * Account operations implementation
- */
-class AccountOperations {
-    /**
-     * Create a new AccountOperations instance
-     *
-     * @param config - Client configuration
-     */
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * Get account information
-     *
-     * @param accountId - Account ID
-     * @returns Promise resolving to account information
-     * @throws {NordValidationError} If the accountId parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    async getAccount(accountId) {
-        if (accountId === undefined || accountId === null) {
-            throw new errors_1.NordValidationError('Account ID is required', 'accountId');
-        }
-        try {
-            const endpoint = `${endpoints_1.ENDPOINTS.ACCOUNT}/${accountId}`;
-            const response = await (0, http_1.httpGet)(this.config.webServerUrl, endpoint);
-            return response;
-        }
-        catch (error) {
-            throw new errors_1.NordApiError(`Failed to fetch account ${accountId}`, error instanceof errors_1.NordApiError ? error.statusCode : 500, endpoints_1.ENDPOINTS.ACCOUNT, error instanceof Error ? error : undefined);
-        }
-    }
-    /**
-     * Get all accounts for a specific address
-     *
-     * @param address - User's blockchain address
-     * @returns Promise resolving to an array of account IDs
-     * @throws {NordValidationError} If the address parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    async getAccounts(address) {
-        if (!address) {
-            throw new errors_1.NordValidationError('Address is required', 'address');
-        }
-        try {
-            const endpoint = `${endpoints_1.ENDPOINTS.ACCOUNTS}?address=${encodeURIComponent(address)}`;
-            const response = await (0, http_1.httpGet)(this.config.webServerUrl, endpoint);
-            return response.accountIds;
-        }
-        catch (error) {
-            throw new errors_1.NordApiError(`Failed to fetch accounts for address ${address}`, error instanceof errors_1.NordApiError ? error.statusCode : 500, endpoints_1.ENDPOINTS.ACCOUNTS, error instanceof Error ? error : undefined);
-        }
-    }
-    /**
-     * Get balance for a specific token in an account
-     *
-     * @param accountId - Account ID
-     * @param token - Token symbol (e.g., "BTC")
-     * @returns Promise resolving to balance information
-     * @throws {NordValidationError} If any parameters are invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    async getBalance(accountId, token) {
-        if (accountId === undefined || accountId === null) {
-            throw new errors_1.NordValidationError('Account ID is required', 'accountId');
-        }
-        if (!token) {
-            throw new errors_1.NordValidationError('Token symbol is required', 'token');
-        }
-        try {
-            const endpoint = `${endpoints_1.ENDPOINTS.BALANCE}?accountId=${accountId}&token=${encodeURIComponent(token)}`;
-            const response = await (0, http_1.httpGet)(this.config.webServerUrl, endpoint);
-            return response;
-        }
-        catch (error) {
-            throw new errors_1.NordApiError(`Failed to fetch balance for account ${accountId} and token ${token}`, error instanceof errors_1.NordApiError ? error.statusCode : 500, endpoints_1.ENDPOINTS.BALANCE, error instanceof Error ? error : undefined);
-        }
-    }
-    /**
-     * Get all balances for an account
-     *
-     * @param accountId - Account ID
-     * @returns Promise resolving to an array of balances
-     * @throws {NordValidationError} If the accountId parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    async getBalances(accountId) {
-        if (accountId === undefined || accountId === null) {
-            throw new errors_1.NordValidationError('Account ID is required', 'accountId');
-        }
-        try {
-            const endpoint = `${endpoints_1.ENDPOINTS.BALANCES}?accountId=${accountId}`;
-            const response = await (0, http_1.httpGet)(this.config.webServerUrl, endpoint);
-            return response;
-        }
-        catch (error) {
-            throw new errors_1.NordApiError(`Failed to fetch balances for account ${accountId}`, error instanceof errors_1.NordApiError ? error.statusCode : 500, endpoints_1.ENDPOINTS.BALANCES, error instanceof Error ? error : undefined);
-        }
-    }
-}
-exports.AccountOperations = AccountOperations;

package/dist/operations/market.d.ts

@@ -1,65 +0,0 @@
-/**
- * Market-related operations
- * @module operations/market
- */
-import { NordClientConfig } from '../types/config';
-import { Market, OrderbookData, Trade, Candle } from '../models';
-/**
- * Market operations implementation
- */
-export declare class MarketOperations {
-    /**
-     * Client configuration
-     */
-    private readonly config;
-    /**
-     * Create a new MarketOperations instance
-     *
-     * @param config - Client configuration
-     */
-    constructor(config: NordClientConfig);
-    /**
-     * Get all available markets
-     *
-     * @returns Promise resolving to an array of markets
-     * @throws {NordApiError} If the API request fails
-     */
-    getMarkets(): Promise<Market[]>;
-    /**
-     * Get orderbook data for a specific market
-     *
-     * @param market - Market symbol (e.g., "BTCUSDC")
-     * @returns Promise resolving to orderbook data
-     * @throws {NordValidationError} If the market parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    getOrderbook(market: string): Promise<OrderbookData>;
-    /**
-     * Get recent trades for a specific market
-     *
-     * @param market - Market symbol (e.g., "BTCUSDC")
-     * @param limit - Maximum number of trades to return (optional)
-     * @returns Promise resolving to an array of trades
-     * @throws {NordValidationError} If the market parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    getTrades(market: string, limit?: number): Promise<Trade[]>;
-    /**
-     * Get candle data for a specific market and timeframe
-     *
-     * @param market - Market symbol (e.g., "BTCUSDC")
-     * @param timeframe - Candle timeframe (e.g., "1m", "5m", "1h", "1d")
-     * @param limit - Maximum number of candles to return (optional)
-     * @returns Promise resolving to an array of candles
-     * @throws {NordValidationError} If any parameters are invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    getCandles(market: string, timeframe: string, limit?: number): Promise<Candle[]>;
-    /**
-     * Get current server timestamp
-     *
-     * @returns Promise resolving to the current server timestamp in milliseconds
-     * @throws {NordApiError} If the API request fails
-     */
-    getTimestamp(): Promise<number>;
-}

package/dist/operations/market.js

@@ -1,131 +0,0 @@
-"use strict";
-/**
- * Market-related operations
- * @module operations/market
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MarketOperations = void 0;
-const errors_1 = require("../utils/errors");
-const http_1 = require("../utils/http");
-const endpoints_1 = require("../constants/endpoints");
-/**
- * Market operations implementation
- */
-class MarketOperations {
-    /**
-     * Create a new MarketOperations instance
-     *
-     * @param config - Client configuration
-     */
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * Get all available markets
-     *
-     * @returns Promise resolving to an array of markets
-     * @throws {NordApiError} If the API request fails
-     */
-    async getMarkets() {
-        try {
-            const endpoint = `${endpoints_1.ENDPOINTS.MARKETS}`;
-            const response = await (0, http_1.httpGet)(this.config.webServerUrl, endpoint);
-            return response;
-        }
-        catch (error) {
-            throw new errors_1.NordApiError('Failed to fetch markets', error instanceof errors_1.NordApiError ? error.statusCode : 500, endpoints_1.ENDPOINTS.MARKETS, error instanceof Error ? error : undefined);
-        }
-    }
-    /**
-     * Get orderbook data for a specific market
-     *
-     * @param market - Market symbol (e.g., "BTCUSDC")
-     * @returns Promise resolving to orderbook data
-     * @throws {NordValidationError} If the market parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    async getOrderbook(market) {
-        if (!market) {
-            throw new errors_1.NordValidationError('Market symbol is required', 'market');
-        }
-        try {
-            const endpoint = `${endpoints_1.ENDPOINTS.ORDERBOOK}?market=${encodeURIComponent(market)}`;
-            const response = await (0, http_1.httpGet)(this.config.webServerUrl, endpoint);
-            return response;
-        }
-        catch (error) {
-            throw new errors_1.NordApiError(`Failed to fetch orderbook for market ${market}`, error instanceof errors_1.NordApiError ? error.statusCode : 500, endpoints_1.ENDPOINTS.ORDERBOOK, error instanceof Error ? error : undefined);
-        }
-    }
-    /**
-     * Get recent trades for a specific market
-     *
-     * @param market - Market symbol (e.g., "BTCUSDC")
-     * @param limit - Maximum number of trades to return (optional)
-     * @returns Promise resolving to an array of trades
-     * @throws {NordValidationError} If the market parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    async getTrades(market, limit) {
-        if (!market) {
-            throw new errors_1.NordValidationError('Market symbol is required', 'market');
-        }
-        try {
-            let endpoint = `${endpoints_1.ENDPOINTS.TRADES}?market=${encodeURIComponent(market)}`;
-            if (limit) {
-                endpoint += `&limit=${limit}`;
-            }
-            const response = await (0, http_1.httpGet)(this.config.webServerUrl, endpoint);
-            return response;
-        }
-        catch (error) {
-            throw new errors_1.NordApiError(`Failed to fetch trades for market ${market}`, error instanceof errors_1.NordApiError ? error.statusCode : 500, endpoints_1.ENDPOINTS.TRADES, error instanceof Error ? error : undefined);
-        }
-    }
-    /**
-     * Get candle data for a specific market and timeframe
-     *
-     * @param market - Market symbol (e.g., "BTCUSDC")
-     * @param timeframe - Candle timeframe (e.g., "1m", "5m", "1h", "1d")
-     * @param limit - Maximum number of candles to return (optional)
-     * @returns Promise resolving to an array of candles
-     * @throws {NordValidationError} If any parameters are invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    async getCandles(market, timeframe, limit) {
-        if (!market) {
-            throw new errors_1.NordValidationError('Market symbol is required', 'market');
-        }
-        if (!timeframe) {
-            throw new errors_1.NordValidationError('Timeframe is required', 'timeframe');
-        }
-        try {
-            let endpoint = `${endpoints_1.ENDPOINTS.CANDLES}?market=${encodeURIComponent(market)}&timeframe=${encodeURIComponent(timeframe)}`;
-            if (limit) {
-                endpoint += `&limit=${limit}`;
-            }
-            const response = await (0, http_1.httpGet)(this.config.webServerUrl, endpoint);
-            return response;
-        }
-        catch (error) {
-            throw new errors_1.NordApiError(`Failed to fetch candles for market ${market} with timeframe ${timeframe}`, error instanceof errors_1.NordApiError ? error.statusCode : 500, endpoints_1.ENDPOINTS.CANDLES, error instanceof Error ? error : undefined);
-        }
-    }
-    /**
-     * Get current server timestamp
-     *
-     * @returns Promise resolving to the current server timestamp in milliseconds
-     * @throws {NordApiError} If the API request fails
-     */
-    async getTimestamp() {
-        try {
-            const endpoint = endpoints_1.ENDPOINTS.TIMESTAMP;
-            const response = await (0, http_1.httpGet)(this.config.webServerUrl, endpoint);
-            return response.timestamp;
-        }
-        catch (error) {
-            throw new errors_1.NordApiError('Failed to fetch server timestamp', error instanceof errors_1.NordApiError ? error.statusCode : 500, endpoints_1.ENDPOINTS.TIMESTAMP, error instanceof Error ? error : undefined);
-        }
-    }
-}
-exports.MarketOperations = MarketOperations;

package/dist/operations/orders.d.ts

@@ -1,57 +0,0 @@
-/**
- * Order-related operations
- * @module operations/orders
- */
-import { NordClientConfig } from '../types/config';
-import { Order, OrderResult, PlaceOrderParams } from '../models';
-/**
- * Order operations implementation
- */
-export declare class OrderOperations {
-    /**
-     * Client configuration
-     */
-    private readonly config;
-    /**
-     * Create a new OrderOperations instance
-     *
-     * @param config - Client configuration
-     */
-    constructor(config: NordClientConfig);
-    /**
-     * Place a new order
-     *
-     * @param params - Order parameters
-     * @returns Promise resolving to order result
-     * @throws {NordValidationError} If any parameters are invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    placeOrder(params: PlaceOrderParams): Promise<OrderResult>;
-    /**
-     * Cancel an existing order
-     *
-     * @param orderId - Order ID to cancel
-     * @returns Promise resolving to true if successful
-     * @throws {NordValidationError} If the orderId parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    cancelOrder(orderId: number): Promise<boolean>;
-    /**
-     * Get information about a specific order
-     *
-     * @param orderId - Order ID
-     * @returns Promise resolving to order information
-     * @throws {NordValidationError} If the orderId parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    getOrder(orderId: number): Promise<Order>;
-    /**
-     * Get all orders for an account
-     *
-     * @param accountId - Account ID
-     * @returns Promise resolving to an array of orders
-     * @throws {NordValidationError} If the accountId parameter is invalid
-     * @throws {NordApiError} If the API request fails
-     */
-    getOrders(accountId: number): Promise<Order[]>;
-}