@andy-liquid-labs/lighter-ts-sdk 1.0.0

package/src/types/txInfoSerializer.ts

@@ -0,0 +1,348 @@
+/**
+ * Transaction Info Serializer
+ *
+ * Converts TypeScript TxInfo objects to JSON format compatible with the Lighter API.
+ * The API expects PascalCase field names matching the Go struct definitions.
+ */
+
+import * as types from "./index";
+
+/**
+ * Convert Uint8Array to base64 string (Go json.Marshal format for []byte)
+ */
+function uint8ArrayToBase64(bytes: Uint8Array): string {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(bytes).toString("base64");
+    }
+    // Browser fallback
+    let binary = "";
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+
+/**
+ * Serialize L2CreateOrderTxInfo to JSON
+ */
+export function serializeCreateOrder(
+    txInfo: types.L2CreateOrderTxInfo,
+): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        MarketIndex: txInfo.orderInfo.marketIndex,
+        ClientOrderIndex: Number(txInfo.orderInfo.clientOrderIndex),
+        BaseAmount: Number(txInfo.orderInfo.baseAmount),
+        Price: txInfo.orderInfo.price,
+        IsAsk: txInfo.orderInfo.isAsk,
+        Type: txInfo.orderInfo.type,
+        TimeInForce: txInfo.orderInfo.timeInForce,
+        ReduceOnly: txInfo.orderInfo.reduceOnly,
+        TriggerPrice: txInfo.orderInfo.triggerPrice,
+        OrderExpiry: Number(txInfo.orderInfo.orderExpiry),
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2CancelOrderTxInfo to JSON
+ */
+export function serializeCancelOrder(
+    txInfo: types.L2CancelOrderTxInfo,
+): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        MarketIndex: txInfo.marketIndex,
+        Index: Number(txInfo.index),
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2ModifyOrderTxInfo to JSON
+ */
+export function serializeModifyOrder(
+    txInfo: types.L2ModifyOrderTxInfo,
+): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        MarketIndex: txInfo.marketIndex,
+        Index: Number(txInfo.index),
+        BaseAmount: Number(txInfo.baseAmount),
+        Price: txInfo.price,
+        TriggerPrice: txInfo.triggerPrice,
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2CancelAllOrdersTxInfo to JSON
+ */
+export function serializeCancelAllOrders(
+    txInfo: types.L2CancelAllOrdersTxInfo,
+): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        TimeInForce: txInfo.timeInForce,
+        Time: Number(txInfo.time),
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2WithdrawTxInfo to JSON
+ */
+export function serializeWithdraw(txInfo: types.L2WithdrawTxInfo): string {
+    return JSON.stringify({
+        FromAccountIndex: Number(txInfo.fromAccountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        AssetIndex: txInfo.assetIndex,
+        RouteType: txInfo.routeType,
+        Amount: Number(txInfo.amount),
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2TransferTxInfo to JSON
+ */
+export function serializeTransfer(txInfo: types.L2TransferTxInfo): string {
+    // Convert memo bytes to string if it's a Uint8Array
+
+    return JSON.stringify({
+        FromAccountIndex: Number(txInfo.fromAccountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        ToAccountIndex: Number(txInfo.toAccountIndex),
+        AssetIndex: txInfo.assetIndex,
+        FromRouteType: txInfo.fromRouteType,
+        ToRouteType: txInfo.toRouteType,
+        Amount: Number(txInfo.amount),
+        USDCFee: Number(txInfo.usdcFee),
+        Memo: Array.from(txInfo.memo),
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2ChangePubKeyTxInfo to JSON
+ */
+export function serializeChangePubKey(
+    txInfo: types.L2ChangePubKeyTxInfo,
+): string {
+    // Convert pubKey bytes to hex string
+    const pubKeyHex = Array.from(txInfo.pubKey)
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        PubKey: pubKeyHex,
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2CreateSubAccountTxInfo to JSON
+ */
+export function serializeCreateSubAccount(
+    txInfo: types.L2CreateSubAccountTxInfo,
+): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2UpdateLeverageTxInfo to JSON
+ */
+export function serializeUpdateLeverage(
+    txInfo: types.L2UpdateLeverageTxInfo,
+): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        MarketIndex: txInfo.marketIndex,
+        InitialMarginFraction: txInfo.initialMarginFraction,
+        MarginMode: txInfo.marginMode,
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2UpdateMarginTxInfo to JSON
+ */
+export function serializeUpdateMargin(
+    txInfo: types.L2UpdateMarginTxInfo,
+): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        MarketIndex: txInfo.marketIndex,
+        UsdcAmount: Number(txInfo.usdcAmount),
+        Direction: txInfo.direction,
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2CreatePublicPoolTxInfo to JSON
+ */
+export function serializeCreatePublicPool(
+    txInfo: types.L2CreatePublicPoolTxInfo,
+): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        OperatorFee: Number(txInfo.operatorFee),
+        InitialTotalShares: Number(txInfo.initialTotalShares),
+        MinOperatorShareRate: txInfo.minOperatorShareRate,
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2UpdatePublicPoolTxInfo to JSON
+ */
+export function serializeUpdatePublicPool(
+    txInfo: types.L2UpdatePublicPoolTxInfo,
+): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        PublicPoolIndex: Number(txInfo.publicPoolIndex),
+        Status: txInfo.status,
+        OperatorFee: Number(txInfo.operatorFee),
+        MinOperatorShareRate: txInfo.minOperatorShareRate,
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2MintSharesTxInfo to JSON
+ */
+export function serializeMintShares(txInfo: types.L2MintSharesTxInfo): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        PublicPoolIndex: Number(txInfo.publicPoolIndex),
+        ShareAmount: Number(txInfo.shareAmount),
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2BurnSharesTxInfo to JSON
+ */
+export function serializeBurnShares(txInfo: types.L2BurnSharesTxInfo): string {
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        PublicPoolIndex: Number(txInfo.publicPoolIndex),
+        ShareAmount: Number(txInfo.shareAmount),
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Serialize L2CreateGroupedOrdersTxInfo to JSON
+ */
+export function serializeCreateGroupedOrders(
+    txInfo: types.L2CreateGroupedOrdersTxInfo,
+): string {
+    const orders = txInfo.orders.map((order) => ({
+        MarketIndex: order.marketIndex,
+        ClientOrderIndex: Number(order.clientOrderIndex),
+        BaseAmount: Number(order.baseAmount),
+        Price: order.price,
+        IsAsk: order.isAsk,
+        Type: order.type,
+        TimeInForce: order.timeInForce,
+        ReduceOnly: order.reduceOnly,
+        TriggerPrice: order.triggerPrice,
+        OrderExpiry: Number(order.orderExpiry),
+    }));
+
+    return JSON.stringify({
+        AccountIndex: Number(txInfo.accountIndex),
+        ApiKeyIndex: txInfo.apiKeyIndex,
+        GroupingType: txInfo.groupingType,
+        Orders: orders,
+        ExpiredAt: Number(txInfo.expiredAt),
+        Nonce: Number(txInfo.nonce),
+        Sig: txInfo.signature ? uint8ArrayToBase64(txInfo.signature) : null,
+    });
+}
+
+/**
+ * Generic serializer - determines the type and calls the appropriate serializer
+ */
+export function serializeTxInfo(txInfo: types.TxInfo): string {
+    if (txInfo instanceof types.L2CreateOrderTxInfo) {
+        return serializeCreateOrder(txInfo);
+    } else if (txInfo instanceof types.L2CancelOrderTxInfo) {
+        return serializeCancelOrder(txInfo);
+    } else if (txInfo instanceof types.L2ModifyOrderTxInfo) {
+        return serializeModifyOrder(txInfo);
+    } else if (txInfo instanceof types.L2CancelAllOrdersTxInfo) {
+        return serializeCancelAllOrders(txInfo);
+    } else if (txInfo instanceof types.L2WithdrawTxInfo) {
+        return serializeWithdraw(txInfo);
+    } else if (txInfo instanceof types.L2TransferTxInfo) {
+        return serializeTransfer(txInfo);
+    } else if (txInfo instanceof types.L2ChangePubKeyTxInfo) {
+        return serializeChangePubKey(txInfo);
+    } else if (txInfo instanceof types.L2CreateSubAccountTxInfo) {
+        return serializeCreateSubAccount(txInfo);
+    } else if (txInfo instanceof types.L2UpdateLeverageTxInfo) {
+        return serializeUpdateLeverage(txInfo);
+    } else if (txInfo instanceof types.L2UpdateMarginTxInfo) {
+        return serializeUpdateMargin(txInfo);
+    } else if (txInfo instanceof types.L2CreatePublicPoolTxInfo) {
+        return serializeCreatePublicPool(txInfo);
+    } else if (txInfo instanceof types.L2UpdatePublicPoolTxInfo) {
+        return serializeUpdatePublicPool(txInfo);
+    } else if (txInfo instanceof types.L2MintSharesTxInfo) {
+        return serializeMintShares(txInfo);
+    } else if (txInfo instanceof types.L2BurnSharesTxInfo) {
+        return serializeBurnShares(txInfo);
+    } else if (txInfo instanceof types.L2CreateGroupedOrdersTxInfo) {
+        return serializeCreateGroupedOrders(txInfo);
+    }
+
+    throw new Error(`Unknown TxInfo type: ${txInfo.constructor.name}`);
+}