@deriverse/kit 1.0.38 → 1.0.41

package/dist/engine/spot-instructions.js

@@ -0,0 +1,376 @@
+"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.buildDepositInstruction = buildDepositInstruction;
+exports.buildWithdrawInstruction = buildWithdrawInstruction;
+exports.buildSpotLpInstruction = buildSpotLpInstruction;
+exports.buildNewSpotOrderInstruction = buildNewSpotOrderInstruction;
+exports.buildSpotQuotesReplaceInstruction = buildSpotQuotesReplaceInstruction;
+exports.buildSpotOrderCancelInstruction = buildSpotOrderCancelInstruction;
+exports.buildSpotMassCancelInstruction = buildSpotMassCancelInstruction;
+exports.buildSwapInstruction = buildSwapInstruction;
+const kit_1 = require("@solana/kit");
+const enums_1 = require("../types/enums");
+const constants_1 = require("../constants");
+const utils_1 = require("./utils");
+const instruction_models_1 = require("../instruction_models");
+const account_helpers_1 = require("./account-helpers");
+const context_builders_1 = require("./context-builders");
+/**
+ * Build deposit instruction
+ */
+function buildDepositInstruction(ctx, args, exists, rpcGetSlot) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const amount = (_a = args.amount) !== null && _a !== void 0 ? _a : 0;
+        const allFunds = args.all_funds ? 1 : 0;
+        const token = ctx.tokens.get(args.tokenId);
+        if (!token) {
+            throw new Error(`Token ${args.tokenId} not found`);
+        }
+        const tokenProgramId = (token.mask & 0x80000000) != 0 ? constants_1.TOKEN_2022_PROGRAM_ID : constants_1.TOKEN_PROGRAM_ID;
+        const clientTokenAccount = yield (0, utils_1.findAssociatedTokenAddress)(ctx.signer, tokenProgramId, token.address);
+        const clientPrimaryAccount = yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, ctx.signer);
+        let keys = [
+            { address: ctx.signer, role: kit_1.AccountRole.READONLY_SIGNER },
+            { address: clientTokenAccount, role: kit_1.AccountRole.WRITABLE },
+            { address: token.programAddress, role: kit_1.AccountRole.WRITABLE },
+            { address: token.address, role: kit_1.AccountRole.READONLY },
+            { address: ctx.rootAccount, role: exists ? kit_1.AccountRole.READONLY : kit_1.AccountRole.WRITABLE },
+            { address: yield (0, account_helpers_1.getTokenAccount)(ctx, token.address), role: kit_1.AccountRole.READONLY },
+            { address: clientPrimaryAccount, role: kit_1.AccountRole.WRITABLE },
+            { address: constants_1.SYSTEM_PROGRAM_ID, role: kit_1.AccountRole.READONLY },
+            { address: tokenProgramId, role: kit_1.AccountRole.READONLY },
+        ];
+        if (ctx.privateMode) {
+            keys.push({
+                address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.PRIVATE_CLIENTS),
+                role: kit_1.AccountRole.WRITABLE,
+            });
+        }
+        if (exists) {
+            if (args.tokenId == 0) {
+                keys.push({
+                    address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY),
+                    role: kit_1.AccountRole.WRITABLE,
+                });
+                keys.push({ address: ctx.clientCommunityAccount, role: kit_1.AccountRole.WRITABLE });
+            }
+            return {
+                accounts: keys,
+                programAddress: ctx.programId,
+                data: (0, instruction_models_1.depositData)(7, 0, allFunds, args.tokenId, amount * (0, utils_1.tokenDec)(ctx.tokens, args.tokenId, ctx.uiNumbers), 0, 0),
+            };
+        }
+        else {
+            const slot = Number(yield rpcGetSlot()) - 1;
+            const lutAddress = yield (0, utils_1.getLookupTableAddress)(ctx.signer, slot);
+            const clientCommunityAccount = yield (0, account_helpers_1.findClientCommunityAccount)(ctx, ctx.signer);
+            keys.push({ address: clientCommunityAccount, role: kit_1.AccountRole.WRITABLE });
+            keys.push({ address: lutAddress, role: kit_1.AccountRole.WRITABLE });
+            keys.push({ address: constants_1.ADDRESS_LOOKUP_TABLE_PROGRAM_ID, role: kit_1.AccountRole.WRITABLE });
+            if (args.tokenId == 0) {
+                keys.push({
+                    address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY),
+                    role: kit_1.AccountRole.WRITABLE,
+                });
+                keys.push({ address: clientCommunityAccount, role: kit_1.AccountRole.WRITABLE });
+            }
+            let refId;
+            if (args.refId != null && args.refId != undefined) {
+                refId = args.refId;
+                if (args.refWallet == null) {
+                    throw new Error('Ref Wallet Not Found');
+                }
+                keys.push({
+                    address: yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, args.refWallet),
+                    role: kit_1.AccountRole.WRITABLE,
+                });
+                keys.push({
+                    address: yield (0, account_helpers_1.findClientCommunityAccount)(ctx, args.refWallet),
+                    role: kit_1.AccountRole.WRITABLE,
+                });
+            }
+            else {
+                refId = 0;
+            }
+            return {
+                accounts: keys,
+                programAddress: ctx.programId,
+                data: (0, instruction_models_1.depositData)(7, 0, allFunds, args.tokenId, amount * (0, utils_1.tokenDec)(ctx.tokens, args.tokenId, ctx.uiNumbers), slot, refId),
+            };
+        }
+    });
+}
+/**
+ * Build withdraw instruction
+ */
+function buildWithdrawInstruction(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const token = ctx.tokens.get(args.tokenId);
+        if (!token) {
+            throw new Error(`Token ${args.tokenId} not found`);
+        }
+        const tokenProgramId = (token.mask & 0x80000000) != 0 ? constants_1.TOKEN_2022_PROGRAM_ID : constants_1.TOKEN_PROGRAM_ID;
+        const clientTokenAccount = yield (0, utils_1.findAssociatedTokenAddress)(ctx.signer, tokenProgramId, token.address);
+        let keys = [
+            { address: ctx.signer, role: kit_1.AccountRole.READONLY_SIGNER },
+            { address: clientTokenAccount, role: kit_1.AccountRole.WRITABLE },
+            { address: token.programAddress, role: kit_1.AccountRole.WRITABLE },
+            { address: token.address, role: kit_1.AccountRole.READONLY },
+            { address: ctx.rootAccount, role: kit_1.AccountRole.READONLY },
+            { address: yield (0, account_helpers_1.getTokenAccount)(ctx, token.address), role: kit_1.AccountRole.READONLY },
+            { address: ctx.clientPrimaryAccount, role: kit_1.AccountRole.WRITABLE },
+            { address: constants_1.SYSTEM_PROGRAM_ID, role: kit_1.AccountRole.READONLY },
+            { address: tokenProgramId, role: kit_1.AccountRole.READONLY },
+            { address: ctx.drvsAuthority, role: kit_1.AccountRole.READONLY },
+            { address: constants_1.ASSOCIATED_TOKEN_PROGRAM_ID, role: kit_1.AccountRole.WRITABLE },
+        ];
+        if (args.spot != undefined) {
+            for (let i = 0; i < args.spot.length; ++i) {
+                const instr = ctx.instruments.get(args.spot[i].instrId);
+                if (!instr) {
+                    throw new Error(`Instrument ${args.spot[i].instrId} not found`);
+                }
+                if (instr.header.assetTokenId == args.tokenId || instr.header.crncyTokenId == args.tokenId) {
+                    keys.push({ address: instr.header.mapsAddress, role: kit_1.AccountRole.READONLY });
+                    keys.push({
+                        address: yield (0, account_helpers_1.getInstrAccountByTag)(ctx, {
+                            assetTokenId: instr.header.assetTokenId,
+                            crncyTokenId: instr.header.crncyTokenId,
+                            tag: enums_1.AccountType.SPOT_CLIENT_INFOS,
+                        }),
+                        role: kit_1.AccountRole.READONLY,
+                    });
+                }
+            }
+        }
+        if (args.tokenId == 0) {
+            keys.push({
+                address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY),
+                role: kit_1.AccountRole.WRITABLE,
+            });
+            keys.push({ address: ctx.clientCommunityAccount, role: kit_1.AccountRole.WRITABLE });
+        }
+        return {
+            accounts: keys,
+            programAddress: ctx.programId,
+            data: (0, instruction_models_1.withdrawData)(8, args.tokenId, args.amount * (0, utils_1.tokenDec)(ctx.tokens, args.tokenId, ctx.uiNumbers)),
+        };
+    });
+}
+/**
+ * Build spot LP instruction
+ */
+function buildSpotLpInstruction(ctx, args, instr) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        let keys = [
+            { address: ctx.signer, role: kit_1.AccountRole.READONLY_SIGNER },
+            { address: ctx.rootAccount, role: kit_1.AccountRole.READONLY },
+            {
+                address: yield (0, account_helpers_1.getInstrAccountByTag)(ctx, {
+                    assetTokenId: instr.header.assetTokenId,
+                    crncyTokenId: instr.header.crncyTokenId,
+                    tag: enums_1.AccountType.INSTR,
+                }),
+                role: kit_1.AccountRole.WRITABLE,
+            },
+            { address: ctx.clientPrimaryAccount, role: kit_1.AccountRole.WRITABLE },
+            { address: constants_1.SYSTEM_PROGRAM_ID, role: kit_1.AccountRole.READONLY },
+        ];
+        if (instr.header.assetTokenId == 0) {
+            keys.push({
+                address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY),
+                role: kit_1.AccountRole.WRITABLE,
+            });
+            keys.push({ address: ctx.clientCommunityAccount, role: kit_1.AccountRole.WRITABLE });
+        }
+        const minPrice = (_a = args.minPrice) !== null && _a !== void 0 ? _a : 0;
+        const maxPrice = (_b = args.maxPrice) !== null && _b !== void 0 ? _b : 0;
+        return {
+            accounts: keys,
+            programAddress: ctx.programId,
+            data: (0, instruction_models_1.spotLpData)(14, args.side, args.instrId, Math.round(args.amount * constants_1.lpDec), minPrice * 1000000000, maxPrice * 1000000000),
+        };
+    });
+}
+/**
+ * Build new spot order instruction
+ */
+function buildNewSpotOrderInstruction(ctx, args, instr) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        let buf = (0, instruction_models_1.newSpotOrderData)(12, (_a = args.ioc) !== null && _a !== void 0 ? _a : 0, (_b = args.orderType) !== null && _b !== void 0 ? _b : 0, args.side, args.instrId, Math.round(args.price * 1000000000), Math.round(args.qty * (0, utils_1.tokenDec)(ctx.tokens, instr.header.assetTokenId, ctx.uiNumbers)), ((_c = args.edgePrice) !== null && _c !== void 0 ? _c : 0) * 1000000000);
+        let keys = [
+            { address: ctx.signer, role: kit_1.AccountRole.READONLY_SIGNER },
+            { address: ctx.rootAccount, role: kit_1.AccountRole.READONLY },
+            { address: yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, ctx.signer), role: kit_1.AccountRole.WRITABLE },
+            { address: yield (0, account_helpers_1.findClientCommunityAccount)(ctx, ctx.signer), role: kit_1.AccountRole.WRITABLE },
+            ...(yield (0, context_builders_1.getSpotContext)(ctx, instr.header)),
+            ...(yield (0, context_builders_1.getSpotCandles)(ctx, instr.header)),
+            {
+                address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY),
+                role: instr.header.assetTokenId == 0 ? kit_1.AccountRole.WRITABLE : kit_1.AccountRole.READONLY,
+            },
+            { address: constants_1.SYSTEM_PROGRAM_ID, role: kit_1.AccountRole.READONLY },
+        ];
+        if (ctx.refClientPrimaryAccount != null) {
+            keys.push({ address: ctx.refClientPrimaryAccount, role: kit_1.AccountRole.WRITABLE });
+        }
+        if (ctx.refClientCommunityAccount != null) {
+            keys.push({ address: ctx.refClientCommunityAccount, role: kit_1.AccountRole.WRITABLE });
+        }
+        return { accounts: keys, programAddress: ctx.programId, data: buf };
+    });
+}
+/**
+ * Build spot quotes replace instruction
+ */
+function buildSpotQuotesReplaceInstruction(ctx, args, instr) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let assetTokenDecFactor = (0, utils_1.tokenDec)(ctx.tokens, instr.header.assetTokenId, ctx.uiNumbers);
+        let buf = (0, instruction_models_1.spotQuotesReplaceData)(34, args.instrId, Math.round(args.newBidPrice * 1000000000), Math.round(args.newBidQty * assetTokenDecFactor), args.bidOrderIdToCancel, Math.round(args.newAskPrice * 1000000000), Math.round(args.newAskQty * assetTokenDecFactor), args.askOrderIdToCancel);
+        let keys = [
+            { address: ctx.signer, role: kit_1.AccountRole.READONLY_SIGNER },
+            { address: ctx.rootAccount, role: kit_1.AccountRole.READONLY },
+            { address: yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, ctx.signer), role: kit_1.AccountRole.WRITABLE },
+            { address: yield (0, account_helpers_1.findClientCommunityAccount)(ctx, ctx.signer), role: kit_1.AccountRole.WRITABLE },
+            ...(yield (0, context_builders_1.getSpotContext)(ctx, instr.header)),
+            ...(yield (0, context_builders_1.getSpotCandles)(ctx, instr.header)),
+            {
+                address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY),
+                role: instr.header.assetTokenId == 0 ? kit_1.AccountRole.WRITABLE : kit_1.AccountRole.READONLY,
+            },
+            { address: constants_1.SYSTEM_PROGRAM_ID, role: kit_1.AccountRole.READONLY },
+        ];
+        if (ctx.refClientPrimaryAccount != null) {
+            keys.push({ address: ctx.refClientPrimaryAccount, role: kit_1.AccountRole.WRITABLE });
+        }
+        if (ctx.refClientCommunityAccount != null) {
+            keys.push({ address: ctx.refClientCommunityAccount, role: kit_1.AccountRole.WRITABLE });
+        }
+        return { accounts: keys, programAddress: ctx.programId, data: buf };
+    });
+}
+/**
+ * Build spot order cancel instruction
+ */
+function buildSpotOrderCancelInstruction(ctx, args, instr) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const drvs = instr.header.assetTokenId == 0;
+        let keys = [
+            { address: ctx.signer, role: kit_1.AccountRole.READONLY_SIGNER },
+            { address: ctx.rootAccount, role: kit_1.AccountRole.READONLY },
+            { address: ctx.clientPrimaryAccount, role: kit_1.AccountRole.WRITABLE },
+            ...(yield (0, context_builders_1.getSpotContext)(ctx, instr.header)),
+            {
+                address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY),
+                role: drvs ? kit_1.AccountRole.WRITABLE : kit_1.AccountRole.READONLY,
+            },
+            { address: constants_1.SYSTEM_PROGRAM_ID, role: kit_1.AccountRole.READONLY },
+        ];
+        if (drvs) {
+            keys.push({
+                address: yield (0, account_helpers_1.findClientCommunityAccount)(ctx, ctx.signer),
+                role: kit_1.AccountRole.WRITABLE,
+            });
+        }
+        return {
+            accounts: keys,
+            programAddress: ctx.programId,
+            data: (0, instruction_models_1.spotOrderCancelData)(13, args.side, args.instrId, args.orderId),
+        };
+    });
+}
+/**
+ * Build spot mass cancel instruction
+ */
+function buildSpotMassCancelInstruction(ctx, args, instr) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const drvs = instr.header.assetTokenId == 0;
+        let keys = [
+            { address: ctx.signer, role: kit_1.AccountRole.READONLY_SIGNER },
+            { address: ctx.rootAccount, role: kit_1.AccountRole.READONLY },
+            { address: ctx.clientPrimaryAccount, role: kit_1.AccountRole.WRITABLE },
+            ...(yield (0, context_builders_1.getSpotContext)(ctx, instr.header)),
+            {
+                address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY),
+                role: drvs ? kit_1.AccountRole.WRITABLE : kit_1.AccountRole.READONLY,
+            },
+            { address: constants_1.SYSTEM_PROGRAM_ID, role: kit_1.AccountRole.READONLY },
+        ];
+        if (drvs) {
+            keys.push({
+                address: yield (0, account_helpers_1.findClientCommunityAccount)(ctx, ctx.signer),
+                role: kit_1.AccountRole.WRITABLE,
+            });
+        }
+        return {
+            accounts: keys,
+            programAddress: ctx.programId,
+            data: (0, instruction_models_1.spotMassCancelData)(15, args.instrId),
+        };
+    });
+}
+/**
+ * Build swap instruction
+ */
+function buildSwapInstruction(ctx, args, instr) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const assetTokenId = yield (0, account_helpers_1.getTokenId)(ctx, args.assetMint);
+        const crncyTokenId = yield (0, account_helpers_1.getTokenId)(ctx, args.crncyMint);
+        if (assetTokenId == null) {
+            throw new Error(`Asset token not found for mint ${args.assetMint}`);
+        }
+        if (crncyTokenId == null) {
+            throw new Error(`Currency token not found for mint ${args.crncyMint}`);
+        }
+        const assetTokenAccount = ctx.tokens.get(assetTokenId);
+        const crncyTokenAccount = ctx.tokens.get(crncyTokenId);
+        if (!assetTokenAccount || !crncyTokenAccount) {
+            throw new Error('Token account not found');
+        }
+        const assetTokenProgramId = (assetTokenAccount.mask & 0x80000000) == 0 ? constants_1.TOKEN_PROGRAM_ID : constants_1.TOKEN_2022_PROGRAM_ID;
+        const crncyTokenProgramId = (crncyTokenAccount.mask & 0x80000000) == 0 ? constants_1.TOKEN_PROGRAM_ID : constants_1.TOKEN_2022_PROGRAM_ID;
+        let instrId = yield (0, account_helpers_1.getInstrId)(ctx, { assetTokenId: assetTokenId, crncyTokenId: crncyTokenId });
+        if (instrId === null) {
+            throw new Error('No instruction ID');
+        }
+        const clientAssetTokenAccount = yield (0, utils_1.findAssociatedTokenAddress)(ctx.signer, assetTokenProgramId, args.assetMint);
+        const clientCrncyTokenAccount = yield (0, utils_1.findAssociatedTokenAddress)(ctx.signer, crncyTokenProgramId, args.crncyMint);
+        let buf = (0, instruction_models_1.swapData)(26, args.crncyInput ? 1 : 0, instrId, Math.round(args.limitPrice * 1000000000), Math.round(args.amount *
+            (args.crncyInput
+                ? (0, utils_1.tokenDec)(ctx.tokens, instr.header.crncyTokenId, ctx.uiNumbers)
+                : (0, utils_1.tokenDec)(ctx.tokens, instr.header.assetTokenId, ctx.uiNumbers))));
+        let keys = [
+            { address: ctx.signer, role: kit_1.AccountRole.READONLY_SIGNER },
+            { address: ctx.rootAccount, role: kit_1.AccountRole.READONLY },
+            ...(yield (0, context_builders_1.getSpotContext)(ctx, instr.header)),
+            ...(yield (0, context_builders_1.getSpotCandles)(ctx, instr.header)),
+            { address: yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY), role: kit_1.AccountRole.READONLY },
+            { address: assetTokenAccount.programAddress, role: kit_1.AccountRole.WRITABLE },
+            { address: crncyTokenAccount.programAddress, role: kit_1.AccountRole.WRITABLE },
+            { address: args.assetMint, role: kit_1.AccountRole.READONLY },
+            { address: args.crncyMint, role: kit_1.AccountRole.READONLY },
+            { address: yield (0, account_helpers_1.getTokenAccount)(ctx, args.assetMint), role: kit_1.AccountRole.READONLY },
+            { address: yield (0, account_helpers_1.getTokenAccount)(ctx, args.crncyMint), role: kit_1.AccountRole.READONLY },
+            { address: clientAssetTokenAccount, role: kit_1.AccountRole.WRITABLE },
+            { address: clientCrncyTokenAccount, role: kit_1.AccountRole.WRITABLE },
+            { address: ctx.drvsAuthority, role: kit_1.AccountRole.READONLY },
+            { address: constants_1.SYSTEM_PROGRAM_ID, role: kit_1.AccountRole.READONLY },
+            { address: assetTokenProgramId, role: kit_1.AccountRole.READONLY },
+            { address: crncyTokenProgramId, role: kit_1.AccountRole.READONLY },
+            { address: constants_1.ASSOCIATED_TOKEN_PROGRAM_ID, role: kit_1.AccountRole.READONLY },
+        ];
+        return { accounts: keys, programAddress: ctx.programId, data: buf };
+    });
+}

package/dist/engine/spot-instructions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/engine/spot-instructions.test.js

@@ -0,0 +1,221 @@
+"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 });
+const vitest_1 = require("vitest");
+const kit_1 = require("@solana/kit");
+const spot_instructions_1 = require("./spot-instructions");
+const structure_models_1 = require("../structure_models");
+vitest_1.vi.mock('./account-helpers', () => ({
+    getAccountByTag: vitest_1.vi.fn().mockResolvedValue('MockAccountByTag11111111111111'),
+    getInstrAccountByTag: vitest_1.vi.fn().mockResolvedValue('MockInstrAccount1111111111111'),
+    getTokenAccount: vitest_1.vi.fn().mockResolvedValue('MockTokenAccount111111111111111'),
+    getTokenId: vitest_1.vi.fn().mockResolvedValue(1),
+    getInstrId: vitest_1.vi.fn().mockResolvedValue(1),
+    findClientPrimaryAccount: vitest_1.vi.fn().mockResolvedValue('MockClientPrimary11111111111'),
+    findClientCommunityAccount: vitest_1.vi.fn().mockResolvedValue('MockClientCommunity111111111'),
+}));
+vitest_1.vi.mock('./context-builders', () => ({
+    getSpotContext: vitest_1.vi.fn().mockResolvedValue([
+        { address: 'SpotCtx1111111111111111111111111', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCtx2222222222222222222222222', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCtx3333333333333333333333333', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCtx4444444444444444444444444', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCtx5555555555555555555555555', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCtx6666666666666666666666666', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCtx7777777777777777777777777', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCtx8888888888888888888888888', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCtx9999999999999999999999999', role: kit_1.AccountRole.WRITABLE },
+    ]),
+    getSpotCandles: vitest_1.vi.fn().mockResolvedValue([
+        { address: 'SpotCandles1111111111111111111', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCandles2222222222222222222', role: kit_1.AccountRole.WRITABLE },
+        { address: 'SpotCandles3333333333333333333', role: kit_1.AccountRole.WRITABLE },
+    ]),
+    getPerpContext: vitest_1.vi.fn().mockResolvedValue([]),
+}));
+vitest_1.vi.mock('./utils', () => ({
+    findAssociatedTokenAddress: vitest_1.vi.fn().mockResolvedValue('MockATA1111111111111111111111111'),
+    getLookupTableAddress: vitest_1.vi.fn().mockResolvedValue('MockLUT1111111111111111111111111'),
+    perpSeatReserve: vitest_1.vi.fn().mockReturnValue(0),
+    tokenDec: vitest_1.vi.fn().mockReturnValue(1000000000), // 10^9
+}));
+// Helper to create a mock token
+function createMockToken(id, decimals = 9) {
+    const token = new structure_models_1.TokenStateModel();
+    token.id = id;
+    token.mask = decimals; // decimals stored in lower byte
+    token.address = `MockToken${id}${'1'.repeat(32 - 10 - id.toString().length)}`;
+    token.programAddress = `MockProgramAddress${id}${'1'.repeat(32 - 19 - id.toString().length)}`;
+    return token;
+}
+// Helper to create a mock instrument
+function createMockInstrument(instrId, assetTokenId = 1, crncyTokenId = 0) {
+    const header = new structure_models_1.InstrAccountHeaderModel();
+    header.instrId = instrId;
+    header.assetTokenId = assetTokenId;
+    header.crncyTokenId = crncyTokenId;
+    header.mapsAddress = '11111111111111111111111111111111';
+    header.perpMapsAddress = '22222222222222222222222222222222';
+    return {
+        address: `MockInstr${instrId}${'1'.repeat(32 - 9 - instrId.toString().length)}`,
+        header,
+        spotBids: [],
+        spotAsks: [],
+        perpBids: [],
+        perpAsks: [],
+    };
+}
+// Helper to create a mock context
+function createMockSpotContext(overrides = {}) {
+    const tokens = new Map();
+    tokens.set(0, createMockToken(0, 9)); // DRVS token
+    tokens.set(1, createMockToken(1, 9)); // SOL-like token
+    const instruments = new Map();
+    instruments.set(1, createMockInstrument(1, 1, 0));
+    return Object.assign({ rpc: {}, programId: 'DRVSvY68xD69Zwwgj9N8hRBu2eXvEzy8eejiVLNYGLti', version: 1, commitment: 'confirmed', drvsAuthority: 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab', instruments,
+        tokens, uiNumbers: true, signer: 'SignerAddress111111111111111111', rootAccount: 'RootAccount1111111111111111111111', clientPrimaryAccount: 'ClientPrimary11111111111111111', clientCommunityAccount: 'ClientCommunity111111111111111', refClientPrimaryAccount: null, refClientCommunityAccount: null, privateMode: false }, overrides);
+}
+(0, vitest_1.describe)('spot instruction builders', () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+    });
+    (0, vitest_1.describe)('buildDepositInstruction', () => {
+        (0, vitest_1.it)('builds deposit instruction for existing account', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const args = { tokenId: 1, amount: 100 };
+            const rpcGetSlot = vitest_1.vi.fn().mockResolvedValue(BigInt(12345));
+            const instruction = yield (0, spot_instructions_1.buildDepositInstruction)(ctx, args, true, rpcGetSlot);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.programAddress).toBe(ctx.programId);
+            (0, vitest_1.expect)(instruction.accounts).toBeDefined();
+            (0, vitest_1.expect)(instruction.accounts.length).toBeGreaterThan(0);
+            (0, vitest_1.expect)(instruction.data).toBeInstanceOf(Uint8Array);
+            (0, vitest_1.expect)(instruction.data[0]).toBe(7); // deposit instruction tag
+        }));
+        (0, vitest_1.it)('builds deposit instruction for new account', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const args = { tokenId: 1, amount: 50 };
+            const rpcGetSlot = vitest_1.vi.fn().mockResolvedValue(BigInt(12345));
+            const instruction = yield (0, spot_instructions_1.buildDepositInstruction)(ctx, args, false, rpcGetSlot);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.programAddress).toBe(ctx.programId);
+            (0, vitest_1.expect)(instruction.accounts.length).toBeGreaterThan(0);
+            (0, vitest_1.expect)(rpcGetSlot).toHaveBeenCalled();
+        }));
+        (0, vitest_1.it)('includes private mode account when enabled', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext({ privateMode: true });
+            const args = { tokenId: 1, amount: 100 };
+            const rpcGetSlot = vitest_1.vi.fn().mockResolvedValue(BigInt(12345));
+            const instruction = yield (0, spot_instructions_1.buildDepositInstruction)(ctx, args, true, rpcGetSlot);
+            (0, vitest_1.expect)(instruction.accounts.length).toBeGreaterThan(9);
+        }));
+        (0, vitest_1.it)('handles all_funds flag', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const args = { tokenId: 1, amount: 0, all_funds: true };
+            const rpcGetSlot = vitest_1.vi.fn().mockResolvedValue(BigInt(12345));
+            const instruction = yield (0, spot_instructions_1.buildDepositInstruction)(ctx, args, true, rpcGetSlot);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.data[2]).toBe(1); // all_funds flag position
+        }));
+    });
+    (0, vitest_1.describe)('buildWithdrawInstruction', () => {
+        (0, vitest_1.it)('builds withdraw instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const args = { tokenId: 1, amount: 50 };
+            const instruction = yield (0, spot_instructions_1.buildWithdrawInstruction)(ctx, args);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.programAddress).toBe(ctx.programId);
+            (0, vitest_1.expect)(instruction.accounts).toBeDefined();
+            (0, vitest_1.expect)(instruction.accounts.length).toBeGreaterThan(0);
+            (0, vitest_1.expect)(instruction.data).toBeInstanceOf(Uint8Array);
+            (0, vitest_1.expect)(instruction.data[0]).toBe(8); // withdraw instruction tag
+        }));
+        (0, vitest_1.it)('includes spot instruments when provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const args = {
+                tokenId: 1,
+                amount: 50,
+                spot: [{ instrId: 1 }],
+            };
+            const instruction = yield (0, spot_instructions_1.buildWithdrawInstruction)(ctx, args);
+            (0, vitest_1.expect)(instruction.accounts.length).toBeGreaterThan(11);
+        }));
+    });
+    (0, vitest_1.describe)('buildSpotLpInstruction', () => {
+        (0, vitest_1.it)('builds spot LP instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 0, amount: 100 };
+            const instruction = yield (0, spot_instructions_1.buildSpotLpInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.programAddress).toBe(ctx.programId);
+            (0, vitest_1.expect)(instruction.data[0]).toBe(14); // spotLp instruction tag
+        }));
+        (0, vitest_1.it)('includes price bounds when provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 1, amount: 100, minPrice: 0.9, maxPrice: 1.1 };
+            const instruction = yield (0, spot_instructions_1.buildSpotLpInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+        }));
+    });
+    (0, vitest_1.describe)('buildNewSpotOrderInstruction', () => {
+        (0, vitest_1.it)('builds new spot order instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 0, price: 100, qty: 10 };
+            const instruction = yield (0, spot_instructions_1.buildNewSpotOrderInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.programAddress).toBe(ctx.programId);
+            (0, vitest_1.expect)(instruction.data[0]).toBe(12); // newSpotOrder instruction tag
+        }));
+        (0, vitest_1.it)('includes IOC flag when provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 1, price: 100, qty: 10, ioc: 1 };
+            const instruction = yield (0, spot_instructions_1.buildNewSpotOrderInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.data[1]).toBe(1); // ioc flag
+        }));
+        (0, vitest_1.it)('includes ref accounts when provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext({
+                refClientPrimaryAccount: 'RefPrimary1111111111111111111111',
+                refClientCommunityAccount: 'RefCommunity11111111111111111111',
+            });
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 0, price: 100, qty: 10 };
+            const instruction = yield (0, spot_instructions_1.buildNewSpotOrderInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction.accounts.length).toBeGreaterThan(15);
+        }));
+    });
+    (0, vitest_1.describe)('buildSpotOrderCancelInstruction', () => {
+        (0, vitest_1.it)('builds spot order cancel instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 0, orderId: 12345 };
+            const instruction = yield (0, spot_instructions_1.buildSpotOrderCancelInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.programAddress).toBe(ctx.programId);
+            (0, vitest_1.expect)(instruction.data[0]).toBe(13); // spotOrderCancel instruction tag
+        }));
+    });
+    (0, vitest_1.describe)('buildSpotMassCancelInstruction', () => {
+        (0, vitest_1.it)('builds spot mass cancel instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockSpotContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1 };
+            const instruction = yield (0, spot_instructions_1.buildSpotMassCancelInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.programAddress).toBe(ctx.programId);
+            (0, vitest_1.expect)(instruction.data[0]).toBe(15); // spotMassCancel instruction tag
+        }));
+    });
+});

package/dist/engine/utils.d.ts

@@ -0,0 +1,23 @@
+import { Address, Base64EncodedDataResponse } from '@solana/kit';
+import { OrderModel, TokenStateModel } from '../structure_models';
+/**
+ * Get token decimal factor for UI number conversion
+ */
+export declare function tokenDec(tokens: Map<number, TokenStateModel>, tokenId: number, uiNumbers: boolean): number;
+/**
+ * Get price step between orderbook lines depending on curent price
+ * @param price Current market price
+ * @returns Price step
+ */
+export declare function getSpotPriceStep(price: number): number;
+/**
+ * Get price step between orderbook lines depending on curent price
+ * @param price Current market price
+ * @returns Price step
+ */
+export declare function getPerpPriceStep(price: number): number;
+export declare function perpSeatReserve(activeUsers: number): number;
+export declare function getMultipleSpotOrders(data: Base64EncodedDataResponse, firstEntry: number, clientId: number): Array<OrderModel>;
+export declare function getMultiplePerpOrders(data: Base64EncodedDataResponse, firstEntry: number, clientId: number): Array<OrderModel>;
+export declare function findAssociatedTokenAddress(owner: Address, tokenProgramId: Address, mint: Address): Promise<Address>;
+export declare function getLookupTableAddress(authority: Address, slot: number): Promise<Address>;