@deriverse/kit 1.0.38 → 1.0.41

package/dist/auto_buffer.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 export declare class AutoBuffer {
     buffer: Buffer;
     offset_: number;

package/dist/auto_data.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { Address, Base64EncodedDataResponse } from '@solana/kit';
 export declare class AutoData {
     buffer: Buffer;

package/dist/constants.d.ts

@@ -0,0 +1,12 @@
+export declare const VERSION = 1;
+export declare const PROGRAM_ID: import("@solana/kit").Address<"DRVSpZ2YUYYKgZP8XtLhAGtT1zYSCKzeHfb4DgRnrgqD">;
+export declare const MARKET_DEPTH = 20;
+export declare const ADDRESS_LOOKUP_TABLE_PROGRAM_ID: import("@solana/kit").Address<"AddressLookupTab1e1111111111111111111111111">;
+export declare const SYSTEM_PROGRAM_ID: import("@solana/kit").Address<"11111111111111111111111111111111">;
+export declare const TOKEN_PROGRAM_ID: import("@solana/kit").Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
+export declare const TOKEN_2022_PROGRAM_ID: import("@solana/kit").Address<"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb">;
+export declare const ASSOCIATED_TOKEN_PROGRAM_ID: import("@solana/kit").Address<"ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL">;
+export declare let dec: number;
+export declare let lpDec: number;
+export declare const nullOrder = 65535;
+export declare function setDecimals(uiNumbers: boolean): void;

package/dist/constants.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nullOrder = exports.lpDec = exports.dec = exports.ASSOCIATED_TOKEN_PROGRAM_ID = exports.TOKEN_2022_PROGRAM_ID = exports.TOKEN_PROGRAM_ID = exports.SYSTEM_PROGRAM_ID = exports.ADDRESS_LOOKUP_TABLE_PROGRAM_ID = exports.MARKET_DEPTH = exports.PROGRAM_ID = exports.VERSION = void 0;
+exports.setDecimals = setDecimals;
+const kit_1 = require("@solana/kit");
+exports.VERSION = 1;
+exports.PROGRAM_ID = (0, kit_1.address)('DRVSpZ2YUYYKgZP8XtLhAGtT1zYSCKzeHfb4DgRnrgqD');
+exports.MARKET_DEPTH = 20;
+exports.ADDRESS_LOOKUP_TABLE_PROGRAM_ID = (0, kit_1.address)('AddressLookupTab1e1111111111111111111111111');
+exports.SYSTEM_PROGRAM_ID = (0, kit_1.address)('11111111111111111111111111111111');
+exports.TOKEN_PROGRAM_ID = (0, kit_1.address)('TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA');
+exports.TOKEN_2022_PROGRAM_ID = (0, kit_1.address)('TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb');
+exports.ASSOCIATED_TOKEN_PROGRAM_ID = (0, kit_1.address)('ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL');
+exports.dec = 1000000000;
+exports.lpDec = 10000;
+exports.nullOrder = 0xffff;
+function setDecimals(uiNumbers) {
+    if (!uiNumbers) {
+        exports.dec = 1;
+        exports.lpDec = 1;
+    }
+    else {
+        exports.dec = 1000000000;
+        exports.lpDec = 10000;
+    }
+}

package/dist/engine/account-helpers.d.ts

@@ -0,0 +1,59 @@
+import { Address, Rpc, DataSlice, Commitment, SolanaRpcApiDevnet, SolanaRpcApiMainnet } from '@solana/kit';
+import { getInstrAccountByTagArgs } from '../types';
+/**
+ * Context needed for account helper functions
+ */
+export interface AccountHelperContext {
+    rpc: Rpc<SolanaRpcApiDevnet> | Rpc<SolanaRpcApiMainnet>;
+    programId: Address;
+    version: number;
+    commitment: Commitment;
+    drvsAuthority: Address;
+}
+/**
+ * Get program-derived account address by tag
+ */
+declare function getAccountByTag(ctx: AccountHelperContext, tag: number): Promise<Address>;
+/**
+ * Get instrument account address by tag and token IDs
+ */
+declare function getInstrAccountByTag(ctx: AccountHelperContext, args: getInstrAccountByTagArgs): Promise<Address>;
+/**
+ * Get token account address for a mint
+ */
+declare function getTokenAccount(ctx: AccountHelperContext, mint: Address): Promise<Address>;
+/**
+ * Get Token ID from mint public key if this token registered on Deriverse
+ */
+declare function getTokenId(ctx: AccountHelperContext, mint: Address): Promise<number | null>;
+/**
+ * Get instrument ID if this instrument registered on Deriverse
+ */
+declare function getInstrId(ctx: AccountHelperContext, args: {
+    assetTokenId: number;
+    crncyTokenId: number;
+}): Promise<number | null>;
+/**
+ * Find accounts by tag (used during initialization)
+ */
+declare function findAccountsByTag(ctx: AccountHelperContext, tag: number, dataSlice?: DataSlice): Promise<Readonly<{
+    account: Readonly<{
+        executable: boolean;
+        lamports: import("@solana/kit").Lamports;
+        owner: Address;
+        rentEpoch: bigint;
+        space: bigint;
+    }> & Readonly<{
+        data: import("@solana/kit").Base64EncodedDataResponse;
+    }>;
+    pubkey: Address;
+}>[]>;
+/**
+ * Find client primary account PDA
+ */
+declare function findClientPrimaryAccount(ctx: Pick<AccountHelperContext, 'programId' | 'version'>, signer: Address): Promise<Address>;
+/**
+ * Find client community account PDA
+ */
+declare function findClientCommunityAccount(ctx: Pick<AccountHelperContext, 'programId' | 'version'>, signer: Address): Promise<Address>;
+export { getAccountByTag, getInstrAccountByTag, getTokenAccount, getTokenId, getInstrId, findAccountsByTag, findClientPrimaryAccount, findClientCommunityAccount, };

package/dist/engine/account-helpers.js

@@ -0,0 +1,177 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAccountByTag = getAccountByTag;
+exports.getInstrAccountByTag = getInstrAccountByTag;
+exports.getTokenAccount = getTokenAccount;
+exports.getTokenId = getTokenId;
+exports.getInstrId = getInstrId;
+exports.findAccountsByTag = findAccountsByTag;
+exports.findClientPrimaryAccount = findClientPrimaryAccount;
+exports.findClientCommunityAccount = findClientCommunityAccount;
+const kit_1 = require("@solana/kit");
+const bs58_1 = __importDefault(require("bs58"));
+const buffer_1 = require("buffer");
+const enums_1 = require("../types/enums");
+const structure_models_1 = require("../structure_models");
+/**
+ * Get program-derived account address by tag
+ */
+function getAccountByTag(ctx, tag) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let buf = buffer_1.Buffer.alloc(8);
+        buf.writeInt32LE(ctx.version, 0);
+        buf.writeInt32LE(tag, 4);
+        const address = (yield (0, kit_1.getProgramDerivedAddress)({
+            programAddress: ctx.programId,
+            seeds: [buf, (0, kit_1.getAddressEncoder)().encode(ctx.drvsAuthority)],
+        }))[0];
+        return address;
+    });
+}
+/**
+ * Get instrument account address by tag and token IDs
+ */
+function getInstrAccountByTag(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let buf = buffer_1.Buffer.alloc(16);
+        buf.writeInt32LE(ctx.version, 0);
+        buf.writeInt32LE(args.tag, 4);
+        buf.writeInt32LE(args.assetTokenId, 8);
+        buf.writeInt32LE(args.crncyTokenId, 12);
+        const address = (yield (0, kit_1.getProgramDerivedAddress)({
+            programAddress: ctx.programId,
+            seeds: [buf, (0, kit_1.getAddressEncoder)().encode(ctx.drvsAuthority)],
+        }))[0];
+        return address;
+    });
+}
+/**
+ * Get token account address for a mint
+ */
+function getTokenAccount(ctx, mint) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let buf = buffer_1.Buffer.from((0, kit_1.getAddressEncoder)().encode(mint).buffer);
+        buf.writeInt32LE(ctx.version, 28);
+        const address = (yield (0, kit_1.getProgramDerivedAddress)({
+            programAddress: ctx.programId,
+            seeds: [buf, (0, kit_1.getAddressEncoder)().encode(ctx.drvsAuthority)],
+        }))[0];
+        return address;
+    });
+}
+/**
+ * Get Token ID from mint public key if this token registered on Deriverse
+ */
+function getTokenId(ctx, mint) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const tokenAddress = yield getTokenAccount(ctx, mint);
+        let info = yield ctx.rpc
+            .getAccountInfo(tokenAddress, {
+            commitment: ctx.commitment,
+            encoding: 'base64',
+            dataSlice: { offset: structure_models_1.TokenStateModel.OFFSET_ID, length: 4 },
+        })
+            .send();
+        if (!info.value) {
+            return null;
+        }
+        else {
+            const data = buffer_1.Buffer.from((0, kit_1.getBase64Encoder)().encode(info.value.data[0]));
+            return data.readUInt32LE(0);
+        }
+    });
+}
+/**
+ * Get instrument ID if this instrument registered on Deriverse
+ */
+function getInstrId(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const instrAddress = yield getInstrAccountByTag(ctx, {
+            assetTokenId: args.assetTokenId,
+            crncyTokenId: args.crncyTokenId,
+            tag: enums_1.AccountType.INSTR,
+        });
+        let info = yield ctx.rpc
+            .getAccountInfo(instrAddress, {
+            commitment: ctx.commitment,
+            encoding: 'base64',
+            dataSlice: { offset: structure_models_1.InstrAccountHeaderModel.OFFSET_INSTR_ID, length: 4 },
+        })
+            .send();
+        if (info.value == null) {
+            return null;
+        }
+        else {
+            const data = buffer_1.Buffer.from((0, kit_1.getBase64Encoder)().encode(info.value.data[0]));
+            return data.readUInt32LE(0);
+        }
+    });
+}
+/**
+ * Find accounts by tag (used during initialization)
+ */
+function findAccountsByTag(ctx, tag, dataSlice) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let tagBuf = buffer_1.Buffer.alloc(8);
+        tagBuf.writeUInt32LE(tag, 0);
+        tagBuf.writeUInt32LE(ctx.version, 4);
+        let accounts = yield ctx.rpc
+            .getProgramAccounts(ctx.programId, {
+            encoding: 'base64',
+            dataSlice: dataSlice,
+            filters: [
+                {
+                    memcmp: {
+                        offset: BigInt(0),
+                        encoding: 'base58',
+                        bytes: bs58_1.default.encode(tagBuf),
+                    },
+                },
+            ],
+        })
+            .send();
+        return accounts;
+    });
+}
+/**
+ * Find client primary account PDA
+ */
+function findClientPrimaryAccount(ctx, signer) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let tagBuf = buffer_1.Buffer.alloc(8);
+        tagBuf.writeUint32LE(ctx.version, 0);
+        tagBuf.writeUint32LE(enums_1.AccountType.CLIENT_PRIMARY, 4);
+        const address = (yield (0, kit_1.getProgramDerivedAddress)({
+            programAddress: ctx.programId,
+            seeds: [tagBuf, (0, kit_1.getAddressEncoder)().encode(signer)],
+        }))[0];
+        return address;
+    });
+}
+/**
+ * Find client community account PDA
+ */
+function findClientCommunityAccount(ctx, signer) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let tagBuf = buffer_1.Buffer.alloc(8);
+        tagBuf.writeUint32LE(ctx.version, 0);
+        tagBuf.writeUint32LE(enums_1.AccountType.CLIENT_COMMUNITY, 4);
+        const address = (yield (0, kit_1.getProgramDerivedAddress)({
+            programAddress: ctx.programId,
+            seeds: [tagBuf, (0, kit_1.getAddressEncoder)().encode(signer)],
+        }))[0];
+        return address;
+    });
+}

package/dist/engine/account-helpers.test.d.ts

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

package/dist/engine/account-helpers.test.js

@@ -0,0 +1,199 @@
+"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 account_helpers_1 = require("./account-helpers");
+const enums_1 = require("../types/enums");
+// Mock context for testing PDA derivation
+function createMockContext(overrides = {}) {
+    return Object.assign({ rpc: {}, programId: 'DRVSvY68xD69Zwwgj9N8hRBu2eXvEzy8eejiVLNYGLti', version: 1, commitment: 'confirmed', drvsAuthority: 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab' }, overrides);
+}
+(0, vitest_1.describe)('account-helpers', () => {
+    (0, vitest_1.describe)('getAccountByTag', () => {
+        (0, vitest_1.it)('returns a valid address', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const address = yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.ROOT);
+            (0, vitest_1.expect)(address).toBeDefined();
+            (0, vitest_1.expect)(typeof address).toBe('string');
+            (0, vitest_1.expect)(address.length).toBeGreaterThan(30);
+        }));
+        (0, vitest_1.it)('returns consistent addresses for same inputs', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const address1 = yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.ROOT);
+            const address2 = yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.ROOT);
+            (0, vitest_1.expect)(address1).toBe(address2);
+        }));
+        (0, vitest_1.it)('returns different addresses for different tags', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const addressRoot = yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.ROOT);
+            const addressCommunity = yield (0, account_helpers_1.getAccountByTag)(ctx, enums_1.AccountType.COMMUNITY);
+            (0, vitest_1.expect)(addressRoot).not.toBe(addressCommunity);
+        }));
+        (0, vitest_1.it)('returns different addresses for different versions', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx1 = createMockContext({ version: 1 });
+            const ctx2 = createMockContext({ version: 2 });
+            const address1 = yield (0, account_helpers_1.getAccountByTag)(ctx1, enums_1.AccountType.ROOT);
+            const address2 = yield (0, account_helpers_1.getAccountByTag)(ctx2, enums_1.AccountType.ROOT);
+            (0, vitest_1.expect)(address1).not.toBe(address2);
+        }));
+        (0, vitest_1.it)('returns different addresses for different drvsAuthority', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx1 = createMockContext({
+                drvsAuthority: 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab',
+            });
+            const ctx2 = createMockContext({
+                drvsAuthority: '11111111111111111111111111111111',
+            });
+            const address1 = yield (0, account_helpers_1.getAccountByTag)(ctx1, enums_1.AccountType.ROOT);
+            const address2 = yield (0, account_helpers_1.getAccountByTag)(ctx2, enums_1.AccountType.ROOT);
+            (0, vitest_1.expect)(address1).not.toBe(address2);
+        }));
+    });
+    (0, vitest_1.describe)('getInstrAccountByTag', () => {
+        (0, vitest_1.it)('returns a valid address', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const address = yield (0, account_helpers_1.getInstrAccountByTag)(ctx, {
+                tag: enums_1.AccountType.INSTR,
+                assetTokenId: 1,
+                crncyTokenId: 0,
+            });
+            (0, vitest_1.expect)(address).toBeDefined();
+            (0, vitest_1.expect)(typeof address).toBe('string');
+            (0, vitest_1.expect)(address.length).toBeGreaterThan(30);
+        }));
+        (0, vitest_1.it)('returns consistent addresses for same inputs', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const args = { tag: enums_1.AccountType.INSTR, assetTokenId: 1, crncyTokenId: 0 };
+            const address1 = yield (0, account_helpers_1.getInstrAccountByTag)(ctx, args);
+            const address2 = yield (0, account_helpers_1.getInstrAccountByTag)(ctx, args);
+            (0, vitest_1.expect)(address1).toBe(address2);
+        }));
+        (0, vitest_1.it)('returns different addresses for different token pairs', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const address1 = yield (0, account_helpers_1.getInstrAccountByTag)(ctx, {
+                tag: enums_1.AccountType.INSTR,
+                assetTokenId: 1,
+                crncyTokenId: 0,
+            });
+            const address2 = yield (0, account_helpers_1.getInstrAccountByTag)(ctx, {
+                tag: enums_1.AccountType.INSTR,
+                assetTokenId: 2,
+                crncyTokenId: 0,
+            });
+            (0, vitest_1.expect)(address1).not.toBe(address2);
+        }));
+        (0, vitest_1.it)('returns different addresses for different tags', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const address1 = yield (0, account_helpers_1.getInstrAccountByTag)(ctx, {
+                tag: enums_1.AccountType.INSTR,
+                assetTokenId: 1,
+                crncyTokenId: 0,
+            });
+            const address2 = yield (0, account_helpers_1.getInstrAccountByTag)(ctx, {
+                tag: enums_1.AccountType.SPOT_BIDS_TREE,
+                assetTokenId: 1,
+                crncyTokenId: 0,
+            });
+            (0, vitest_1.expect)(address1).not.toBe(address2);
+        }));
+    });
+    (0, vitest_1.describe)('getTokenAccount', () => {
+        (0, vitest_1.it)('returns a valid address', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const mint = 'So11111111111111111111111111111111111111112';
+            const address = yield (0, account_helpers_1.getTokenAccount)(ctx, mint);
+            (0, vitest_1.expect)(address).toBeDefined();
+            (0, vitest_1.expect)(typeof address).toBe('string');
+            (0, vitest_1.expect)(address.length).toBeGreaterThan(30);
+        }));
+        (0, vitest_1.it)('returns consistent addresses for same mint', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const mint = 'So11111111111111111111111111111111111111112';
+            const address1 = yield (0, account_helpers_1.getTokenAccount)(ctx, mint);
+            const address2 = yield (0, account_helpers_1.getTokenAccount)(ctx, mint);
+            (0, vitest_1.expect)(address1).toBe(address2);
+        }));
+        (0, vitest_1.it)('returns different addresses for different mints', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const mint1 = 'So11111111111111111111111111111111111111112';
+            const mint2 = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
+            const address1 = yield (0, account_helpers_1.getTokenAccount)(ctx, mint1);
+            const address2 = yield (0, account_helpers_1.getTokenAccount)(ctx, mint2);
+            (0, vitest_1.expect)(address1).not.toBe(address2);
+        }));
+    });
+    (0, vitest_1.describe)('findClientPrimaryAccount', () => {
+        (0, vitest_1.it)('returns a valid address', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const signer = 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab';
+            const address = yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, signer);
+            (0, vitest_1.expect)(address).toBeDefined();
+            (0, vitest_1.expect)(typeof address).toBe('string');
+            (0, vitest_1.expect)(address.length).toBeGreaterThan(30);
+        }));
+        (0, vitest_1.it)('returns consistent addresses for same signer', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const signer = 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab';
+            const address1 = yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, signer);
+            const address2 = yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, signer);
+            (0, vitest_1.expect)(address1).toBe(address2);
+        }));
+        (0, vitest_1.it)('returns different addresses for different signers', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const signer1 = 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab';
+            const signer2 = '11111111111111111111111111111111';
+            const address1 = yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, signer1);
+            const address2 = yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, signer2);
+            (0, vitest_1.expect)(address1).not.toBe(address2);
+        }));
+        (0, vitest_1.it)('only requires programId and version from context', () => __awaiter(void 0, void 0, void 0, function* () {
+            // findClientPrimaryAccount uses Pick<AccountHelperContext, 'programId' | 'version'>
+            const minimalCtx = {
+                programId: 'DRVSvY68xD69Zwwgj9N8hRBu2eXvEzy8eejiVLNYGLti',
+                version: 1,
+            };
+            const signer = 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab';
+            const address = yield (0, account_helpers_1.findClientPrimaryAccount)(minimalCtx, signer);
+            (0, vitest_1.expect)(address).toBeDefined();
+        }));
+    });
+    (0, vitest_1.describe)('findClientCommunityAccount', () => {
+        (0, vitest_1.it)('returns a valid address', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const signer = 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab';
+            const address = yield (0, account_helpers_1.findClientCommunityAccount)(ctx, signer);
+            (0, vitest_1.expect)(address).toBeDefined();
+            (0, vitest_1.expect)(typeof address).toBe('string');
+            (0, vitest_1.expect)(address.length).toBeGreaterThan(30);
+        }));
+        (0, vitest_1.it)('returns consistent addresses for same signer', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const signer = 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab';
+            const address1 = yield (0, account_helpers_1.findClientCommunityAccount)(ctx, signer);
+            const address2 = yield (0, account_helpers_1.findClientCommunityAccount)(ctx, signer);
+            (0, vitest_1.expect)(address1).toBe(address2);
+        }));
+        (0, vitest_1.it)('returns different addresses for different signers', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const signer1 = 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab';
+            const signer2 = '11111111111111111111111111111111';
+            const address1 = yield (0, account_helpers_1.findClientCommunityAccount)(ctx, signer1);
+            const address2 = yield (0, account_helpers_1.findClientCommunityAccount)(ctx, signer2);
+            (0, vitest_1.expect)(address1).not.toBe(address2);
+        }));
+        (0, vitest_1.it)('returns different address than findClientPrimaryAccount for same signer', () => __awaiter(void 0, void 0, void 0, function* () {
+            const ctx = createMockContext();
+            const signer = 'DRVStQsAKhF8gpz1xLzWyk2Q1HKKF3g21tknXtHpVLab';
+            const primaryAddress = yield (0, account_helpers_1.findClientPrimaryAccount)(ctx, signer);
+            const communityAddress = yield (0, account_helpers_1.findClientCommunityAccount)(ctx, signer);
+            (0, vitest_1.expect)(primaryAddress).not.toBe(communityAddress);
+        }));
+    });
+});

package/dist/engine/client-queries.d.ts

@@ -0,0 +1,36 @@
+import { Address } from '@solana/kit';
+import { Instrument, GetClientSpotOrdersInfoResponse, GetClientSpotOrdersArgs, GetClientSpotOrdersResponse, GetClientPerpOrdersInfoResponse, GetClientPerpOrdersArgs, GetClientPerpOrdersResponse, GetClientDataResponse, GetClientSpotOrdersInfoArgs, GetClientPerpOrdersInfoArgs } from '../types';
+import { TokenStateModel } from '../structure_models';
+import { AccountHelperContext } from './account-helpers';
+/**
+ * Context needed for client query functions
+ */
+export interface ClientQueryContext extends AccountHelperContext {
+    instruments: Map<number, Instrument>;
+    tokens: Map<number, TokenStateModel>;
+    uiNumbers: boolean;
+    clientPrimaryAccount: Address | null;
+    clientCommunityAccount: Address | null;
+    originalClientId: number | null;
+}
+/**
+ * Unpack client accounts
+ */
+declare function getClientData(ctx: ClientQueryContext): Promise<GetClientDataResponse>;
+/**
+ * Get general information about open orders in particular instrument (spot)
+ */
+declare function getClientSpotOrdersInfo(ctx: ClientQueryContext, args: GetClientSpotOrdersInfoArgs): Promise<GetClientSpotOrdersInfoResponse>;
+/**
+ * Get general information about open orders in particular instrument (perp)
+ */
+declare function getClientPerpOrdersInfo(ctx: ClientQueryContext, args: GetClientPerpOrdersInfoArgs): Promise<GetClientPerpOrdersInfoResponse>;
+/**
+ * Get list of open orders (spot) in particular instrument
+ */
+declare function getClientSpotOrders(ctx: ClientQueryContext, args: GetClientSpotOrdersArgs): Promise<GetClientSpotOrdersResponse>;
+/**
+ * Get list of open orders (perp) in particular instrument
+ */
+declare function getClientPerpOrders(ctx: ClientQueryContext, args: GetClientPerpOrdersArgs): Promise<GetClientPerpOrdersResponse>;
+export { getClientData, getClientSpotOrdersInfo, getClientPerpOrdersInfo, getClientSpotOrders, getClientPerpOrders };