@wzrd_sol/sdk 0.1.1 → 0.2.0

package/dist/instructions.d.ts

@@ -12,6 +12,50 @@ import { Connection, PublicKey, TransactionInstruction } from '@solana/web3.js';
 export declare function anchorDisc(name: string): Promise<Buffer>;
 /** Build a CreateIdempotent ATA instruction (instruction index 1). Never fails if ATA exists. */
 export declare function createAtaIdempotentIx(payer: PublicKey, ata: PublicKey, owner: PublicKey, mint: PublicKey, tokenProgramId?: PublicKey): TransactionInstruction;
+/**
+ * Meteora DLMM program ID (mainnet).
+ * Used for addLiquidity / removeLiquidity instructions.
+ */
+export declare const DLMM_PROGRAM_ID: PublicKey;
+/**
+ * Build a Meteora DLMM `addLiquidity` TransactionInstruction.
+ *
+ * This is the agent LP pattern: deposit CCM + counterpart (SOL/USDC) into
+ * a DLMM concentrated liquidity position to earn swap fees from other agents.
+ *
+ * Note: For Token-2022 mints like CCM, transfer fees are deducted automatically
+ * on transfer_checked. The DLMM program handles this internally.
+ *
+ * @param pool - DLMM pool address (e.g., CCM/SOL, CCM/USDC)
+ * @param position - Position account (create with DLMM initPosition first)
+ * @param owner - Position owner (signer)
+ * @param tokenXMint - Pool token X mint
+ * @param tokenYMint - Pool token Y mint
+ * @param userTokenX - Owner's token X ATA
+ * @param userTokenY - Owner's token Y ATA
+ * @param reserveX - Pool reserve X account
+ * @param reserveY - Pool reserve Y account
+ * @param binArrayLower - Lower bin array account
+ * @param binArrayUpper - Upper bin array account
+ * @param amountX - Token X amount (native units)
+ * @param amountY - Token Y amount (native units)
+ */
+export declare function createAddLiquidityIx(pool: PublicKey, position: PublicKey, owner: PublicKey, tokenXMint: PublicKey, tokenYMint: PublicKey, userTokenX: PublicKey, userTokenY: PublicKey, reserveX: PublicKey, reserveY: PublicKey, binArrayLower: PublicKey, binArrayUpper: PublicKey, amountX: bigint, amountY: bigint, activeBinId: number, binCount: number, tokenXProgram?: PublicKey, tokenYProgram?: PublicKey): TransactionInstruction;
+/**
+ * Build a Meteora DLMM `removeLiquidity` TransactionInstruction.
+ *
+ * Agent pattern: withdraw LP position to recover tokens and accrued fees.
+ */
+export declare function createRemoveLiquidityIx(pool: PublicKey, position: PublicKey, owner: PublicKey, reserveX: PublicKey, reserveY: PublicKey, userTokenX: PublicKey, userTokenY: PublicKey, tokenXMint: PublicKey, tokenYMint: PublicKey, binArrayLower: PublicKey, binArrayUpper: PublicKey, bpsBasisPointsToRemove: number, tokenXProgram?: PublicKey, tokenYProgram?: PublicKey): TransactionInstruction;
+/**
+ * `settle_market` account layout mode.
+ *
+ * `legacy_ccm` matches the currently deployed mainnet ABI, which still validates
+ * `ccm_mint` / `user_ccm_ata` accounts even though the instruction no longer mints CCM.
+ * `current` matches the slimmer source layout after those accounts were removed.
+ * `auto` selects `legacy_ccm` for the current mainnet program ID and `current` otherwise.
+ */
+export type SettleAccountsMode = 'auto' | 'current' | 'legacy_ccm';
 /**
  * Build a `deposit_market` TransactionInstruction.
  *
@@ -45,15 +89,21 @@ amount: bigint | number, programId?: PublicKey): Promise<TransactionInstruction[
  *   5. user_vlofi_ata    (writable)
  *   6. vault_usdc_ata    (writable)
  *   7. user_usdc_ata     (writable)
- *   8. ccm_mint          (writable)
- *   9. user_ccm_ata      (writable)
+ *   8. ccm_mint          (legacy mainnet ABI only)
+ *   9. user_ccm_ata      (legacy mainnet ABI only)
  *  10. token_program     (readonly) — legacy SPL (USDC)
  *  11. token_2022_program (readonly) — vLOFI burn
- *  12. ccm_token_program (readonly) — CCM mint (Token-2022 on mainnet)
+ *  12. ccm_token_program (readonly) — Token-2022 for legacy mainnet ABI
+ *
+ * The deployed mainnet program still expects the legacy CCM accounts even though
+ * the instruction no longer mints CCM. In `auto` mode we include them for mainnet
+ * and use the slimmer layout elsewhere.
  *
- * @returns Array of instructions: idempotent ATA create for CCM + the settle IX.
+ * @returns Array containing the settle IX.
  */
-export declare function createSettleMarketIx(connection: Connection, user: PublicKey, marketId: number, programId?: PublicKey): Promise<TransactionInstruction[]>;
+export declare function createSettleMarketIx(connection: Connection, user: PublicKey, marketId: number, programId?: PublicKey, options?: {
+    accountsMode?: SettleAccountsMode;
+}): Promise<TransactionInstruction[]>;
 /**
  * Build an `initialize_market_vault` TransactionInstruction.
  *
@@ -87,6 +137,13 @@ export declare function createInitializeMarketVaultIx(admin: PublicKey, marketId
 export declare function createClaimGlobalIx(connection: Connection, claimer: PublicKey, rootSeq: number, cumulativeTotal: bigint | number, 
 /** Hex-encoded 32-byte sibling hashes from the claims API */
 proofHex: string[], programId?: PublicKey): Promise<TransactionInstruction[]>;
+/**
+ * Build a `claim_global_v2` TransactionInstruction (V5 leaf format).
+ *
+ * Same accounts as claim_global, but args split cumulative_total into
+ * base_yield + attention_bonus for V5 merkle leaf verification.
+ */
+export declare function createClaimGlobalV2Ix(connection: Connection, claimer: PublicKey, rootSeq: number, baseYield: bigint | number, attentionBonus: bigint | number, proofHex: string[], programId?: PublicKey): Promise<TransactionInstruction[]>;
 /**
  * Build a `create_channel_config_v2` TransactionInstruction.
  *
@@ -105,3 +162,492 @@ proofHex: string[], programId?: PublicKey): Promise<TransactionInstruction[]>;
 export declare function createChannelConfigV2Ix(admin: PublicKey, 
 /** CCM mint pubkey (from ProtocolState.mint) */
 mint: PublicKey, subject: PublicKey, authority: PublicKey, creatorWallet: PublicKey, creatorFeeBps: number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `create_market` TransactionInstruction (prediction markets).
+ *
+ * Accounts (order must match CreateMarket struct in markets.rs):
+ *   0. authority         (signer, writable)
+ *   1. protocol_state    (readonly)
+ *   2. global_root_config (readonly)
+ *   3. market_state      (writable, init)
+ *   4. system_program    (readonly)
+ *
+ * Args (Borsh):
+ *   market_id:            u64
+ *   creator_wallet:       Pubkey (32 bytes)
+ *   metric:               u8
+ *   target:               u64
+ *   resolution_root_seq:  u64
+ */
+export declare function createCreateMarketIx(authority: PublicKey, ccmMint: PublicKey, marketId: number, creatorWallet: PublicKey, metric: number, target: bigint | number, resolutionRootSeq: bigint | number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build an `update_attention` TransactionInstruction.
+ *
+ * Oracle pushes attention multiplier to a user's market position.
+ *
+ * Accounts (order must match UpdateAttention struct in vault.rs):
+ *   0. oracle_authority        (signer, writable)
+ *   1. protocol_state          (readonly)
+ *   2. market_vault            (readonly)
+ *   3. user_market_position    (writable)
+ *
+ * Args: market_id (u64), user_pubkey (Pubkey), multiplier_bps (u64)
+ */
+export declare function createUpdateAttentionIx(oracleAuthority: PublicKey, marketId: number, userPubkey: PublicKey, multiplierBps: bigint | number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `publish_global_root` TransactionInstruction.
+ *
+ * Accounts (order must match PublishGlobalRoot struct in global.rs):
+ *   0. payer                (signer, writable)
+ *   1. protocol_state       (readonly)
+ *   2. global_root_config   (writable)
+ *
+ * Args: root_seq (u64), root ([u8; 32]), dataset_hash ([u8; 32])
+ */
+export declare function createPublishGlobalRootIx(payer: PublicKey, ccmMint: PublicKey, rootSeq: bigint | number, 
+/** 32-byte merkle root (hex string or Buffer) */
+root: string | Buffer, 
+/** 32-byte dataset hash (hex string or Buffer) */
+datasetHash: string | Buffer, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `claim_yield` TransactionInstruction.
+ *
+ * NOTE: This instruction is deprecated on-chain and always returns
+ * `ClaimYieldDeprecated`. Included for SDK completeness.
+ *
+ * Accounts (order must match ClaimYield struct in vault.rs):
+ *   0. user                   (signer, writable)
+ *   1. protocol_state         (readonly)
+ *   2. market_vault           (readonly)
+ *   3. user_market_position   (writable)
+ *
+ * Args: market_id (u64)
+ */
+export declare function createClaimYieldIx(user: PublicKey, marketId: number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `close_market` TransactionInstruction (prediction markets).
+ *
+ * Accounts (order must match CloseMarket struct in markets.rs):
+ *   0. admin            (signer, writable)
+ *   1. protocol_state   (readonly)
+ *   2. market_state     (writable, close -> admin)
+ *   3. vault            (writable) — must be empty
+ *   4. ccm_mint         (readonly)
+ *   5. mint_authority   (readonly)
+ *   6. token_program    (readonly) — Token-2022
+ */
+export declare function createCloseMarketIx(admin: PublicKey, ccmMint: PublicKey, marketId: number, vault: PublicKey, mintAuthority: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build an `update_nav` TransactionInstruction.
+ *
+ * Oracle authority sets NAV per vLOFI share on a MarketVault.
+ *
+ * Accounts (order must match UpdateNav struct in vault.rs):
+ *   0. oracle_authority  (signer, writable)
+ *   1. protocol_state    (readonly)
+ *   2. market_vault      (writable)
+ *
+ * Args: market_id (u64), nav_per_share_bps (u64)
+ */
+export declare function createUpdateNavIx(oracleAuthority: PublicKey, marketId: number, navPerShareBps: bigint | number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build an `initialize_protocol_state` TransactionInstruction.
+ *
+ * One-time protocol setup. Creates the singleton ProtocolState PDA.
+ *
+ * Accounts (order must match InitializeProtocolState struct in vault.rs):
+ *   0. admin           (signer, writable)
+ *   1. protocol_state  (writable, init)
+ *   2. system_program  (readonly)
+ *
+ * Args: publisher (Pubkey), treasury (Pubkey), oracle_authority (Pubkey), ccm_mint (Pubkey)
+ */
+export declare function createInitializeProtocolStateIx(admin: PublicKey, publisher: PublicKey, treasury: PublicKey, oracleAuthority: PublicKey, ccmMint: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build an `update_publisher_open` TransactionInstruction.
+ *
+ * Admin updates the allowlisted publisher address.
+ *
+ * Accounts (order must match UpdatePublisherOpen struct in admin.rs):
+ *   0. admin           (signer, writable)
+ *   1. protocol_state  (writable)
+ *
+ * Args: new_publisher (Pubkey)
+ */
+export declare function createUpdateProtocolStateIx(admin: PublicKey, newPublisher: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `set_treasury` TransactionInstruction.
+ *
+ * Admin updates the treasury wallet (fee destination owner).
+ *
+ * Accounts (order must match SetTreasury struct in admin.rs):
+ *   0. admin           (signer, writable)
+ *   1. protocol_state  (writable)
+ *
+ * Args: new_treasury (Pubkey)
+ */
+export declare function createSetTreasuryIx(admin: PublicKey, newTreasury: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `stake_channel` TransactionInstruction.
+ *
+ * Accounts (order must match StakeChannel struct in staking.rs):
+ *   0.  user                (signer)
+ *   1.  payer               (signer, writable)
+ *   2.  protocol_state      (readonly)
+ *   3.  channel_config      (readonly)
+ *   4.  mint                (readonly) — CCM Token-2022
+ *   5.  stake_pool          (writable)
+ *   6.  user_stake          (writable, init)
+ *   7.  vault               (writable) — pool's staking vault
+ *   8.  user_token_account  (writable) — user's CCM ATA
+ *   9.  nft_mint            (writable) — soulbound NFT mint PDA
+ *   10. nft_ata             (writable) — user's NFT ATA
+ *   11. token_program       (readonly) — Token-2022
+ *   12. associated_token_program (readonly)
+ *   13. system_program      (readonly)
+ *   14. rent                (readonly)
+ *
+ * Args: amount (u64), lock_duration (u64)
+ */
+export declare function createStakeChannelIx(user: PublicKey, payer: PublicKey, ccmMint: PublicKey, channelConfig: PublicKey, amount: bigint | number, lockDuration: bigint | number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build an `unstake_channel` TransactionInstruction.
+ *
+ * Accounts (order must match UnstakeChannel struct in staking.rs):
+ *   0.  user                (signer, writable)
+ *   1.  channel_config      (readonly)
+ *   2.  mint                (readonly) — CCM Token-2022
+ *   3.  stake_pool          (writable)
+ *   4.  user_stake          (writable, close -> user)
+ *   5.  vault               (writable)
+ *   6.  user_token_account  (writable)
+ *   7.  nft_mint            (writable)
+ *   8.  nft_ata             (writable)
+ *   9.  token_program       (readonly) — Token-2022
+ *   10. associated_token_program (readonly)
+ *
+ * No args (no instruction data beyond disc).
+ */
+export declare function createUnstakeChannelIx(user: PublicKey, ccmMint: PublicKey, channelConfig: PublicKey, nftMint: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `claim_channel_rewards` TransactionInstruction.
+ *
+ * Accounts (order must match ClaimChannelRewards struct in staking.rs):
+ *   0. user                (signer, writable)
+ *   1. channel_config      (readonly)
+ *   2. mint                (readonly) — CCM Token-2022
+ *   3. stake_pool          (writable)
+ *   4. user_stake          (writable)
+ *   5. vault               (writable) — pool vault
+ *   6. user_token_account  (writable) — receives rewards
+ *   7. token_program       (readonly) — Token-2022
+ *
+ * No args beyond disc.
+ */
+export declare function createClaimChannelRewardsIx(user: PublicKey, ccmMint: PublicKey, channelConfig: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build an `initialize_stake_pool` TransactionInstruction.
+ *
+ * Accounts (order must match InitializeStakePool struct in staking.rs):
+ *   0. payer            (signer, writable)
+ *   1. protocol_state   (readonly)
+ *   2. channel_config   (readonly)
+ *   3. mint             (readonly) — CCM Token-2022
+ *   4. stake_pool       (writable, init)
+ *   5. vault            (writable, init) — pool's CCM vault
+ *   6. token_program    (readonly) — Token-2022
+ *   7. system_program   (readonly)
+ *
+ * No args beyond disc.
+ */
+export declare function createInitializeStakePoolIx(payer: PublicKey, ccmMint: PublicKey, channelConfig: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build an `initialize_strategy_vault` TransactionInstruction.
+ *
+ * Accounts (order must match InitializeStrategyVault struct in strategy.rs):
+ *   0. admin_authority  (signer, writable)
+ *   1. protocol_state   (readonly)
+ *   2. market_vault     (readonly)
+ *   3. deposit_mint     (readonly)
+ *   4. strategy_vault   (writable, init)
+ *   5. system_program   (readonly)
+ *
+ * Args: reserve_ratio_bps (u16), utilization_cap_bps (u16),
+ *       operator_authority (Pubkey), klend_program (Pubkey),
+ *       klend_reserve (Pubkey), klend_lending_market (Pubkey), ctoken_ata (Pubkey)
+ */
+export declare function createInitializeStrategyVaultIx(adminAuthority: PublicKey, marketId: number, depositMint: PublicKey, reserveRatioBps: number, utilizationCapBps: number, operatorAuthority: PublicKey, klendProgram: PublicKey, klendReserve: PublicKey, klendLendingMarket: PublicKey, ctokenAta: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `deploy_to_strategy` TransactionInstruction.
+ *
+ * Deploys USDC from MarketVault into Kamino K-Lend. Requires all Kamino
+ * oracle accounts. All account addresses are pinned at strategy vault init.
+ *
+ * Accounts (order must match DeployToStrategy struct in strategy.rs):
+ *   0.  operator_authority            (signer, writable)
+ *   1.  protocol_state               (readonly)
+ *   2.  market_vault                  (readonly)
+ *   3.  strategy_vault               (writable)
+ *   4.  deposit_mint                  (readonly)
+ *   5.  vault_usdc_ata               (writable)
+ *   6.  ctoken_ata                   (writable)
+ *   7.  klend_program                (readonly)
+ *   8.  klend_reserve                (writable)
+ *   9.  klend_lending_market         (readonly)
+ *   10. klend_lending_market_authority (readonly)
+ *   11. reserve_liquidity_supply     (writable)
+ *   12. reserve_collateral_mint      (writable)
+ *   13. pyth_oracle                  (readonly)
+ *   14. switchboard_price_oracle     (readonly)
+ *   15. switchboard_twap_oracle      (readonly)
+ *   16. scope_prices                 (readonly)
+ *   17. instruction_sysvar_account   (readonly)
+ *   18. token_program                (readonly) — SPL Token
+ *
+ * Args: amount (u64)
+ */
+export declare function createDeployToStrategyIx(operatorAuthority: PublicKey, marketId: number, depositMint: PublicKey, vaultUsdcAta: PublicKey, ctokenAta: PublicKey, klendProgram: PublicKey, klendReserve: PublicKey, klendLendingMarket: PublicKey, klendLendingMarketAuthority: PublicKey, reserveLiquiditySupply: PublicKey, reserveCollateralMint: PublicKey, pythOracle: PublicKey, switchboardPriceOracle: PublicKey, switchboardTwapOracle: PublicKey, scopePrices: PublicKey, amount: bigint | number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `withdraw_from_strategy` TransactionInstruction.
+ *
+ * Withdraws USDC from Kamino back into the MarketVault reserve.
+ * Same Kamino oracle accounts as deploy_to_strategy.
+ *
+ * Accounts (order must match WithdrawFromStrategy struct in strategy.rs):
+ *   Same layout as DeployToStrategy.
+ *
+ * Args: amount (u64)
+ */
+export declare function createWithdrawFromStrategyIx(operatorAuthority: PublicKey, marketId: number, depositMint: PublicKey, vaultUsdcAta: PublicKey, ctokenAta: PublicKey, klendProgram: PublicKey, klendReserve: PublicKey, klendLendingMarket: PublicKey, klendLendingMarketAuthority: PublicKey, reserveLiquiditySupply: PublicKey, reserveCollateralMint: PublicKey, pythOracle: PublicKey, switchboardPriceOracle: PublicKey, switchboardTwapOracle: PublicKey, scopePrices: PublicKey, amount: bigint | number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `harvest_strategy_yield` TransactionInstruction.
+ *
+ * Harvests yield (NAV above principal) from Kamino and sends it to treasury.
+ *
+ * Accounts (order must match HarvestStrategyYield struct in strategy.rs):
+ *   0.  operator_authority            (signer, writable)
+ *   1.  protocol_state               (readonly)
+ *   2.  market_vault                  (readonly)
+ *   3.  strategy_vault               (writable)
+ *   4.  deposit_mint                  (readonly)
+ *   5.  vault_usdc_ata               (readonly) — for validation
+ *   6.  treasury_ata                 (writable) — receives yield USDC
+ *   7.  ctoken_ata                   (writable)
+ *   8.  klend_program                (readonly)
+ *   9.  klend_reserve                (writable)
+ *   10. klend_lending_market         (readonly)
+ *   11. klend_lending_market_authority (readonly)
+ *   12. reserve_liquidity_supply     (writable)
+ *   13. reserve_collateral_mint      (writable)
+ *   14. pyth_oracle                  (readonly)
+ *   15. switchboard_price_oracle     (readonly)
+ *   16. switchboard_twap_oracle      (readonly)
+ *   17. scope_prices                 (readonly)
+ *   18. instruction_sysvar_account   (readonly)
+ *   19. token_program                (readonly) — SPL Token
+ *
+ * No args beyond disc.
+ */
+export declare function createHarvestStrategyYieldIx(operatorAuthority: PublicKey, marketId: number, depositMint: PublicKey, vaultUsdcAta: PublicKey, treasuryAta: PublicKey, ctokenAta: PublicKey, klendProgram: PublicKey, klendReserve: PublicKey, klendLendingMarket: PublicKey, klendLendingMarketAuthority: PublicKey, reserveLiquiditySupply: PublicKey, reserveCollateralMint: PublicKey, pythOracle: PublicKey, switchboardPriceOracle: PublicKey, switchboardTwapOracle: PublicKey, scopePrices: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `harvest_fees` TransactionInstruction.
+ *
+ * Permissionless. Sweeps Token-2022 withheld fees from source accounts
+ * into the treasury ATA. Source accounts are passed via `sourceAccounts`.
+ *
+ * Accounts (order must match HarvestFees struct in governance.rs):
+ *   0. authority         (signer, writable)
+ *   1. protocol_state    (readonly) — legacy PDA (seeds = ["protocol", mint])
+ *   2. mint              (writable)
+ *   3. treasury          (writable) — treasury ATA
+ *   4. token_program     (readonly) — Token-2022
+ *   + remaining_accounts: source token accounts to sweep
+ *
+ * No args beyond disc.
+ */
+export declare function createHarvestAndDistributeFeesIx(authority: PublicKey, ccmMint: PublicKey, treasuryAta: PublicKey, 
+/** Token-2022 accounts with withheld fees to sweep (max 30). */
+sourceAccounts: PublicKey[], programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `route_treasury` TransactionInstruction.
+ *
+ * Phase 2 treasury routing — moves CCM from treasury to destination with min_reserve guard.
+ *
+ * Accounts (order must match RouteTreasury struct in governance.rs):
+ *   0. admin            (signer, writable)
+ *   1. protocol_state   (readonly) — legacy PDA (seeds = ["protocol", mint])
+ *   2. mint             (readonly)
+ *   3. treasury_ata     (writable) — source
+ *   4. destination_ata  (writable) — target
+ *   5. token_program    (readonly) — Token-2022
+ *
+ * Args: amount (u64), min_reserve (u64)
+ */
+export declare function createRouteTreasuryIx(admin: PublicKey, ccmMint: PublicKey, treasuryAta: PublicKey, destinationAta: PublicKey, amount: bigint | number, minReserve: bigint | number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `withdraw_fees_from_mint` TransactionInstruction.
+ *
+ * Permissionless. Moves accumulated withheld fees from the mint itself to treasury.
+ *
+ * Accounts (order must match WithdrawFeesFromMint struct in governance.rs):
+ *   0. authority         (signer, writable)
+ *   1. protocol_state    (readonly) — legacy PDA (seeds = ["protocol", mint])
+ *   2. mint              (writable)
+ *   3. treasury_ata      (writable)
+ *   4. token_program     (readonly) — Token-2022
+ *
+ * No args beyond disc.
+ */
+export declare function createWithdrawFeesFromMintIx(authority: PublicKey, ccmMint: PublicKey, treasuryAta: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `realloc_legacy_protocol` TransactionInstruction.
+ *
+ * One-shot migration: extends the legacy 141-byte ProtocolState PDA
+ * (seeds = ["protocol", mint]) to 173 bytes and inserts oracle_authority.
+ *
+ * Accounts (order must match ReallocLegacyProtocol struct in governance.rs):
+ *   0. admin                (signer, writable)
+ *   1. live_protocol_state  (readonly) — current ProtocolState (seeds = ["protocol_state"])
+ *   2. legacy_protocol_state (writable) — legacy PDA (seeds = ["protocol", mint])
+ *   3. mint                 (readonly)
+ *   4. system_program       (readonly)
+ *
+ * No args beyond disc.
+ */
+export declare function createReallocLegacyProtocolIx(admin: PublicKey, ccmMint: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `realloc_market_vault` TransactionInstruction.
+ *
+ * Grows existing MarketVault PDA from 137 to 153 bytes (Phase 2 NAV fields).
+ * Admin-only. No-op if already at target size.
+ *
+ * Accounts (order must match ReallocMarketVault struct in vault.rs):
+ *   0. payer            (signer, writable)
+ *   1. protocol_state   (readonly)
+ *   2. market_vault     (writable) — UncheckedAccount (may be undersized)
+ *   3. system_program   (readonly)
+ *
+ * Args: market_id (u64)
+ */
+export declare function createReallocMarketVaultIx(payer: PublicKey, marketId: number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `resolve_market` TransactionInstruction (prediction markets).
+ *
+ * Accounts (order must match ResolveMarket struct in markets.rs):
+ *   0. resolver          (signer)
+ *   1. protocol_state    (readonly)
+ *   2. global_root_config (readonly)
+ *   3. market_state      (writable)
+ *
+ * Args: cumulative_total (u64), proof (Vec<[u8; 32]>)
+ */
+export declare function createResolveMarketIx(resolver: PublicKey, ccmMint: PublicKey, marketId: number, cumulativeTotal: bigint | number, proofHex: string[], programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `set_paused_open` TransactionInstruction.
+ *
+ * Emergency pause/unpause toggle. Admin-only.
+ *
+ * Accounts (order must match SetPausedOpen struct in admin.rs):
+ *   0. admin           (signer, writable)
+ *   1. protocol_state  (writable)
+ *
+ * Args: paused (bool, serialized as u8: 0 or 1)
+ */
+export declare function createSetPausedOpenIx(admin: PublicKey, paused: boolean, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build an `initialize_global_root` TransactionInstruction.
+ *
+ * Creates the singleton GlobalRootConfig PDA for merkle root publishing.
+ *
+ * Accounts (order must match InitializeGlobalRoot struct in global.rs):
+ *   0. payer              (signer, writable)
+ *   1. protocol_state     (readonly)
+ *   2. global_root_config (writable, init)
+ *   3. system_program     (readonly)
+ *
+ * No args beyond disc.
+ */
+export declare function createInitializeGlobalRootIx(payer: PublicKey, ccmMint: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `set_price_updater` TransactionInstruction.
+ *
+ * Authority rotates the cranker key for a price feed.
+ *
+ * Accounts (order must match SetPriceUpdater struct in price_feed.rs):
+ *   0. authority     (signer)
+ *   1. price_feed    (writable)
+ *
+ * Args: label ([u8; 32]), new_updater (Pubkey)
+ */
+export declare function createSetPriceUpdaterIx(authority: PublicKey, 
+/** 32-byte label (zero-padded). Use `Buffer.alloc(32)` and write your label. */
+label: Buffer, newUpdater: PublicKey, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `mint_shares` TransactionInstruction (prediction markets).
+ *
+ * Deposits CCM into the prediction market vault and receives 1:1 YES + NO tokens.
+ *
+ * Accounts (13 fixed, order matches markets.rs mint_shares):
+ *   0.  depositor          (signer, writable)
+ *   1.  protocol_state     (readonly)
+ *   2.  market_state       (writable)
+ *   3.  ccm_mint           (readonly)
+ *   4.  depositor_ccm_ata  (writable)
+ *   5.  vault              (writable)
+ *   6.  yes_mint           (writable)
+ *   7.  no_mint            (writable)
+ *   8.  depositor_yes_ata  (writable)
+ *   9.  depositor_no_ata   (writable)
+ *   10. mint_authority     (readonly)
+ *   11. token_program      (Token-2022, for CCM)
+ *   12. outcome_token_prog (SPL Token, for YES/NO)
+ *
+ * Args: amount (u64) — CCM native units to deposit
+ */
+export declare function createMintSharesIx(depositor: PublicKey, ccmMint: PublicKey, marketId: number, amount: bigint | number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `redeem_shares` TransactionInstruction (prediction markets).
+ *
+ * Burns equal YES + NO shares and returns CCM. Pre-resolution only.
+ *
+ * Accounts (13 fixed, order matches markets.rs redeem_shares):
+ *   0.  redeemer           (signer, writable)
+ *   1.  protocol_state     (readonly)
+ *   2.  market_state       (writable)
+ *   3.  ccm_mint           (readonly)
+ *   4.  vault              (writable)
+ *   5.  yes_mint           (writable)
+ *   6.  no_mint            (writable)
+ *   7.  redeemer_yes_ata   (writable)
+ *   8.  redeemer_no_ata    (writable)
+ *   9.  redeemer_ccm_ata   (writable)
+ *   10. mint_authority     (readonly)
+ *   11. token_program      (Token-2022, for CCM)
+ *   12. outcome_token_prog (SPL Token, for YES/NO)
+ *
+ * Args: shares (u64) — number of YES+NO pairs to redeem
+ */
+export declare function createRedeemSharesIx(redeemer: PublicKey, ccmMint: PublicKey, marketId: number, shares: bigint | number, programId?: PublicKey): Promise<TransactionInstruction>;
+/**
+ * Build a `settle` TransactionInstruction (prediction markets).
+ *
+ * Burns winning-side tokens and returns CCM 1:1. Post-resolution only.
+ *
+ * Accounts (11 fixed, order matches markets.rs settle):
+ *   0.  settler            (signer, writable)
+ *   1.  protocol_state     (readonly)
+ *   2.  market_state       (readonly)
+ *   3.  ccm_mint           (readonly)
+ *   4.  vault              (writable)
+ *   5.  winning_mint       (writable) — yes_mint if YES won, no_mint if NO
+ *   6.  settler_winning    (writable) — settler's ATA for the winning mint
+ *   7.  settler_ccm        (writable) — settler's CCM ATA
+ *   8.  mint_authority     (readonly)
+ *   9.  token_program      (Token-2022, for CCM)
+ *   10. outcome_token_prog (SPL Token, for YES/NO)
+ *
+ * Args: shares (u64) — winning tokens to settle
+ */
+export declare function createSettlePredictionIx(settler: PublicKey, ccmMint: PublicKey, marketId: number, shares: bigint | number, 
+/** true = YES won, false = NO won */
+yesOutcome: boolean, programId?: PublicKey): Promise<TransactionInstruction>;