@deriverse/kit 1.0.39 → 1.0.42

package/dist/engine/index.js

@@ -0,0 +1,745 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Engine = void 0;
+const kit_1 = require("@solana/kit");
+const buffer_1 = require("buffer");
+const types_1 = require("../types");
+const enums_1 = require("../types/enums");
+const constants_1 = require("../constants");
+const structure_models_1 = require("../structure_models");
+const logs_decoder_1 = require("./logs-decoder");
+const account_helpers_1 = require("./account-helpers");
+const context_builders_1 = require("./context-builders");
+const utils_1 = require("./utils");
+const client_queries_1 = require("./client-queries");
+const spot_instructions_1 = require("./spot-instructions");
+const perp_instructions_1 = require("./perp-instructions");
+/**
+ * Main class to operate with Deriverse
+ * @property {number} originalClientId Deriverse main client ID
+ * @property {AddressLookupTableAccount} lut Root address lookup table account
+ * @property {AddressLookupTableAccount} clientLut Client address lookup table account
+ * @property {Map<number, Token>} tokens Tokens data
+ * @property {Map<number, Instrument>} instruments Instruments data
+ */
+class Engine {
+    /**
+     * @param rpc @solana/kit rpc
+     */
+    constructor(rpc, args) {
+        var _a, _b, _c, _d;
+        this.originalClientId = null;
+        this.clientLutAddress = null;
+        this.privateMode = false;
+        this.signer = null;
+        this.clientPrimaryAccount = null;
+        this.clientCommunityAccount = null;
+        this.refClientPrimaryAccount = null;
+        this.refClientCommunityAccount = null;
+        if (args)
+            types_1.EngineArgsSchema.parse(args);
+        this.rpc = rpc;
+        this.programId = (_a = args === null || args === void 0 ? void 0 : args.programId) !== null && _a !== void 0 ? _a : constants_1.PROGRAM_ID;
+        this.version = (_b = args === null || args === void 0 ? void 0 : args.version) !== null && _b !== void 0 ? _b : constants_1.VERSION;
+        this.commitment = (_c = args === null || args === void 0 ? void 0 : args.commitment) !== null && _c !== void 0 ? _c : 'confirmed';
+        this.uiNumbers = (_d = args === null || args === void 0 ? void 0 : args.uiNumbers) !== null && _d !== void 0 ? _d : true;
+        (0, constants_1.setDecimals)(this.uiNumbers);
+    }
+    // ============================================
+    // CONTEXT HELPERS (internal)
+    // ============================================
+    getAccountHelperContext() {
+        return {
+            rpc: this.rpc,
+            programId: this.programId,
+            version: this.version,
+            commitment: this.commitment,
+            drvsAuthority: this.drvsAuthority,
+        };
+    }
+    getSpotInstructionContext() {
+        if (this.signer === null) {
+            throw new Error('Wallet is not connected');
+        }
+        if (this.clientPrimaryAccount === null) {
+            throw new Error('Client primary account not found');
+        }
+        if (this.clientCommunityAccount === null) {
+            throw new Error('Client community account not found');
+        }
+        return Object.assign(Object.assign({}, this.getAccountHelperContext()), { instruments: this.instruments, tokens: this.tokens, uiNumbers: this.uiNumbers, signer: this.signer, rootAccount: this.rootAccount, clientPrimaryAccount: this.clientPrimaryAccount, clientCommunityAccount: this.clientCommunityAccount, refClientPrimaryAccount: this.refClientPrimaryAccount, refClientCommunityAccount: this.refClientCommunityAccount, privateMode: this.privateMode });
+    }
+    getPerpInstructionContext() {
+        return Object.assign(Object.assign({}, this.getSpotInstructionContext()), { rootStateModel: this.rootStateModel });
+    }
+    getClientQueryContext() {
+        return Object.assign(Object.assign({}, this.getAccountHelperContext()), { instruments: this.instruments, tokens: this.tokens, uiNumbers: this.uiNumbers, clientPrimaryAccount: this.clientPrimaryAccount, clientCommunityAccount: this.clientCommunityAccount, originalClientId: this.originalClientId });
+    }
+    requireClient() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!(yield this.checkClient())) {
+                throw new Error('Client account not found');
+            }
+        });
+    }
+    requireInstrument(instrId) {
+        const instr = this.instruments.get(instrId);
+        if (instr === undefined) {
+            throw new Error('Instrument not found');
+        }
+        return instr;
+    }
+    getSpotInstrumentWithUpdate(instrId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let instr = this.instruments.get(instrId);
+            if ((instr === null || instr === void 0 ? void 0 : instr.header.mapsAddress) == undefined) {
+                yield this.updateInstrData({ instrId });
+                instr = this.requireInstrument(instrId);
+            }
+            return instr;
+        });
+    }
+    getPerpInstrumentWithUpdate(instrId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let instr = this.instruments.get(instrId);
+            if ((instr === null || instr === void 0 ? void 0 : instr.header.perpMapsAddress) == undefined) {
+                yield this.updateInstrData({ instrId });
+                instr = this.requireInstrument(instrId);
+            }
+            return instr;
+        });
+    }
+    checkClient() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.signer === null) {
+                throw new Error('Wallet not connected');
+            }
+            if (this.clientPrimaryAccount != null) {
+                return true;
+            }
+            const clientPrimaryAccount = yield (0, account_helpers_1.findClientPrimaryAccount)({ programId: this.programId, version: this.version }, this.signer);
+            try {
+                const info = yield this.rpc
+                    .getAccountInfo(clientPrimaryAccount, { commitment: this.commitment, encoding: 'base64' })
+                    .send();
+                if (info.value == null) {
+                    return false;
+                }
+                const clientPrimaryAccountHeaderModel = structure_models_1.ClientPrimaryAccountHeaderModel.fromBuffer(info.value.data);
+                this.clientPrimaryAccount = clientPrimaryAccount;
+                this.clientCommunityAccount = yield (0, account_helpers_1.findClientCommunityAccount)({ programId: this.programId, version: this.version }, this.signer);
+                this.originalClientId = clientPrimaryAccountHeaderModel.id;
+                return true;
+            }
+            catch (err) {
+                console.error(err);
+                return false;
+            }
+        });
+    }
+    // ============================================
+    // LOGS DECODING
+    // ============================================
+    logsDecode(data) {
+        return (0, logs_decoder_1.decodeTransactionLogs)(data, {
+            instruments: this.instruments,
+            tokens: this.tokens,
+            uiNumbers: this.uiNumbers,
+        });
+    }
+    // ============================================
+    // INITIALIZATION METHODS
+    // ============================================
+    initialize() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                this.drvsAuthority = (yield (0, kit_1.getProgramDerivedAddress)({ programAddress: this.programId, seeds: ['ndxnt'] }))[0];
+                const ctx = this.getAccountHelperContext();
+                this.rootAccount = yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.ROOT);
+                this.communityAccount = yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY);
+                const infos = yield this.rpc
+                    .getMultipleAccounts([this.rootAccount, this.communityAccount], {
+                    commitment: this.commitment,
+                    encoding: 'base64',
+                })
+                    .send();
+                if (infos.value == null || infos.value[0] == null || infos.value[1] == null) {
+                    throw new Error('Initialization failed: getMultipleAccountsInfo');
+                }
+                this.rootStateModel = structure_models_1.RootStateModel.fromBuffer(infos.value[0].data);
+                this.tokens = new Map();
+                this.instruments = new Map();
+                this.privateMode = (this.rootStateModel.mask & 1) != 0;
+                const tokenAccounts = yield (0, account_helpers_1.findAccountsByTag)(ctx, enums_1.AccountType.TOKEN);
+                tokenAccounts.forEach((t) => {
+                    let tokenStateModel = structure_models_1.TokenStateModel.fromBuffer(t.account.data);
+                    this.tokens.set(tokenStateModel.id, tokenStateModel);
+                });
+                const instrAccounts = yield (0, account_helpers_1.findAccountsByTag)(ctx, enums_1.AccountType.INSTR, {
+                    offset: 8,
+                    length: 16,
+                });
+                instrAccounts.forEach((response) => {
+                    const buffer = buffer_1.Buffer.from((0, kit_1.getBase64Encoder)().encode(response.account.data[0]));
+                    let instrAccountHeaderModel = new structure_models_1.InstrAccountHeaderModel();
+                    instrAccountHeaderModel.instrId = buffer.readUint32LE(0);
+                    instrAccountHeaderModel.assetTokenId = buffer.readUint32LE(4);
+                    instrAccountHeaderModel.crncyTokenId = buffer.readUint32LE(8);
+                    instrAccountHeaderModel.mask = buffer.readUint32LE(12);
+                    this.instruments.set(instrAccountHeaderModel.instrId, {
+                        address: response.pubkey,
+                        header: instrAccountHeaderModel,
+                        spotBids: [],
+                        spotAsks: [],
+                        perpBids: [],
+                        perpAsks: [],
+                    });
+                });
+                this.updateCommunityFromBuffer(infos.value[1].data);
+                return true;
+            }
+            catch (err) {
+                console.error('Initialization failed:', err);
+                return false;
+            }
+        });
+    }
+    addToken(tokenAccount) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const info = yield this.rpc
+                .getAccountInfo(tokenAccount, { commitment: this.commitment, encoding: 'base64' })
+                .send();
+            if (info.value == null) {
+                throw new Error('Add Token Failed: getAccountInfo');
+            }
+            const tokenStateModel = structure_models_1.TokenStateModel.fromBuffer(info.value.data);
+            if (tokenStateModel.id > this.rootStateModel.tokensCount ||
+                tokenStateModel.tag != enums_1.AccountType.TOKEN ||
+                tokenStateModel.version != this.version) {
+                throw new Error('Invalid Token Account');
+            }
+            this.tokens.set(tokenStateModel.id, tokenStateModel);
+        });
+    }
+    addInstr(instrAccount) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const info = yield this.rpc
+                .getAccountInfo(instrAccount, { commitment: this.commitment, encoding: 'base64' })
+                .send();
+            if (info.value == null) {
+                throw new Error('Add Instrument Failed: getAccountInfo');
+            }
+            const instrAccountHeaderModel = structure_models_1.InstrAccountHeaderModel.fromBuffer(info.value.data);
+            if (instrAccountHeaderModel.instrId > this.rootStateModel.instrCount ||
+                instrAccountHeaderModel.tag != enums_1.AccountType.INSTR ||
+                instrAccountHeaderModel.version != this.version) {
+                throw new Error('Invalid Instrument Account');
+            }
+            this.instruments.set(instrAccountHeaderModel.instrId, {
+                address: instrAccount,
+                header: instrAccountHeaderModel,
+                spotBids: [],
+                spotAsks: [],
+                perpBids: [],
+                perpAsks: [],
+            });
+        });
+    }
+    setSigner(signer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.signer = signer;
+            const clientPrimaryAccount = yield (0, account_helpers_1.findClientPrimaryAccount)({ programId: this.programId, version: this.version }, signer);
+            let exists = false;
+            try {
+                const info = yield this.rpc
+                    .getAccountInfo(clientPrimaryAccount, { commitment: this.commitment, encoding: 'base64' })
+                    .send();
+                if (info.value) {
+                    const clientPrimaryAccountHeaderModel = structure_models_1.ClientPrimaryAccountHeaderModel.fromBuffer(info.value.data);
+                    if (clientPrimaryAccountHeaderModel.walletAddress == signer) {
+                        this.clientPrimaryAccount = clientPrimaryAccount;
+                        this.clientCommunityAccount = yield (0, account_helpers_1.findClientCommunityAccount)({ programId: this.programId, version: this.version }, signer);
+                        this.originalClientId = clientPrimaryAccountHeaderModel.id;
+                        this.clientLutAddress = clientPrimaryAccountHeaderModel.lutAddress;
+                        let date = Math.floor(new Date().valueOf() / 1000);
+                        if (date < clientPrimaryAccountHeaderModel.refProgramExpiration) {
+                            this.refClientPrimaryAccount = clientPrimaryAccountHeaderModel.refAddress;
+                            if (!this.refClientPrimaryAccount)
+                                throw new Error('Ref client account address not found');
+                            let refInfo = yield this.rpc
+                                .getAccountInfo(this.refClientPrimaryAccount, {
+                                commitment: this.commitment,
+                                encoding: 'base64',
+                            })
+                                .send();
+                            if (refInfo.value == null)
+                                throw new Error('Ref client account not found');
+                            const refClientPrimaryAccountHeaderModel = structure_models_1.ClientPrimaryAccountHeaderModel.fromBuffer(refInfo.value.data);
+                            this.refClientCommunityAccount = yield (0, account_helpers_1.findClientCommunityAccount)({ programId: this.programId, version: this.version }, refClientPrimaryAccountHeaderModel.walletAddress);
+                        }
+                        exists = true;
+                    }
+                }
+            }
+            catch (err) {
+                console.error(err);
+                throw new Error('Wallet connection failed');
+            }
+            if (!exists) {
+                this.clientPrimaryAccount = null;
+                this.originalClientId = null;
+            }
+        });
+    }
+    // ============================================
+    // ACCOUNT & STATE UPDATE METHODS
+    // ============================================
+    updateCommunityFromBuffer(data) {
+        let baseCrncyRecords = new Map();
+        let communityAccountHeaderModel = structure_models_1.CommunityAccountHeaderModel.fromBuffer(data);
+        const drvsDec = (0, utils_1.tokenDec)(this.tokens, 0, this.uiNumbers);
+        communityAccountHeaderModel.prevVotingSupply /= drvsDec;
+        communityAccountHeaderModel.votingSupply /= drvsDec;
+        communityAccountHeaderModel.drvsTokens /= drvsDec;
+        for (let i = 0; i < communityAccountHeaderModel.count; ++i) {
+            let record = structure_models_1.BaseCrncyRecordModel.fromBuffer(data, structure_models_1.CommunityAccountHeaderModel.LENGTH + i * structure_models_1.BaseCrncyRecordModel.LENGTH);
+            record.funds /= (0, utils_1.tokenDec)(this.tokens, record.crncyTokenId, this.uiNumbers);
+            baseCrncyRecords.set(record.crncyTokenId, record);
+        }
+        this.community = {
+            header: communityAccountHeaderModel,
+            data: baseCrncyRecords,
+        };
+    }
+    updateCommunity() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const info = yield this.rpc
+                .getAccountInfo(this.communityAccount, { commitment: this.commitment, encoding: 'base64' })
+                .send();
+            if (info.value == null) {
+                throw new Error('Community Account: GetAccountInfo Failed');
+            }
+            this.updateCommunityFromBuffer(info.value.data);
+        });
+    }
+    updateRootFromBuffer(data) {
+        this.rootStateModel = structure_models_1.RootStateModel.fromBuffer(data);
+    }
+    updateRoot() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const info = yield this.rpc
+                .getAccountInfo(this.rootAccount, { commitment: this.commitment, encoding: 'base64' })
+                .send();
+            if (info.value == null) {
+                throw new Error('Root Account: GetAccountInfo Failed');
+            }
+            this.updateRootFromBuffer(info.value.data);
+        });
+    }
+    getInstrAccountByTag(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (0, account_helpers_1.getInstrAccountByTag)(this.getAccountHelperContext(), args);
+        });
+    }
+    getAccountByTag(tag) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (0, account_helpers_1.getAccountByTag)(this.getAccountHelperContext(), tag);
+        });
+    }
+    getTokenAccount(mint) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (0, account_helpers_1.getTokenAccount)(this.getAccountHelperContext(), mint);
+        });
+    }
+    getTokenId(mint) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (0, account_helpers_1.getTokenId)(this.getAccountHelperContext(), mint);
+        });
+    }
+    getInstrId(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (0, account_helpers_1.getInstrId)(this.getAccountHelperContext(), args);
+        });
+    }
+    instrLut(args) {
+        return this.requireInstrument(args.instrId).header.lutAddress;
+    }
+    updateInstrData(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const instr = this.instruments.get(args.instrId);
+            if (!instr) {
+                throw new Error('Instrument not found!');
+            }
+            const ctx = this.getAccountHelperContext();
+            let instrAccount = yield (0, account_helpers_1.getInstrAccountByTag)(ctx, {
+                assetTokenId: instr.header.assetTokenId,
+                crncyTokenId: instr.header.crncyTokenId,
+                tag: enums_1.AccountType.INSTR,
+            });
+            const info = yield this.rpc
+                .getAccountInfo(instrAccount, { commitment: this.commitment, encoding: 'base64' })
+                .send();
+            if (info.value == null) {
+                throw new Error('updateInstrData: getAccountInfo failed');
+            }
+            yield this.updateInstrDataFromBuffer(info.value.data);
+        });
+    }
+    updateInstrDataFromBuffer(data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let header = structure_models_1.InstrAccountHeaderModel.fromBuffer(data);
+            header.ps /= constants_1.lpDec;
+            const assetTokenDec = (0, utils_1.tokenDec)(this.tokens, header.assetTokenId, this.uiNumbers);
+            const crncyTokenDec = (0, utils_1.tokenDec)(this.tokens, header.crncyTokenId, this.uiNumbers);
+            header.assetTokens /= assetTokenDec;
+            header.crncyTokens /= crncyTokenDec;
+            header.protocolFees /= crncyTokenDec;
+            header.lastAssetTokens /= assetTokenDec;
+            header.lastCrncyTokens /= crncyTokenDec;
+            header.dayAssetTokens /= assetTokenDec;
+            header.dayCrncyTokens /= crncyTokenDec;
+            header.prevDayAssetTokens /= assetTokenDec;
+            header.prevDayCrncyTokens /= crncyTokenDec;
+            header.perpLastTradeAssetTokens /= assetTokenDec;
+            header.perpLastTradeCrncyTokens /= crncyTokenDec;
+            header.perpDayAssetTokens /= assetTokenDec;
+            header.perpDayCrncyTokens /= crncyTokenDec;
+            header.fixingAssetTokens /= assetTokenDec;
+            header.fixingCrncyTokens /= crncyTokenDec;
+            header.perpFundingFunds /= crncyTokenDec;
+            header.perpInsuranceFund /= crncyTokenDec;
+            header.perpOpenInt /= assetTokenDec;
+            header.perpSocLossFunds /= crncyTokenDec;
+            header.perpPrevDayAssetTokens /= assetTokenDec;
+            header.perpPrevDayCrncyTokens /= crncyTokenDec;
+            header.bestBid /= constants_1.dec;
+            header.bestAsk /= constants_1.dec;
+            header.dayHigh /= constants_1.dec;
+            header.dayLow /= constants_1.dec;
+            header.perpBestBid /= constants_1.dec;
+            header.perpBestAsk /= constants_1.dec;
+            header.perpDayHigh /= constants_1.dec;
+            header.perpDayLow /= constants_1.dec;
+            header.lastPx /= constants_1.dec;
+            header.perpUnderlyingPx /= constants_1.dec;
+            header.lastClose /= constants_1.dec;
+            header.fixingPx /= constants_1.dec;
+            header.perpLastClose /= constants_1.dec;
+            header.perpLastPx /= constants_1.dec;
+            header.perpLongSpotPriceForWithdrowal /= constants_1.dec;
+            header.perpShortSpotPriceForWithdrowal /= constants_1.dec;
+            header.poolFees /= crncyTokenDec;
+            let spotBids = [];
+            let spotAsks = [];
+            let perpBids = [];
+            let perpAsks = [];
+            for (let i = 0; i < constants_1.MARKET_DEPTH; ++i) {
+                const offset = structure_models_1.InstrAccountHeaderModel.LENGTH + i * 16;
+                let line = structure_models_1.LineQuotesModel.fromBuffer(data, offset);
+                if (line.px == 0) {
+                    break;
+                }
+                line.px /= constants_1.dec;
+                line.qty /= assetTokenDec;
+                spotBids.push(line);
+            }
+            for (let i = 0; i < constants_1.MARKET_DEPTH; ++i) {
+                const offset = structure_models_1.InstrAccountHeaderModel.LENGTH + i * 16 + 16 * constants_1.MARKET_DEPTH;
+                let line = structure_models_1.LineQuotesModel.fromBuffer(data, offset);
+                if (line.px == 0) {
+                    break;
+                }
+                line.px /= constants_1.dec;
+                line.qty /= assetTokenDec;
+                spotAsks.push(line);
+            }
+            for (let i = 0; i < constants_1.MARKET_DEPTH; ++i) {
+                const offset = structure_models_1.InstrAccountHeaderModel.LENGTH + i * 16 + 16 * constants_1.MARKET_DEPTH * 2;
+                let line = structure_models_1.LineQuotesModel.fromBuffer(data, offset);
+                if (line.px == 0) {
+                    break;
+                }
+                line.px /= constants_1.dec;
+                line.qty /= assetTokenDec;
+                perpBids.push(line);
+            }
+            for (let i = 0; i < constants_1.MARKET_DEPTH; ++i) {
+                const offset = structure_models_1.InstrAccountHeaderModel.LENGTH + i * 16 + 16 * constants_1.MARKET_DEPTH * 3;
+                let line = structure_models_1.LineQuotesModel.fromBuffer(data, offset);
+                if (line.px == 0) {
+                    break;
+                }
+                line.px /= constants_1.dec;
+                line.qty /= assetTokenDec;
+                perpAsks.push(line);
+            }
+            let pattern = buffer_1.Buffer.alloc(16);
+            pattern.writeInt32LE(this.version, 0);
+            pattern.writeInt32LE(enums_1.AccountType.INSTR, 4);
+            pattern.writeInt32LE(header.assetTokenId, 8);
+            pattern.writeInt32LE(header.crncyTokenId, 12);
+            const instrAddress = (yield (0, kit_1.getProgramDerivedAddress)({
+                programAddress: this.programId,
+                seeds: [pattern, (0, kit_1.getAddressEncoder)().encode(this.drvsAuthority)],
+            }))[0];
+            this.instruments.set(header.instrId, {
+                address: instrAddress,
+                header: header,
+                spotBids: spotBids,
+                spotAsks: spotAsks,
+                perpBids: perpBids,
+                perpAsks: perpAsks,
+            });
+        });
+    }
+    // ============================================
+    // CONTEXT BUILDER METHODS
+    // ============================================
+    getSpotContext(instrAccountHeaderModel) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (0, context_builders_1.getSpotContext)(this.getAccountHelperContext(), instrAccountHeaderModel);
+        });
+    }
+    getPerpContext(instrAccountHeaderModel) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (0, context_builders_1.getPerpContext)(this.getAccountHelperContext(), instrAccountHeaderModel);
+        });
+    }
+    getSpotCandles(instrAccountHeaderModel) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (0, context_builders_1.getSpotCandles)(this.getAccountHelperContext(), instrAccountHeaderModel);
+        });
+    }
+    // ============================================
+    // CLIENT DATA QUERY METHODS
+    // ============================================
+    getClientData() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.requireClient();
+            return (0, client_queries_1.getClientData)(this.getClientQueryContext());
+        });
+    }
+    getClientSpotOrdersInfo(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.GetClientSpotOrdersInfoArgsSchema.parse(args);
+            return (0, client_queries_1.getClientSpotOrdersInfo)(this.getClientQueryContext(), args);
+        });
+    }
+    getClientPerpOrdersInfo(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.GetClientPerpOrdersInfoArgsSchema.parse(args);
+            return (0, client_queries_1.getClientPerpOrdersInfo)(this.getClientQueryContext(), args);
+        });
+    }
+    getClientSpotOrders(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.GetClientSpotOrdersArgsSchema.parse(args);
+            return (0, client_queries_1.getClientSpotOrders)(this.getClientQueryContext(), args);
+        });
+    }
+    getClientPerpOrders(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.GetClientPerpOrdersArgsSchema.parse(args);
+            return (0, client_queries_1.getClientPerpOrders)(this.getClientQueryContext(), args);
+        });
+    }
+    // ============================================
+    // DEPOSIT & WITHDRAW INSTRUCTIONS
+    // ============================================
+    depositInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.DepositArgsSchema.parse(args);
+            const exists = yield this.checkClient();
+            return (0, spot_instructions_1.buildDepositInstruction)(this.getSpotInstructionContext(), args, exists, () => this.rpc.getSlot().send());
+        });
+    }
+    withdrawInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.WithdrawArgsSchema.parse(args);
+            yield this.requireClient();
+            return (0, spot_instructions_1.buildWithdrawInstruction)(this.getSpotInstructionContext(), args);
+        });
+    }
+    // ============================================
+    // SPOT TRADING INSTRUCTIONS
+    // ============================================
+    spotLpInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.SpotLpArgsSchema.parse(args);
+            yield this.requireClient();
+            yield this.updateInstrData({ instrId: args.instrId });
+            const instr = this.requireInstrument(args.instrId);
+            return (0, spot_instructions_1.buildSpotLpInstruction)(this.getSpotInstructionContext(), args, instr);
+        });
+    }
+    newSpotOrderInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.NewSpotOrderArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getSpotInstrumentWithUpdate(args.instrId);
+            return (0, spot_instructions_1.buildNewSpotOrderInstruction)(this.getSpotInstructionContext(), args, instr);
+        });
+    }
+    spotQuotesReplaceInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.SpotQuotesReplaceArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getSpotInstrumentWithUpdate(args.instrId);
+            return (0, spot_instructions_1.buildSpotQuotesReplaceInstruction)(this.getSpotInstructionContext(), args, instr);
+        });
+    }
+    spotOrderCancelInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.SpotOrderCancelArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getSpotInstrumentWithUpdate(args.instrId);
+            return (0, spot_instructions_1.buildSpotOrderCancelInstruction)(this.getSpotInstructionContext(), args, instr);
+        });
+    }
+    spotMassCancelInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.SpotMassCancelArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getSpotInstrumentWithUpdate(args.instrId);
+            return (0, spot_instructions_1.buildSpotMassCancelInstruction)(this.getSpotInstructionContext(), args, instr);
+        });
+    }
+    swapInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.SwapArgsSchema.parse(args);
+            const assetTokenId = yield this.getTokenId(args.assetMint);
+            const crncyTokenId = yield this.getTokenId(args.crncyMint);
+            if (assetTokenId === null) {
+                throw new Error('Asset token not found!');
+            }
+            if (crncyTokenId === null) {
+                throw new Error('Crncy token not found!');
+            }
+            const instrId = yield this.getInstrId({ assetTokenId, crncyTokenId });
+            if (instrId === null) {
+                throw new Error('Instruction not found!');
+            }
+            const instr = yield this.getSpotInstrumentWithUpdate(instrId);
+            return (0, spot_instructions_1.buildSwapInstruction)(this.getSpotInstructionContext(), args, instr);
+        });
+    }
+    // ============================================
+    // PERP TRADING INSTRUCTIONS
+    // ============================================
+    upgradeToPerpInstructions(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.InstrIdSchema.parse(args);
+            if (this.signer == null) {
+                throw new Error('Wallet is not connected');
+            }
+            if (this.instruments.get(args.instrId) == null) {
+                throw new Error('Invalid Instr ID');
+            }
+            yield this.updateInstrData({ instrId: args.instrId });
+            const instr = this.requireInstrument(args.instrId);
+            return (0, perp_instructions_1.buildUpgradeToPerpInstructions)(this.getPerpInstructionContext(), args, instr, (size) => this.rpc.getMinimumBalanceForRentExemption(size).send());
+        });
+    }
+    perpDepositInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.PerpDepositArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getPerpInstrumentWithUpdate(args.instrId);
+            return (0, perp_instructions_1.buildPerpDepositInstruction)(this.getPerpInstructionContext(), args, instr);
+        });
+    }
+    perpBuySeatInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.PerpBuySeatArgsSchema.parse(args);
+            yield this.requireClient();
+            yield this.updateInstrData({ instrId: args.instrId });
+            const instr = this.requireInstrument(args.instrId);
+            return (0, perp_instructions_1.buildPerpBuySeatInstruction)(this.getPerpInstructionContext(), args, instr);
+        });
+    }
+    perpSellSeatInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.PerpSellSeatArgsSchema.parse(args);
+            yield this.requireClient();
+            yield this.updateInstrData({ instrId: args.instrId });
+            const instr = this.requireInstrument(args.instrId);
+            return (0, perp_instructions_1.buildPerpSellSeatInstruction)(this.getPerpInstructionContext(), args, instr);
+        });
+    }
+    newPerpOrderInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.NewPerpOrderArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getPerpInstrumentWithUpdate(args.instrId);
+            return (0, perp_instructions_1.buildNewPerpOrderInstruction)(this.getPerpInstructionContext(), args, instr);
+        });
+    }
+    perpQuotesReplaceInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.PerpQuotesReplaceArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getPerpInstrumentWithUpdate(args.instrId);
+            return (0, perp_instructions_1.buildPerpQuotesReplaceInstruction)(this.getPerpInstructionContext(), args, instr);
+        });
+    }
+    perpOrderCancelInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.PerpOrderCancelArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getPerpInstrumentWithUpdate(args.instrId);
+            return (0, perp_instructions_1.buildPerpOrderCancelInstruction)(this.getPerpInstructionContext(), args, instr);
+        });
+    }
+    perpMassCancelInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.PerpMassCancelArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getPerpInstrumentWithUpdate(args.instrId);
+            return (0, perp_instructions_1.buildPerpMassCancelInstruction)(this.getPerpInstructionContext(), args, instr);
+        });
+    }
+    newRefLinkInstruction() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.requireClient();
+            return (0, perp_instructions_1.buildNewRefLinkInstruction)(this.getPerpInstructionContext());
+        });
+    }
+    perpChangeLeverageInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.PerpChangeLeverageArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getPerpInstrumentWithUpdate(args.instrId);
+            return (0, perp_instructions_1.buildPerpChangeLeverageInstruction)(this.getPerpInstructionContext(), args, instr);
+        });
+    }
+    perpStatisticsResetInstruction(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.PerpStatisticsResetArgsSchema.parse(args);
+            yield this.requireClient();
+            const instr = yield this.getPerpInstrumentWithUpdate(args.instrId);
+            return (0, perp_instructions_1.buildPerpStatisticsResetInstruction)(this.getPerpInstructionContext(), args, instr);
+        });
+    }
+    // ============================================
+    // NEW INSTRUMENT INSTRUCTIONS
+    // ============================================
+    newInstrumentInstructions(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            types_1.NewInstrumentArgsSchema.parse(args);
+            if (this.signer == null) {
+                throw new Error('Wallet is not connected');
+            }
+            return (0, perp_instructions_1.buildNewInstrumentInstructions)(this.getPerpInstructionContext(), args, () => this.rpc.getSlot().send(), (address) => this.rpc.getAccountInfo(address).send(), (size) => this.rpc.getMinimumBalanceForRentExemption(size).send());
+        });
+    }
+}
+exports.Engine = Engine;