@wzrd_sol/sdk 0.1.0 → 0.1.2

package/README.md

@@ -1,4 +1,4 @@
-# @wzrd/sdk
+# @wzrd_sol/sdk
 
 TypeScript SDK for the Liquid Attention Protocol on Solana.
 
@@ -7,7 +7,7 @@ Builds `deposit_market`, `settle_market`, and `claim_global` transaction instruc
 ## Install
 
 ```bash
-npm install @wzrd/sdk @solana/web3.js
+npm install @wzrd_sol/sdk @solana/web3.js
 ```
 
 ## Example Scripts
@@ -46,7 +46,7 @@ import {
   getGlobalRootConfigPDA,
   getClaimStatePDA,
   PROGRAM_ID,
-} from '@wzrd/sdk';
+} from '@wzrd_sol/sdk';
 
 const protocolState = getProtocolStatePDA();
 const marketVault = getMarketVaultPDA(protocolState, 6); // market ID 6
@@ -57,7 +57,7 @@ const position = getUserPositionPDA(marketVault, walletPubkey);
 
 ```typescript
 import { Connection, Keypair, VersionedTransaction, TransactionMessage } from '@solana/web3.js';
-import { createDepositMarketIx } from '@wzrd/sdk';
+import { createDepositMarketIx } from '@wzrd_sol/sdk';
 
 const connection = new Connection('https://api.mainnet-beta.solana.com');
 const wallet = Keypair.fromSecretKey(/* your key */);
@@ -81,7 +81,7 @@ console.log('Deposit tx:', sig);
 ### Claim CCM via Merkle Proof
 
 ```typescript
-import { createClaimGlobalIx } from '@wzrd/sdk';
+import { createClaimGlobalIx } from '@wzrd_sol/sdk';
 
 // Fetch proof from the server API
 const res = await fetch(`https://api.twzrd.xyz/v1/claims/${wallet.publicKey.toBase58()}`);
@@ -101,16 +101,18 @@ const ixs = await createClaimGlobalIx(
 ### Settle a Matured Position
 
 ```typescript
-import { createSettleMarketIx } from '@wzrd/sdk';
+import { createSettleMarketIx } from '@wzrd_sol/sdk';
 
 const ixs = await createSettleMarketIx(connection, wallet.publicKey, 6);
 // Build, sign, send as above
 ```
 
+`settle_market` returns USDC from reserve and burns vLOFI. It does not mint CCM; CCM is claimed via merkle proof (`claim_global` / `claim_global_v2`).
+
 ### Read On-Chain State
 
 ```typescript
-import { fetchMarketVault, fetchOnChainPosition, fetchTokenBalance } from '@wzrd/sdk';
+import { fetchMarketVault, fetchOnChainPosition, fetchTokenBalance } from '@wzrd_sol/sdk';
 
 const vault = await fetchMarketVault(connection, 6);
 console.log('Total deposited:', vault?.totalDeposited);

package/dist/accounts.d.ts

@@ -15,6 +15,8 @@ export interface MarketVaultFull extends MarketVaultData {
     marketId: number;
     totalDeposited: bigint;
     totalShares: bigint;
+    navPerShareBps: bigint;
+    lastNavUpdateSlot: bigint;
 }
 export interface ProtocolStateData {
     isInitialized: boolean;

package/dist/accounts.js

@@ -5,7 +5,7 @@
  * programs/attention-oracle/src/state/*.rs.
  */
 import { PublicKey } from '@solana/web3.js';
-import { getProtocolStatePDA, getMarketVaultPDA, getUserPositionPDA } from './pda';
+import { getProtocolStatePDA, getMarketVaultPDA, getUserPositionPDA } from './pda.js';
 // ── Parsers ────────────────────────────────────────────
 /** Parse a MarketVault account's core fields (skip Anchor discriminator). */
 export function parseMarketVault(data) {
@@ -82,6 +82,8 @@ export async function fetchMarketVault(connection, marketId, programId) {
         marketId,
         totalDeposited: d.readBigUInt64LE(105),
         totalShares: d.readBigUInt64LE(113),
+        navPerShareBps: d.length >= 137 ? d.readBigUInt64LE(129) : 0n,
+        lastNavUpdateSlot: d.length >= 145 ? d.readBigUInt64LE(137) : 0n,
     };
 }
 /** Read a token account balance from chain. */

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 /**
- * @wzrd/sdk — TypeScript SDK for the Liquid Attention Protocol.
+ * @wzrd_sol/sdk — TypeScript SDK for the Liquid Attention Protocol.
  *
  * PDA derivation, instruction builders, and account parsers for
  * deposit_market, settle_market, and claim_global.
  */
-export declare const VERSION = "0.1.0";
-export { PROGRAM_ID, DEVNET_PROGRAM_ID, MAINNET_PROGRAM_ID, TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID, PROTOCOL_STATE_SEED, MARKET_VAULT_SEED, MARKET_POSITION_SEED, GLOBAL_ROOT_SEED, CLAIM_STATE_GLOBAL_SEED, CHANNEL_CONFIG_V2_SEED, } from './constants';
-export { getProtocolStatePDA, getMarketVaultPDA, getUserPositionPDA, getGlobalRootConfigPDA, getClaimStatePDA, getChannelConfigV2PDA, getAta, } from './pda';
-export type { MarketVaultData, MarketVaultFull, ProtocolStateData, OnChainPosition, } from './accounts';
-export { parseMarketVault, parseProtocolState, parseUserMarketPosition, fetchOnChainPosition, fetchMarketVault, fetchTokenBalance, } from './accounts';
-export { anchorDisc, createAtaIdempotentIx, createDepositMarketIx, createSettleMarketIx, createInitializeMarketVaultIx, createClaimGlobalIx, createChannelConfigV2Ix, } from './instructions';
+export declare const VERSION = "0.1.1";
+export { PROGRAM_ID, DEVNET_PROGRAM_ID, MAINNET_PROGRAM_ID, TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID, PROTOCOL_STATE_SEED, MARKET_VAULT_SEED, MARKET_POSITION_SEED, GLOBAL_ROOT_SEED, CLAIM_STATE_GLOBAL_SEED, CHANNEL_CONFIG_V2_SEED, } from './constants.js';
+export { getProtocolStatePDA, getMarketVaultPDA, getUserPositionPDA, getGlobalRootConfigPDA, getClaimStatePDA, getChannelConfigV2PDA, getAta, } from './pda.js';
+export type { MarketVaultData, MarketVaultFull, ProtocolStateData, OnChainPosition, } from './accounts.js';
+export { parseMarketVault, parseProtocolState, parseUserMarketPosition, fetchOnChainPosition, fetchMarketVault, fetchTokenBalance, } from './accounts.js';
+export type { NavInfo } from './nav.js';
+export { computeSharesForDeposit, computePrincipalForSettle, } from './nav.js';
+export { anchorDisc, createAtaIdempotentIx, createDepositMarketIx, createSettleMarketIx, createInitializeMarketVaultIx, createClaimGlobalIx, createClaimGlobalV2Ix, createChannelConfigV2Ix, } from './instructions.js';

package/dist/index.js

@@ -1,14 +1,15 @@
 /**
- * @wzrd/sdk — TypeScript SDK for the Liquid Attention Protocol.
+ * @wzrd_sol/sdk — TypeScript SDK for the Liquid Attention Protocol.
  *
  * PDA derivation, instruction builders, and account parsers for
  * deposit_market, settle_market, and claim_global.
  */
-export const VERSION = '0.1.0';
+export const VERSION = '0.1.1';
 // ── Constants ──────────────────────────────────────────
-export { PROGRAM_ID, DEVNET_PROGRAM_ID, MAINNET_PROGRAM_ID, TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID, PROTOCOL_STATE_SEED, MARKET_VAULT_SEED, MARKET_POSITION_SEED, GLOBAL_ROOT_SEED, CLAIM_STATE_GLOBAL_SEED, CHANNEL_CONFIG_V2_SEED, } from './constants';
+export { PROGRAM_ID, DEVNET_PROGRAM_ID, MAINNET_PROGRAM_ID, TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID, PROTOCOL_STATE_SEED, MARKET_VAULT_SEED, MARKET_POSITION_SEED, GLOBAL_ROOT_SEED, CLAIM_STATE_GLOBAL_SEED, CHANNEL_CONFIG_V2_SEED, } from './constants.js';
 // ── PDA Derivation ─────────────────────────────────────
-export { getProtocolStatePDA, getMarketVaultPDA, getUserPositionPDA, getGlobalRootConfigPDA, getClaimStatePDA, getChannelConfigV2PDA, getAta, } from './pda';
-export { parseMarketVault, parseProtocolState, parseUserMarketPosition, fetchOnChainPosition, fetchMarketVault, fetchTokenBalance, } from './accounts';
+export { getProtocolStatePDA, getMarketVaultPDA, getUserPositionPDA, getGlobalRootConfigPDA, getClaimStatePDA, getChannelConfigV2PDA, getAta, } from './pda.js';
+export { parseMarketVault, parseProtocolState, parseUserMarketPosition, fetchOnChainPosition, fetchMarketVault, fetchTokenBalance, } from './accounts.js';
+export { computeSharesForDeposit, computePrincipalForSettle, } from './nav.js';
 // ── Instruction Builders ───────────────────────────────
-export { anchorDisc, createAtaIdempotentIx, createDepositMarketIx, createSettleMarketIx, createInitializeMarketVaultIx, createClaimGlobalIx, createChannelConfigV2Ix, } from './instructions';
+export { anchorDisc, createAtaIdempotentIx, createDepositMarketIx, createSettleMarketIx, createInitializeMarketVaultIx, createClaimGlobalIx, createClaimGlobalV2Ix, createChannelConfigV2Ix, } from './instructions.js';

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
  *
- * @returns Array of instructions: idempotent ATA create for CCM + the settle IX.
+ * 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 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,423 @@ 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>;