@andy-liquid-labs/lighter-ts-sdk 1.0.3 → 1.0.5

package/dist/index.d.mts

@@ -272,9 +272,9 @@ interface KeyManager extends Signer {
     prvKeyBytes(): Uint8Array;
 }
 /**
- * Create a new KeyManager from private key bytes
+ * Create a new KeyManager from private key bytes and public key bytes
  */
-declare function newKeyManager(privateKeyBytes: Uint8Array): KeyManager;
+declare function newKeyManager(privateKeyBytes: Uint8Array, publicKeyBytes: Uint8Array): KeyManager;
 /**
  * Generate a new API key pair
  * Returns [privateKey, publicKey] as hex strings
@@ -1622,8 +1622,9 @@ declare class TxClient {
     private readonly chainId;
     private readonly keyManager;
     private readonly _accountIndex;
+    private readonly _pubkey;
     private readonly _apiKeyIndex;
-    constructor(apiClient: MinimalHTTPClient | null, privateKey: string, accountIndex: bigint, apiKeyIndex: number, chainId: number);
+    constructor(apiClient: MinimalHTTPClient | null, privateKey: string, publicKey: string, accountIndex: bigint, apiKeyIndex: number, chainId: number);
     /**
      * Fill in default transaction options
      */
@@ -1657,9 +1658,15 @@ declare class TxClient {
      */
     getNextNonce: () => Promise<bigint>;
     /**
-     * Create an auth token
+     * Create an auth token with caching
+     * Generates a new token if:
+     * 1. No cached token exists for this account
+     * 2. The cached token expires in less than 1 hour
+     *
+     * @param deadline - Optional deadline for the token (defaults to 24 hours from now)
+     * @returns Auth token string in format: "timestamp:accountIndex:apiKeyIndex:signature"
      */
-    getAuthToken(deadline: Date): string;
+    getAuthToken(deadline?: Date): string;
     /**
      * Sign a create order transaction
      */
@@ -1736,7 +1743,7 @@ declare function getClient(apiKeyIndex?: number, accountIndex?: bigint): TxClien
 /**
  * Create a new TxClient and store it
  */
-declare function createClient(httpClient: MinimalHTTPClient | null, privateKey: string, chainId: number, apiKeyIndex: number, accountIndex: bigint): TxClient;
+declare function createClient(httpClient: MinimalHTTPClient | null, privateKey: string, publicKey: string, chainId: number, apiKeyIndex: number, accountIndex: bigint): TxClient;
 /**
  * Check that a client exists and the API key matches the one on the server
  */
@@ -1887,6 +1894,7 @@ interface Candlestick {
     l: number;
     c: number;
     v: number;
+    V: number;
 }
 interface CandlesRequest {
     market_id: number;
@@ -2949,7 +2957,7 @@ interface InfoPrivateClientConfig {
  *
  * @example
  * ```typescript
- * const txClient = createClient(httpClient, privateKey, chainId, apiKeyIndex, accountIndex);
+ * const txClient = createClient(httpClient, privateKey, publicKey, chainId, apiKeyIndex, accountIndex);
  * const client = new InfoPrivateClient({
  *   baseURL: "https://mainnet.zklighter.elliot.ai",
  *   txClient
@@ -3346,7 +3354,7 @@ interface ExchangeClientConfig {
  *
  * @example
  * ```typescript
- * const txClient = createClient(httpClient, privateKey, chainId, apiKeyIndex, accountIndex);
+ * const txClient = createClient(httpClient, privateKey, publicKey, chainId, apiKeyIndex, accountIndex);
  * const client = new ExchangeClient({
  *   baseURL: "https://mainnet.zklighter.elliot.ai",
  *   txClient

package/dist/index.d.ts

@@ -272,9 +272,9 @@ interface KeyManager extends Signer {
     prvKeyBytes(): Uint8Array;
 }
 /**
- * Create a new KeyManager from private key bytes
+ * Create a new KeyManager from private key bytes and public key bytes
  */
-declare function newKeyManager(privateKeyBytes: Uint8Array): KeyManager;
+declare function newKeyManager(privateKeyBytes: Uint8Array, publicKeyBytes: Uint8Array): KeyManager;
 /**
  * Generate a new API key pair
  * Returns [privateKey, publicKey] as hex strings
@@ -1622,8 +1622,9 @@ declare class TxClient {
     private readonly chainId;
     private readonly keyManager;
     private readonly _accountIndex;
+    private readonly _pubkey;
     private readonly _apiKeyIndex;
-    constructor(apiClient: MinimalHTTPClient | null, privateKey: string, accountIndex: bigint, apiKeyIndex: number, chainId: number);
+    constructor(apiClient: MinimalHTTPClient | null, privateKey: string, publicKey: string, accountIndex: bigint, apiKeyIndex: number, chainId: number);
     /**
      * Fill in default transaction options
      */
@@ -1657,9 +1658,15 @@ declare class TxClient {
      */
     getNextNonce: () => Promise<bigint>;
     /**
-     * Create an auth token
+     * Create an auth token with caching
+     * Generates a new token if:
+     * 1. No cached token exists for this account
+     * 2. The cached token expires in less than 1 hour
+     *
+     * @param deadline - Optional deadline for the token (defaults to 24 hours from now)
+     * @returns Auth token string in format: "timestamp:accountIndex:apiKeyIndex:signature"
      */
-    getAuthToken(deadline: Date): string;
+    getAuthToken(deadline?: Date): string;
     /**
      * Sign a create order transaction
      */
@@ -1736,7 +1743,7 @@ declare function getClient(apiKeyIndex?: number, accountIndex?: bigint): TxClien
 /**
  * Create a new TxClient and store it
  */
-declare function createClient(httpClient: MinimalHTTPClient | null, privateKey: string, chainId: number, apiKeyIndex: number, accountIndex: bigint): TxClient;
+declare function createClient(httpClient: MinimalHTTPClient | null, privateKey: string, publicKey: string, chainId: number, apiKeyIndex: number, accountIndex: bigint): TxClient;
 /**
  * Check that a client exists and the API key matches the one on the server
  */
@@ -1887,6 +1894,7 @@ interface Candlestick {
     l: number;
     c: number;
     v: number;
+    V: number;
 }
 interface CandlesRequest {
     market_id: number;
@@ -2949,7 +2957,7 @@ interface InfoPrivateClientConfig {
  *
  * @example
  * ```typescript
- * const txClient = createClient(httpClient, privateKey, chainId, apiKeyIndex, accountIndex);
+ * const txClient = createClient(httpClient, privateKey, publicKey, chainId, apiKeyIndex, accountIndex);
  * const client = new InfoPrivateClient({
  *   baseURL: "https://mainnet.zklighter.elliot.ai",
  *   txClient
@@ -3346,7 +3354,7 @@ interface ExchangeClientConfig {
  *
  * @example
  * ```typescript
- * const txClient = createClient(httpClient, privateKey, chainId, apiKeyIndex, accountIndex);
+ * const txClient = createClient(httpClient, privateKey, publicKey, chainId, apiKeyIndex, accountIndex);
  * const client = new ExchangeClient({
  *   baseURL: "https://mainnet.zklighter.elliot.ai",
  *   txClient

package/dist/index.js

@@ -1962,14 +1962,19 @@ function schnorrSignHashedMessageDeterministic(hashedMessage, sk, k) {
 
 // src/signer/keyManager.ts
 var KeyManagerImpl = class {
-  constructor(privateKeyBytes) {
+  constructor(privateKeyBytes, publicKeyBytes) {
     if (privateKeyBytes.length !== 40) {
       throw new Error(
         `Invalid private key length. expected: 40, got: ${privateKeyBytes.length}`
       );
     }
+    if (publicKeyBytes.length !== 40) {
+      throw new Error(
+        `Invalid public key length. expected: 40, got: ${publicKeyBytes.length}`
+      );
+    }
     this.key = ECgFp5Scalar.fromLittleEndianBytes(privateKeyBytes);
-    this._pubKey = schnorrPkFromSk(this.key);
+    this._pubKey = GFp5Element.fromLittleEndianBytes(publicKeyBytes);
   }
   sign(hashedMessage) {
     if (hashedMessage.length !== 40) {
@@ -1989,8 +1994,8 @@ var KeyManagerImpl = class {
     return this.key.toLittleEndianBytes();
   }
 };
-function newKeyManager(privateKeyBytes) {
-  return new KeyManagerImpl(privateKeyBytes);
+function newKeyManager(privateKeyBytes, publicKeyBytes) {
+  return new KeyManagerImpl(privateKeyBytes, publicKeyBytes);
 }
 async function generateApiKey(seed) {
   const key = seed ? await sampleScalarFromSeed(seed) : sampleScalar();
@@ -3595,8 +3600,11 @@ function bigIntSafeStringify(obj) {
 }
 
 // src/client/txClient.ts
+var EIGHT_HOUR_MS = 8 * 60 * 60 * 1e3;
+var HAFT_HOUR_MS = 30 * 60 * 1e3;
+var authTokenCache = /* @__PURE__ */ new Map();
 var TxClient = class {
-  constructor(apiClient, privateKey, accountIndex, apiKeyIndex, chainId) {
+  constructor(apiClient, privateKey, publicKey, accountIndex, apiKeyIndex, chainId) {
     /**
      * Get the next nonce for the current account from the server
      */
@@ -3617,9 +3625,22 @@ var TxClient = class {
         `Invalid private key length: expected 40, got ${privateKeyBytes.length}`
       );
     }
+    let publicKeyBytes;
+    try {
+      publicKeyBytes = hexToBytes(publicKey);
+    } catch (e) {
+      console.log("error parsing public key:", e);
+      throw new Error("Invalid public key format");
+    }
+    if (publicKeyBytes.length !== 40) {
+      throw new Error(
+        `Invalid public key length: expected 40, got ${publicKeyBytes.length}`
+      );
+    }
+    this._pubkey = publicKey;
     this.apiClient = apiClient;
     this.chainId = chainId;
-    this.keyManager = newKeyManager(privateKeyBytes);
+    this.keyManager = newKeyManager(privateKeyBytes, publicKeyBytes);
     this._accountIndex = accountIndex;
     this._apiKeyIndex = apiKeyIndex;
   }
@@ -3702,16 +3723,37 @@ var TxClient = class {
     }
   }
   /**
-   * Create an auth token
+   * Create an auth token with caching
+   * Generates a new token if:
+   * 1. No cached token exists for this account
+   * 2. The cached token expires in less than 1 hour
+   *
+   * @param deadline - Optional deadline for the token (defaults to 24 hours from now)
+   * @returns Auth token string in format: "timestamp:accountIndex:apiKeyIndex:signature"
    */
   getAuthToken(deadline) {
-    const message = `${Math.floor(deadline.getTime() / 1e3)}:${this._accountIndex}:${this._apiKeyIndex}`;
+    const tokenDeadline = deadline || new Date(Date.now() + EIGHT_HOUR_MS);
+    const cacheKey = `${this._accountIndex}:${this._apiKeyIndex}:${this._pubkey}`;
+    const cached = authTokenCache.get(cacheKey);
+    if (cached) {
+      const now = Date.now();
+      const timeUntilExpiry = cached.deadline.getTime();
+      if (timeUntilExpiry > HAFT_HOUR_MS) {
+        return cached.token;
+      }
+    }
+    const message = `${Math.floor(tokenDeadline.getTime() / 1e3)}:${this._accountIndex}:${this._apiKeyIndex}`;
     const msgBytes = new TextEncoder().encode(message);
     const msgElements = bytesToFieldElementsCanonicalLE(msgBytes);
     const msgHash = hashToQuinticExtension(msgElements);
     const signatureBytes = this.keyManager.sign(msgHash);
     const signature = bytesToHex(signatureBytes);
-    return `${message}:${signature}`;
+    const token = `${message}:${signature}`;
+    authTokenCache.set(cacheKey, {
+      token,
+      deadline: tokenDeadline
+    });
+    return token;
   }
   /**
    * Sign a create order transaction
@@ -4060,13 +4102,14 @@ function getClient(apiKeyIndex = DEFAULT_API_KEY_INDEX, accountIndex = DEFAULT_A
   }
   return client;
 }
-function createClient(httpClient, privateKey, chainId, apiKeyIndex, accountIndex) {
+function createClient(httpClient, privateKey, publicKey, chainId, apiKeyIndex, accountIndex) {
   if (accountIndex <= 0n) {
     throw new Error("Invalid account index");
   }
   const txClientInstance = new TxClient(
     httpClient,
     privateKey,
+    publicKey,
     accountIndex,
     apiKeyIndex,
     chainId