@deriverse/kit 1.0.38 → 1.0.41

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

@@ -0,0 +1,296 @@
+"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 perp_instructions_1 = require("./perp-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([]),
+    getSpotCandles: vitest_1.vi.fn().mockResolvedValue([]),
+    getPerpContext: vitest_1.vi.fn().mockResolvedValue([
+        { address: 'PerpCtx1111111111111111111111111', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtx2222222222222222222222222', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtx3333333333333333333333333', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtx4444444444444444444444444', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtx5555555555555555555555555', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtx6666666666666666666666666', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtx7777777777777777777777777', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtx8888888888888888888888888', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtx9999999999999999999999999', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtxAAAAAAAAAAAAAAAAAAAAAAAAA', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtxBBBBBBBBBBBBBBBBBBBBBBBBB', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtxCCCCCCCCCCCCCCCCCCCCCCCCC', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtxDDDDDDDDDDDDDDDDDDDDDDDDD', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtxEEEEEEEEEEEEEEEEEEEEEEEEE', role: kit_1.AccountRole.WRITABLE },
+        { address: 'PerpCtxFFFFFFFFFFFFFFFFFFFFFFFFF', role: kit_1.AccountRole.WRITABLE },
+    ]),
+}));
+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(100),
+    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';
+    header.perpClientsCount = 10;
+    header.mask = 0;
+    return {
+        address: `MockInstr${instrId}${'1'.repeat(32 - 9 - instrId.toString().length)}`,
+        header,
+        spotBids: [],
+        spotAsks: [],
+        perpBids: [],
+        perpAsks: [],
+    };
+}
+// Helper to create a mock root state model
+function createMockRootStateModel() {
+    const model = new structure_models_1.RootStateModel();
+    model.tokensCount = 5;
+    model.instrCount = 3;
+    return model;
+}
+// Helper to create a mock context
+function createMockPerpContext(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, rootStateModel: createMockRootStateModel(), uiNumbers: true, signer: 'SignerAddress111111111111111111', rootAccount: 'RootAccount1111111111111111111111', clientPrimaryAccount: 'ClientPrimary11111111111111111', clientCommunityAccount: 'ClientCommunity111111111111111', refClientPrimaryAccount: null, refClientCommunityAccount: null }, overrides);
+}
+(0, vitest_1.describe)('perp instruction builders', () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+    });
+    (0, vitest_1.describe)('buildPerpDepositInstruction', () => {
+        (0, vitest_1.it)('builds perp deposit instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, amount: 100 };
+            const instruction = yield (0, perp_instructions_1.buildPerpDepositInstruction)(ctx, args, instr);
+            (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(11); // perpDeposit instruction tag
+        }));
+        (0, vitest_1.it)('converts amount with uiNumbers', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext({ uiNumbers: true });
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, amount: 1 };
+            const instruction = yield (0, perp_instructions_1.buildPerpDepositInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            // Amount should be multiplied by 10^9 for token with 9 decimals
+        }));
+    });
+    (0, vitest_1.describe)('buildNewPerpOrderInstruction', () => {
+        (0, vitest_1.it)('builds new perp order instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 0, price: 100, qty: 10 };
+            const instruction = yield (0, perp_instructions_1.buildNewPerpOrderInstruction)(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(19); // newPerpOrder instruction tag
+        }));
+        (0, vitest_1.it)('includes IOC flag when provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 1, price: 100, qty: 10, ioc: 1 };
+            const instruction = yield (0, perp_instructions_1.buildNewPerpOrderInstruction)(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 leverage when provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 0, price: 100, qty: 10, leverage: 5 };
+            const instruction = yield (0, perp_instructions_1.buildNewPerpOrderInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.data[2]).toBe(5); // leverage
+        }));
+        (0, vitest_1.it)('includes ref accounts when provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext({
+                refClientPrimaryAccount: 'RefPrimary1111111111111111111111',
+                refClientCommunityAccount: 'RefCommunity11111111111111111111',
+            });
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 0, price: 100, qty: 10 };
+            const instruction = yield (0, perp_instructions_1.buildNewPerpOrderInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction.accounts.length).toBeGreaterThan(20);
+        }));
+    });
+    (0, vitest_1.describe)('buildPerpOrderCancelInstruction', () => {
+        (0, vitest_1.it)('builds perp order cancel instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, side: 0, orderId: 12345 };
+            const instruction = yield (0, perp_instructions_1.buildPerpOrderCancelInstruction)(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(30); // perpOrderCancel instruction tag
+        }));
+    });
+    (0, vitest_1.describe)('buildPerpMassCancelInstruction', () => {
+        (0, vitest_1.it)('builds perp mass cancel instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1 };
+            const instruction = yield (0, perp_instructions_1.buildPerpMassCancelInstruction)(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(36); // perpMassCancel instruction tag
+        }));
+    });
+    (0, vitest_1.describe)('buildPerpChangeLeverageInstruction', () => {
+        (0, vitest_1.it)('builds perp change leverage instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, leverage: 10 };
+            const instruction = yield (0, perp_instructions_1.buildPerpChangeLeverageInstruction)(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(37); // perpChangeLeverage instruction tag
+        }));
+    });
+    (0, vitest_1.describe)('buildNewRefLinkInstruction', () => {
+        (0, vitest_1.it)('builds new ref link instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instruction = yield (0, perp_instructions_1.buildNewRefLinkInstruction)(ctx);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.programAddress).toBe(ctx.programId);
+            (0, vitest_1.expect)(instruction.accounts.length).toBe(3);
+            (0, vitest_1.expect)(instruction.data[0]).toBe(45); // newRefLink instruction tag
+        }));
+    });
+    (0, vitest_1.describe)('buildPerpBuySeatInstruction', () => {
+        (0, vitest_1.it)('builds perp buy seat instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, amount: 100 };
+            const instruction = yield (0, perp_instructions_1.buildPerpBuySeatInstruction)(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(47); // buyMarketSeat instruction tag
+        }));
+        (0, vitest_1.it)('handles slippage parameter', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, amount: 100, slippage: 0.05 };
+            const instruction = yield (0, perp_instructions_1.buildPerpBuySeatInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.data[0]).toBe(47);
+        }));
+        (0, vitest_1.it)('defaults slippage to 0 when not provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, amount: 50 };
+            const instruction = yield (0, perp_instructions_1.buildPerpBuySeatInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+        }));
+    });
+    (0, vitest_1.describe)('buildPerpSellSeatInstruction', () => {
+        (0, vitest_1.it)('builds perp sell seat instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1 };
+            const instruction = yield (0, perp_instructions_1.buildPerpSellSeatInstruction)(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(48); // sellMarketSeat instruction tag
+        }));
+        (0, vitest_1.it)('handles slippage parameter', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1, slippage: 0.1 };
+            const instruction = yield (0, perp_instructions_1.buildPerpSellSeatInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction).toBeDefined();
+            (0, vitest_1.expect)(instruction.data[0]).toBe(48);
+        }));
+    });
+    (0, vitest_1.describe)('buildPerpQuotesReplaceInstruction', () => {
+        (0, vitest_1.it)('builds perp quotes replace instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = {
+                instrId: 1,
+                newBidPrice: 99,
+                newBidQty: 10,
+                bidOrderIdToCancel: 12345,
+                newAskPrice: 101,
+                newAskQty: 10,
+                askOrderIdToCancel: 67890,
+            };
+            const instruction = yield (0, perp_instructions_1.buildPerpQuotesReplaceInstruction)(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(42); // perpQuotesReplace instruction tag
+        }));
+        (0, vitest_1.it)('includes ref accounts when provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext({
+                refClientPrimaryAccount: 'RefPrimary1111111111111111111111',
+                refClientCommunityAccount: 'RefCommunity11111111111111111111',
+            });
+            const instr = ctx.instruments.get(1);
+            const args = {
+                instrId: 1,
+                newBidPrice: 99,
+                newBidQty: 10,
+                bidOrderIdToCancel: 12345,
+                newAskPrice: 101,
+                newAskQty: 10,
+                askOrderIdToCancel: 67890,
+            };
+            const instruction = yield (0, perp_instructions_1.buildPerpQuotesReplaceInstruction)(ctx, args, instr);
+            (0, vitest_1.expect)(instruction.accounts.length).toBeGreaterThan(18);
+        }));
+    });
+    (0, vitest_1.describe)('buildPerpStatisticsResetInstruction', () => {
+        (0, vitest_1.it)('builds perp statistics reset instruction', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockPerpContext();
+            const instr = ctx.instruments.get(1);
+            const args = { instrId: 1 };
+            const instruction = yield (0, perp_instructions_1.buildPerpStatisticsResetInstruction)(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(46); // perpStatisticsReset instruction tag
+        }));
+    });
+});

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

@@ -0,0 +1,52 @@
+import { Address } from '@solana/kit';
+import { Instrument, DepositArgs, WithdrawArgs, SpotLpArgs, NewSpotOrderArgs, SpotQuotesReplaceArgs, SpotOrderCancelArgs, SpotMassCancelArgs, SwapArgs, Instruction } from '../types';
+import { TokenStateModel } from '../structure_models';
+import { AccountHelperContext } from './account-helpers';
+/**
+ * Context needed for spot instruction builders
+ */
+export interface SpotInstructionContext extends AccountHelperContext {
+    instruments: Map<number, Instrument>;
+    tokens: Map<number, TokenStateModel>;
+    uiNumbers: boolean;
+    signer: Address;
+    rootAccount: Address;
+    clientPrimaryAccount: Address;
+    clientCommunityAccount: Address;
+    refClientPrimaryAccount: Address | null;
+    refClientCommunityAccount: Address | null;
+    privateMode: boolean;
+}
+/**
+ * Build deposit instruction
+ */
+declare function buildDepositInstruction(ctx: SpotInstructionContext, args: DepositArgs, exists: boolean, rpcGetSlot: () => Promise<bigint>): Promise<Instruction>;
+/**
+ * Build withdraw instruction
+ */
+declare function buildWithdrawInstruction(ctx: SpotInstructionContext, args: WithdrawArgs): Promise<Instruction>;
+/**
+ * Build spot LP instruction
+ */
+declare function buildSpotLpInstruction(ctx: SpotInstructionContext, args: SpotLpArgs, instr: Instrument): Promise<Instruction>;
+/**
+ * Build new spot order instruction
+ */
+declare function buildNewSpotOrderInstruction(ctx: SpotInstructionContext, args: NewSpotOrderArgs, instr: Instrument): Promise<Instruction>;
+/**
+ * Build spot quotes replace instruction
+ */
+declare function buildSpotQuotesReplaceInstruction(ctx: SpotInstructionContext, args: SpotQuotesReplaceArgs, instr: Instrument): Promise<Instruction>;
+/**
+ * Build spot order cancel instruction
+ */
+declare function buildSpotOrderCancelInstruction(ctx: SpotInstructionContext, args: SpotOrderCancelArgs, instr: Instrument): Promise<Instruction>;
+/**
+ * Build spot mass cancel instruction
+ */
+declare function buildSpotMassCancelInstruction(ctx: SpotInstructionContext, args: SpotMassCancelArgs, instr: Instrument): Promise<Instruction>;
+/**
+ * Build swap instruction
+ */
+declare function buildSwapInstruction(ctx: SpotInstructionContext, args: SwapArgs, instr: Instrument): Promise<Instruction>;
+export { buildDepositInstruction, buildWithdrawInstruction, buildSpotLpInstruction, buildNewSpotOrderInstruction, buildSpotQuotesReplaceInstruction, buildSpotOrderCancelInstruction, buildSpotMassCancelInstruction, buildSwapInstruction, };