zklighter-perps 1.0.89 → 1.0.91

package/.circleci/config.yml

@@ -14,6 +14,7 @@ jobs:
           name: Clone zklighter-perps repository
           command: |
             git clone https://${GITHUB_TOKEN}@github.com/elliottech/zklighter-perps.git
+            git checkout << pipeline.parameters.BE_BRANCH >>
 
       - run:
           name: Download goctl-swagger binary
@@ -64,7 +65,7 @@ jobs:
           name: Get openapi.json from workspace
           command: |
             cp /tmp/workspace/openapi.json ./.circleci
-      
+
       - run:
           name: Run postprocess script
           command: |
@@ -98,7 +99,7 @@ jobs:
           name: Download OpenAPI Generator JAR
           command: |
             wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.7.0/openapi-generator-cli-7.7.0.jar -O openapi-generator-cli.jar
-            
+
       - run:
           name: Generate TS client using OpenAPI Generator
           command: |
@@ -154,7 +155,9 @@ parameters:
   update_ts_sdk:
     default: false
     type: boolean
-
+  BE_BRANCH:
+    type: string
+    default: "main"
 
 workflows:
   version: 2
@@ -185,4 +188,5 @@ workflows:
       - update_npm_package:
           filters:
             branches:
-              only: main
+              only: main
+

package/.openapi-generator/FILES

@@ -5,6 +5,7 @@ apis/CandlestickApi.ts
 apis/InfoApi.ts
 apis/LiquidationApi.ts
 apis/OrderApi.ts
+apis/ReferralApi.ts
 apis/RootApi.ts
 apis/TransactionApi.ts
 apis/index.ts
@@ -65,6 +66,7 @@ models/PublicPool.ts
 models/PublicPoolInfo.ts
 models/PublicPoolShare.ts
 models/PublicPools.ts
+models/ReferralCode.ts
 models/ReqDoFaucet.ts
 models/ReqGetAccount.ts
 models/ReqGetAccountActiveOrders.ts
@@ -94,6 +96,7 @@ models/ReqGetRangeWithCursor.ts
 models/ReqGetRangeWithIndex.ts
 models/ReqGetRangeWithIndexSortable.ts
 models/ReqGetRecentTrades.ts
+models/ReqGetReferralCode.ts
 models/ReqGetTrades.ts
 models/ReqGetTx.ts
 models/ReqGetWithdrawHistory.ts

package/apis/AccountApi.ts

@@ -245,7 +245,7 @@ export class AccountApi extends runtime.BaseAPI {
     }
 
     /**
-     * Get account api key
+     * Get account api key. Set `api_key_index` to 255 to retrieve all api keys associated with the account.
      * apikeys
      */
     async apikeysRaw(requestParameters: ApikeysRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AccountApiKeys>> {
@@ -286,7 +286,7 @@ export class AccountApi extends runtime.BaseAPI {
     }
 
     /**
-     * Get account api key
+     * Get account api key. Set `api_key_index` to 255 to retrieve all api keys associated with the account.
      * apikeys
      */
     async apikeys(requestParameters: ApikeysRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AccountApiKeys> {

package/apis/InfoApi.ts

@@ -62,7 +62,7 @@ export class InfoApi extends runtime.BaseAPI {
     }
 
     /**
-     * Get zklighter general info, including contract address, and count of transactions and active users
+     * Get zklighter general info, including transaction and block stats
      * layer2BasicInfo
      */
     async layer2BasicInfoRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Layer2BasicInfo>> {
@@ -81,7 +81,7 @@ export class InfoApi extends runtime.BaseAPI {
     }
 
     /**
-     * Get zklighter general info, including contract address, and count of transactions and active users
+     * Get zklighter general info, including transaction and block stats
      * layer2BasicInfo
      */
     async layer2BasicInfo(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Layer2BasicInfo> {

package/apis/OrderApi.ts

@@ -98,7 +98,7 @@ export interface TradesRequest {
 export class OrderApi extends runtime.BaseAPI {
 
     /**
-     * Get account active orders
+     * Get account active orders. `auth` can be generated using the SDK.
      * accountActiveOrders
      */
     async accountActiveOrdersRaw(requestParameters: AccountActiveOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Orders>> {
@@ -150,7 +150,7 @@ export class OrderApi extends runtime.BaseAPI {
     }
 
     /**
-     * Get account active orders
+     * Get account active orders. `auth` can be generated using the SDK.
      * accountActiveOrders
      */
     async accountActiveOrders(requestParameters: AccountActiveOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Orders> {
@@ -159,7 +159,7 @@ export class OrderApi extends runtime.BaseAPI {
     }
 
     /**
-     * Get account active orders
+     * Get account inactive orders
      * accountInactiveOrders
      */
     async accountInactiveOrdersRaw(requestParameters: AccountInactiveOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Orders>> {
@@ -216,7 +216,7 @@ export class OrderApi extends runtime.BaseAPI {
     }
 
     /**
-     * Get account active orders
+     * Get account inactive orders
      * accountInactiveOrders
      */
     async accountInactiveOrders(requestParameters: AccountInactiveOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Orders> {

package/apis/ReferralApi.ts

@@ -0,0 +1,238 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+import type {
+  ReferralCode,
+  ResultCode,
+} from '../models/index';
+import {
+    ReferralCodeFromJSON,
+    ReferralCodeToJSON,
+    ResultCodeFromJSON,
+    ResultCodeToJSON,
+} from '../models/index';
+
+export interface ReferralCreateRequest {
+    auth: string;
+    account_index: number;
+}
+
+export interface ReferralGetRequest {
+    auth: string;
+    account_index: number;
+}
+
+export interface ReferralUseRequest {
+    l1_address: string;
+    referral_code: string;
+    discord?: string;
+    telegram?: string;
+}
+
+/**
+ * 
+ */
+export class ReferralApi extends runtime.BaseAPI {
+
+    /**
+     * Create referral code
+     * referral_create
+     */
+    async referralCreateRaw(requestParameters: ReferralCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ReferralCode>> {
+        if (requestParameters['auth'] == null) {
+            throw new runtime.RequiredError(
+                'auth',
+                'Required parameter "auth" was null or undefined when calling referralCreate().'
+            );
+        }
+
+        if (requestParameters['account_index'] == null) {
+            throw new runtime.RequiredError(
+                'account_index',
+                'Required parameter "account_index" was null or undefined when calling referralCreate().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        const consumes: runtime.Consume[] = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+
+        let formParams: { append(param: string, value: any): any };
+        let useForm = false;
+        if (useForm) {
+            formParams = new FormData();
+        } else {
+            formParams = new URLSearchParams();
+        }
+
+        if (requestParameters['auth'] != null) {
+            formParams.append('auth', requestParameters['auth'] as any);
+        }
+
+        if (requestParameters['account_index'] != null) {
+            formParams.append('account_index', requestParameters['account_index'] as any);
+        }
+
+        const response = await this.request({
+            path: `/api/v1/referral/create`,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ReferralCodeFromJSON(jsonValue));
+    }
+
+    /**
+     * Create referral code
+     * referral_create
+     */
+    async referralCreate(requestParameters: ReferralCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ReferralCode> {
+        const response = await this.referralCreateRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Get referral code
+     * referral_get
+     */
+    async referralGetRaw(requestParameters: ReferralGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ReferralCode>> {
+        if (requestParameters['auth'] == null) {
+            throw new runtime.RequiredError(
+                'auth',
+                'Required parameter "auth" was null or undefined when calling referralGet().'
+            );
+        }
+
+        if (requestParameters['account_index'] == null) {
+            throw new runtime.RequiredError(
+                'account_index',
+                'Required parameter "account_index" was null or undefined when calling referralGet().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['auth'] != null) {
+            queryParameters['auth'] = requestParameters['auth'];
+        }
+
+        if (requestParameters['account_index'] != null) {
+            queryParameters['account_index'] = requestParameters['account_index'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        const response = await this.request({
+            path: `/api/v1/referral/get`,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ReferralCodeFromJSON(jsonValue));
+    }
+
+    /**
+     * Get referral code
+     * referral_get
+     */
+    async referralGet(requestParameters: ReferralGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ReferralCode> {
+        const response = await this.referralGetRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Use referral code
+     * referral_use
+     */
+    async referralUseRaw(requestParameters: ReferralUseRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ResultCode>> {
+        if (requestParameters['l1_address'] == null) {
+            throw new runtime.RequiredError(
+                'l1_address',
+                'Required parameter "l1_address" was null or undefined when calling referralUse().'
+            );
+        }
+
+        if (requestParameters['referral_code'] == null) {
+            throw new runtime.RequiredError(
+                'referral_code',
+                'Required parameter "referral_code" was null or undefined when calling referralUse().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        const consumes: runtime.Consume[] = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+
+        let formParams: { append(param: string, value: any): any };
+        let useForm = false;
+        if (useForm) {
+            formParams = new FormData();
+        } else {
+            formParams = new URLSearchParams();
+        }
+
+        if (requestParameters['l1_address'] != null) {
+            formParams.append('l1_address', requestParameters['l1_address'] as any);
+        }
+
+        if (requestParameters['referral_code'] != null) {
+            formParams.append('referral_code', requestParameters['referral_code'] as any);
+        }
+
+        if (requestParameters['discord'] != null) {
+            formParams.append('discord', requestParameters['discord'] as any);
+        }
+
+        if (requestParameters['telegram'] != null) {
+            formParams.append('telegram', requestParameters['telegram'] as any);
+        }
+
+        const response = await this.request({
+            path: `/api/v1/referral/use`,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ResultCodeFromJSON(jsonValue));
+    }
+
+    /**
+     * Use referral code
+     * referral_use
+     */
+    async referralUse(requestParameters: ReferralUseRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ResultCode> {
+        const response = await this.referralUseRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/apis/TransactionApi.ts

@@ -343,7 +343,7 @@ export class TransactionApi extends runtime.BaseAPI {
     }
 
     /**
-     * Get next nonce for a specific account
+     * Get next nonce for a specific account and api key
      * nextNonce
      */
     async nextNonceRaw(requestParameters: NextNonceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NextNonce>> {
@@ -384,7 +384,7 @@ export class TransactionApi extends runtime.BaseAPI {
     }
 
     /**
-     * Get next nonce for a specific account
+     * Get next nonce for a specific account and api key
      * nextNonce
      */
     async nextNonce(requestParameters: NextNonceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NextNonce> {

package/apis/index.ts

@@ -7,5 +7,6 @@ export * from './CandlestickApi';
 export * from './InfoApi';
 export * from './LiquidationApi';
 export * from './OrderApi';
+export * from './ReferralApi';
 export * from './RootApi';
 export * from './TransactionApi';

package/models/DepositHistoryItem.ts

@@ -43,6 +43,12 @@ export interface DepositHistoryItem {
      * @memberof DepositHistoryItem
      */
     status: DepositHistoryItemStatusEnum;
+    /**
+     * 
+     * @type {string}
+     * @memberof DepositHistoryItem
+     */
+    l1_tx_hash: string;
 }
 
 
@@ -66,6 +72,7 @@ export function instanceOfDepositHistoryItem(value: object): value is DepositHis
     if (!('amount' in value) || value['amount'] === undefined) return false;
     if (!('timestamp' in value) || value['timestamp'] === undefined) return false;
     if (!('status' in value) || value['status'] === undefined) return false;
+    if (!('l1_tx_hash' in value) || value['l1_tx_hash'] === undefined) return false;
     return true;
 }
 
@@ -83,6 +90,7 @@ export function DepositHistoryItemFromJSONTyped(json: any, ignoreDiscriminator:
         'amount': json['amount'],
         'timestamp': json['timestamp'],
         'status': json['status'],
+        'l1_tx_hash': json['l1_tx_hash'],
     };
 }
 
@@ -96,6 +104,7 @@ export function DepositHistoryItemToJSON(value?: DepositHistoryItem | null): any
         'amount': value['amount'],
         'timestamp': value['timestamp'],
         'status': value['status'],
+        'l1_tx_hash': value['l1_tx_hash'],
     };
 }
 

package/models/ReferralCode.ts

@@ -0,0 +1,87 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * 
+ * @export
+ * @interface ReferralCode
+ */
+export interface ReferralCode {
+    /**
+     * 
+     * @type {number}
+     * @memberof ReferralCode
+     */
+    code: number;
+    /**
+     * 
+     * @type {string}
+     * @memberof ReferralCode
+     */
+    message?: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof ReferralCode
+     */
+    referral_code: string;
+    /**
+     * 
+     * @type {number}
+     * @memberof ReferralCode
+     */
+    remaining_usage: number;
+}
+
+/**
+ * Check if a given object implements the ReferralCode interface.
+ */
+export function instanceOfReferralCode(value: object): value is ReferralCode {
+    if (!('code' in value) || value['code'] === undefined) return false;
+    if (!('referral_code' in value) || value['referral_code'] === undefined) return false;
+    if (!('remaining_usage' in value) || value['remaining_usage'] === undefined) return false;
+    return true;
+}
+
+export function ReferralCodeFromJSON(json: any): ReferralCode {
+    return ReferralCodeFromJSONTyped(json, false);
+}
+
+export function ReferralCodeFromJSONTyped(json: any, ignoreDiscriminator: boolean): ReferralCode {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'code': json['code'],
+        'message': json['message'] == null ? undefined : json['message'],
+        'referral_code': json['referral_code'],
+        'remaining_usage': json['remaining_usage'],
+    };
+}
+
+export function ReferralCodeToJSON(value?: ReferralCode | null): any {
+    if (value == null) {
+        return value;
+    }
+    return {
+        
+        'code': value['code'],
+        'message': value['message'],
+        'referral_code': value['referral_code'],
+        'remaining_usage': value['remaining_usage'],
+    };
+}
+

package/models/ReqGetReferralCode.ts

@@ -0,0 +1,70 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * 
+ * @export
+ * @interface ReqGetReferralCode
+ */
+export interface ReqGetReferralCode {
+    /**
+     * 
+     * @type {string}
+     * @memberof ReqGetReferralCode
+     */
+    auth: string;
+    /**
+     * 
+     * @type {number}
+     * @memberof ReqGetReferralCode
+     */
+    account_index: number;
+}
+
+/**
+ * Check if a given object implements the ReqGetReferralCode interface.
+ */
+export function instanceOfReqGetReferralCode(value: object): value is ReqGetReferralCode {
+    if (!('auth' in value) || value['auth'] === undefined) return false;
+    if (!('account_index' in value) || value['account_index'] === undefined) return false;
+    return true;
+}
+
+export function ReqGetReferralCodeFromJSON(json: any): ReqGetReferralCode {
+    return ReqGetReferralCodeFromJSONTyped(json, false);
+}
+
+export function ReqGetReferralCodeFromJSONTyped(json: any, ignoreDiscriminator: boolean): ReqGetReferralCode {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'auth': json['auth'],
+        'account_index': json['account_index'],
+    };
+}
+
+export function ReqGetReferralCodeToJSON(value?: ReqGetReferralCode | null): any {
+    if (value == null) {
+        return value;
+    }
+    return {
+        
+        'auth': value['auth'],
+        'account_index': value['account_index'],
+    };
+}
+

package/models/WithdrawHistoryItem.ts

@@ -49,6 +49,12 @@ export interface WithdrawHistoryItem {
      * @memberof WithdrawHistoryItem
      */
     type: WithdrawHistoryItemTypeEnum;
+    /**
+     * 
+     * @type {string}
+     * @memberof WithdrawHistoryItem
+     */
+    l1_tx_hash: string;
 }
 
 
@@ -83,6 +89,7 @@ export function instanceOfWithdrawHistoryItem(value: object): value is WithdrawH
     if (!('timestamp' in value) || value['timestamp'] === undefined) return false;
     if (!('status' in value) || value['status'] === undefined) return false;
     if (!('type' in value) || value['type'] === undefined) return false;
+    if (!('l1_tx_hash' in value) || value['l1_tx_hash'] === undefined) return false;
     return true;
 }
 
@@ -101,6 +108,7 @@ export function WithdrawHistoryItemFromJSONTyped(json: any, ignoreDiscriminator:
         'timestamp': json['timestamp'],
         'status': json['status'],
         'type': json['type'],
+        'l1_tx_hash': json['l1_tx_hash'],
     };
 }
 
@@ -115,6 +123,7 @@ export function WithdrawHistoryItemToJSON(value?: WithdrawHistoryItem | null): a
         'timestamp': value['timestamp'],
         'status': value['status'],
         'type': value['type'],
+        'l1_tx_hash': value['l1_tx_hash'],
     };
 }
 

package/models/index.ts

@@ -56,6 +56,7 @@ export * from './PublicPool';
 export * from './PublicPoolInfo';
 export * from './PublicPoolShare';
 export * from './PublicPools';
+export * from './ReferralCode';
 export * from './ReqDoFaucet';
 export * from './ReqGetAccount';
 export * from './ReqGetAccountActiveOrders';
@@ -85,6 +86,7 @@ export * from './ReqGetRangeWithCursor';
 export * from './ReqGetRangeWithIndex';
 export * from './ReqGetRangeWithIndexSortable';
 export * from './ReqGetRecentTrades';
+export * from './ReqGetReferralCode';
 export * from './ReqGetTrades';
 export * from './ReqGetTx';
 export * from './ReqGetWithdrawHistory';

package/openapi.json

@@ -130,7 +130,7 @@
         "consumes": [
           "multipart/form-data"
         ],
-        "description": "Get account active orders"
+        "description": "Get account active orders. `auth` can be generated using the SDK."
       }
     },
     "/api/v1/accountInactiveOrders": {
@@ -203,7 +203,7 @@
         "consumes": [
           "multipart/form-data"
         ],
-        "description": "Get account active orders"
+        "description": "Get account inactive orders"
       }
     },
     "/api/v1/accountOrders": {
@@ -520,7 +520,7 @@
         "consumes": [
           "multipart/form-data"
         ],
-        "description": "Get account api key"
+        "description": "Get account api key. Set `api_key_index` to 255 to retrieve all api keys associated with the account."
       }
     },
     "/api/v1/block": {
@@ -1259,7 +1259,7 @@
         "tags": [
           "info"
         ],
-        "description": "Get zklighter general info, including contract address, and count of transactions and active users"
+        "description": "Get zklighter general info, including transaction and block stats"
       }
     },
     "/api/v1/leaderboard": {
@@ -1384,7 +1384,7 @@
         "consumes": [
           "multipart/form-data"
         ],
-        "description": "Get next nonce for a specific account"
+        "description": "Get next nonce for a specific account and api key"
       }
     },
     "/api/v1/orderBookDetails": {
@@ -1747,6 +1747,122 @@
         "description": "Get recent trades"
       }
     },
+    "/api/v1/referral/create": {
+      "post": {
+        "summary": "referral_create",
+        "operationId": "referral_create",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/ReferralCode"
+            }
+          },
+          "400": {
+            "description": "Bad request",
+            "schema": {
+              "$ref": "#/definitions/ResultCode"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ReqCreateReferralCode"
+            }
+          }
+        ],
+        "tags": [
+          "referral"
+        ],
+        "consumes": [
+          "multipart/form-data"
+        ],
+        "description": "Create referral code"
+      }
+    },
+    "/api/v1/referral/get": {
+      "get": {
+        "summary": "referral_get",
+        "operationId": "referral_get",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/ReferralCode"
+            }
+          },
+          "400": {
+            "description": "Bad request",
+            "schema": {
+              "$ref": "#/definitions/ResultCode"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "auth",
+            "in": "query",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "account_index",
+            "in": "query",
+            "required": true,
+            "type": "integer",
+            "format": "int64"
+          }
+        ],
+        "tags": [
+          "referral"
+        ],
+        "consumes": [
+          "multipart/form-data"
+        ],
+        "description": "Get referral code"
+      }
+    },
+    "/api/v1/referral/use": {
+      "post": {
+        "summary": "referral_use",
+        "operationId": "referral_use",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/ResultCode"
+            }
+          },
+          "400": {
+            "description": "Bad request",
+            "schema": {
+              "$ref": "#/definitions/ResultCode"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ReqUseReferralCode"
+            }
+          }
+        ],
+        "tags": [
+          "referral"
+        ],
+        "consumes": [
+          "multipart/form-data"
+        ],
+        "description": "Use referral code"
+      }
+    },
     "/api/v1/sendTx": {
       "post": {
         "summary": "sendTx",
@@ -2975,6 +3091,10 @@
             "completed",
             "claimable"
           ]
+        },
+        "l1_tx_hash": {
+          "type": "string",
+          "example": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8"
         }
       },
       "title": "DepositHistoryItem",
@@ -2982,7 +3102,8 @@
         "id",
         "amount",
         "timestamp",
-        "status"
+        "status",
+        "l1_tx_hash"
       ]
     },
     "DetailedAccount": {
@@ -4637,6 +4758,34 @@
         "public_pools"
       ]
     },
+    "ReferralCode": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "integer",
+          "format": "int32",
+          "example": "200"
+        },
+        "message": {
+          "type": "string"
+        },
+        "referral_code": {
+          "type": "string",
+          "example": "5V24K3MJ"
+        },
+        "remaining_usage": {
+          "type": "integer",
+          "format": "int32",
+          "example": "3"
+        }
+      },
+      "title": "ReferralCode",
+      "required": [
+        "code",
+        "referral_code",
+        "remaining_usage"
+      ]
+    },
     "ReqCancelDeposit": {
       "type": "object",
       "properties": {
@@ -4677,6 +4826,23 @@
         "amount"
       ]
     },
+    "ReqCreateReferralCode": {
+      "type": "object",
+      "properties": {
+        "auth": {
+          "type": "string"
+        },
+        "account_index": {
+          "type": "integer",
+          "format": "int64"
+        }
+      },
+      "title": "ReqCreateReferralCode",
+      "required": [
+        "auth",
+        "account_index"
+      ]
+    },
     "ReqDoFaucet": {
       "type": "object",
       "properties": {
@@ -5347,6 +5513,23 @@
         "limit"
       ]
     },
+    "ReqGetReferralCode": {
+      "type": "object",
+      "properties": {
+        "auth": {
+          "type": "string"
+        },
+        "account_index": {
+          "type": "integer",
+          "format": "int64"
+        }
+      },
+      "title": "ReqGetReferralCode",
+      "required": [
+        "auth",
+        "account_index"
+      ]
+    },
     "ReqGetTrades": {
       "type": "object",
       "properties": {
@@ -5564,6 +5747,28 @@
         "auth"
       ]
     },
+    "ReqUseReferralCode": {
+      "type": "object",
+      "properties": {
+        "l1_address": {
+          "type": "string"
+        },
+        "referral_code": {
+          "type": "string"
+        },
+        "discord": {
+          "type": "string"
+        },
+        "telegram": {
+          "type": "string"
+        }
+      },
+      "title": "ReqUseReferralCode",
+      "required": [
+        "l1_address",
+        "referral_code"
+      ]
+    },
     "RespGetFastwithdrawalInfo": {
       "type": "object",
       "properties": {
@@ -6081,6 +6286,10 @@
             "secure",
             "fast"
           ]
+        },
+        "l1_tx_hash": {
+          "type": "string",
+          "example": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8"
         }
       },
       "title": "WithdrawHistoryItem",
@@ -6089,7 +6298,8 @@
         "amount",
         "timestamp",
         "status",
-        "type"
+        "type",
+        "l1_tx_hash"
       ]
     },
     "ZkLighterInfo": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zklighter-perps",
-  "version": "1.0.89",
+  "version": "1.0.91",
   "description": "zkLighter Perps SDK",
   "main": "index.ts",
   "directories": {