@bench.games/conviction-markets 0.1.4 → 0.1.6

package/README.md

@@ -2,297 +2,5 @@
 
 TypeScript SDK for Solana Conviction Markets with encrypted votes using Arcium MPC.
 
-## Overview
-
-Conviction Markets allow users to influence decision-making by staking capital on their preferred option. Vote choices and stake amounts are encrypted on-chain and only revealed when the market creator announces the winning option. Winners can claim yield from the reward pool.
-
-## Installation
-
-```bash
-npm install @bench/conviction-markets @solana/web3.js @coral-xyz/anchor @arcium-hq/client
-```
-
-or with Bun:
-
-```bash
-bun add @bench/conviction-markets @solana/web3.js @coral-xyz/anchor @arcium-hq/client
-```
-
-## Features
-
-- **Encrypted Voting**: User votes and stake amounts remain private using Arcium MPC
-- **Ergonomic API**: Auto-generates computation offsets, nonces, and handles encryption
-- **Type-Safe**: Full TypeScript support with IDL-generated types
-- **Comprehensive**: All program instructions with helper utilities
-
-## Quick Start
-
-```typescript
-import {
-  createMarket,
-  addMarketOption,
-  openMarket,
-  initVoteTokenAccount,
-  mintVoteTokens,
-  buyMarketShares,
-  generateSolanaKeypair,
-  generateX25519Keypair,
-  PROGRAM_ID,
-} from "@bench/conviction-markets";
-import { Connection } from "@solana/web3.js";
-import { AnchorProvider, Wallet } from "@coral-xyz/anchor";
-
-// Setup connection and provider
-const connection = new Connection("https://api.devnet.solana.com");
-const creator = generateSolanaKeypair(); // Or load from file
-const wallet = new Wallet(creator);
-const provider = new AnchorProvider(connection, wallet, {
-  commitment: "confirmed",
-});
-
-// Create a market
-const { signature, marketPda, computationOffset } = await createMarket(
-  provider,
-  {
-    creator,
-    marketIndex: Date.now(), // Use unique index
-    maxOptions: 3,
-    maxShares: 1000,
-    rewardLamports: 1_000_000, // 0.001 SOL
-    timeToStake: 3600, // 1 hour
-    timeToReveal: 600, // 10 minutes
-  }
-);
-
-// Wait for MPC computation to finalize
-await awaitComputationFinalization(provider, computationOffset);
-console.log("Market created:", marketPda.toBase58());
-
-// Add options
-await addMarketOption(provider, {
-  creator,
-  market: marketPda,
-  optionIndex: 1,
-  name: "Option A",
-});
-
-// Open market for trading
-const now = Math.floor(Date.now() / 1000);
-await openMarket(provider, {
-  creator,
-  market: marketPda,
-  openTimestamp: now + 60, // Opens in 60 seconds
-});
-```
-
-## User Participation
-
-```typescript
-import {
-  initVoteTokenAccount,
-  mintVoteTokens,
-  initShareAccount,
-  buyMarketShares,
-  awaitComputationFinalization,
-  generateSolanaKeypair,
-  generateX25519Keypair,
-} from "@bench/conviction-markets";
-
-// Create user keypairs
-const user = generateSolanaKeypair();
-const userX25519 = generateX25519Keypair();
-
-// Initialize vote token account
-const { computationOffset: initOffset } = await initVoteTokenAccount(provider, {
-  signer: user,
-  userX25519Keypair: userX25519,
-});
-await awaitComputationFinalization(provider, initOffset);
-
-// Buy vote tokens with SOL
-const { computationOffset: mintOffset } = await mintVoteTokens(provider, {
-  signer: user,
-  userX25519Keypair: userX25519,
-  amount: 100, // Buy 100 vote tokens
-});
-await awaitComputationFinalization(provider, mintOffset);
-
-// Initialize share account
-await initShareAccount(provider, {
-  signer: user,
-  market: marketPda,
-});
-
-// Buy market shares (amount and option encrypted automatically!)
-const { computationOffset: buyOffset } = await buyMarketShares(provider, {
-  signer: user,
-  userX25519Keypair: userX25519,
-  market: marketPda,
-  amount: 50, // Spend 50 vote tokens
-  selectedOption: 1, // Vote for option 1
-});
-await awaitComputationFinalization(provider, buyOffset);
-```
-
-## Market Resolution & Claims
-
-```typescript
-import {
-  selectOption,
-  revealShares,
-  incrementOptionTally,
-  closeShareAccount,
-  awaitComputationFinalization,
-} from "@bench/conviction-markets";
-
-// Market creator selects winning option
-await selectOption(provider, {
-  authority: creator,
-  market: marketPda,
-  optionIndex: 1,
-});
-
-// Anyone can reveal shares (permissionless)
-const { computationOffset: revealOffset } = await revealShares(provider, {
-  signer: anyKeypair, // Can be anyone
-  owner: user.publicKey,
-  market: marketPda,
-  ownerX25519Keypair: userX25519,
-});
-await awaitComputationFinalization(provider, revealOffset);
-
-// Increment option tally (permissionless)
-await incrementOptionTally(provider, {
-  market: marketPda,
-  owner: user.publicKey,
-  optionIndex: 1,
-});
-
-// User claims yield and closes share account
-await closeShareAccount(provider, {
-  owner: user,
-  market: marketPda,
-  optionIndex: 1, // Option they voted for
-});
-```
-
-## API Reference
-
-### Market Lifecycle
-
-- **`createMarket()`** - Creates a new market with encrypted state
-- **`addMarketOption()`** - Adds a named voting option
-- **`openMarket()`** - Opens market for trading at specified timestamp
-- **`selectOption()`** - Selects the winning option (creator or authority)
-
-### Vote Tokens
-
-- **`initVoteTokenAccount()`** - Initializes encrypted balance account
-- **`mintVoteTokens()`** - Buys vote tokens with SOL (0.001 SOL per token)
-- **`claimVoteTokens()`** - Sells unused vote tokens back for SOL
-
-### Market Shares
-
-- **`initShareAccount()`** - Initializes share account for a market
-- **`buyMarketShares()`** - Purchases shares with encrypted input
-- **`revealShares()`** - Reveals encrypted shares (after staking ends)
-- **`incrementOptionTally()`** - Increments option tally after reveal
-- **`closeShareAccount()`** - Closes account and claims yield (if winner)
-
-### Utilities
-
-- **`generateSolanaKeypair()`** - Generates Solana keypair for signing
-- **`generateX25519Keypair()`** - Generates X25519 keypair for encryption
-- **`deriveMarketPda()`** - Derives market PDA
-- **`deriveVoteTokenAccountPda()`** - Derives vote token account PDA
-- **`deriveShareAccountPda()`** - Derives share account PDA
-- **`deriveOptionPda()`** - Derives option PDA
-
-## Key Concepts
-
-### Two Types of Keypairs
-
-1. **Solana Keypair**: Used for transaction signing and account ownership
-   ```typescript
-   const solanaKeypair = generateSolanaKeypair();
-   ```
-
-2. **X25519 Keypair**: Used for MPC encryption with Arcium
-   ```typescript
-   const x25519Keypair = generateX25519Keypair();
-   ```
-
-### MPC Instructions
-
-Instructions that use encrypted computations return a `computationOffset`. Use the `awaitComputationFinalization` helper to wait for the computation to complete:
-
-```typescript
-import { mintVoteTokens, awaitComputationFinalization } from "@bench/conviction-markets";
-
-const { signature, computationOffset } = await mintVoteTokens(provider, {
-  signer: user,
-  userX25519Keypair,
-  amount: 100,
-});
-
-// Wait for MPC computation to complete
-await awaitComputationFinalization(provider, computationOffset);
-
-// With options
-await awaitComputationFinalization(provider, computationOffset, {
-  commitment: "finalized",
-  programId: customProgramId,
-});
-```
-
-### Automatic Encryption
-
-The SDK handles encryption automatically for `buyMarketShares()`:
-
-```typescript
-// Just pass plain values - SDK encrypts them!
-await buyMarketShares(provider, {
-  signer: user,
-  userX25519Keypair,
-  market: marketPda,
-  amount: 50, // Plain value
-  selectedOption: 1, // Plain value
-});
-```
-
-## Program Information
-
-- **Devnet Program ID**: `bnchXx34qGANGyEL6MxTYdG8iXmUmSPyQFAGhxj1VKn`
-- **Vote Token Price**: 0.001 SOL per token
-- **Arcium Version**: v0.6.3
-
-## Market Flow
-
-1. **Create** market with parameters
-2. **Add** named options (1-indexed)
-3. **Fund** market with SOL for rewards
-4. **Open** market at specified timestamp
-5. **Users mint** vote tokens and buy shares
-6. **Creator selects** winning option
-7. **Shares revealed** and tallied
-8. **Winners claim** proportional yield
-
-## Examples
-
-See the `/scripts` and `/tests` directories in the main repository for complete examples:
-
-- `scripts/test-open-market.ts` - Full market creation flow
-- `tests/conviction.ts` - Comprehensive integration tests
-
-## License
-
-MIT
-
-## Contributing
-
-Contributions are welcome! Please see the main repository for guidelines.
-
-## Links
-
 - [GitHub Repository](https://github.com/arcium/solana-conviction-markets)
 - [Arcium](https://arcium.com/)

package/dist/types/accounts.d.ts

@@ -1,104 +1,16 @@
-import type { PublicKey } from "@solana/web3.js";
-import type { BN } from "@coral-xyz/anchor";
 /**
- * Conviction Market account structure
+ * Account types are now inferred from the Anchor program and exported from utils/accounts.ts
  *
- * Represents a prediction/voting market where users can stake capital
- * on their preferred option with encrypted votes.
- */
-export interface ConvictionMarketAccount {
-    /** Encrypted available shares state */
-    encryptedAvailableShares: Uint8Array[][];
-    /** PDA bump seed */
-    bump: number;
-    /** Market creator's public key */
-    creator: PublicKey;
-    /** Unique market index */
-    index: BN;
-    /** Current number of options added */
-    totalOptions: number;
-    /** Maximum number of options allowed */
-    maxOptions: number;
-    /** Timestamp when market opens for trading */
-    openTimestamp?: BN;
-    /** Duration of staking period in seconds */
-    timeToStake: BN;
-    /** Duration of reveal period in seconds */
-    timeToReveal: BN;
-    /** Selected winning option (if set) */
-    selectedOption?: number;
-    /** Nonce for encrypted state */
-    stateNonce: BN;
-    /** Maximum shares available for purchase */
-    maxShares: BN;
-    /** Reward pool in lamports for winners */
-    rewardLamports: BN;
-    /** Optional authority that can select winning option */
-    selectAuthority?: PublicKey;
-}
-/**
- * Vote Token Account structure
- *
- * Holds a user's encrypted vote token balance.
- * Vote tokens are used to purchase market shares.
- */
-export interface VoteTokenAccountData {
-    /** Encrypted token balance state */
-    encryptedState: Uint8Array[][];
-    /** PDA bump seed */
-    bump: number;
-    /** Account owner's public key */
-    owner: PublicKey;
-    /** Nonce for encrypted state */
-    stateNonce: BN;
-}
-/**
- * Share Account structure
- *
- * Represents a user's encrypted position in a specific market,
- * including the amount of shares and selected option.
- */
-export interface ShareAccountData {
-    /** Encrypted state: [share_amount, selected_option] */
-    encryptedState: Uint8Array[][];
-    /** Nonce for encrypted state */
-    stateNonce: BN;
-    /** PDA bump seed */
-    bump: number;
-    /** Account owner's public key */
-    owner: PublicKey;
-    /** Market this share account is for */
-    market: PublicKey;
-    /** Encrypted state disclosure for analytics */
-    encryptedStateDisclosure: Uint8Array[][];
-    /** Nonce for disclosure state */
-    stateNonceDisclosure: BN;
-    /** Timestamp when shares were purchased */
-    boughtAtTimestamp: BN;
-    /** Revealed share amount (after reveal) */
-    revealedAmount?: BN;
-    /** Revealed option choice (after reveal) */
-    revealedOption?: number;
-    /** Conviction score (amount * time-in-market) */
-    revealedScore?: BN;
-    /** Whether tally has been incremented for this share */
-    totalIncremented: boolean;
-}
-/**
- * Market Option structure
+ * Use the following exports:
+ * - VoteTokenAccountData
+ * - ShareAccountData
+ * - ConvictionMarketAccount
+ * - ConvictionMarketOptionData
+ * - DecryptedVoteTokenBalance
+ * - DecryptedShareAccount
+ * - DecryptedMarketShares
  *
- * Represents a named voting option in a market.
+ * All imported from: @bench.games/conviction-markets (utils/accounts module)
  */
-export interface ConvictionMarketOptionData {
-    /** PDA bump seed */
-    bump: number;
-    /** Market creator's public key */
-    creator: PublicKey;
-    /** Human-readable name of the option */
-    name: string;
-    /** Total shares bought for this option */
-    totalShares?: BN;
-    /** Total conviction score for this option */
-    totalScore?: BN;
-}
+export type { VoteTokenAccountData, ShareAccountData, ConvictionMarketAccount, ConvictionMarketOptionData, DecryptedVoteTokenBalance, DecryptedShareAccount, DecryptedMarketShares, } from "../utils/accounts";
 //# sourceMappingURL=accounts.d.ts.map

package/dist/types/accounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/types/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,wBAAwB,EAAE,UAAU,EAAE,EAAE,CAAC;IACzC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,SAAS,CAAC;IACnB,0BAA0B;IAC1B,KAAK,EAAE,EAAE,CAAC;IACV,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,EAAE,CAAC;IACnB,4CAA4C;IAC5C,WAAW,EAAE,EAAE,CAAC;IAChB,2CAA2C;IAC3C,YAAY,EAAE,EAAE,CAAC;IACjB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,UAAU,EAAE,EAAE,CAAC;IACf,4CAA4C;IAC5C,SAAS,EAAE,EAAE,CAAC;IACd,0CAA0C;IAC1C,cAAc,EAAE,EAAE,CAAC;IACnB,wDAAwD;IACxD,eAAe,CAAC,EAAE,SAAS,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,cAAc,EAAE,UAAU,EAAE,EAAE,CAAC;IAC/B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,gCAAgC;IAChC,UAAU,EAAE,EAAE,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,cAAc,EAAE,UAAU,EAAE,EAAE,CAAC;IAC/B,gCAAgC;IAChC,UAAU,EAAE,EAAE,CAAC;IACf,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,uCAAuC;IACvC,MAAM,EAAE,SAAS,CAAC;IAClB,+CAA+C;IAC/C,wBAAwB,EAAE,UAAU,EAAE,EAAE,CAAC;IACzC,iCAAiC;IACjC,oBAAoB,EAAE,EAAE,CAAC;IACzB,2CAA2C;IAC3C,iBAAiB,EAAE,EAAE,CAAC;IACtB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,EAAE,CAAC;IACpB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,aAAa,CAAC,EAAE,EAAE,CAAC;IACnB,wDAAwD;IACxD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,SAAS,CAAC;IACnB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,CAAC,EAAE,EAAE,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,EAAE,CAAC;CACjB"}
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/types/accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}

package/dist/types/accounts.js

@@ -1,2 +1,16 @@
+/**
+ * Account types are now inferred from the Anchor program and exported from utils/accounts.ts
+ *
+ * Use the following exports:
+ * - VoteTokenAccountData
+ * - ShareAccountData
+ * - ConvictionMarketAccount
+ * - ConvictionMarketOptionData
+ * - DecryptedVoteTokenBalance
+ * - DecryptedShareAccount
+ * - DecryptedMarketShares
+ *
+ * All imported from: @bench.games/conviction-markets (utils/accounts module)
+ */
 export {};
 //# sourceMappingURL=accounts.js.map

package/dist/types/accounts.js.map

@@ -1 +1 @@
-{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/types/accounts.ts"],"names":[],"mappings":""}
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/types/accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/utils/accounts.d.ts

@@ -0,0 +1,191 @@
+import { Program, type AnchorProvider } from "@coral-xyz/anchor";
+import type { PublicKey } from "@solana/web3.js";
+import type { ConvictionMarket } from "../idl/conviction_market";
+/**
+ * Creates a Program instance for the Conviction Market program
+ *
+ * @param provider - Anchor provider
+ * @returns Program instance
+ */
+export declare function createProgram(provider: AnchorProvider): Program<ConvictionMarket>;
+/**
+ * Fetches and decrypts a user's vote token balance
+ *
+ * @param program - Anchor program instance
+ * @param voteTokenAccountPda - PDA of the vote token account
+ * @param userX25519Keypair - User's X25519 keypair for decryption
+ * @returns Decrypted balance and account data
+ * @throws If account doesn't exist or decryption fails
+ */
+export declare function fetchAndDecryptVoteTokenBalance(program: Program<ConvictionMarket>, voteTokenAccountPda: PublicKey, userX25519Keypair: {
+    publicKey: Uint8Array;
+    secretKey: Uint8Array;
+}): Promise<{
+    balance: bigint;
+    account: {
+        encryptedState: number[][];
+        bump: number;
+        owner: PublicKey;
+        stateNonce: import("bn.js");
+    };
+}>;
+export type DecryptedVoteTokenBalance = Awaited<ReturnType<typeof fetchAndDecryptVoteTokenBalance>>;
+/**
+ * Fetches and decrypts a user's share account
+ *
+ * @param program - Anchor program instance
+ * @param shareAccountPda - PDA of the share account
+ * @param userX25519Keypair - User's X25519 keypair for decryption
+ * @returns Decrypted share data and account data
+ * @throws If account doesn't exist or decryption fails
+ */
+export declare function fetchAndDecryptShareAccount(program: Program<ConvictionMarket>, shareAccountPda: PublicKey, userX25519Keypair: {
+    publicKey: Uint8Array;
+    secretKey: Uint8Array;
+}): Promise<{
+    amount: bigint;
+    selectedOption: bigint;
+    account: {
+        encryptedState: number[][];
+        stateNonce: import("bn.js");
+        bump: number;
+        owner: PublicKey;
+        market: PublicKey;
+        encryptedStateDisclosure: number[][];
+        stateNonceDisclosure: import("bn.js");
+        boughtAtTimestamp: import("bn.js");
+        revealedAmount: import("bn.js") | null;
+        revealedOption: number | null;
+        revealedScore: import("bn.js") | null;
+        totalIncremented: boolean;
+    };
+}>;
+export type DecryptedShareAccount = Awaited<ReturnType<typeof fetchAndDecryptShareAccount>>;
+/**
+ * Fetches and decrypts a market's available shares
+ *
+ * @param program - Anchor program instance
+ * @param marketPda - PDA of the conviction market
+ * @param userX25519Keypair - User's X25519 keypair for decryption
+ * @returns Decrypted available shares and account data
+ * @throws If account doesn't exist or decryption fails
+ */
+export declare function fetchAndDecryptMarketShares(program: Program<ConvictionMarket>, marketPda: PublicKey, userX25519Keypair: {
+    publicKey: Uint8Array;
+    secretKey: Uint8Array;
+}): Promise<{
+    availableShares: bigint;
+    account: {
+        encryptedAvailableShares: number[][];
+        bump: number;
+        creator: PublicKey;
+        index: import("bn.js");
+        totalOptions: number;
+        maxOptions: number;
+        openTimestamp: import("bn.js") | null;
+        timeToStake: import("bn.js");
+        timeToReveal: import("bn.js");
+        selectedOption: number | null;
+        stateNonce: import("bn.js");
+        maxShares: import("bn.js");
+        rewardLamports: import("bn.js");
+        selectAuthority: PublicKey | null;
+    };
+}>;
+export type DecryptedMarketShares = Awaited<ReturnType<typeof fetchAndDecryptMarketShares>>;
+/**
+ * Fetches a vote token account without decryption
+ *
+ * @param program - Anchor program instance
+ * @param voteTokenAccountPda - PDA of the vote token account
+ * @returns Vote token account data
+ * @throws If account doesn't exist
+ */
+export declare function fetchVoteTokenAccount(program: Program<ConvictionMarket>, voteTokenAccountPda: PublicKey): Promise<{
+    encryptedState: number[][];
+    bump: number;
+    owner: PublicKey;
+    stateNonce: import("bn.js");
+}>;
+export type VoteTokenAccountData = Awaited<ReturnType<typeof fetchVoteTokenAccount>>;
+/**
+ * Fetches a share account without decryption
+ *
+ * @param program - Anchor program instance
+ * @param shareAccountPda - PDA of the share account
+ * @returns Share account data
+ * @throws If account doesn't exist
+ */
+export declare function fetchShareAccount(program: Program<ConvictionMarket>, shareAccountPda: PublicKey): Promise<{
+    encryptedState: number[][];
+    stateNonce: import("bn.js");
+    bump: number;
+    owner: PublicKey;
+    market: PublicKey;
+    encryptedStateDisclosure: number[][];
+    stateNonceDisclosure: import("bn.js");
+    boughtAtTimestamp: import("bn.js");
+    revealedAmount: import("bn.js") | null;
+    revealedOption: number | null;
+    revealedScore: import("bn.js") | null;
+    totalIncremented: boolean;
+}>;
+export type ShareAccountData = Awaited<ReturnType<typeof fetchShareAccount>>;
+/**
+ * Fetches a conviction market account
+ *
+ * @param program - Anchor program instance
+ * @param marketPda - PDA of the conviction market
+ * @returns Conviction market account data
+ * @throws If account doesn't exist
+ */
+export declare function fetchConvictionMarket(program: Program<ConvictionMarket>, marketPda: PublicKey): Promise<{
+    encryptedAvailableShares: number[][];
+    bump: number;
+    creator: PublicKey;
+    index: import("bn.js");
+    totalOptions: number;
+    maxOptions: number;
+    openTimestamp: import("bn.js") | null;
+    timeToStake: import("bn.js");
+    timeToReveal: import("bn.js");
+    selectedOption: number | null;
+    stateNonce: import("bn.js");
+    maxShares: import("bn.js");
+    rewardLamports: import("bn.js");
+    selectAuthority: PublicKey | null;
+}>;
+export type ConvictionMarketAccount = Awaited<ReturnType<typeof fetchConvictionMarket>>;
+/**
+ * Fetches a market option account
+ *
+ * @param program - Anchor program instance
+ * @param optionPda - PDA of the market option
+ * @returns Market option account data
+ * @throws If account doesn't exist
+ */
+export declare function fetchMarketOption(program: Program<ConvictionMarket>, optionPda: PublicKey): Promise<{
+    bump: number;
+    creator: PublicKey;
+    name: string;
+    totalShares: import("bn.js") | null;
+    totalScore: import("bn.js") | null;
+}>;
+export type ConvictionMarketOptionData = Awaited<ReturnType<typeof fetchMarketOption>>;
+/**
+ * Checks if a vote token account exists
+ *
+ * @param provider - Anchor provider
+ * @param voteTokenAccountPda - PDA of the vote token account
+ * @returns True if account exists, false otherwise
+ */
+export declare function voteTokenAccountExists(provider: AnchorProvider, voteTokenAccountPda: PublicKey): Promise<boolean>;
+/**
+ * Checks if a share account exists
+ *
+ * @param provider - Anchor provider
+ * @param shareAccountPda - PDA of the share account
+ * @returns True if account exists, false otherwise
+ */
+export declare function shareAccountExists(provider: AnchorProvider, shareAccountPda: PublicKey): Promise<boolean>;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/utils/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/utils/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAKjF;AAED;;;;;;;;GAQG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,mBAAmB,EAAE,SAAS,EAC9B,iBAAiB,EAAE;IAAE,SAAS,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE;;;;;;;;GAwBpE;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC,CAAC;AAEpG;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,eAAe,EAAE,SAAS,EAC1B,iBAAiB,EAAE;IAAE,SAAS,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE;;;;;;;;;;;;;;;;;GAyBpE;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAC;AAE5F;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,SAAS,EAAE,SAAS,EACpB,iBAAiB,EAAE;IAAE,SAAS,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE;;;;;;;;;;;;;;;;;;GAwBpE;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAC;AAE5F;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,mBAAmB,EAAE,SAAS;;;;;GAG/B;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,eAAe,EAAE,SAAS;;;;;;;;;;;;;GAG3B;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAE7E;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,SAAS,EAAE,SAAS;;;;;;;;;;;;;;;GAGrB;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC;AAExF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,SAAS,EAAE,SAAS;;;;;;GAGrB;AAED,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAEvF;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,cAAc,EACxB,mBAAmB,EAAE,SAAS,GAC7B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,cAAc,EACxB,eAAe,EAAE,SAAS,GACzB,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/utils/accounts.js

@@ -0,0 +1,149 @@
+import { Program } from "@coral-xyz/anchor";
+import { createEncryptionContext, fetchMXEPublicKey } from "./encryption";
+import IDL from "../idl/conviction_market.json";
+/**
+ * Creates a Program instance for the Conviction Market program
+ *
+ * @param provider - Anchor provider
+ * @returns Program instance
+ */
+export function createProgram(provider) {
+    return new Program(IDL, provider);
+}
+/**
+ * Fetches and decrypts a user's vote token balance
+ *
+ * @param program - Anchor program instance
+ * @param voteTokenAccountPda - PDA of the vote token account
+ * @param userX25519Keypair - User's X25519 keypair for decryption
+ * @returns Decrypted balance and account data
+ * @throws If account doesn't exist or decryption fails
+ */
+export async function fetchAndDecryptVoteTokenBalance(program, voteTokenAccountPda, userX25519Keypair) {
+    const account = await program.account.voteTokenAccount.fetch(voteTokenAccountPda);
+    // Fetch MXE public key and create encryption context
+    const mxePublicKey = await fetchMXEPublicKey(program.provider, program.programId);
+    const encryptionContext = createEncryptionContext(userX25519Keypair, mxePublicKey);
+    const decrypted = encryptionContext.cipher.decrypt(account.encryptedState, Uint8Array.from(account.stateNonce.toArray("le", 16)));
+    if (!decrypted[0]) {
+        throw new Error("Failed to decrypt balance");
+    }
+    return {
+        balance: decrypted[0],
+        account,
+    };
+}
+/**
+ * Fetches and decrypts a user's share account
+ *
+ * @param program - Anchor program instance
+ * @param shareAccountPda - PDA of the share account
+ * @param userX25519Keypair - User's X25519 keypair for decryption
+ * @returns Decrypted share data and account data
+ * @throws If account doesn't exist or decryption fails
+ */
+export async function fetchAndDecryptShareAccount(program, shareAccountPda, userX25519Keypair) {
+    const account = await program.account.shareAccount.fetch(shareAccountPda);
+    // Fetch MXE public key and create encryption context
+    const mxePublicKey = await fetchMXEPublicKey(program.provider, program.programId);
+    const encryptionContext = createEncryptionContext(userX25519Keypair, mxePublicKey);
+    const decrypted = encryptionContext.cipher.decrypt(account.encryptedState, Uint8Array.from(account.stateNonce.toArray("le", 16)));
+    if (!decrypted[0] || !decrypted[1]) {
+        throw new Error("Failed to decrypt share account");
+    }
+    return {
+        amount: decrypted[0],
+        selectedOption: decrypted[1],
+        account,
+    };
+}
+/**
+ * Fetches and decrypts a market's available shares
+ *
+ * @param program - Anchor program instance
+ * @param marketPda - PDA of the conviction market
+ * @param userX25519Keypair - User's X25519 keypair for decryption
+ * @returns Decrypted available shares and account data
+ * @throws If account doesn't exist or decryption fails
+ */
+export async function fetchAndDecryptMarketShares(program, marketPda, userX25519Keypair) {
+    const account = await program.account.convictionMarket.fetch(marketPda);
+    // Fetch MXE public key and create encryption context
+    const mxePublicKey = await fetchMXEPublicKey(program.provider, program.programId);
+    const encryptionContext = createEncryptionContext(userX25519Keypair, mxePublicKey);
+    const decrypted = encryptionContext.cipher.decrypt(account.encryptedAvailableShares, Uint8Array.from(account.stateNonce.toArray("le", 16)));
+    if (!decrypted[0]) {
+        throw new Error("Failed to decrypt market shares");
+    }
+    return {
+        availableShares: decrypted[0],
+        account,
+    };
+}
+/**
+ * Fetches a vote token account without decryption
+ *
+ * @param program - Anchor program instance
+ * @param voteTokenAccountPda - PDA of the vote token account
+ * @returns Vote token account data
+ * @throws If account doesn't exist
+ */
+export async function fetchVoteTokenAccount(program, voteTokenAccountPda) {
+    return await program.account.voteTokenAccount.fetch(voteTokenAccountPda);
+}
+/**
+ * Fetches a share account without decryption
+ *
+ * @param program - Anchor program instance
+ * @param shareAccountPda - PDA of the share account
+ * @returns Share account data
+ * @throws If account doesn't exist
+ */
+export async function fetchShareAccount(program, shareAccountPda) {
+    return await program.account.shareAccount.fetch(shareAccountPda);
+}
+/**
+ * Fetches a conviction market account
+ *
+ * @param program - Anchor program instance
+ * @param marketPda - PDA of the conviction market
+ * @returns Conviction market account data
+ * @throws If account doesn't exist
+ */
+export async function fetchConvictionMarket(program, marketPda) {
+    return await program.account.convictionMarket.fetch(marketPda);
+}
+/**
+ * Fetches a market option account
+ *
+ * @param program - Anchor program instance
+ * @param optionPda - PDA of the market option
+ * @returns Market option account data
+ * @throws If account doesn't exist
+ */
+export async function fetchMarketOption(program, optionPda) {
+    return await program.account.convictionMarketOption.fetch(optionPda);
+}
+/**
+ * Checks if a vote token account exists
+ *
+ * @param provider - Anchor provider
+ * @param voteTokenAccountPda - PDA of the vote token account
+ * @returns True if account exists, false otherwise
+ */
+export async function voteTokenAccountExists(provider, voteTokenAccountPda) {
+    const accountInfo = await provider.connection.getAccountInfo(voteTokenAccountPda);
+    return accountInfo !== null;
+}
+/**
+ * Checks if a share account exists
+ *
+ * @param provider - Anchor provider
+ * @param shareAccountPda - PDA of the share account
+ * @returns True if account exists, false otherwise
+ */
+export async function shareAccountExists(provider, shareAccountPda) {
+    const accountInfo = await provider.connection.getAccountInfo(shareAccountPda);
+    return accountInfo !== null;
+}
+//# sourceMappingURL=accounts.js.map

package/dist/utils/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/utils/accounts.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -4,4 +4,5 @@ export * from "./computations";
 export * from "./encryption";
 export * from "./awaitComputationFinalization";
 export * from "./arcium";
+export * from "./accounts";
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/utils/index.js

@@ -4,4 +4,5 @@ export * from "./computations";
 export * from "./encryption";
 export * from "./awaitComputationFinalization";
 export * from "./arcium";
+export * from "./accounts";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bench.games/conviction-markets",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "author": "Bench",
   "main": "./dist/index.js",
   "devDependencies": {