@deriverse/kit 1.0.39 → 1.0.41

package/dist/engine/context-builders.test.js

@@ -0,0 +1,156 @@
+"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 context_builders_1 = require("./context-builders");
+const structure_models_1 = require("../structure_models");
+// Mock context for testing
+function createMockContext() {
+    return {
+        rpc: {},
+        programId: 'DRVSvY68xD69Zwwgj9N8hRBu2eXvEzy8eejiVLNYGLti',
+        version: 1,
+        commitment: 'confirmed',
+        drvsAuthority: 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab',
+    };
+}
+// Create a mock instrument header
+function createMockInstrHeader(overrides = {}) {
+    const header = new structure_models_1.InstrAccountHeaderModel();
+    header.instrId = 1;
+    header.assetTokenId = 1;
+    header.crncyTokenId = 0;
+    header.mapsAddress = '11111111111111111111111111111111';
+    header.perpMapsAddress = '22222222222222222222222222222222';
+    Object.assign(header, overrides);
+    return header;
+}
+(0, vitest_1.describe)('context-builders', () => {
+    (0, vitest_1.describe)('getSpotContext', () => {
+        (0, vitest_1.it)('returns array of account metas', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header = createMockInstrHeader();
+            const accounts = yield (0, context_builders_1.getSpotContext)(ctx, header);
+            (0, vitest_1.expect)(Array.isArray(accounts)).toBe(true);
+            (0, vitest_1.expect)(accounts.length).toBe(9); // INSTR + BIDS_TREE + ASKS_TREE + BID_ORDERS + ASK_ORDERS + LINES + MAPS + CLIENT_INFOS + CLIENT_INFOS2
+        }));
+        (0, vitest_1.it)('all accounts are writable', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header = createMockInstrHeader();
+            const accounts = yield (0, context_builders_1.getSpotContext)(ctx, header);
+            accounts.forEach((account) => {
+                (0, vitest_1.expect)(account.role).toBe(kit_1.AccountRole.WRITABLE);
+            });
+        }));
+        (0, vitest_1.it)('includes mapsAddress from header', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const mapsAddress = 'TestMapsAddress111111111111111111';
+            const header = createMockInstrHeader({ mapsAddress });
+            const accounts = yield (0, context_builders_1.getSpotContext)(ctx, header);
+            // mapsAddress should be at index 6 (7th element)
+            (0, vitest_1.expect)(accounts[6].address).toBe(mapsAddress);
+        }));
+        (0, vitest_1.it)('returns consistent accounts for same inputs', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header = createMockInstrHeader();
+            const accounts1 = yield (0, context_builders_1.getSpotContext)(ctx, header);
+            const accounts2 = yield (0, context_builders_1.getSpotContext)(ctx, header);
+            (0, vitest_1.expect)(accounts1.length).toBe(accounts2.length);
+            for (let i = 0; i < accounts1.length; i++) {
+                (0, vitest_1.expect)(accounts1[i].address).toBe(accounts2[i].address);
+                (0, vitest_1.expect)(accounts1[i].role).toBe(accounts2[i].role);
+            }
+        }));
+        (0, vitest_1.it)('returns different accounts for different token pairs', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header1 = createMockInstrHeader({ assetTokenId: 1, crncyTokenId: 0 });
+            const header2 = createMockInstrHeader({ assetTokenId: 2, crncyTokenId: 0 });
+            const accounts1 = yield (0, context_builders_1.getSpotContext)(ctx, header1);
+            const accounts2 = yield (0, context_builders_1.getSpotContext)(ctx, header2);
+            // INSTR address should be different
+            (0, vitest_1.expect)(accounts1[0].address).not.toBe(accounts2[0].address);
+        }));
+    });
+    (0, vitest_1.describe)('getPerpContext', () => {
+        (0, vitest_1.it)('returns array of account metas', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header = createMockInstrHeader();
+            const accounts = yield (0, context_builders_1.getPerpContext)(ctx, header);
+            (0, vitest_1.expect)(Array.isArray(accounts)).toBe(true);
+            // INSTR + BIDS_TREE + ASKS_TREE + BID_ORDERS + ASK_ORDERS + LINES + PERP_MAPS +
+            // CLIENT_INFOS + CLIENT_INFOS2 + CLIENT_INFOS3 + CLIENT_INFOS4 + CLIENT_INFOS5 +
+            // LONG_PX_TREE + SHORT_PX_TREE + REBALANCE_TIME_TREE
+            (0, vitest_1.expect)(accounts.length).toBe(15);
+        }));
+        (0, vitest_1.it)('all accounts are writable', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header = createMockInstrHeader();
+            const accounts = yield (0, context_builders_1.getPerpContext)(ctx, header);
+            accounts.forEach((account) => {
+                (0, vitest_1.expect)(account.role).toBe(kit_1.AccountRole.WRITABLE);
+            });
+        }));
+        (0, vitest_1.it)('includes perpMapsAddress from header', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const perpMapsAddress = 'PerpMapsAddress11111111111111111';
+            const header = createMockInstrHeader({ perpMapsAddress });
+            const accounts = yield (0, context_builders_1.getPerpContext)(ctx, header);
+            // perpMapsAddress should be at index 6 (7th element)
+            (0, vitest_1.expect)(accounts[6].address).toBe(perpMapsAddress);
+        }));
+        (0, vitest_1.it)('has more accounts than spot context', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header = createMockInstrHeader();
+            const spotAccounts = yield (0, context_builders_1.getSpotContext)(ctx, header);
+            const perpAccounts = yield (0, context_builders_1.getPerpContext)(ctx, header);
+            (0, vitest_1.expect)(perpAccounts.length).toBeGreaterThan(spotAccounts.length);
+        }));
+    });
+    (0, vitest_1.describe)('getSpotCandles', () => {
+        (0, vitest_1.it)('returns array of 3 candle accounts', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header = createMockInstrHeader();
+            const accounts = yield (0, context_builders_1.getSpotCandles)(ctx, header);
+            (0, vitest_1.expect)(Array.isArray(accounts)).toBe(true);
+            (0, vitest_1.expect)(accounts.length).toBe(3); // 1M, 15M, DAY candles
+        }));
+        (0, vitest_1.it)('all candle accounts are writable', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header = createMockInstrHeader();
+            const accounts = yield (0, context_builders_1.getSpotCandles)(ctx, header);
+            accounts.forEach((account) => {
+                (0, vitest_1.expect)(account.role).toBe(kit_1.AccountRole.WRITABLE);
+            });
+        }));
+        (0, vitest_1.it)('returns consistent accounts for same inputs', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header = createMockInstrHeader();
+            const accounts1 = yield (0, context_builders_1.getSpotCandles)(ctx, header);
+            const accounts2 = yield (0, context_builders_1.getSpotCandles)(ctx, header);
+            (0, vitest_1.expect)(accounts1.length).toBe(accounts2.length);
+            for (let i = 0; i < accounts1.length; i++) {
+                (0, vitest_1.expect)(accounts1[i].address).toBe(accounts2[i].address);
+            }
+        }));
+        (0, vitest_1.it)('returns different accounts for different token pairs', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const header1 = createMockInstrHeader({ assetTokenId: 1, crncyTokenId: 0 });
+            const header2 = createMockInstrHeader({ assetTokenId: 2, crncyTokenId: 0 });
+            const accounts1 = yield (0, context_builders_1.getSpotCandles)(ctx, header1);
+            const accounts2 = yield (0, context_builders_1.getSpotCandles)(ctx, header2);
+            // All candle addresses should be different
+            (0, vitest_1.expect)(accounts1[0].address).not.toBe(accounts2[0].address);
+            (0, vitest_1.expect)(accounts1[1].address).not.toBe(accounts2[1].address);
+            (0, vitest_1.expect)(accounts1[2].address).not.toBe(accounts2[2].address);
+        }));
+    });
+});

package/dist/engine/index.d.ts

@@ -0,0 +1,101 @@
+import { Address as SolanaAddress, SolanaRpcApiDevnet, SolanaRpcApiMainnet, Base64EncodedDataResponse, Rpc, Commitment } from '@solana/kit';
+import { Instrument, CommunityData, GetClientSpotOrdersInfoResponse, GetClientSpotOrdersArgs, GetClientSpotOrdersResponse, GetClientPerpOrdersInfoResponse, GetClientPerpOrdersArgs, GetClientPerpOrdersResponse, GetClientDataResponse, GetClientSpotOrdersInfoArgs, GetClientPerpOrdersInfoArgs, getInstrAccountByTagArgs, SpotLpArgs, NewSpotOrderArgs, DepositArgs, WithdrawArgs, SpotQuotesReplaceArgs, SpotOrderCancelArgs, SpotMassCancelArgs, InstrId, PerpDepositArgs, NewPerpOrderArgs, PerpQuotesReplaceArgs, PerpOrderCancelArgs, PerpMassCancelArgs, PerpChangeLeverageArgs, PerpStatisticsResetArgs, NewInstrumentArgs, PerpBuySeatArgs, SwapArgs, PerpSellSeatArgs, LogMessage, AccountMeta, Instruction } from '../types';
+import { InstrAccountHeaderModel, RootStateModel, TokenStateModel } from '../structure_models';
+type Address = SolanaAddress<string>;
+/**
+ * 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
+ */
+export declare class Engine {
+    programId: Address;
+    rootAccount: Address;
+    communityAccount: Address;
+    commitment: Commitment;
+    version: number;
+    rootStateModel: RootStateModel;
+    community: CommunityData;
+    tokens: Map<number, TokenStateModel>;
+    instruments: Map<number, Instrument>;
+    originalClientId: number | null;
+    clientLutAddress: Address | null;
+    privateMode: boolean;
+    private rpc;
+    private drvsAuthority;
+    private signer;
+    private clientPrimaryAccount;
+    private clientCommunityAccount;
+    private refClientPrimaryAccount;
+    private refClientCommunityAccount;
+    private uiNumbers;
+    /**
+     * @param rpc @solana/kit rpc
+     */
+    constructor(rpc: Rpc<SolanaRpcApiDevnet> | Rpc<SolanaRpcApiMainnet>, args?: {
+        programId?: Address;
+        version?: number;
+        commitment?: Commitment;
+        uiNumbers?: boolean;
+    });
+    private getAccountHelperContext;
+    private getSpotInstructionContext;
+    private getPerpInstructionContext;
+    private getClientQueryContext;
+    private requireClient;
+    private requireInstrument;
+    private getSpotInstrumentWithUpdate;
+    private getPerpInstrumentWithUpdate;
+    private checkClient;
+    logsDecode(data: readonly string[]): LogMessage[];
+    initialize(): Promise<boolean>;
+    addToken(tokenAccount: Address): Promise<void>;
+    addInstr(instrAccount: Address): Promise<void>;
+    setSigner(signer: Address): Promise<void>;
+    updateCommunityFromBuffer(data: Base64EncodedDataResponse): void;
+    updateCommunity(): Promise<void>;
+    updateRootFromBuffer(data: Base64EncodedDataResponse): void;
+    updateRoot(): Promise<void>;
+    getInstrAccountByTag(args: getInstrAccountByTagArgs): Promise<Address>;
+    getAccountByTag(tag: number): Promise<Address>;
+    getTokenAccount(mint: Address): Promise<Address>;
+    getTokenId(mint: Address): Promise<number | null>;
+    getInstrId(args: {
+        assetTokenId: number;
+        crncyTokenId: number;
+    }): Promise<number | null>;
+    instrLut(args: InstrId): Address;
+    updateInstrData(args: InstrId): Promise<void>;
+    updateInstrDataFromBuffer(data: Base64EncodedDataResponse): Promise<void>;
+    getSpotContext(instrAccountHeaderModel: InstrAccountHeaderModel): Promise<AccountMeta[]>;
+    getPerpContext(instrAccountHeaderModel: InstrAccountHeaderModel): Promise<AccountMeta[]>;
+    getSpotCandles(instrAccountHeaderModel: InstrAccountHeaderModel): Promise<AccountMeta[]>;
+    getClientData(): Promise<GetClientDataResponse>;
+    getClientSpotOrdersInfo(args: GetClientSpotOrdersInfoArgs): Promise<GetClientSpotOrdersInfoResponse>;
+    getClientPerpOrdersInfo(args: GetClientPerpOrdersInfoArgs): Promise<GetClientPerpOrdersInfoResponse>;
+    getClientSpotOrders(args: GetClientSpotOrdersArgs): Promise<GetClientSpotOrdersResponse>;
+    getClientPerpOrders(args: GetClientPerpOrdersArgs): Promise<GetClientPerpOrdersResponse>;
+    depositInstruction(args: DepositArgs): Promise<Instruction>;
+    withdrawInstruction(args: WithdrawArgs): Promise<Instruction>;
+    spotLpInstruction(args: SpotLpArgs): Promise<Instruction>;
+    newSpotOrderInstruction(args: NewSpotOrderArgs): Promise<Instruction>;
+    spotQuotesReplaceInstruction(args: SpotQuotesReplaceArgs): Promise<Instruction>;
+    spotOrderCancelInstruction(args: SpotOrderCancelArgs): Promise<Instruction>;
+    spotMassCancelInstruction(args: SpotMassCancelArgs): Promise<Instruction>;
+    swapInstruction(args: SwapArgs): Promise<Instruction>;
+    upgradeToPerpInstructions(args: InstrId): Promise<Instruction[]>;
+    perpDepositInstruction(args: PerpDepositArgs): Promise<Instruction>;
+    perpBuySeatInstruction(args: PerpBuySeatArgs): Promise<Instruction>;
+    perpSellSeatInstruction(args: PerpSellSeatArgs): Promise<Instruction>;
+    newPerpOrderInstruction(args: NewPerpOrderArgs): Promise<Instruction>;
+    perpQuotesReplaceInstruction(args: PerpQuotesReplaceArgs): Promise<Instruction>;
+    perpOrderCancelInstruction(args: PerpOrderCancelArgs): Promise<Instruction>;
+    perpMassCancelInstruction(args: PerpMassCancelArgs): Promise<Instruction>;
+    newRefLinkInstruction(): Promise<Instruction>;
+    perpChangeLeverageInstruction(args: PerpChangeLeverageArgs): Promise<Instruction>;
+    perpStatisticsResetInstruction(args: PerpStatisticsResetArgs): Promise<Instruction>;
+    newInstrumentInstructions(args: NewInstrumentArgs): Promise<Instruction[]>;
+}
+export {};