@n1xyz/nord-ts 0.1.6 → 0.1.8

package/dist/{nord/client → client}/NordUser.d.ts

@@ -1,84 +1,9 @@
-import { Connection, PublicKey, Transaction, SendOptions } from "@solana/web3.js";
+import { PublicKey, Transaction, SendOptions } from "@solana/web3.js";
 import Decimal from "decimal.js";
-import { FillMode, Side, SPLTokenInfo, QuoteSize, TriggerKind } from "../../types";
-import * as proto from "../../gen/nord_pb";
-import { BigIntValue } from "../../utils";
+import { FillMode, Side, SPLTokenInfo, QuoteSize, TriggerKind } from "../types";
+import * as proto from "../gen/nord_pb";
+import { BigIntValue } from "../utils";
 import { Nord } from "./Nord";
-import { NordClient } from "./NordClient";
-/**
- * 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<Uint8Array>;
-    /** Function to sign messages with the user's session key */
-    sessionSignFn: (message: Uint8Array) => Promise<Uint8Array>;
-    /** Function to sign transactions with the user's wallet (optional) */
-    transactionSignFn: <T extends Transaction>(tx: T) => Promise<T>;
-    /** Solana connection (optional) */
-    connection?: Connection;
-    /** Session ID (optional) */
-    sessionId?: bigint;
-    /** Session public key (required) */
-    sessionPubKey: Uint8Array;
-    /** Session public key (required) */
-    publicKey: PublicKey;
-}
-/**
- * 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 object (requires non-zero price and size) */
-    quoteSize?: QuoteSize;
-    /** Account ID to place the order from */
-    accountId?: number;
-    clientOrderId?: BigIntValue;
-}
-export interface AddTriggerParams {
-    marketId: number;
-    side: Side;
-    kind: TriggerKind;
-    triggerPrice: Decimal.Value;
-    limitPrice?: Decimal.Value;
-    accountId?: number;
-}
-export interface RemoveTriggerParams {
-    marketId: number;
-    side: Side;
-    kind: TriggerKind;
-    accountId?: number;
-}
-/**
- * Parameters for transferring tokens between accounts
- */
-export interface TransferParams {
-    /** Recipient user */
-    to: NordUser;
-    /** Token ID to transfer */
-    tokenId: number;
-    /** Amount to transfer */
-    amount: Decimal.Value;
-    /** Source account ID */
-    fromAccountId: number;
-    /** Destination account ID */
-    toAccountId: number;
-}
 /**
  * Parameters for individual atomic subactions (user-friendly version)
  */
@@ -107,7 +32,15 @@ export interface UserAtomicSubaction {
 /**
  * User class for interacting with the Nord protocol
  */
-export declare class NordUser extends NordClient {
+export declare class NordUser {
+    readonly nord: Nord;
+    readonly sessionSignFn: (message: Uint8Array) => Promise<Uint8Array>;
+    readonly transactionSignFn: (tx: Transaction) => Promise<Transaction>;
+    sessionId?: bigint;
+    sessionPubKey: PublicKey;
+    publicKey: PublicKey;
+    lastTs: number;
+    private nonce;
     /** User balances by token symbol */
     balances: {
         [key: string]: {
@@ -152,26 +85,31 @@ export declare class NordUser extends NordClient {
     /**
      * Create a new NordUser instance
      *
-     * @param params - Parameters for creating a NordUser
+     * @param nord - Nord client instance
+     * @param sessionSignFn - Function to sign messages with the user's session key
+     * @param transactionSignFn - Function to sign transactions with the user's wallet (optional)
+     * @param sessionId - Existing session identifier
+     * @param sessionPubKey - Session public key
+     * @param publicKey - Wallet public key
      * @throws {NordError} If required parameters are missing
      */
-    constructor({ address, nord, publicKey, sessionPubKey, sessionSignFn, transactionSignFn, walletSignFn, connection, sessionId, }: NordUserParams);
-    /**
-     * Create a clone of this NordUser instance
-     *
-     * @returns A new NordUser instance with the same properties
-     */
-    clone(): NordUser;
+    constructor({ nord, sessionSignFn, transactionSignFn, sessionId, sessionPubKey, publicKey, }: Readonly<{
+        nord: Nord;
+        sessionSignFn: (message: Uint8Array) => Promise<Uint8Array>;
+        transactionSignFn: (tx: Transaction) => Promise<Transaction>;
+        sessionId?: bigint;
+        sessionPubKey: Uint8Array;
+        publicKey: PublicKey;
+    }>);
     /**
      * Create a NordUser from a private key
      *
      * @param nord - Nord instance
      * @param privateKey - Private key as string or Uint8Array
-     * @param connection - Solana connection (optional)
      * @returns NordUser instance
      * @throws {NordError} If the private key is invalid
      */
-    static fromPrivateKey(nord: Nord, privateKey: string | Uint8Array, connection?: Connection): NordUser;
+    static fromPrivateKey(nord: Nord, privateKey: string | Uint8Array): NordUser;
     /**
      * Get the associated token account for a token mint
      *
@@ -261,11 +199,29 @@ export declare class NordUser extends NordClient {
     /**
      * Place an order on the exchange
      *
-     * @param params - Order parameters
+     * @param marketId - Target market identifier
+     * @param side - Order side
+     * @param fillMode - Fill mode (limit, market, etc.)
+     * @param isReduceOnly - Reduce-only flag
+     * @param size - Base size to place
+     * @param price - Limit price
+     * @param quoteSize - Quote-sized order representation
+     * @param accountId - Account executing the order
+     * @param clientOrderId - Optional client-specified identifier
      * @returns Object containing actionId, orderId (if posted), fills, and clientOrderId
      * @throws {NordError} If the operation fails
      */
-    placeOrder(params: PlaceOrderParams): Promise<{
+    placeOrder({ marketId, side, fillMode, isReduceOnly, size, price, quoteSize, accountId, clientOrderId, }: Readonly<{
+        marketId: number;
+        side: Side;
+        fillMode: FillMode;
+        isReduceOnly: boolean;
+        size?: Decimal.Value;
+        price?: Decimal.Value;
+        quoteSize?: QuoteSize;
+        accountId?: number;
+        clientOrderId?: BigIntValue;
+    }>): Promise<{
         actionId: bigint;
         orderId?: bigint;
         fills: proto.Receipt_Trade[];
@@ -286,30 +242,61 @@ export declare class NordUser extends NordClient {
     /**
      * Add a trigger for the current session
      *
-     * @param params - Trigger parameters including market, side, and prices
+     * @param marketId - Market to watch
+     * @param side - Order side for the trigger
+     * @param kind - Stop-loss or take-profit trigger type
+     * @param triggerPrice - Price that activates the trigger
+     * @param limitPrice - Limit price placed once the trigger fires
+     * @param accountId - Account executing the trigger
      * @returns Object containing the actionId of the submitted trigger
      * @throws {NordError} If the operation fails
      */
-    addTrigger(params: AddTriggerParams): Promise<{
+    addTrigger({ marketId, side, kind, triggerPrice, limitPrice, accountId, }: Readonly<{
+        marketId: number;
+        side: Side;
+        kind: TriggerKind;
+        triggerPrice: Decimal.Value;
+        limitPrice?: Decimal.Value;
+        accountId?: number;
+    }>): Promise<{
         actionId: bigint;
     }>;
     /**
      * Remove a trigger for the current session
      *
-     * @param params - Trigger parameters identifying the trigger to remove
+     * @param marketId - Market the trigger belongs to
+     * @param side - Order side for the trigger
+     * @param kind - Stop-loss or take-profit trigger type
+     * @param accountId - Account executing the trigger
      * @returns Object containing the actionId of the removal action
      * @throws {NordError} If the operation fails
      */
-    removeTrigger(params: RemoveTriggerParams): Promise<{
+    removeTrigger({ marketId, side, kind, accountId, }: Readonly<{
+        marketId: number;
+        side: Side;
+        kind: TriggerKind;
+        accountId?: number;
+    }>): Promise<{
         actionId: bigint;
     }>;
     /**
      * Transfer tokens to another account
      *
-     * @param params - Transfer parameters
+     * @param tokenId - Token identifier to move
+     * @param amount - Amount to transfer
+     * @param fromAccountId - Source account id
+     * @param toAccountId - Destination account id
      * @throws {NordError} If the operation fails
      */
-    transferToAccount(params: TransferParams): Promise<void>;
+    transferToAccount({ tokenId, amount, fromAccountId, toAccountId, }: Readonly<{
+        tokenId: number;
+        amount: Decimal.Value;
+        fromAccountId?: number;
+        toAccountId?: number;
+    }>): Promise<{
+        actionId: bigint;
+        newAccountId?: number;
+    }>;
     /**
      * Execute up to four place/cancel operations atomically.
      * Per Market:
@@ -359,4 +346,5 @@ export declare class NordUser extends NordClient {
             [symbol: string]: string;
         };
     }>;
+    protected submitSignedAction(kind: proto.Action["kind"], makeSignedMessage: (message: Uint8Array) => Promise<Uint8Array>): Promise<proto.Receipt>;
 }