@vercora-protocol/sdk 0.0.1 → 0.0.5

package/dist/client.js

@@ -6,6 +6,69 @@ const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
 const pda_1 = require("./pda");
 const types_1 = require("./types");
+/**
+ * Some RPC plans (e.g. QuickNode Discover) reject `getMultipleAccounts` with more than 5 keys.
+ * Chunk so batched reads stay compatible.
+ */
+const GET_MULTIPLE_ACCOUNTS_MAX_KEYS = 5;
+/**
+ * Anchor `BorshAccountsCoder.decode` often returns IDL snake_case keys (`active_stake`);
+ * typed clients expect camelCase (`activeStake`). Reading the wrong shape yields `undefined`
+ * and `.toString()` throws — batched code then silently returned 0 for stakes.
+ */
+function pickDecodedField(obj, camel, snake) {
+    const v = obj[camel] ?? obj[snake];
+    return v;
+}
+function decodedMarketOutcomeLabel(acc) {
+    const v = acc.label ?? acc['label'];
+    if (typeof v === 'string')
+        return v.trim();
+    if (v != null)
+        return String(v).trim();
+    return '';
+}
+/**
+ * Read `MarketOutcome` fields from raw account bytes (8-byte disc + Borsh body).
+ * Matches `programs/vercora/src/state/market_outcome.rs`: u8 vote, u8 bump, Borsh `String` label (u32 len + UTF-8).
+ * Used when IDL/account coders omit or mis-decode `label` so **all** clients see the same text as on-chain.
+ */
+function parseMarketOutcomeAccountLayout(data) {
+    if (data.length < 8 + 2 + 4)
+        return null;
+    const vote = data.readUInt8(8);
+    const strLen = data.readUInt32LE(10);
+    if (strLen > 64 || 14 + strLen > data.length)
+        return null;
+    const label = data.subarray(14, 14 + strLen).toString('utf8').trim();
+    return { resolutionVoteCount: vote, label };
+}
+function decodedParimutuelActiveStakeBn(obj) {
+    const v = pickDecodedField(obj, 'activeStake', 'active_stake');
+    if (v == null)
+        return new anchor_1.BN(0);
+    try {
+        if (typeof v === 'bigint')
+            return new anchor_1.BN(v.toString());
+        if (typeof v === 'number' && Number.isFinite(v))
+            return new anchor_1.BN(Math.trunc(v));
+        return new anchor_1.BN(v.toString());
+    }
+    catch {
+        return new anchor_1.BN(0);
+    }
+}
+/**
+ * Read `active_stake` (u64 LE) from raw account data.
+ * Layout: 8-byte Anchor discriminator, then Borsh: market(32) + user(32) + outcome_index(1) + active_stake(8).
+ * Prefer this over IDL decode for stake-only reads — avoids camelCase/snake_case mismatches in coders.
+ */
+const PARIMUTUEL_POSITION_ACTIVE_STAKE_OFFSET = 8 + 32 + 32 + 1;
+function readParimutuelActiveStakeU64Le(data) {
+    if (data.length < PARIMUTUEL_POSITION_ACTIVE_STAKE_OFFSET + 8)
+        return new anchor_1.BN(0);
+    return new anchor_1.BN(data.readBigUInt64LE(PARIMUTUEL_POSITION_ACTIVE_STAKE_OFFSET).toString());
+}
 class PredictionMarketClient {
     constructor(program) {
         this.program = program;
@@ -15,6 +78,50 @@ class PredictionMarketClient {
     get walletKey() {
         return this.program.provider.wallet.publicKey;
     }
+    /**
+     * Active stake for a pari position: read u64 at fixed Borsh offset (authoritative), then fall back to IDL decode.
+     */
+    decodeParimutuelPositionActiveStake(data) {
+        const buf = Buffer.from(data);
+        if (buf.length >= PARIMUTUEL_POSITION_ACTIVE_STAKE_OFFSET + 8) {
+            return readParimutuelActiveStakeU64Le(buf);
+        }
+        try {
+            const coder = this.program.account.parimutuelPosition?.coder;
+            if (coder?.decode) {
+                const dec = coder.decode(buf);
+                if (dec && typeof dec === 'object') {
+                    return decodedParimutuelActiveStakeBn(dec);
+                }
+            }
+        }
+        catch {
+            /* fall through */
+        }
+        try {
+            const raw = this.program.coder.accounts.decode('ParimutuelPosition', buf);
+            return decodedParimutuelActiveStakeBn(raw);
+        }
+        catch {
+            return new anchor_1.BN(0);
+        }
+    }
+    /**
+     * Same as `Connection.getMultipleAccountsInfo`, but splits into chunks of
+     * {@link GET_MULTIPLE_ACCOUNTS_MAX_KEYS}.
+     * Chunks run **sequentially** so we do not burst the RPC (reduces 429s on free tiers).
+     */
+    async getMultipleAccountsInfoBatched(keys) {
+        if (keys.length === 0)
+            return [];
+        const out = [];
+        for (let i = 0; i < keys.length; i += GET_MULTIPLE_ACCOUNTS_MAX_KEYS) {
+            const chunk = keys.slice(i, i + GET_MULTIPLE_ACCOUNTS_MAX_KEYS);
+            const infos = await this.connection.getMultipleAccountsInfo(chunk);
+            out.push(...infos);
+        }
+        return out;
+    }
     async collateralTokenProgramForMint(mint) {
         const info = await this.connection.getAccountInfo(mint);
         if (!info)
@@ -48,7 +155,7 @@ class PredictionMarketClient {
      */
     async initializeConfig(params, opts) {
         return this.program.methods
-            .initializeConfig(params.secondaryAuthority, params.depositPlatformFeeBps, params.platformTreasuryWallet, params.platformFeeLamports, params.parimutuelPenaltyProtocolShareBps, params.parimutuelWithdrawPlatformFeeBps)
+            .initializeConfig(params.secondaryAuthority, params.depositPlatformFeeBps, params.platformTreasuryWallet, params.platformFeeLamports, params.parimutuelWithdrawPlatformFeeBps)
             .accounts({
             globalConfig: this.globalConfig,
             authority: this.walletKey,
@@ -63,7 +170,7 @@ class PredictionMarketClient {
      */
     async updateConfig(params, opts) {
         return this.program.methods
-            .updateConfig(params.secondaryAuthority, params.depositPlatformFeeBps, params.platformTreasuryWallet, params.platformFeeLamports, params.parimutuelPenaltyProtocolShareBps, params.parimutuelWithdrawPlatformFeeBps)
+            .updateConfig(params.secondaryAuthority, params.depositPlatformFeeBps, params.platformTreasuryWallet, params.platformFeeLamports, params.parimutuelWithdrawPlatformFeeBps)
             .accounts({
             globalConfig: this.globalConfig,
             authority: this.walletKey,
@@ -99,6 +206,33 @@ class PredictionMarketClient {
         })
             .rpc(opts ?? { skipPreflight: true });
     }
+    // ─── Market categories ───────────────────────────────────────────────────────
+    /**
+     * Create a new `MarketCategory` PDA.
+     * `params.categoryId` must equal `globalConfig.nextCategoryId` at call time.
+     */
+    async createMarketCategory(params, opts) {
+        return this.program.methods
+            .createMarketCategory(params.categoryId, params.name)
+            .accounts({
+            globalConfig: this.globalConfig,
+            marketCategory: (0, pda_1.deriveMarketCategory)(this.program.programId, params.categoryId),
+            authority: this.walletKey,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .rpc(opts ?? { skipPreflight: true });
+    }
+    /** Update an existing market category's name and active state. */
+    async updateMarketCategory(params, opts) {
+        return this.program.methods
+            .updateMarketCategory(params.name, params.active)
+            .accounts({
+            globalConfig: this.globalConfig,
+            marketCategory: (0, pda_1.deriveMarketCategory)(this.program.programId, params.categoryId),
+            authority: this.walletKey,
+        })
+            .rpc(opts ?? { skipPreflight: true });
+    }
     // ─── Market creation (3 steps) ──────────────────────────────────────────────
     /**
      * Step 1 — Create Market + Vault.
@@ -126,6 +260,7 @@ class PredictionMarketClient {
             creatorFeeBps: params.creatorFeeBps,
             depositPlatformFeeBps: params.depositPlatformFeeBps,
             numResolvers: params.numResolvers,
+            maxOutcomeInvestment: params.maxOutcomeInvestment ?? new anchor_1.BN(0),
             title: params.title,
             marketType: (0, types_1.toMarketTypeIx)(params.marketType),
         })
@@ -190,7 +325,6 @@ class PredictionMarketClient {
                 marketId: parimutuelStateParams.marketId,
                 earlyWithdrawPenaltyBps: parimutuelStateParams.earlyWithdrawPenaltyBps,
                 penaltyKeptInPoolBps: parimutuelStateParams.penaltyKeptInPoolBps,
-                penaltySurplusCreatorShareBps: parimutuelStateParams.penaltySurplusCreatorShareBps,
             })
                 .accounts({
                 payer: this.walletKey,
@@ -204,6 +338,31 @@ class PredictionMarketClient {
         }
         return await provider.sendAndConfirm(tx, undefined, opts ?? { skipPreflight: true });
     }
+    /**
+     * Initialize `MarketOutcome` PDAs for indices `0..labels.length-1` (creator as payer).
+     */
+    async initializeMarketOutcomeSlots(marketPda, params, opts) {
+        const provider = this.program.provider;
+        const tx = new web3_js_1.Transaction();
+        for (let i = 0; i < params.labels.length; i++) {
+            const label = params.labels[i];
+            const ix = await this.program.methods
+                .initializeMarketOutcome({
+                marketId: params.marketId,
+                outcomeIndex: i,
+                label,
+            })
+                .accounts({
+                payer: this.walletKey,
+                market: marketPda,
+                marketOutcome: (0, pda_1.deriveMarketOutcome)(this.program.programId, marketPda, i),
+                systemProgram: web3_js_1.SystemProgram.programId,
+            })
+                .instruction();
+            tx.add(ix);
+        }
+        return await provider.sendAndConfirm(tx, undefined, opts ?? { skipPreflight: true });
+    }
     /**
      * Step 3 — Initialize 8 Outcome Mints.
      * Decimals are inherited from the collateral mint stored on the market account.
@@ -236,11 +395,14 @@ class PredictionMarketClient {
     /** Length must equal `params.numResolvers` (typically the first N of an 8-slot UI). */
     resolverPubkeys, params, opts) {
         const { marketPda } = await this.createMarket(creator, collateralMint, creatorFeeAccount, params, opts);
+        const labels = params.outcomeLabels ??
+            Array.from({ length: params.outcomeCount }, (_, i) => `Outcome ${i}`);
+        if (labels.length !== params.outcomeCount) {
+            throw new Error('outcomeLabels length must equal outcomeCount');
+        }
+        await this.initializeMarketOutcomeSlots(marketPda, { marketId: params.marketId, labels }, opts);
         if (params.marketType === 'parimutuel') {
-            const gc = await this.fetchGlobalConfig();
             const pi = params.parimutuelInit ?? {};
-            const penaltySurplusCreatorShareBps = pi.penaltySurplusCreatorShareBps ??
-                10000 - gc.parimutuelPenaltyProtocolShareBps;
             await this.initializeMarketResolverSlots(marketPda, {
                 marketId: params.marketId,
                 resolverPubkeys: resolverPubkeys.slice(0, params.numResolvers),
@@ -248,7 +410,6 @@ class PredictionMarketClient {
                 marketId: params.marketId,
                 earlyWithdrawPenaltyBps: pi.earlyWithdrawPenaltyBps ?? 500,
                 penaltyKeptInPoolBps: pi.penaltyKeptInPoolBps ?? 8000,
-                penaltySurplusCreatorShareBps,
             });
         }
         else {
@@ -271,7 +432,6 @@ class PredictionMarketClient {
             marketId: params.marketId,
             earlyWithdrawPenaltyBps: params.earlyWithdrawPenaltyBps,
             penaltyKeptInPoolBps: params.penaltyKeptInPoolBps,
-            penaltySurplusCreatorShareBps: params.penaltySurplusCreatorShareBps,
         })
             .accounts({
             payer: this.walletKey,
@@ -287,15 +447,34 @@ class PredictionMarketClient {
         tx.add(pariIx);
         return await provider.sendAndConfirm(tx, [], opts ?? { commitment: 'confirmed', skipPreflight: true });
     }
+    /**
+     * Update early-exit penalty parameters on an open pari-mutuel pool.
+     * Only callable by the market creator.
+     */
+    async updateParimutuelState(marketPda, params, opts) {
+        return this.program.methods
+            .updateParimutuelState({
+            marketId: params.marketId,
+            earlyWithdrawPenaltyBps: params.earlyWithdrawPenaltyBps,
+            penaltyKeptInPoolBps: params.penaltyKeptInPoolBps,
+        })
+            .accounts({
+            creator: this.walletKey,
+            market: marketPda,
+            parimutuelState: (0, pda_1.deriveParimutuelState)(this.program.programId, marketPda),
+        })
+            .rpc(opts ?? { skipPreflight: true });
+    }
     async parimutuelStake(marketPda, params, opts) {
         const parimutuelState = (0, pda_1.deriveParimutuelState)(this.program.programId, marketPda);
         const market = await this.fetchMarket(marketPda);
         const globalConfig = await this.fetchGlobalConfig();
+        const collateralTokenProgram = await this.collateralTokenProgramForMint(market.collateralMint);
         const position = (0, pda_1.deriveParimutuelPosition)(this.program.programId, marketPda, this.walletKey, params.outcomeIndex);
         const vaultPda = (0, pda_1.deriveVault)(this.program.programId, marketPda);
         const allowedMint = (0, pda_1.deriveAllowedMint)(this.program.programId, market.collateralMint);
-        const userCollateral = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, this.walletKey, false, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
-        const platformTreasuryAta = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, globalConfig.platformTreasury, false, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+        const userCollateral = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, this.walletKey, false, collateralTokenProgram, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+        const platformTreasuryAta = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, globalConfig.platformTreasury, false, collateralTokenProgram, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
         return this.program.methods
             .parimutuelStake({
             marketId: params.marketId,
@@ -315,7 +494,7 @@ class PredictionMarketClient {
             platformTreasuryWallet: globalConfig.platformTreasury,
             platformTreasuryAta,
             allowedMint,
-            collateralTokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+            collateralTokenProgram,
             tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
             systemProgram: web3_js_1.SystemProgram.programId,
         })
@@ -327,8 +506,9 @@ class PredictionMarketClient {
         const position = (0, pda_1.deriveParimutuelPosition)(this.program.programId, marketPda, this.walletKey, params.outcomeIndex);
         const vaultPda = (0, pda_1.deriveVault)(this.program.programId, marketPda);
         const globalConfig = await this.fetchGlobalConfig();
-        const userCollateral = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, this.walletKey, false, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
-        const platformTreasuryAta = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, globalConfig.platformTreasury, false, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+        const collateralTokenProgram = await this.collateralTokenProgramForMint(market.collateralMint);
+        const userCollateral = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, this.walletKey, false, collateralTokenProgram, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+        const platformTreasuryAta = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, globalConfig.platformTreasury, false, collateralTokenProgram, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
         return this.program.methods
             .parimutuelWithdraw({
             marketId: params.marketId,
@@ -347,7 +527,7 @@ class PredictionMarketClient {
             globalConfig: this.globalConfig,
             platformTreasuryWallet: globalConfig.platformTreasury,
             platformTreasuryAta,
-            collateralTokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+            collateralTokenProgram,
             tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
             systemProgram: web3_js_1.SystemProgram.programId,
         })
@@ -356,9 +536,10 @@ class PredictionMarketClient {
     async parimutuelClaim(marketPda, params, opts) {
         const parimutuelState = (0, pda_1.deriveParimutuelState)(this.program.programId, marketPda);
         const market = await this.fetchMarket(marketPda);
+        const collateralTokenProgram = await this.collateralTokenProgramForMint(market.collateralMint);
         const position = (0, pda_1.deriveParimutuelPosition)(this.program.programId, marketPda, this.walletKey, params.outcomeIndex);
         const vaultPda = (0, pda_1.deriveVault)(this.program.programId, marketPda);
-        const userCollateral = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, this.walletKey, false, spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+        const userCollateral = (0, spl_token_1.getAssociatedTokenAddressSync)(market.collateralMint, this.walletKey, false, collateralTokenProgram, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
         return this.program.methods
             .parimutuelClaim({
             marketId: params.marketId,
@@ -372,7 +553,7 @@ class PredictionMarketClient {
             vault: vaultPda,
             collateralMint: market.collateralMint,
             userCollateralAccount: userCollateral,
-            collateralTokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+            collateralTokenProgram,
             tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
         })
             .rpc(opts ?? { skipPreflight: true });
@@ -462,7 +643,7 @@ class PredictionMarketClient {
      */
     async voteResolution(marketPda, params, opts) {
         const votePda = (0, pda_1.deriveResolutionVote)(this.program.programId, marketPda, params.resolverIndex);
-        const tallyPda = (0, pda_1.deriveOutcomeTally)(this.program.programId, marketPda, params.outcomeIndex);
+        const marketOutcomePda = (0, pda_1.deriveMarketOutcome)(this.program.programId, marketPda, params.outcomeIndex);
         return this.program.methods
             .voteResolution({
             marketId: params.marketId,
@@ -474,7 +655,7 @@ class PredictionMarketClient {
             market: marketPda,
             resolver: (0, pda_1.deriveResolver)(this.program.programId, marketPda, params.resolverIndex),
             resolutionVote: votePda,
-            outcomeTally: tallyPda,
+            marketOutcome: marketOutcomePda,
             systemProgram: web3_js_1.SystemProgram.programId,
         })
             .rpc(opts ?? { skipPreflight: true });
@@ -482,7 +663,7 @@ class PredictionMarketClient {
     /** Clears the resolver’s active vote and decrements that outcome’s on-chain tally. */
     async revokeResolutionVote(marketPda, params, opts) {
         const votePda = (0, pda_1.deriveResolutionVote)(this.program.programId, marketPda, params.resolverIndex);
-        const tallyPda = (0, pda_1.deriveOutcomeTally)(this.program.programId, marketPda, params.outcomeIndex);
+        const marketOutcomePda = (0, pda_1.deriveMarketOutcome)(this.program.programId, marketPda, params.outcomeIndex);
         return this.program.methods
             .revokeResolutionVote({
             marketId: params.marketId,
@@ -494,7 +675,7 @@ class PredictionMarketClient {
             market: marketPda,
             resolver: (0, pda_1.deriveResolver)(this.program.programId, marketPda, params.resolverIndex),
             resolutionVote: votePda,
-            outcomeTally: tallyPda,
+            marketOutcome: marketOutcomePda,
         })
             .rpc(opts ?? { skipPreflight: true });
     }
@@ -504,20 +685,20 @@ class PredictionMarketClient {
      * Passes optional per-outcome tally accounts (null if that tally PDA was never created).
      */
     async finalizeResolution(marketPda, params, opts) {
-        const tallies = (0, pda_1.deriveAllOutcomeTallies)(this.program.programId, marketPda);
-        const infos = await Promise.all(tallies.map((p) => this.connection.getAccountInfo(p)));
+        const outcomes = (0, pda_1.deriveAllMarketOutcomes)(this.program.programId, marketPda);
+        const infos = await Promise.all(outcomes.map((p) => this.connection.getAccountInfo(p)));
         return this.program.methods
             .finalizeResolution({ marketId: params.marketId })
             .accounts({
             market: marketPda,
-            outcomeTally0: infos[0] ? tallies[0] : null,
-            outcomeTally1: infos[1] ? tallies[1] : null,
-            outcomeTally2: infos[2] ? tallies[2] : null,
-            outcomeTally3: infos[3] ? tallies[3] : null,
-            outcomeTally4: infos[4] ? tallies[4] : null,
-            outcomeTally5: infos[5] ? tallies[5] : null,
-            outcomeTally6: infos[6] ? tallies[6] : null,
-            outcomeTally7: infos[7] ? tallies[7] : null,
+            marketOutcome0: infos[0] ? outcomes[0] : null,
+            marketOutcome1: infos[1] ? outcomes[1] : null,
+            marketOutcome2: infos[2] ? outcomes[2] : null,
+            marketOutcome3: infos[3] ? outcomes[3] : null,
+            marketOutcome4: infos[4] ? outcomes[4] : null,
+            marketOutcome5: infos[5] ? outcomes[5] : null,
+            marketOutcome6: infos[6] ? outcomes[6] : null,
+            marketOutcome7: infos[7] ? outcomes[7] : null,
         })
             .rpc(opts ?? { skipPreflight: true });
     }
@@ -584,6 +765,29 @@ class PredictionMarketClient {
         })
             .rpc(opts ?? { skipPreflight: true });
     }
+    /**
+     * Abandon an incomplete market and recover all rent (market account + vault).
+     *
+     * Only callable by the market creator while the vault holds zero collateral.
+     * Guards on the program side additionally reject resolved and voided markets.
+     * On success the market and vault accounts are closed and lamports returned to creator.
+     */
+    async abandonMarket(marketPda, params, opts) {
+        const market = await this.fetchMarket(marketPda);
+        const collateralMint = market.collateralMint;
+        const collateralTokenProgram = await this.collateralTokenProgramForMint(collateralMint);
+        return this.program.methods
+            .abandonMarket({ marketId: params.marketId })
+            .accounts({
+            creator: this.walletKey,
+            market: marketPda,
+            vault: (0, pda_1.deriveVault)(this.program.programId, marketPda),
+            collateralMint,
+            collateralTokenProgram,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .rpc(opts ?? { skipPreflight: true });
+    }
     // ─── State readers ───────────────────────────────────────────────────────────
     async fetchGlobalConfig() {
         return this.program.account.globalConfig.fetch(this.globalConfig);
@@ -591,6 +795,23 @@ class PredictionMarketClient {
     async fetchMarket(market) {
         return this.program.account.market.fetch(market);
     }
+    /**
+     * Read `MarketOutcome.label` for each active outcome index (parallel fetches).
+     * Missing accounts yield `Outcome {i+1}` placeholders.
+     */
+    async fetchMarketOutcomeLabels(marketPda, outcomeCount) {
+        return Promise.all(Array.from({ length: outcomeCount }, async (_, i) => {
+            const pda = (0, pda_1.deriveMarketOutcome)(this.program.programId, marketPda, i);
+            try {
+                const acc = (await this.program.account.marketOutcome.fetch(pda));
+                const t = (acc.label ?? '').trim();
+                return t || `Outcome ${i + 1}`;
+            }
+            catch {
+                return `Outcome ${i + 1}`;
+            }
+        }));
+    }
     /** Returns the collateral balance (base units) held in the vault. */
     async fetchVaultBalance(market) {
         const vault = (0, pda_1.deriveVault)(this.program.programId, market);
@@ -604,6 +825,109 @@ class PredictionMarketClient {
         const acc = await (0, spl_token_1.getAccount)(this.connection, ata, undefined, spl_token_1.TOKEN_PROGRAM_ID);
         return acc.amount;
     }
+    /** Fetch a single `MarketCategory` account by its PDA. */
+    async fetchMarketCategory(categoryPda) {
+        return this.program.account.marketCategory.fetch(categoryPda);
+    }
+    /**
+     * Fetch all on-chain `MarketCategory` accounts.
+     * Returns an array sorted by `id` ascending.
+     */
+    async fetchAllMarketCategories() {
+        const rows = await this.program.account.marketCategory.all();
+        return rows
+            .map((r) => ({ pubkey: r.publicKey, account: r.account }))
+            .sort((a, b) => a.account.id.cmp(b.account.id));
+    }
+    /**
+     * Fetch the `ResolutionVote` PDA for a specific resolver slot.
+     * Returns `null` if the account does not exist (resolver has not voted).
+     */
+    async fetchResolutionVote(marketPda, resolverIndex) {
+        const pda = (0, pda_1.deriveResolutionVote)(this.program.programId, marketPda, resolverIndex);
+        const info = await this.connection.getAccountInfo(pda);
+        if (!info)
+            return null;
+        return this.program.coder.accounts.decode('ResolutionVote', Buffer.from(info.data));
+    }
+    /**
+     * Decode all 8 `MarketOutcome` PDAs via chunked `getMultipleAccounts` (QuickNode Discover: max 5 keys/call).
+     * `labels` has length `outcomeCount` (for UI); `resolutionVoteCounts` always has length 8.
+     */
+    async fetchMarketOutcomesSnapshot(marketPda, outcomeCount) {
+        const n = Math.min(8, Math.max(0, outcomeCount));
+        const allPdas = (0, pda_1.deriveAllMarketOutcomes)(this.program.programId, marketPda);
+        const infos = await this.getMultipleAccountsInfoBatched(allPdas);
+        const labels = [];
+        const resolutionVoteCounts = [];
+        for (let i = 0; i < 8; i++) {
+            const info = infos[i];
+            let voteCount = 0;
+            let label = `Outcome ${i + 1}`;
+            if (info) {
+                const buf = Buffer.from(info.data);
+                const layout = parseMarketOutcomeAccountLayout(buf);
+                try {
+                    let acc;
+                    try {
+                        const coder = this.program.account.marketOutcome?.coder;
+                        acc = coder?.decode
+                            ? (coder.decode(buf) ?? {})
+                            : this.program.coder.accounts.decode('MarketOutcome', buf);
+                    }
+                    catch {
+                        acc = this.program.coder.accounts.decode('MarketOutcome', buf);
+                    }
+                    const voteRaw = pickDecodedField(acc, 'resolutionVoteCount', 'resolution_vote_count');
+                    if (voteRaw == null) {
+                        voteCount = layout?.resolutionVoteCount ?? 0;
+                    }
+                    else if (typeof voteRaw === 'number') {
+                        voteCount = Math.floor(voteRaw);
+                    }
+                    else {
+                        voteCount = Number(voteRaw.toString(10));
+                    }
+                    const t = decodedMarketOutcomeLabel(acc);
+                    if (t) {
+                        label = t;
+                    }
+                    else if (layout?.label) {
+                        label = layout.label;
+                    }
+                }
+                catch {
+                    if (layout) {
+                        voteCount = layout.resolutionVoteCount;
+                        if (layout.label)
+                            label = layout.label;
+                    }
+                }
+            }
+            resolutionVoteCounts.push(voteCount);
+            if (i < n)
+                labels.push(label);
+        }
+        return { labels, resolutionVoteCounts };
+    }
+    /**
+     * Fetch the resolver vote tally (resolutionVoteCount) for all 8 outcome slots.
+     * Missing PDAs return 0.
+     */
+    async fetchOutcomeTallyCounts(marketPda) {
+        const { resolutionVoteCounts } = await this.fetchMarketOutcomesSnapshot(marketPda, 8);
+        return resolutionVoteCounts;
+    }
+    /**
+     * Fetch all allowed collateral mints from the platform allowlist.
+     * Returns an array of mint public keys sorted lexicographically.
+     */
+    async fetchAllowedCollateralMints() {
+        const rows = await this.program.account.allowedMint.all();
+        const mints = rows.map((r) => r.account.mint);
+        mints.sort((a, b) => a.toBase58().localeCompare(b.toBase58()));
+        return mints;
+    }
     // ─── User profiles ───────────────────────────────────────────────────────────
     /**
      * Create or update the caller's on-chain user profile.
@@ -676,7 +1000,40 @@ class PredictionMarketClient {
         const info = await this.connection.getAccountInfo(pda);
         if (!info)
             return null;
-        return this.program.account.parimutuelPosition.fetch(pda);
+        const buf = Buffer.from(info.data);
+        const activeStakeFromLayout = readParimutuelActiveStakeU64Le(buf);
+        let raw;
+        try {
+            const coder = this.program.account.parimutuelPosition?.coder;
+            raw = coder?.decode
+                ? (coder.decode(buf) ?? {})
+                : this.program.coder.accounts.decode('ParimutuelPosition', buf);
+        }
+        catch {
+            return null;
+        }
+        const activeStake = buf.length >= PARIMUTUEL_POSITION_ACTIVE_STAKE_OFFSET + 8
+            ? activeStakeFromLayout
+            : decodedParimutuelActiveStakeBn(raw);
+        return { ...raw, activeStake };
+    }
+    /**
+     * All parimutuel position PDAs for this user via chunked `getMultipleAccounts` (see plan limits).
+     */
+    async fetchParimutuelActiveStakesBatch(market, user, outcomeCount) {
+        const n = Math.max(0, outcomeCount);
+        const pdas = Array.from({ length: n }, (_, i) => (0, pda_1.deriveParimutuelPosition)(this.program.programId, market, user, i));
+        const infos = await this.getMultipleAccountsInfoBatched(pdas);
+        return infos.map((info) => {
+            if (!info)
+                return new anchor_1.BN(0);
+            try {
+                return this.decodeParimutuelPositionActiveStake(info.data);
+            }
+            catch {
+                return new anchor_1.BN(0);
+            }
+        });
     }
     /**
      * Fetch outcome token balances (base units) for all active outcomes for a user in a
@@ -722,13 +1079,28 @@ class PredictionMarketClient {
      */
     async fetchAllResolvers(market, numResolvers) {
         const pdas = Array.from({ length: numResolvers }, (_, i) => (0, pda_1.deriveResolver)(this.program.programId, market, i));
-        const infos = await Promise.all(pdas.map((p) => this.connection.getAccountInfo(p)));
-        const results = await Promise.all(pdas.map(async (pda, i) => {
-            if (!infos[i])
-                return null;
-            const acc = (await this.program.account.resolver.fetch(pda));
-            return { index: i, resolverPubkey: acc.resolverPubkey };
-        }));
+        const infos = await this.getMultipleAccountsInfoBatched(pdas);
+        const results = [];
+        for (let i = 0; i < numResolvers; i++) {
+            const info = infos[i];
+            if (!info) {
+                results.push(null);
+                continue;
+            }
+            try {
+                const acc = this.program.coder.accounts.decode('Resolver', Buffer.from(info.data));
+                const resolverPubkey = pickDecodedField(acc, 'resolverPubkey', 'resolver_pubkey');
+                if (!resolverPubkey) {
+                    results.push(null);
+                }
+                else {
+                    results.push({ index: i, resolverPubkey });
+                }
+            }
+            catch {
+                results.push(null);
+            }
+        }
         return results.filter((r) => r !== null);
     }
     // ─── Internal ────────────────────────────────────────────────────────────────