@lightprotocol/compressed-token 0.23.0-beta.8 → 0.23.0

package/dist/types/unified/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
-import { PublicKey, AccountInfo, Commitment, TransactionInstruction, AccountMeta, Signer, Keypair, ConfirmOptions, TransactionSignature, Connection } from '@solana/web3.js';
-import { MerkleContext, CompressedAccountWithMerkleContext, Rpc, ValidityProofWithContext, AddressTreeInfo, TreeInfo, ParsedTokenAccount, ValidityProof, TreeType, PackedMerkleContextLegacy, CompressedCpiContext, InputTokenDataWithContext as InputTokenDataWithContext$1, CompressedProof } from '@lightprotocol/stateless.js';
+import { PublicKey, AccountInfo, Commitment, TransactionInstruction, Signer, Keypair, ConfirmOptions, TransactionSignature, AccountMeta, Connection } from '@solana/web3.js';
+import { MerkleContext, CompressedAccountWithMerkleContext, Rpc, ValidityProofWithContext, AddressTreeInfo, TreeInfo, ParsedTokenAccount, TreeType, PackedMerkleContextLegacy, CompressedCpiContext, ValidityProof, InputTokenDataWithContext as InputTokenDataWithContext$1, CompressedProof } from '@lightprotocol/stateless.js';
 export { ParsedTokenAccount } from '@lightprotocol/stateless.js';
 import { Account, Mint } from '@solana/spl-token';
 export { AccountState } from '@solana/spl-token';
@@ -798,8 +798,8 @@ declare const TokenAccountSourceType: {
     readonly Token2022: "token2022";
     readonly SplCold: "spl-cold";
     readonly Token2022Cold: "token2022-cold";
-    readonly CTokenHot: "ctoken-hot";
-    readonly CTokenCold: "ctoken-cold";
+    readonly LightTokenHot: "light-token-hot";
+    readonly LightTokenCold: "light-token-cold";
 };
 type TokenAccountSourceTypeValue = (typeof TokenAccountSourceType)[keyof typeof TokenAccountSourceType];
 /** @internal */
@@ -822,9 +822,9 @@ interface AccountInterface {
     _anyFrozen?: boolean;
     /** True when fetched via getAtaInterface */
     _isAta?: boolean;
-    /** ATA owner - set by getAtaInterface */
+    /** Associated token account owner - set by getAtaInterface */
     _owner?: PublicKey;
-    /** ATA mint - set by getAtaInterface */
+    /** Associated token account mint - set by getAtaInterface */
     _mint?: PublicKey;
 }
 /** @internal */
@@ -839,21 +839,21 @@ declare function convertTokenDataToAccount(address: PublicKey, tokenData: {
 /** Convert compressed account to AccountInfo */
 declare function toAccountInfo(compressedAccount: CompressedAccountWithMerkleContext): AccountInfo<Buffer$1>;
 /** @internal */
-declare function parseCTokenHot(address: PublicKey, accountInfo: AccountInfo<Buffer$1>): {
+declare function parseLightTokenHot(address: PublicKey, accountInfo: AccountInfo<Buffer$1>): {
     accountInfo: AccountInfo<Buffer$1>;
     loadContext: undefined;
     parsed: Account;
     isCold: false;
 };
 /** @internal */
-declare function parseCTokenCold(address: PublicKey, compressedAccount: CompressedAccountWithMerkleContext): {
+declare function parseLightTokenCold(address: PublicKey, compressedAccount: CompressedAccountWithMerkleContext): {
     accountInfo: AccountInfo<Buffer$1>;
     loadContext: MerkleContext;
     parsed: Account;
     isCold: true;
 };
 /**
- * Retrieve information about a token account of SPL/T22/c-token.
+ * Retrieve information about a token account of SPL/T22/light-token.
  *
  * @param rpc        RPC connection to use
  * @param address    Token account address
@@ -1048,45 +1048,6 @@ declare function selectTokenPoolInfo(infos: TokenPoolInfo[]): TokenPoolInfo;
  */
 declare function selectTokenPoolInfosForDecompression(infos: TokenPoolInfo[], decompressAmount: number | BN): TokenPoolInfo[];
 
-/**
- * Options for interface operations (load, transfer)
- */
-interface InterfaceOptions {
-    /** SPL interface infos (fetched if not provided) */
-    splInterfaceInfos?: SplInterfaceInfo[];
-}
-/**
- * Options for createTransferInterfaceInstructions.
- */
-interface TransferOptions extends InterfaceOptions {
-    /** Include SPL/T22 wrapping to c-token ATA (unified path). Default: false. */
-    wrap?: boolean;
-    /** Token program ID. Default: LIGHT_TOKEN_PROGRAM_ID. */
-    programId?: PublicKey;
-    /**
-     * Include an idempotent recipient ATA creation instruction in the
-     * transfer transaction. No extra RPC fetch -- uses
-     * createAssociatedTokenAccountInterfaceIdempotentInstruction which is
-     * a no-op on-chain if the ATA already exists (~200 CU overhead).
-     * Default: true.
-     */
-    ensureRecipientAta?: boolean;
-}
-/**
- * Splits the last element from an array.
- *
- * Useful for separating load transactions (parallel) from the final transfer
- * transaction (sequential) returned by `createTransferInterfaceInstructions`.
- *
- * @returns `{ rest, last }` where `rest` is everything before the last
- * element and `last` is the last element.
- * @throws if the input array is empty.
- */
-declare function sliceLast<T>(items: T[]): {
-    rest: T[];
-    last: T;
-};
-
 interface LayoutObject {
     [key: string]: any;
 }
@@ -1226,7 +1187,7 @@ interface AdditionalMetadata {
 }
 
 /**
- * Token metadata for creating a c-token mint.
+ * Token metadata for creating a light-token mint.
  */
 interface TokenMetadataInstructionData {
     name: string;
@@ -1237,7 +1198,7 @@ interface TokenMetadataInstructionData {
 }
 declare function createTokenMetadata(name: string, symbol: string, uri: string, updateAuthority?: PublicKey | null, additionalMetadata?: AdditionalMetadata[] | null): TokenMetadataInstructionData;
 /**
- * Create instruction for initializing a c-token mint.
+ * Create instruction for initializing a light-token mint.
  *
  * @param mintSigner          Mint signer keypair public key.
  * @param decimals            Number of decimals for the mint.
@@ -1248,8 +1209,9 @@ declare function createTokenMetadata(name: string, symbol: string, uri: string,
  * @param addressTreeInfo     Address tree info for the mint.
  * @param outputStateTreeInfo Output state tree info.
  * @param metadata            Optional token metadata.
+ * @param maxTopUp             Optional cap on rent top-up (units of 1k lamports; default no cap)
  */
-declare function createMintInstruction(mintSigner: PublicKey, decimals: number, mintAuthority: PublicKey, freezeAuthority: PublicKey | null, payer: PublicKey, validityProof: ValidityProofWithContext, addressTreeInfo: AddressTreeInfo, outputStateTreeInfo: TreeInfo, metadata?: TokenMetadataInstructionData): TransactionInstruction;
+declare function createMintInstruction(mintSigner: PublicKey, decimals: number, mintAuthority: PublicKey, freezeAuthority: PublicKey | null, payer: PublicKey, validityProof: ValidityProofWithContext, addressTreeInfo: AddressTreeInfo, outputStateTreeInfo: TreeInfo, metadata?: TokenMetadataInstructionData, maxTopUp?: number): TransactionInstruction;
 
 /**
  * SPL-compatible base mint structure
@@ -1267,12 +1229,12 @@ interface BaseMint {
     freezeAuthority: PublicKey | null;
 }
 /**
- * Compressed mint context (protocol version, SPL mint reference)
+ * Light mint context (protocol version, SPL mint reference)
  */
 interface MintContext {
     /** Protocol version for upgradability */
     version: number;
-    /** Whether the compressed mint is decompressed to a CMint Solana account */
+    /** Whether the compressed light mint has been decompressed to a light mint account */
     cmintDecompressed: boolean;
     /** PDA of the associated SPL mint */
     splMint: PublicKey;
@@ -1310,7 +1272,7 @@ interface TokenMetadata {
     }[];
 }
 /**
- * Complete compressed mint structure (raw format)
+ * Complete light mint structure (raw format)
  */
 interface CompressedMint {
     base: BaseMint;
@@ -1339,7 +1301,7 @@ interface RentConfig {
     maxTopUp: number;
 }
 /**
- * Compression info embedded in CompressedMint
+ * Compression info embedded in light mint
  */
 interface CompressionInfo {
     /** Config account version (0 = uninitialized) */
@@ -1364,18 +1326,18 @@ interface CompressionInfo {
     rentConfig: RentConfig;
 }
 /**
- * Deserialize a compressed mint from buffer
+ * Deserialize a light mint from buffer
  * Uses SPL's MintLayout for BaseMint and buffer-layout struct for context
  *
  * @param data - The raw account data buffer
- * @returns The deserialized CompressedMint
+ * @returns The deserialized light mint
  */
 declare function deserializeMint(data: Buffer$1 | Uint8Array): CompressedMint;
 /**
- * Serialize a CompressedMint to buffer
+ * Serialize a light mint to buffer
  * Uses SPL's MintLayout for BaseMint, helper functions for context/metadata
  *
- * @param mint - The CompressedMint to serialize
+ * @param mint - The light mint to serialize
  * @returns The serialized buffer
  */
 declare function serializeMint(mint: CompressedMint): Buffer$1;
@@ -1438,11 +1400,11 @@ interface MintInterface {
     mintContext?: MintContext;
     tokenMetadata?: TokenMetadata;
     extensions?: MintExtension[];
-    /** Compression info for c-token mints */
+    /** Compression info for light-token mints */
     compression?: CompressionInfo;
 }
 /**
- * Get unified mint info for SPL/T22/c-token mints.
+ * Get unified mint info for SPL/T22/light-token mints.
  *
  * @param rpc           RPC connection
  * @param address       The mint address
@@ -1454,16 +1416,16 @@ interface MintInterface {
  */
 declare function getMintInterface(rpc: Rpc, address: PublicKey, commitment?: Commitment, programId?: PublicKey): Promise<MintInterface>;
 /**
- * Unpack mint info from raw account data for SPL/T22/c-token.
+ * Unpack mint info from raw account data for SPL/T22/light-token.
  *
  * @param address       The mint pubkey
  * @param data          The raw account data or AccountInfo
- * @param programId     Token program ID. Default c-token.
+ * @param programId     Token program ID. Default light-token.
  * @returns Object with mint, optional mintContext and tokenMetadata.
  */
 declare function unpackMintInterface(address: PublicKey, data: Buffer$1 | Uint8Array | AccountInfo<Buffer$1>, programId?: PublicKey): Omit<MintInterface, 'merkleContext'>;
 /**
- * Unpack c-token mint context and metadata from raw account data
+ * Unpack light-token mint context and metadata from raw account data
  *
  * @param data  The raw account data
  * @returns     Object with mintContext, tokenMetadata, and extensions
@@ -1475,19 +1437,20 @@ declare function unpackMintData(data: Buffer$1 | Uint8Array): {
 };
 
 /**
- * Create instruction for updating a compressed mint's mint authority.
- * Works for both compressed and decompressed mints.
+ * Create instruction for updating a light mint's mint authority.
+ * Works for both compressed and decompressed light mints.
  *
  * @param mintInterface          MintInterface from getMintInterface() - must have merkleContext
  * @param currentMintAuthority   Current mint authority public key (must sign)
  * @param newMintAuthority       New mint authority (or null to revoke)
  * @param payer                  Fee payer public key
- * @param validityProof          Validity proof for the compressed mint (null for decompressed mints)
+ * @param validityProof          Validity proof for the compressed light mint (null for decompressed light mints)
+ * @param maxTopUp               Optional cap on rent top-up (units of 1k lamports; default no cap)
  */
-declare function createUpdateMintAuthorityInstruction(mintInterface: MintInterface, currentMintAuthority: PublicKey, newMintAuthority: PublicKey | null, payer: PublicKey, validityProof: ValidityProofWithContext | null): TransactionInstruction;
+declare function createUpdateMintAuthorityInstruction(mintInterface: MintInterface, currentMintAuthority: PublicKey, newMintAuthority: PublicKey | null, payer: PublicKey, validityProof: ValidityProofWithContext | null, maxTopUp?: number): TransactionInstruction;
 /**
- * Create instruction for updating a compressed mint's freeze authority.
- * Works for both compressed and decompressed mints.
+ * Create instruction for updating a light mint's freeze authority.
+ * Works for both compressed and decompressed light mints.
  *
  * Output queue is automatically derived from mintInterface.merkleContext.treeInfo
  * (preferring nextTreeInfo.queue if available for rollover support).
@@ -1496,12 +1459,13 @@ declare function createUpdateMintAuthorityInstruction(mintInterface: MintInterfa
  * @param currentFreezeAuthority   Current freeze authority public key (must sign)
  * @param newFreezeAuthority       New freeze authority (or null to revoke)
  * @param payer                    Fee payer public key
- * @param validityProof            Validity proof for the compressed mint (null for decompressed mints)
+ * @param validityProof            Validity proof for the compressed light mint (null for decompressed light mints)
+ * @param maxTopUp                 Optional cap on rent top-up (units of 1k lamports; default no cap)
  */
-declare function createUpdateFreezeAuthorityInstruction(mintInterface: MintInterface, currentFreezeAuthority: PublicKey, newFreezeAuthority: PublicKey | null, payer: PublicKey, validityProof: ValidityProofWithContext | null): TransactionInstruction;
+declare function createUpdateFreezeAuthorityInstruction(mintInterface: MintInterface, currentFreezeAuthority: PublicKey, newFreezeAuthority: PublicKey | null, payer: PublicKey, validityProof: ValidityProofWithContext | null, maxTopUp?: number): TransactionInstruction;
 
 /**
- * Create instruction for updating a compressed mint's metadata field.
+ * Create instruction for updating a light mint's metadata field.
  *
  * Output queue is automatically derived from mintInterface.merkleContext.treeInfo
  * (preferring nextTreeInfo.queue if available for rollover support).
@@ -1509,15 +1473,16 @@ declare function createUpdateFreezeAuthorityInstruction(mintInterface: MintInter
  * @param mintInterface  MintInterface from getMintInterface() - must have merkleContext and tokenMetadata
  * @param authority      Metadata update authority public key (must sign)
  * @param payer          Fee payer public key
- * @param validityProof  Validity proof for the compressed mint (null for decompressed mints)
+ * @param validityProof  Validity proof for the light mint (null for decompressed light mints)
  * @param fieldType      Field to update: 'name', 'symbol', 'uri', or 'custom'
  * @param value          New value for the field
  * @param customKey      Custom key name (required if fieldType is 'custom')
  * @param extensionIndex Extension index (default: 0)
+ * @param maxTopUp        Optional cap on rent top-up (units of 1k lamports; default no cap)
  */
-declare function createUpdateMetadataFieldInstruction(mintInterface: MintInterface, authority: PublicKey, payer: PublicKey, validityProof: ValidityProofWithContext | null, fieldType: 'name' | 'symbol' | 'uri' | 'custom', value: string, customKey?: string, extensionIndex?: number): TransactionInstruction;
+declare function createUpdateMetadataFieldInstruction(mintInterface: MintInterface, authority: PublicKey, payer: PublicKey, validityProof: ValidityProofWithContext | null, fieldType: 'name' | 'symbol' | 'uri' | 'custom', value: string, customKey?: string, extensionIndex?: number, maxTopUp?: number): TransactionInstruction;
 /**
- * Create instruction for updating a compressed mint's metadata authority.
+ * Create instruction for updating a light mint's metadata authority.
  *
  * Output queue is automatically derived from mintInterface.merkleContext.treeInfo
  * (preferring nextTreeInfo.queue if available for rollover support).
@@ -1526,12 +1491,13 @@ declare function createUpdateMetadataFieldInstruction(mintInterface: MintInterfa
  * @param currentAuthority Current metadata update authority public key (must sign)
  * @param newAuthority     New metadata update authority public key
  * @param payer            Fee payer public key
- * @param validityProof    Validity proof for the compressed mint (null for decompressed mints)
+ * @param validityProof    Validity proof for the light mint (null for decompressed light mints)
  * @param extensionIndex   Extension index (default: 0)
+ * @param maxTopUp         Optional cap on rent top-up (units of 1k lamports; default no cap)
  */
-declare function createUpdateMetadataAuthorityInstruction(mintInterface: MintInterface, currentAuthority: PublicKey, newAuthority: PublicKey, payer: PublicKey, validityProof: ValidityProofWithContext | null, extensionIndex?: number): TransactionInstruction;
+declare function createUpdateMetadataAuthorityInstruction(mintInterface: MintInterface, currentAuthority: PublicKey, newAuthority: PublicKey, payer: PublicKey, validityProof: ValidityProofWithContext | null, extensionIndex?: number, maxTopUp?: number): TransactionInstruction;
 /**
- * Create instruction for removing a metadata key from a compressed mint.
+ * Create instruction for removing a metadata key from a light mint.
  *
  * Output queue is automatically derived from mintInterface.merkleContext.treeInfo
  * (preferring nextTreeInfo.queue if available for rollover support).
@@ -1539,12 +1505,13 @@ declare function createUpdateMetadataAuthorityInstruction(mintInterface: MintInt
  * @param mintInterface  MintInterface from getMintInterface() - must have merkleContext and tokenMetadata
  * @param authority      Metadata update authority public key (must sign)
  * @param payer          Fee payer public key
- * @param validityProof  Validity proof for the compressed mint (null for decompressed mints)
+ * @param validityProof  Validity proof for the light mint (null for decompressed light mints)
  * @param key            Metadata key to remove
  * @param idempotent     If true, don't error if key doesn't exist (default: false)
  * @param extensionIndex Extension index (default: 0)
+ * @param maxTopUp        Optional cap on rent top-up (units of 1k lamports; default no cap)
  */
-declare function createRemoveMetadataKeyInstruction(mintInterface: MintInterface, authority: PublicKey, payer: PublicKey, validityProof: ValidityProofWithContext | null, key: string, idempotent?: boolean, extensionIndex?: number): TransactionInstruction;
+declare function createRemoveMetadataKeyInstruction(mintInterface: MintInterface, authority: PublicKey, payer: PublicKey, validityProof: ValidityProofWithContext | null, key: string, idempotent?: boolean, extensionIndex?: number, maxTopUp?: number): TransactionInstruction;
 
 interface CompressToPubkey {
     bump: number;
@@ -1558,11 +1525,11 @@ interface CompressibleConfig {
     writeTopUp: number;
     compressToAccountPubkey?: CompressToPubkey | null;
 }
-interface CreateAssociatedCTokenAccountParams {
+interface CreateAssociatedLightTokenAccountParams {
     compressibleConfig?: CompressibleConfig | null;
 }
 /**
- * Default compressible config for c-token ATAs - matches Rust SDK defaults.
+ * Default compressible config for light-token ATAs - matches Rust SDK defaults.
  *
  * - tokenAccountVersion: 3 (ShaFlat) - latest hashing scheme
  * - rentPayment: 16 - prepay 16 epochs (~24 hours rent)
@@ -1570,7 +1537,7 @@ interface CreateAssociatedCTokenAccountParams {
  * - writeTopUp: 766 - per-write top-up (~2 epochs rent) when rent < 2 epochs
  * - compressToAccountPubkey: null - required for ATAs
  *
- * Cost breakdown at ATA creation:
+ * Cost breakdown at associated token account creation:
  * - Rent sponsor PDA (LIGHT_TOKEN_RENT_SPONSOR) pays: rent exemption (~890,880 lamports)
  * - Fee payer pays: compression_cost (11K) + 16 epochs rent (~6,400) = ~17,400 lamports + tx fees
  *
@@ -1578,7 +1545,7 @@ interface CreateAssociatedCTokenAccountParams {
  * - When account rent is below 2 epochs, fee payer pays 766 lamports top-up
  * - This keeps the account perpetually funded when actively used
  *
- * Rent calculation (272-byte compressible ctoken account):
+ * Rent calculation (272-byte compressible lightToken account):
  * - rent_per_epoch = base_rent (128) + bytes * rent_per_byte (272 * 1) = 400 lamports
  * - 16 epochs = 16 * 400 = 6,400 lamports (24 hours)
  * - 2 epochs = 2 * 400 = 800 lamports (~3 hours, writeTopUp = 766 is conservative)
@@ -1594,7 +1561,7 @@ interface CreateAssociatedCTokenAccountParams {
  */
 declare const DEFAULT_COMPRESSIBLE_CONFIG: CompressibleConfig;
 /**
- * Create instruction for creating an associated compressed token account.
+ * Create instruction for creating an associated light-token account.
  * Uses the default rent sponsor PDA by default.
  *
  * @param feePayer          Fee payer public key.
@@ -1604,9 +1571,9 @@ declare const DEFAULT_COMPRESSIBLE_CONFIG: CompressibleConfig;
  * @param configAccount     Config account (defaults to LIGHT_TOKEN_CONFIG).
  * @param rentPayerPda      Rent payer PDA (defaults to LIGHT_TOKEN_RENT_SPONSOR).
  */
-declare function createAssociatedCTokenAccountInstruction(feePayer: PublicKey, owner: PublicKey, mint: PublicKey, compressibleConfig?: CompressibleConfig | null, configAccount?: PublicKey, rentPayerPda?: PublicKey): TransactionInstruction;
+declare function createAssociatedLightTokenAccountInstruction(feePayer: PublicKey, owner: PublicKey, mint: PublicKey, compressibleConfig?: CompressibleConfig | null, configAccount?: PublicKey, rentPayerPda?: PublicKey): TransactionInstruction;
 /**
- * Create idempotent instruction for creating an associated compressed token account.
+ * Create idempotent instruction for creating an associated light-token account.
  * Uses the default rent sponsor PDA by default.
  *
  * @param feePayer          Fee payer public key.
@@ -1616,19 +1583,19 @@ declare function createAssociatedCTokenAccountInstruction(feePayer: PublicKey, o
  * @param configAccount     Config account (defaults to LIGHT_TOKEN_CONFIG).
  * @param rentPayerPda      Rent payer PDA (defaults to LIGHT_TOKEN_RENT_SPONSOR).
  */
-declare function createAssociatedCTokenAccountIdempotentInstruction(feePayer: PublicKey, owner: PublicKey, mint: PublicKey, compressibleConfig?: CompressibleConfig | null, configAccount?: PublicKey, rentPayerPda?: PublicKey): TransactionInstruction;
+declare function createAssociatedLightTokenAccountIdempotentInstruction(feePayer: PublicKey, owner: PublicKey, mint: PublicKey, compressibleConfig?: CompressibleConfig | null, configAccount?: PublicKey, rentPayerPda?: PublicKey): TransactionInstruction;
 
 /**
- * c-token-specific config for createAssociatedTokenAccountInterfaceInstruction
+ * light-token-specific config for createAssociatedTokenAccountInterfaceInstruction
  */
-interface CTokenConfig {
+interface LightTokenConfig {
     compressibleConfig?: CompressibleConfig | null;
     configAccount?: PublicKey;
     rentPayerPda?: PublicKey;
 }
 /**
  * Create instruction for creating an associated token account (SPL, Token-2022,
- * or c-token). Follows SPL Token API signature with optional c-token config at the
+ * or light-token). Follows SPL Token API signature with optional light-token config at the
  * end.
  *
  * @param payer                    Fee payer public key.
@@ -1637,12 +1604,12 @@ interface CTokenConfig {
  * @param mint                     Mint address.
  * @param programId                Token program ID (default: TOKEN_PROGRAM_ID).
  * @param associatedTokenProgramId Associated token program ID.
- * @param ctokenConfig             Optional c-token-specific configuration.
+ * @param lightTokenConfig             Optional light-token-specific configuration.
  */
-declare function createAssociatedTokenAccountInterfaceInstruction(payer: PublicKey, associatedToken: PublicKey, owner: PublicKey, mint: PublicKey, programId?: PublicKey, associatedTokenProgramId?: PublicKey, ctokenConfig?: CTokenConfig): TransactionInstruction;
+declare function createAssociatedTokenAccountInterfaceInstruction(payer: PublicKey, associatedToken: PublicKey, owner: PublicKey, mint: PublicKey, programId?: PublicKey, associatedTokenProgramId?: PublicKey, lightTokenConfig?: LightTokenConfig): TransactionInstruction;
 /**
  * Create idempotent instruction for creating an associated token account (SPL,
- * Token-2022, or c-token). Follows SPL Token API signature with optional c-token
+ * Token-2022, or light-token). Follows SPL Token API signature with optional light-token
  * config at the end.
  *
  * @param payer                    Fee payer public key.
@@ -1651,36 +1618,70 @@ declare function createAssociatedTokenAccountInterfaceInstruction(payer: PublicK
  * @param mint                     Mint address.
  * @param programId                Token program ID (default: TOKEN_PROGRAM_ID).
  * @param associatedTokenProgramId Associated token program ID.
- * @param ctokenConfig             Optional c-token-specific configuration.
+ * @param lightTokenConfig             Optional light-token-specific configuration.
  */
-declare function createAssociatedTokenAccountInterfaceIdempotentInstruction(payer: PublicKey, associatedToken: PublicKey, owner: PublicKey, mint: PublicKey, programId?: PublicKey, associatedTokenProgramId?: PublicKey, ctokenConfig?: CTokenConfig): TransactionInstruction;
+declare function createAssociatedTokenAccountInterfaceIdempotentInstruction(payer: PublicKey, associatedToken: PublicKey, owner: PublicKey, mint: PublicKey, programId?: PublicKey, associatedTokenProgramId?: PublicKey, lightTokenConfig?: LightTokenConfig): TransactionInstruction;
 /**
  * Short alias for createAssociatedTokenAccountInterfaceIdempotentInstruction.
  */
 declare const createAtaInterfaceIdempotentInstruction: typeof createAssociatedTokenAccountInterfaceIdempotentInstruction;
 
+declare function sliceLast<T>(items: T[]): {
+    rest: T[];
+    last: T;
+};
+
+/**
+ * Create a light-token transfer instruction.
+ *
+ * For light-token accounts with compressible extension, the program needs
+ * system_program and fee_payer to handle rent top-ups.
+ *
+ * @param source        Source light-token account
+ * @param destination   Destination light-token account
+ * @param owner         Owner of the source account (signer, also pays for compressible extension top-ups)
+ * @param amount        Amount to transfer
+ * @param feePayer      Optional fee payer for top-ups (defaults to owner)
+ * @returns Transaction instruction for light-token transfer
+ */
+declare function createLightTokenTransferInstruction(source: PublicKey, destination: PublicKey, owner: PublicKey, amount: number | bigint, feePayer?: PublicKey): TransactionInstruction;
+/**
+ * Create a light-token transfer_checked instruction. Same semantics as SPL
+ * TransferChecked.
+ */
+declare function createLightTokenTransferCheckedInstruction(source: PublicKey, destination: PublicKey, mint: PublicKey, owner: PublicKey, amount: number | bigint, decimals: number, payer: PublicKey): TransactionInstruction;
+
+interface InterfaceOptions {
+    splInterfaceInfos?: SplInterfaceInfo[];
+    wrap?: boolean;
+    /**
+     * Delegate authority pubkey. For owner-signed flows, omit this field.
+     */
+    delegatePubkey?: PublicKey;
+}
+
 /**
  * Parameters for creating a MintTo instruction.
  */
 interface CreateMintToInstructionParams {
-    /** Mint account (CMint - decompressed compressed mint) */
+    /** Light mint account (decompressed from compressed light mint) */
     mint: PublicKey;
-    /** Destination CToken account to mint to */
+    /** Destination light-token account to mint to */
     destination: PublicKey;
     /** Amount of tokens to mint */
     amount: number | bigint;
     /** Mint authority (must be signer) */
     authority: PublicKey;
-    /** Maximum lamports for rent and top-up combined. Transaction fails if exceeded. (0 = no limit) */
+    /** Maximum lamports for rent and top-up combined. Transaction fails if exceeded. (u16::MAX = no limit, 0 = no top-ups allowed) */
     maxTopUp?: number;
     /** Optional fee payer for rent top-ups. If not provided, authority pays. */
     feePayer?: PublicKey;
 }
 /**
- * Create instruction for minting tokens to a CToken account.
+ * Create instruction for minting tokens to a light-token account.
  *
- * This is a simple 3-4 account instruction for minting to decompressed CToken accounts.
- * Uses discriminator 7 (CTokenMintTo).
+ * This is a simple 3-4 account instruction for minting to light-token associated token accounts (hot).
+ * Uses discriminator 7 (LightTokenMintTo).
  *
  * @param params - Mint instruction parameters
  * @returns TransactionInstruction for minting tokens
@@ -1714,9 +1715,14 @@ declare const COMPRESS_SPL_TOKEN_ACCOUNT_DISCRIMINATOR: Buffer$1<ArrayBuffer>;
 declare const APPROVE_DISCRIMINATOR: Buffer$1<ArrayBuffer>;
 declare const REVOKE_DISCRIMINATOR: Buffer$1<ArrayBuffer>;
 declare const ADD_TOKEN_POOL_DISCRIMINATOR: Buffer$1<ArrayBuffer>;
-declare const DECOMPRESS_ACCOUNTS_IDEMPOTENT_DISCRIMINATOR: Buffer$1<ArrayBuffer>;
 /**
- * Rent configuration constants for compressible ctoken accounts.
+ * Maximum lamports for rent top-up in a single instruction.
+ * u16::MAX = no limit; 0 = no top-ups allowed.
+ * Matches Rust SDK (e.g. token-sdk create_mints uses u16::MAX for "no limit").
+ */
+declare const MAX_TOP_UP = 65535;
+/**
+ * Rent configuration constants for compressible light token accounts.
  * These match the Rust SDK defaults in program-libs/compressible/src/rent/config.rs
  */
 /** Base rent per epoch (lamports) */
@@ -1732,21 +1738,21 @@ declare const COMPRESSION_INCENTIVE = 1000;
 /** Total compression cost (COMPRESSION_COST + COMPRESSION_INCENTIVE) */
 declare const TOTAL_COMPRESSION_COST: number;
 /**
- * Compressible ctoken account size in bytes.
+ * Compressible light token account size in bytes.
  * = 165 (base SPL token) + 1 (account_type) + 1 (Option) + 4 (Vec len) + 1 (ext disc) + 4 (ext header) + 96 (CompressionInfo) = 272
  * Source: program-libs/token-interface/src/state/token/top_up.rs MIN_SIZE_WITH_COMPRESSIBLE
  */
-declare const COMPRESSIBLE_CTOKEN_ACCOUNT_SIZE = 272;
+declare const COMPRESSIBLE_LIGHT_TOKEN_ACCOUNT_SIZE = 272;
 /**
  * Calculate rent per epoch for a given account size.
  * Formula: base_rent + (bytes * lamports_per_byte_per_epoch)
  */
 declare function rentPerEpoch(bytes: number): number;
 /**
- * Default rent per epoch for a compressible ctoken account (272 bytes).
+ * Default rent per epoch for a compressible light token account (272 bytes).
  * = 128 + 272 = 400 lamports
  */
-declare const COMPRESSIBLE_CTOKEN_RENT_PER_EPOCH: number;
+declare const COMPRESSIBLE_LIGHT_TOKEN_RENT_PER_EPOCH: number;
 /** Default prepaid epochs (24 hours = 16 epochs * 1.5h) */
 declare const DEFAULT_PREPAY_EPOCHS = 16;
 /** Default write top-up (lamports) - ~2 epochs rent */
@@ -1758,33 +1764,34 @@ declare const DEFAULT_WRITE_TOP_UP = 766;
 declare function calculateFeePayerCostAtCreation(prepayEpochs?: number, accountBytes?: number): number;
 
 /**
- * Create instruction for minting tokens from a c-mint to compressed accounts.
- * To mint to onchain token accounts across SPL/T22/c-mints, use
+ * Create instruction for minting tokens from a light mint to compressed accounts.
+ * To mint to light-token associated token accounts across SPL/T22/light mints, use
  * {@link createMintToInterfaceInstruction} instead.
  *
  * @param authority             Mint authority public key.
  * @param payer                 Fee payer public key.
- * @param validityProof         Validity proof for the compressed mint.
- * @param merkleContext         Merkle context of the compressed mint.
+ * @param validityProof         Validity proof for the light mint.
+ * @param merkleContext         Merkle context of the light mint.
  * @param mintData              Mint instruction data.
  * @param recipients            Array of recipients with amounts.
  * @param outputStateTreeInfo   Optional output state tree info. Uses merkle
  * context queue if not provided.
  * @param tokenAccountVersion   Token account version (default:
  * TokenDataVersion.ShaFlat).
+ * @param maxTopUp              Optional cap on rent top-up (units of 1k lamports; default no cap)
  */
 declare function createMintToCompressedInstruction(authority: PublicKey, payer: PublicKey, validityProof: ValidityProofWithContext, merkleContext: MerkleContext, mintData: MintInstructionData, recipients: Array<{
     recipient: PublicKey;
     amount: number | bigint;
-}>, outputStateTreeInfo?: TreeInfo, tokenAccountVersion?: TokenDataVersion): TransactionInstruction;
+}>, outputStateTreeInfo?: TreeInfo, tokenAccountVersion?: TokenDataVersion, maxTopUp?: number): TransactionInstruction;
 
 /**
- * Create mint-to instruction for SPL, Token-2022, or CToken mints.
- * This instruction ONLY mints to decompressed/onchain token accounts.
+ * Create mint-to instruction for SPL, Token-2022, or light-token mints.
+ * This instruction ONLY mints to light-token associated token accounts (hot).
  *
- * For CToken mints, the mint must be decompressed first (CMint account must exist on-chain).
+ * For light-token mints, the light mint account must exist (mint must be decompressed first).
  *
- * @param mintInterface   Mint interface (SPL, Token-2022, or CToken).
+ * @param mintInterface   Mint interface (SPL, Token-2022, or light-token).
  * @param destination     Destination onchain token account address.
  * @param authority       Mint authority public key.
  * @param payer           Fee payer public key.
@@ -1794,185 +1801,28 @@ declare function createMintToCompressedInstruction(authority: PublicKey, payer:
  */
 declare function createMintToInterfaceInstruction(mintInterface: MintInterface, destination: PublicKey, authority: PublicKey, payer: PublicKey, amount: number | bigint, validityProof?: ValidityProofWithContext, multiSigners?: PublicKey[]): TransactionInstruction;
 
-/**
- * Create a Light token transfer instruction.
- *
- * For c-token accounts with compressible extension, the program needs
- * system_program and fee_payer to handle rent top-ups.
- *
- * @param source        Source c-token account
- * @param destination   Destination c-token account
- * @param owner         Owner of the source account (signer, also pays for compressible extension top-ups)
- * @param amount        Amount to transfer
- * @param feePayer      Optional fee payer for top-ups (defaults to owner)
- * @returns Transaction instruction for Light token transfer
- */
-declare function createLightTokenTransferInstruction(source: PublicKey, destination: PublicKey, owner: PublicKey, amount: number | bigint, feePayer?: PublicKey): TransactionInstruction;
-
-/**
- * Create decompressInterface instruction using Transfer2.
- *
- * Supports decompressing to both c-token accounts and SPL token accounts:
- * - For c-token destinations: No splInterfaceInfo needed
- * - For SPL destinations: Provide splInterfaceInfo (token pool info) and decimals
- *
- * @param payer                        Fee payer public key
- * @param inputCompressedTokenAccounts Input compressed token accounts
- * @param toAddress                    Destination token account address (c-token or SPL ATA)
- * @param amount                       Amount to decompress
- * @param validityProof                Validity proof (contains compressedProof and rootIndices)
- * @param splInterfaceInfo             Optional: SPL interface info for SPL destinations
- * @param decimals                     Mint decimals (required for SPL destinations)
- * @returns TransactionInstruction
- */
-declare function createDecompressInterfaceInstruction(payer: PublicKey, inputCompressedTokenAccounts: ParsedTokenAccount[], toAddress: PublicKey, amount: bigint, validityProof: ValidityProofWithContext, splInterfaceInfo: SplInterfaceInfo | undefined, decimals: number): TransactionInstruction;
-
-/**
- * Account info interface for compressible accounts.
- * Matches return structure of getAccountInterface/getAtaInterface.
- *
- * Integrating programs provide their own fetch/parse - this is just the data shape.
- */
-interface ParsedAccountInfoInterface<T = unknown> {
-    /** Parsed account data (program-specific) */
-    parsed: T;
-    /** Load context - present if account is compressed (cold), undefined if hot */
-    loadContext?: MerkleContext;
-}
-/**
- * Input for createLoadAccountsParams.
- * Supports both program PDAs and c-token vaults.
- *
- * The integrating program is responsible for fetching and parsing their accounts.
- * This helper just packs them for the decompressAccountsIdempotent instruction.
- */
-interface CompressibleAccountInput<T = unknown> {
-    /** Account address */
-    address: PublicKey;
-    /**
-     * Account type key for packing:
-     * - For PDAs: program-specific type name (e.g., "poolState", "observationState")
-     * - For c-token vaults: "cTokenData"
-     */
-    accountType: string;
-    /**
-     * Token variant - required when accountType is "cTokenData".
-     * Examples: "lpVault", "token0Vault", "token1Vault"
-     */
-    tokenVariant?: string;
-    /** Parsed account info (from program-specific fetch) */
-    info: ParsedAccountInfoInterface<T>;
-}
-/**
- * Packed compressed account for decompressAccountsIdempotent instruction
- */
-interface PackedCompressedAccount {
-    [key: string]: unknown;
-    merkleContext: {
-        merkleTreePubkeyIndex: number;
-        queuePubkeyIndex: number;
-    };
-}
-/**
- * Result from building load params
- */
-interface CompressibleLoadParams {
-    /** Validity proof wrapped in option (null if all proveByIndex) */
-    proofOption: {
-        0: ValidityProof | null;
-    };
-    /** Packed compressed accounts data for instruction */
-    compressedAccounts: PackedCompressedAccount[];
-    /** Offset to system accounts in remainingAccounts */
-    systemAccountsOffset: number;
-    /** Account metas for remaining accounts */
-    remainingAccounts: AccountMeta[];
-}
-/**
- * Result from createLoadAccountsParams
- */
-interface LoadResult {
-    /** Params for decompressAccountsIdempotent (null if no program accounts need decompressing) */
-    decompressParams: CompressibleLoadParams | null;
-    /** Instructions to load ATAs (create ATA, wrap SPL/T22, decompressInterface) */
-    ataInstructions: TransactionInstruction[];
-}
-/**
- * Create params for loading program accounts and ATAs.
- *
- * Returns:
- * - decompressParams: for a caller program's standardized
- *   decompressAccountsIdempotent instruction
- * - ataInstructions: for loading user ATAs
- *
- * @param rpc              RPC connection
- * @param payer            Fee payer (needed for ATA instructions)
- * @param programId        Program ID for decompressAccountsIdempotent
- * @param programAccounts  PDAs and vaults (caller pre-fetches)
- * @param atas             User ATAs (fetched via getAtaInterface)
- * @param options          Optional load options
- * @returns                LoadResult with decompressParams and ataInstructions
- *
- * @example
- * ```typescript
- * const poolInfo = await myProgram.fetchPoolState(rpc, poolAddress);
- * const vault0Ata = getAssociatedTokenAddressInterface(token0Mint, poolAddress);
- * const vault0Info = await getAtaInterface(rpc, vault0Ata, poolAddress, token0Mint, undefined, LIGHT_TOKEN_PROGRAM_ID);
- * const userAta = getAssociatedTokenAddressInterface(tokenMint, userWallet);
- * const userAtaInfo = await getAtaInterface(rpc, userAta, userWallet, tokenMint);
- *
- * const result = await createLoadAccountsParams(
- *     rpc,
- *     payer.publicKey,
- *     programId,
- *     [
- *         { address: poolAddress, accountType: 'poolState', info: poolInfo },
- *         { address: vault0, accountType: 'cTokenData', tokenVariant: 'token0Vault', info: vault0Info },
- *     ],
- *     [userAta],
- * );
- *
- * // Build transaction with both program decompress and ATA load
- * const instructions = [...result.ataInstructions];
- * if (result.decompressParams) {
- *     instructions.push(await program.methods
- *         .decompressAccountsIdempotent(
- *             result.decompressParams.proofOption,
- *             result.decompressParams.compressedAccounts,
- *             result.decompressParams.systemAccountsOffset,
- *         )
- *         .remainingAccounts(result.decompressParams.remainingAccounts)
- *         .instruction());
- * }
- * ```
- */
-declare function createLoadAccountsParams(rpc: Rpc, payer: PublicKey, programId: PublicKey, programAccounts?: CompressibleAccountInput[], atas?: AccountInterface[], options?: InterfaceOptions): Promise<LoadResult>;
-/**
- * Calculate compute units for compressible load operation
- */
-declare function calculateCompressibleLoadComputeUnits(compressedAccountCount: number, hasValidityProof: boolean): number;
-
 /**
  * Create a wrap instruction that moves tokens from an SPL/T22 account to a
- * c-token account.
+ * light-token account.
  *
  * @param source            Source SPL/T22 token account
- * @param destination       Destination c-token account
+ * @param destination       Destination light-token account
  * @param owner             Owner of the source account (signer)
  * @param mint              Mint address
  * @param amount            Amount to wrap,
  * @param splInterfaceInfo  SPL interface info for the compression
  * @param decimals          Mint decimals (required for transfer_checked)
  * @param payer             Fee payer (defaults to owner)
+ * @param maxTopUp          Optional cap on rent top-up (units of 1k lamports; default no cap)
  * @returns Instruction to wrap tokens
  */
-declare function createWrapInstruction(source: PublicKey, destination: PublicKey, owner: PublicKey, mint: PublicKey, amount: bigint, splInterfaceInfo: SplInterfaceInfo, decimals: number, payer?: PublicKey): TransactionInstruction;
+declare function createWrapInstruction(source: PublicKey, destination: PublicKey, owner: PublicKey, mint: PublicKey, amount: bigint, splInterfaceInfo: SplInterfaceInfo, decimals: number, payer?: PublicKey, maxTopUp?: number): TransactionInstruction;
 
 /**
- * Create an unwrap instruction that moves tokens from a c-token account to an
+ * Create an unwrap instruction that moves tokens from a light-token account to an
  * SPL/T22 account.
  *
- * @param source           Source c-token account
+ * @param source           Source light-token account
  * @param destination      Destination SPL/T22 token account
  * @param owner            Owner of the source account (signer)
  * @param mint             Mint address
@@ -1980,24 +1830,96 @@ declare function createWrapInstruction(source: PublicKey, destination: PublicKey
  * @param splInterfaceInfo SPL interface info for the decompression
  * @param decimals         Mint decimals (required for transfer_checked)
  * @param payer            Fee payer (defaults to owner if not provided)
+ * @param maxTopUp         Optional cap on rent top-up (units of 1k lamports; default no cap)
  * @returns TransactionInstruction to unwrap tokens
  */
-declare function createUnwrapInstruction(source: PublicKey, destination: PublicKey, owner: PublicKey, mint: PublicKey, amount: bigint, splInterfaceInfo: SplInterfaceInfo, decimals: number, payer?: PublicKey): TransactionInstruction;
+declare function createUnwrapInstruction(source: PublicKey, destination: PublicKey, owner: PublicKey, mint: PublicKey, amount: bigint, splInterfaceInfo: SplInterfaceInfo, decimals: number, payer?: PublicKey, maxTopUp?: number): TransactionInstruction;
+
+/**
+ * Create an instruction to freeze a decompressed light-token account.
+ *
+ * Freezing sets the account state to AccountState::Frozen, preventing
+ * transfers and other token operations. Only the mint's freeze_authority
+ * can freeze accounts.
+ *
+ * Account order per program:
+ * 0. token_account (mutable) - the light-token account to freeze
+ * 1. mint (readonly)         - the mint associated with the token account
+ * 2. freeze_authority        - must match mint.freeze_authority (signer)
+ *
+ * @param tokenAccount   The light-token account to freeze (must be Initialized)
+ * @param mint           The mint of the light-token account
+ * @param freezeAuthority The freeze authority of the mint (signer)
+ * @returns TransactionInstruction
+ */
+declare function createLightTokenFreezeAccountInstruction(tokenAccount: PublicKey, mint: PublicKey, freezeAuthority: PublicKey): TransactionInstruction;
+/**
+ * Create an instruction to thaw (unfreeze) a frozen light-token account.
+ *
+ * Thawing restores the account state from AccountState::Frozen to
+ * AccountState::Initialized, re-enabling token operations. Only the
+ * mint's freeze_authority can thaw accounts.
+ *
+ * Account order per program:
+ * 0. token_account (mutable) - the frozen light-token account to thaw
+ * 1. mint (readonly)         - the mint associated with the token account
+ * 2. freeze_authority        - must match mint.freeze_authority (signer)
+ *
+ * @param tokenAccount   The frozen light-token account to thaw
+ * @param mint           The mint of the light-token account
+ * @param freezeAuthority The freeze authority of the mint (signer)
+ * @returns TransactionInstruction
+ */
+declare function createLightTokenThawAccountInstruction(tokenAccount: PublicKey, mint: PublicKey, freezeAuthority: PublicKey): TransactionInstruction;
+
+/**
+ * Create an instruction to approve a delegate for a light-token account.
+ *
+ * Account order per program:
+ * 0. token_account (mutable)   - the light-token account
+ * 1. delegate      (readonly)  - the delegate to approve
+ * 2. owner         (signer)    - owner of the token account
+ * 3. system_program (readonly) - for rent top-ups via CPI
+ * 4. fee_payer     (mutable, signer) - pays for rent top-ups
+ *
+ * @param tokenAccount The light-token account to set delegation on
+ * @param delegate     The delegate to approve
+ * @param owner        Owner of the token account (signer)
+ * @param amount       Amount of tokens to delegate
+ * @param feePayer     Optional fee payer for rent top-ups (defaults to owner)
+ * @returns TransactionInstruction
+ */
+declare function createLightTokenApproveInstruction(tokenAccount: PublicKey, delegate: PublicKey, owner: PublicKey, amount: number | bigint, feePayer?: PublicKey): TransactionInstruction;
+/**
+ * Create an instruction to revoke delegation for a light-token account.
+ *
+ * Account order per program:
+ * 0. token_account (mutable)   - the light-token account
+ * 1. owner         (signer)    - owner of the token account
+ * 2. system_program (readonly) - for rent top-ups via CPI
+ * 3. fee_payer     (mutable, signer) - pays for rent top-ups
+ *
+ * @param tokenAccount The light-token account to revoke delegation on
+ * @param owner        Owner of the token account (signer)
+ * @param feePayer     Optional fee payer for rent top-ups (defaults to owner)
+ * @returns TransactionInstruction
+ */
+declare function createLightTokenRevokeInstruction(tokenAccount: PublicKey, owner: PublicKey, feePayer?: PublicKey): TransactionInstruction;
 
 /**
- * Create and initialize a new mint for SPL/T22/c-token.
+ * Create and initialize a new mint for SPL/T22/light-token.
  *
  * @param rpc                   RPC connection to use
  * @param payer                 Fee payer
- * @param mintAuthority         Account that will control minting (signer for c-token mints)
+ * @param mintAuthority         Account that will control minting (signer for light-token mints)
  * @param freezeAuthority       Account that will control freeze and thaw (optional)
  * @param decimals              Location of the decimal place
  * @param keypair               Mint keypair (defaults to a random keypair)
  * @param confirmOptions        Confirm options
  * @param programId             Token program ID (defaults to LIGHT_TOKEN_PROGRAM_ID)
- * @param tokenMetadata         Optional token metadata (c-token mints only)
- * @param outputStateTreeInfo   Optional output state tree info (c-token mints only)
- * @param addressTreeInfo       Optional address tree info (c-token mints only)
+ * @param tokenMetadata         Optional token metadata (light-token mints only)
+ * @param outputStateTreeInfo   Optional output state tree info (light-token mints only)
+ * @param addressTreeInfo       Optional address tree info (light-token mints only)
  *
  * @returns Object with mint address and transaction signature
  */
@@ -2007,8 +1929,8 @@ declare function createMintInterface(rpc: Rpc, payer: Signer, mintAuthority: Pub
 }>;
 
 /**
- * Update the mint authority of a compressed token mint.
- * Works for both compressed and decompressed mints.
+ * Update the mint authority of a light-token mint.
+ * Works for both compressed and decompressed light mints.
  *
  * @param rpc                    RPC connection
  * @param payer                  Fee payer (signer)
@@ -2019,8 +1941,8 @@ declare function createMintInterface(rpc: Rpc, payer: Signer, mintAuthority: Pub
  */
 declare function updateMintAuthority(rpc: Rpc, payer: Signer, mint: PublicKey, currentMintAuthority: Signer, newMintAuthority: PublicKey | null, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
 /**
- * Update the freeze authority of a compressed token mint.
- * Works for both compressed and decompressed mints.
+ * Update the freeze authority of a light-token mint.
+ * Works for both compressed and decompressed light mints.
  *
  * @param rpc                      RPC connection
  * @param payer                    Fee payer (signer)
@@ -2032,8 +1954,8 @@ declare function updateMintAuthority(rpc: Rpc, payer: Signer, mint: PublicKey, c
 declare function updateFreezeAuthority(rpc: Rpc, payer: Signer, mint: PublicKey, currentFreezeAuthority: Signer, newFreezeAuthority: PublicKey | null, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
 
 /**
- * Update a metadata field on a compressed token mint.
- * Works for both compressed and decompressed mints.
+ * Update a metadata field on a light-token mint.
+ * Works for both compressed and decompressed light mints.
  *
  * @param rpc            RPC connection
  * @param payer          Fee payer (signer)
@@ -2047,8 +1969,8 @@ declare function updateFreezeAuthority(rpc: Rpc, payer: Signer, mint: PublicKey,
  */
 declare function updateMetadataField(rpc: Rpc, payer: Signer, mint: PublicKey, authority: Signer, fieldType: 'name' | 'symbol' | 'uri' | 'custom', value: string, customKey?: string, extensionIndex?: number, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
 /**
- * Update the metadata authority of a compressed token mint.
- * Works for both compressed and decompressed mints.
+ * Update the metadata authority of a light-token mint.
+ * Works for both compressed and decompressed light mints.
  *
  * @param rpc              RPC connection
  * @param payer            Fee payer (signer)
@@ -2060,8 +1982,8 @@ declare function updateMetadataField(rpc: Rpc, payer: Signer, mint: PublicKey, a
  */
 declare function updateMetadataAuthority(rpc: Rpc, payer: Signer, mint: PublicKey, currentAuthority: Signer, newAuthority: PublicKey, extensionIndex?: number, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
 /**
- * Remove a metadata key from a compressed token mint.
- * Works for both compressed and decompressed mints.
+ * Remove a metadata key from a light-token mint.
+ * Works for both compressed and decompressed light mints.
  *
  * @param rpc            RPC connection
  * @param payer          Fee payer (signer)
@@ -2075,8 +1997,8 @@ declare function updateMetadataAuthority(rpc: Rpc, payer: Signer, mint: PublicKe
 declare function removeMetadataKey(rpc: Rpc, payer: Signer, mint: PublicKey, authority: Signer, key: string, idempotent?: boolean, extensionIndex?: number, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
 
 /**
- * Create an associated token account for SPL/T22/c-token. Defaults to c-token
- * program.
+ * Create an associated token account for SPL/T22/light-token. Defaults to
+ * light-token program.
  *
  * @param rpc                       RPC connection
  * @param payer                     Fee payer and transaction signer
@@ -2086,15 +2008,15 @@ declare function removeMetadataKey(rpc: Rpc, payer: Signer, mint: PublicKey, aut
  * @param confirmOptions            Options for confirming the transaction
  * @param programId                 Token program ID (default:
  *                                  LIGHT_TOKEN_PROGRAM_ID)
- * @param associatedTokenProgramId  ATA program ID (auto-derived if not
- *                                  provided)
- * @param ctokenConfig              Optional rent config
+ * @param associatedTokenProgramId  associated token account program ID
+ *                                  (auto-derived if not provided)
+ * @param lightTokenConfig              Optional rent config
  * @returns Address of the new associated token account
  */
-declare function createAtaInterface(rpc: Rpc, payer: Signer, mint: PublicKey, owner: PublicKey, allowOwnerOffCurve?: boolean, confirmOptions?: ConfirmOptions, programId?: PublicKey, associatedTokenProgramId?: PublicKey, ctokenConfig?: CTokenConfig): Promise<PublicKey>;
+declare function createAtaInterface(rpc: Rpc, payer: Signer, mint: PublicKey, owner: PublicKey, allowOwnerOffCurve?: boolean, confirmOptions?: ConfirmOptions, programId?: PublicKey, associatedTokenProgramId?: PublicKey, lightTokenConfig?: LightTokenConfig): Promise<PublicKey>;
 /**
- * Create an associated token account idempotently for SPL/T22/c-token. Defaults
- * to c-token program.
+ * Create an associated token account idempotently for SPL/T22/light-token.
+ * Defaults to light-token program.
  *
  * If the account already exists, the instruction succeeds without error.
  *
@@ -2106,24 +2028,24 @@ declare function createAtaInterface(rpc: Rpc, payer: Signer, mint: PublicKey, ow
  * @param confirmOptions            Options for confirming the transaction
  * @param programId                 Token program ID (default:
  *                                  LIGHT_TOKEN_PROGRAM_ID)
- * @param associatedTokenProgramId  ATA program ID (auto-derived if not
- *                                  provided)
- * @param ctokenConfig              Optional c-token-specific configuration
+ * @param associatedTokenProgramId  associated token account program ID
+ *                                  (auto-derived if not provided)
+ * @param lightTokenConfig              Optional light-token-specific configuration
  *
  * @returns Address of the associated token account
  */
-declare function createAtaInterfaceIdempotent(rpc: Rpc, payer: Signer, mint: PublicKey, owner: PublicKey, allowOwnerOffCurve?: boolean, confirmOptions?: ConfirmOptions, programId?: PublicKey, associatedTokenProgramId?: PublicKey, ctokenConfig?: CTokenConfig): Promise<PublicKey>;
+declare function createAtaInterfaceIdempotent(rpc: Rpc, payer: Signer, mint: PublicKey, owner: PublicKey, allowOwnerOffCurve?: boolean, confirmOptions?: ConfirmOptions, programId?: PublicKey, associatedTokenProgramId?: PublicKey, lightTokenConfig?: LightTokenConfig): Promise<PublicKey>;
 
 /**
- * Mint tokens to a CToken account.
+ * Mint tokens to a light-token account.
  *
- * This is a simple mint instruction for minting to decompressed CToken accounts.
- * The mint must be decompressed (CMint account must exist on-chain).
+ * This is a simple mint instruction for minting to light-token associated token accounts (hot).
+ * The light mint account must exist (mint must be decompressed first).
  *
  * @param rpc - RPC connection
  * @param payer - Fee payer (signer)
- * @param mint - Mint address (CMint account)
- * @param destination - Destination CToken account
+ * @param mint - Mint address (light mint account)
+ * @param destination - Destination light-token account
  * @param authority - Mint authority (signer)
  * @param amount - Amount to mint
  * @param maxTopUp - Optional maximum lamports for rent top-up
@@ -2133,7 +2055,7 @@ declare function createAtaInterfaceIdempotent(rpc: Rpc, payer: Signer, mint: Pub
 declare function mintTo$1(rpc: Rpc, payer: Signer, mint: PublicKey, destination: PublicKey, authority: Signer, amount: number | bigint, maxTopUp?: number, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
 
 /**
- * Mint compressed tokens directly to compressed accounts.
+ * Mint light-tokens directly to compressed accounts.
  *
  * @param rpc                   RPC connection
  * @param payer                 Fee payer
@@ -2142,25 +2064,26 @@ declare function mintTo$1(rpc: Rpc, payer: Signer, mint: PublicKey, destination:
  * @param recipients            Array of recipients with amounts
  * @param outputStateTreeInfo   Optional output state tree info (auto-fetched if not provided)
  * @param tokenAccountVersion   Token account version (default: 3)
+ * @param maxTopUp              Optional: cap on rent top-up (units of 1k lamports; default no cap)
  * @param confirmOptions        Optional confirm options
  */
 declare function mintToCompressed(rpc: Rpc, payer: Signer, mint: PublicKey, authority: Signer, recipients: Array<{
     recipient: PublicKey;
     amount: number | bigint;
-}>, outputStateTreeInfo?: TreeInfo, tokenAccountVersion?: number, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
+}>, outputStateTreeInfo?: TreeInfo, tokenAccountVersion?: number, maxTopUp?: number, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
 
 /**
  * Mint tokens to a decompressed/onchain token account.
- * Works with SPL, Token-2022, and CToken mints.
+ * Works with SPL, Token-2022, and light-token mints.
  *
- * This function ONLY mints to decompressed onchain token accounts, never to compressed accounts.
- * For CToken mints, the mint must be decompressed first (CMint account must exist on-chain).
+ * This function ONLY mints to light-token associated token accounts (hot), never to compressed light-token accounts (cold).
+ * For light-token mints, the light mint account must exist (mint must be decompressed first).
  *
  * The signature matches the standard SPL mintTo for simplicity and consistency.
  *
  * @param rpc - RPC connection to use
  * @param payer - Transaction fee payer
- * @param mint - Mint address (SPL, Token-2022, or CToken mint)
+ * @param mint - Mint address (SPL, Token-2022, or light-token mint)
  * @param destination - Destination token account address (must be an existing onchain token account)
  * @param authority - Mint authority (can be Signer or PublicKey if multiSigners provided)
  * @param amount - Amount to mint
@@ -2173,48 +2096,31 @@ declare function mintToCompressed(rpc: Rpc, payer: Signer, mint: PublicKey, auth
 declare function mintToInterface(rpc: Rpc, payer: Signer, mint: PublicKey, destination: PublicKey, authority: Signer | PublicKey, amount: number | bigint, multiSigners?: Signer[], confirmOptions?: ConfirmOptions, programId?: PublicKey): Promise<TransactionSignature>;
 
 /**
- * Decompress compressed (cold) tokens to an on-chain token account.
- *
- * For unified loading, use {@link loadAta} instead.
- *
- * @param rpc                  RPC connection
- * @param payer                Fee payer (signer)
- * @param owner                Owner of the compressed tokens (signer)
- * @param mint                 Mint address
- * @param amount               Amount to decompress (defaults to all)
- * @param destinationAta       Destination token account address
- * @param destinationOwner     Owner of the destination ATA
- * @param splInterfaceInfo     SPL interface info for SPL/T22 destinations
- * @param confirmOptions       Confirm options
- * @returns Transaction signature, null if nothing to load.
- */
-declare function decompressInterface(rpc: Rpc, payer: Signer, owner: Signer, mint: PublicKey, amount?: number | bigint | BN, destinationAta?: PublicKey, destinationOwner?: PublicKey, splInterfaceInfo?: SplInterfaceInfo, confirmOptions?: ConfirmOptions): Promise<TransactionSignature | null>;
-
-/**
- * Wrap tokens from an SPL/T22 account to a c-token account.
+ * Wrap tokens from an SPL/T22 account to a light-token account.
  *
  * This is an agnostic action that takes explicit account addresses (spl-token style).
- * Use getAssociatedTokenAddressSync() to derive ATA addresses if needed.
+ * Use getAssociatedTokenAddressSync() to derive associated token account addresses if needed.
  *
  * @param rpc             RPC connection
  * @param payer           Fee payer
- * @param source          Source SPL/T22 token account (any token account, not just ATA)
- * @param destination     Destination c-token account
+ * @param source          Source SPL/T22 token account (any token account, not just associated token account)
+ * @param destination     Destination light-token account
  * @param owner           Owner/authority of the source account (must sign)
  * @param mint            Mint address
  * @param amount          Amount to wrap
  * @param splInterfaceInfo Optional: SPL interface info (will be fetched if not provided)
+ * @param maxTopUp         Optional: cap on rent top-up (units of 1k lamports; default no cap)
  * @param confirmOptions  Optional: Confirm options
  *
  * @example
  * const splAta = getAssociatedTokenAddressSync(mint, owner.publicKey, false, TOKEN_PROGRAM_ID);
- * const ctokenAta = getAssociatedTokenAddressInterface(mint, owner.publicKey); // defaults to c-token
+ * const lightTokenAta = getAssociatedTokenAddressInterface(mint, owner.publicKey); // defaults to light-token
  *
  * await wrap(
  *   rpc,
  *   payer,
  *   splAta,
- *   ctokenAta,
+ *   lightTokenAta,
  *   owner,
  *   mint,
  *   1000n,
@@ -2222,25 +2128,7 @@ declare function decompressInterface(rpc: Rpc, payer: Signer, owner: Signer, min
  *
  * @returns Transaction signature
  */
-declare function wrap(rpc: Rpc, payer: Signer, source: PublicKey, destination: PublicKey, owner: Signer, mint: PublicKey, amount: bigint, splInterfaceInfo?: SplInterfaceInfo, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
-
-/**
- * Create instructions to load an ATA from its AccountInterface.
- *
- * Behavior depends on `wrap` parameter:
- * - wrap=false (standard): Decompress compressed tokens to the target ATA type
- *   (SPL ATA via pool, T22 ATA via pool, or c-token ATA direct)
- * - wrap=true (unified): Wrap SPL/T22 + decompress all to c-token ATA
- *
- * @param rpc         RPC connection
- * @param payer       Fee payer
- * @param ata         AccountInterface from getAtaInterface (must have _isAta, _owner, _mint)
- * @param options     Optional load options
- * @param wrap        Unified mode: wrap SPL/T22 to c-token (default: false)
- * @param targetAta   Target ATA address (used for type detection in standard mode)
- * @returns           Array of instructions (empty if nothing to load)
- */
-declare function createLoadAtaInstructionsFromInterface(rpc: Rpc, payer: PublicKey, ata: AccountInterface, options?: InterfaceOptions, wrap?: boolean, targetAta?: PublicKey): Promise<TransactionInstruction[]>;
+declare function wrap(rpc: Rpc, payer: Signer, source: PublicKey, destination: PublicKey, owner: Signer, mint: PublicKey, amount: bigint, splInterfaceInfo?: SplInterfaceInfo, maxTopUp?: number, confirmOptions?: ConfirmOptions): Promise<TransactionSignature>;
 
 /**
  * Input for creating off-chain metadata JSON.
@@ -2290,7 +2178,7 @@ interface OffChainTokenMetadataJson {
  * const metadataJson = toOffChainMetadataJson({
  *     name: 'My Token',
  *     symbol: 'MTK',
- *     description: 'A compressed token',
+ *     description: 'A light-token',
  *     image: 'https://example.com/image.png',
  * });
  * const uri = await umi.uploader.uploadJson(metadataJson);
@@ -2301,18 +2189,30 @@ interface OffChainTokenMetadataJson {
 declare function toOffChainMetadataJson(meta: OffChainTokenMetadata): OffChainTokenMetadataJson;
 
 /**
- * Returns the compressed mint address as bytes.
+ * Returns the light mint address as bytes.
+ * @internal
  */
 declare function deriveCMintAddress(mintSeed: PublicKey, addressTreeInfo: TreeInfo): number[];
 declare const COMPRESSED_MINT_SEED: Buffer$1;
 /**
- * Finds the SPL mint PDA for a c-token mint.
+ * Finds the SPL mint PDA for a light-token mint.
  * @param mintSeed The mint seed public key.
  * @returns [PDA, bump]
+ * @internal
  */
 declare function findMintAddress(mintSigner: PublicKey): [PublicKey, number];
-declare function getAssociatedCTokenAddressAndBump(owner: PublicKey, mint: PublicKey): [PublicKey, number];
-declare function getAssociatedCTokenAddress(owner: PublicKey, mint: PublicKey): PublicKey;
+/**
+ * Same as "getAssociatedTokenAddress" but returns the bump as well.
+ * Uses light-token program ID.
+ * @internal
+ */
+declare function getAssociatedLightTokenAddressAndBump(owner: PublicKey, mint: PublicKey): [PublicKey, number];
+/**
+ * Same as "getAssociatedTokenAddress", returning just the associated token address.
+ * Uses light-token program ID.
+ * @internal
+ */
+declare function getAssociatedLightTokenAddress(owner: PublicKey, mint: PublicKey): PublicKey;
 
 /**
  * Approve a delegate to spend tokens
@@ -5534,7 +5434,7 @@ declare class CompressedTokenProgram {
 /**
  * Exports for @lightprotocol/compressed-token/unified
  *
- * Import from `/unified` to get a single unified ATA for SPL/T22 and c-token
+ * Import from `/unified` to get a single unified associated token account for SPL/T22 and light-token
  * mints.
  */
 
@@ -5551,21 +5451,21 @@ declare class CompressedTokenProgram {
  */
 declare function getAtaInterface(rpc: Rpc, ata: PublicKey, owner: PublicKey, mint: PublicKey, commitment?: Commitment, programId?: PublicKey): Promise<AccountInterface>;
 /**
- * Derive the canonical token ATA for SPL/T22/c-token in the unified path.
+ * Derive the canonical token associated token account for SPL/T22/light-token in the unified path.
  *
  * Enforces LIGHT_TOKEN_PROGRAM_ID.
  *
  * @param mint                      Mint public key
  * @param owner                     Owner public key
  * @param allowOwnerOffCurve        Allow owner to be a PDA. Default false.
- * @param programId                 Token program ID. Default c-token.
+ * @param programId                 Token program ID. Default light-token.
  * @param associatedTokenProgramId  Associated token program ID. Default
  *                                  auto-detected.
  * @returns                         Associated token address.
  */
 declare function getAssociatedTokenAddressInterface(mint: PublicKey, owner: PublicKey, allowOwnerOffCurve?: boolean, programId?: PublicKey, associatedTokenProgramId?: PublicKey): PublicKey;
 /**
- * Create instruction batches for loading ALL token balances into a c-token ATA.
+ * Create instruction batches for loading ALL token balances into a light-token associated token account.
  *
  * @param rpc     RPC connection
  * @param ata     Associated token address
@@ -5577,14 +5477,14 @@ declare function getAssociatedTokenAddressInterface(mint: PublicKey, owner: Publ
  */
 declare function createLoadAtaInstructions(rpc: Rpc, ata: PublicKey, owner: PublicKey, mint: PublicKey, payer?: PublicKey, options?: InterfaceOptions): Promise<TransactionInstruction[][]>;
 /**
- * Load all token balances into the c-token ATA.
+ * Load all token balances into the light-token associated token account.
  *
- * Wraps SPL/Token-2022 balances and decompresses compressed c-tokens
- * into the on-chain c-token ATA. If no balances exist and the ATA doesn't
+ * Wraps SPL/Token-2022 balances and decompresses compressed light-tokens
+ * into the on-chain light-token associated token account. If no balances exist and the associated token account doesn't
  * exist, creates an empty ATA (idempotent).
  *
  * @param rpc               RPC connection
- * @param ata               Associated token address (c-token)
+ * @param ata               Associated token address (light-token)
  * @param owner             Owner of the tokens (signer)
  * @param mint              Mint public key
  * @param payer             Fee payer (signer, defaults to owner)
@@ -5592,37 +5492,45 @@ declare function createLoadAtaInstructions(rpc: Rpc, ata: PublicKey, owner: Publ
  * @param interfaceOptions  Optional interface options
  * @returns Transaction signature, or null if ATA exists and nothing to load
  */
-declare function loadAta(rpc: Rpc, ata: PublicKey, owner: Signer, mint: PublicKey, payer?: Signer, confirmOptions?: ConfirmOptions, interfaceOptions?: InterfaceOptions): Promise<string | null>;
+declare function loadAta(rpc: Rpc, ata: PublicKey, owner: Signer, mint: PublicKey, payer?: Signer, confirmOptions?: ConfirmOptions, interfaceOptions?: InterfaceOptions, decimals?: number): Promise<string | null>;
 /**
  * Transfer tokens using the unified ata interface.
  *
- * Destination ATA must exist. Automatically wraps SPL/T22 to c-token ATA.
+ * Destination ATA is derived from `recipient` and created idempotently.
+ * Automatically wraps SPL/T22 to light-token associated token account.
  *
  * @param rpc             RPC connection
  * @param payer           Fee payer (signer)
- * @param source          Source c-token ATA address
+ * @param source          Source light-token associated token account address
  * @param mint            Mint address
- * @param destination     Destination c-token ATA address (must exist)
- * @param owner           Source owner (signer)
+ * @param recipient       Destination owner wallet address
+ * @param owner           Source account owner pubkey
+ * @param authority       Signing authority (owner or approved delegate)
  * @param amount          Amount to transfer
  * @param confirmOptions  Optional confirm options
  * @param options         Optional interface options
  * @returns Transaction signature
  */
-declare function transferInterface(rpc: Rpc, payer: Signer, source: PublicKey, mint: PublicKey, destination: PublicKey, owner: Signer, amount: number | bigint | BN, confirmOptions?: ConfirmOptions, options?: InterfaceOptions): Promise<string>;
+declare function transferInterface(rpc: Rpc, payer: Signer, source: PublicKey, mint: PublicKey, recipient: PublicKey, owner: PublicKey, authority: Signer, amount: number | bigint | BN, confirmOptions?: ConfirmOptions, options?: InterfaceOptions, decimals?: number): Promise<string>;
+/**
+ * Transfer tokens to an explicit destination token account.
+ *
+ * Use this for advanced routing to non-ATA destinations.
+ */
+declare function transferToAccountInterface(rpc: Rpc, payer: Signer, source: PublicKey, mint: PublicKey, destination: PublicKey, owner: PublicKey, authority: Signer, amount: number | bigint | BN, confirmOptions?: ConfirmOptions, options?: InterfaceOptions, decimals?: number): Promise<string>;
 /**
- * Get or create c-token ATA with unified balance detection and auto-loading.
+ * Get or create light-token ATA with unified balance detection and auto-loading.
  *
  * Enforces LIGHT_TOKEN_PROGRAM_ID. Aggregates balances from:
- * - c-token hot (on-chain) account
- * - c-token cold (compressed) accounts
+ * - light-token associated token account (hot balance)
+ * - compressed light-token accounts (cold balance)
  * - SPL token accounts (for unified wrapping)
  * - Token-2022 accounts (for unified wrapping)
  *
  * When owner is a Signer:
  * - Creates hot ATA if it doesn't exist
  * - Loads cold (compressed) tokens into hot ATA
- * - Wraps SPL/T22 tokens into c-token ATA
+ * - Wraps SPL/T22 tokens into light-token associated token account
  * - Returns account with all tokens ready to use
  *
  * When owner is a PublicKey:
@@ -5642,26 +5550,34 @@ declare function getOrCreateAtaInterface(rpc: Rpc, payer: Signer, mint: PublicKe
 /**
  * Create transfer instructions for a unified token transfer.
  *
- * Unified variant: always wraps SPL/T22 to c-token ATA.
+ * Unified variant: always wraps SPL/T22 to light-token associated token account.
+ * Recipient must be an on-curve wallet address. For PDA/off-curve owners,
+ * use createTransferToAccountInterfaceInstructions with an explicit destination ATA.
  *
  * Returns `TransactionInstruction[][]`. Send [0..n-2] in parallel, then [n-1].
  * Use `sliceLast` to separate the parallel prefix from the final transfer.
  *
  * @see createTransferInterfaceInstructions in v3/actions/transfer-interface.ts
  */
-declare function createTransferInterfaceInstructions(rpc: Rpc, payer: PublicKey, mint: PublicKey, amount: number | bigint | BN, sender: PublicKey, recipient: PublicKey, options?: Omit<TransferOptions, 'wrap'>): Promise<TransactionInstruction[][]>;
+declare function createTransferInterfaceInstructions(rpc: Rpc, payer: PublicKey, mint: PublicKey, amount: number | bigint | BN, owner: PublicKey, recipient: PublicKey, options?: InterfaceOptions): Promise<TransactionInstruction[][]>;
+/**
+ * Create transfer instructions that route to an explicit destination token
+ * account.
+ */
+declare function createTransferToAccountInterfaceInstructions(rpc: Rpc, payer: PublicKey, mint: PublicKey, amount: number | bigint | BN, owner: PublicKey, destination: PublicKey, options?: InterfaceOptions): Promise<TransactionInstruction[][]>;
 /**
- * Build instruction batches for unwrapping c-tokens to SPL/T22.
+ * Build instruction batches for unwrapping light-tokens to SPL/T22.
  *
- * Unified variant: uses wrap=true for loading, so SPL/T22 balances are
- * consolidated before unwrapping.
+ * Load batches (cold -> hot) come first if needed; unwrap is bundled into the
+ * final batch.
+ * SPL/T22 balances are not consolidated; only light ATA (hot + cold) is unwrapped.
  *
- * Returns `TransactionInstruction[][]`. Load batches (if any) come first,
- * followed by one final unwrap transaction.
+ * Returns `TransactionInstruction[][]`. Load-only batches (if any) come first;
+ * the last batch contains unwrap.
  *
  * @param rpc               RPC connection
  * @param destination       Destination SPL/T22 token account (must exist)
- * @param owner             Owner of the c-token
+ * @param owner             Owner of the light-token
  * @param mint              Mint address
  * @param amount            Amount to unwrap (defaults to full balance)
  * @param payer             Fee payer (defaults to owner)
@@ -5671,21 +5587,80 @@ declare function createTransferInterfaceInstructions(rpc: Rpc, payer: PublicKey,
  */
 declare function createUnwrapInstructions(rpc: Rpc, destination: PublicKey, owner: PublicKey, mint: PublicKey, amount?: number | bigint | BN, payer?: PublicKey, splInterfaceInfo?: SplInterfaceInfo, interfaceOptions?: InterfaceOptions): Promise<TransactionInstruction[][]>;
 /**
- * Unwrap c-tokens to SPL tokens.
+ * Unwrap light-tokens to SPL tokens.
  *
- * Unified variant: loads all cold + SPL/T22 balances to c-token ATA first,
- * then unwraps to the destination SPL/T22 account.
+ * Loads cold into hot if needed, then unwraps from light ATA to destination SPL/T22.
+ * SPL/T22 balances are not consolidated; only light ATA balance is unwrapped.
  *
  * @param rpc                RPC connection
  * @param payer              Fee payer
  * @param destination        Destination SPL/T22 token account
- * @param owner              Owner of the c-token (signer)
+ * @param owner              Owner of the light-token (signer)
  * @param mint               Mint address
  * @param amount             Amount to unwrap (defaults to all)
  * @param splInterfaceInfo   SPL interface info
  * @param confirmOptions     Confirm options
  * @returns Transaction signature of the unwrap transaction
  */
-declare function unwrap(rpc: Rpc, payer: Signer, destination: PublicKey, owner: Signer, mint: PublicKey, amount?: number | bigint | BN, splInterfaceInfo?: SplInterfaceInfo, confirmOptions?: ConfirmOptions): Promise<string>;
+declare function unwrap(rpc: Rpc, payer: Signer, destination: PublicKey, owner: Signer, mint: PublicKey, amount?: number | bigint | BN, splInterfaceInfo?: SplInterfaceInfo, confirmOptions?: ConfirmOptions, decimals?: number): Promise<string>;
+/**
+ * Approve a delegate for an associated token account.
+ *
+ * Auto-detects mint type (light-token, SPL, or Token-2022) and dispatches
+ * to the appropriate instruction.
+ *
+ * @remarks For light-token mints, all cold (compressed) balances are loaded
+ * into the hot ATA, not just the delegation amount. The `amount` parameter
+ * only controls the delegate's spending limit.
+ *
+ * @param rpc            RPC connection
+ * @param payer          Fee payer (signer)
+ * @param tokenAccount   ATA address
+ * @param mint           Mint address
+ * @param delegate       Delegate to approve
+ * @param amount         Amount to delegate
+ * @param owner          Owner of the token account (signer)
+ * @param confirmOptions Optional confirm options
+ * @returns Transaction signature
+ */
+declare function approveInterface(rpc: Rpc, payer: Signer, tokenAccount: PublicKey, mint: PublicKey, delegate: PublicKey, amount: number | bigint | BN, owner: Signer, confirmOptions?: ConfirmOptions, options?: InterfaceOptions, decimals?: number): Promise<string>;
+/**
+ * Build instruction batches for approving a delegate on an ATA.
+ *
+ * Auto-detects mint type (light-token, SPL, or Token-2022).
+ *
+ * @remarks For light-token mints, all cold (compressed) balances are loaded
+ * into the hot ATA before the approve instruction. The `amount` parameter
+ * only controls the delegate's spending limit, not the number of accounts
+ * loaded.
+ */
+declare function createApproveInterfaceInstructions(rpc: Rpc, payer: PublicKey, mint: PublicKey, tokenAccount: PublicKey, delegate: PublicKey, amount: number | bigint | BN, owner: PublicKey, decimals?: number, options?: InterfaceOptions): Promise<TransactionInstruction[][]>;
+/**
+ * Revoke delegation for an associated token account.
+ *
+ * Auto-detects mint type (light-token, SPL, or Token-2022) and dispatches
+ * to the appropriate instruction.
+ *
+ * @remarks For light-token mints, all cold (compressed) balances are loaded
+ * into the hot ATA before the revoke instruction.
+ *
+ * @param rpc            RPC connection
+ * @param payer          Fee payer (signer)
+ * @param tokenAccount   ATA address
+ * @param mint           Mint address
+ * @param owner          Owner of the token account (signer)
+ * @param confirmOptions Optional confirm options
+ * @returns Transaction signature
+ */
+declare function revokeInterface(rpc: Rpc, payer: Signer, tokenAccount: PublicKey, mint: PublicKey, owner: Signer, confirmOptions?: ConfirmOptions, options?: InterfaceOptions, decimals?: number): Promise<string>;
+/**
+ * Build instruction batches for revoking delegation on an ATA.
+ *
+ * Auto-detects mint type (light-token, SPL, or Token-2022).
+ *
+ * @remarks For light-token mints, all cold (compressed) balances are loaded
+ * into the hot ATA before the revoke instruction.
+ */
+declare function createRevokeInterfaceInstructions(rpc: Rpc, payer: PublicKey, mint: PublicKey, tokenAccount: PublicKey, owner: PublicKey, decimals?: number, options?: InterfaceOptions): Promise<TransactionInstruction[][]>;
 
-export { ADD_TOKEN_POOL_DISCRIMINATOR, APPROVE_DISCRIMINATOR, type AccountInterface, Action, type AddSplInterfaceParams, type AddTokenPoolParams, type ApproveAndMintToParams, type ApproveParams, BASE_RENT_PER_EPOCH, BATCH_COMPRESS_DISCRIMINATOR, type BaseMint, type BatchCompressInstructionData, COMPRESSED_MINT_SEED, COMPRESSIBLE_CTOKEN_ACCOUNT_SIZE, COMPRESSIBLE_CTOKEN_RENT_PER_EPOCH, COMPRESSION_COST, COMPRESSION_INCENTIVE, COMPRESS_SPL_TOKEN_ACCOUNT_DISCRIMINATOR, CPI_AUTHORITY_SEED, CREATE_TOKEN_POOL_DISCRIMINATOR, type CTokenConfig, type CompressParams, type CompressSplTokenAccountInstructionData, type CompressSplTokenAccountParams, type CompressedMint, type CompressedTokenInstructionDataApprove, CompressedTokenInstructionDataApproveLayout, type CompressedTokenInstructionDataRevoke, CompressedTokenInstructionDataRevokeLayout, type CompressedTokenInstructionDataTransfer, CompressedTokenInstructionDataTransferLayout, CompressedTokenProgram, type CompressibleAccountInput, type CompressibleConfig, type CompressibleLoadParams, CpiContextLayout, type CreateAssociatedCTokenAccountParams, type CreateMintParams, type CreateSplInterfaceParams, type CreateTokenPoolParams, type CreateTokenProgramLookupTableParams, DECOMPRESS_ACCOUNTS_IDEMPOTENT_DISCRIMINATOR, DEFAULT_COMPRESSIBLE_CONFIG, DEFAULT_PREPAY_EPOCHS, DEFAULT_WRITE_TOP_UP, type DecompressParams, type DelegatedTransfer, DelegatedTransferLayout, ERROR_MIXED_TREE_TYPES, ERROR_NO_ACCOUNTS_FOUND, ExtensionType, IDL, type InputTokenDataWithContext, type InterfaceOptions, LIGHT_TOKEN_CONFIG, LIGHT_TOKEN_RENT_SPONSOR, type LightCompressedToken, type LoadResult, MINT_TO_DISCRIMINATOR, type MergeTokenAccountsParams, type MintContext, type MintExtension, type MintInterface, type MintToInstructionData, type MintToParams, type OffChainTokenMetadata, type OffChainTokenMetadataJson, POOL_SEED, type PackCompressedTokenAccountsParams, type PackedCompressedAccount, type PackedTokenTransferOutputData, type ParsedAccountInfoInterface, RENT_PER_BYTE_PER_EPOCH, REVOKE_DISCRIMINATOR, type RevokeParams, SLOTS_PER_RENT_EPOCH, SPL_TOKEN_MINT_RENT_EXEMPT_BALANCE, type SelectInputAccountsOptions, type SelectedAccountsResult, type SplInterfaceActivity, type SplInterfaceInfo, TOTAL_COMPRESSION_COST, TRANSFER_DISCRIMINATOR, type TokenAccountSource, type TokenData, TokenDataVersion, type TokenMetadata, type TokenMetadataInstructionData, type TokenPoolActivity, type TokenPoolInfo, type TokenTransferOutputData, type TransferOptions, type TransferParams, addSplInterfaces, addTokenPoolAccountsLayout, type addTokenPoolAccountsLayoutParams, addTokenPools, approve, approveAccountsLayout, type approveAccountsLayoutParams, approveAndMintTo, batchCompressLayout, calculateCompressibleLoadComputeUnits, calculateFeePayerCostAtCreation, checkMint, checkSplInterfaceInfo, checkTokenPoolInfo, compress, compressSplTokenAccount, compressSplTokenAccountInstructionDataLayout, convertTokenDataToAccount, createAssociatedCTokenAccountIdempotentInstruction, createAssociatedCTokenAccountInstruction, createAssociatedTokenAccountInterfaceIdempotentInstruction, createAssociatedTokenAccountInterfaceInstruction, createAtaInterface, createAtaInterfaceIdempotent, createAtaInterfaceIdempotentInstruction, createDecompressInterfaceInstruction, createDecompressOutputState, createLightTokenTransferInstruction, createLoadAccountsParams, createLoadAtaInstructions, createLoadAtaInstructionsFromInterface, createMint, createMintInstruction, createMintInterface, createMintToCompressedInstruction, createMintToInstruction, createMintToInterfaceInstruction, createRemoveMetadataKeyInstruction, createSplInterface, createTokenMetadata, createTokenPool, createTokenPoolAccountsLayout, type createTokenPoolAccountsLayoutParams, createTokenProgramLookupTable, createTransferInterfaceInstructions, createTransferOutputState, createUnwrapInstruction, createUnwrapInstructions, createUpdateFreezeAuthorityInstruction, createUpdateMetadataAuthorityInstruction, createUpdateMetadataFieldInstruction, createUpdateMintAuthorityInstruction, createWrapInstruction, decodeApproveInstructionData, decodeBatchCompressInstructionData, decodeCompressSplTokenAccountInstructionData, decodeMintToInstructionData, decodeRevokeInstructionData, decodeTokenMetadata, decodeTransferInstructionData, decompress, decompressDelegated, decompressInterface, deriveCMintAddress, deriveSplInterfaceInfo, deriveTokenPoolInfo, deserializeMint, encodeApproveInstructionData, encodeBatchCompressInstructionData, encodeCompressSplTokenAccountInstructionData, encodeMintToInstructionData, encodeRevokeInstructionData, encodeTokenMetadata, encodeTransferInstructionData, extractTokenMetadata, findMintAddress, freezeAccountsLayout, type freezeAccountsLayoutParams, getAccountInterface, getAssociatedCTokenAddress, getAssociatedCTokenAddressAndBump, getAssociatedTokenAddressInterface, getAtaInterface, getMintInterface, getOrCreateAtaInterface, getSplInterfaceInfos, getTokenPoolInfos, groupAccountsByTreeType, isSingleSplInterfaceInfo, isSingleTokenPoolInfo, loadAta, mergeTokenAccounts, mintTo, mintToAccountsLayout, type mintToAccountsLayoutParams, mintTo$1 as mintToCToken, mintToCompressed, mintToInterface, mintToLayout, packCompressedTokenAccounts, parseCTokenCold, parseCTokenHot, parseMaybeDelegatedTransfer, parseTokenData, removeMetadataKey, rentPerEpoch, revoke, revokeAccountsLayout, type revokeAccountsLayoutParams, selectAccountsByPreferredTreeType, selectMinCompressedTokenAccountsForDecompression, selectMinCompressedTokenAccountsForTransfer, selectMinCompressedTokenAccountsForTransferOrPartial, selectSmartCompressedTokenAccountsForTransfer, selectSmartCompressedTokenAccountsForTransferOrPartial, selectSplInterfaceInfo, selectSplInterfaceInfosForDecompression, selectTokenAccountsForApprove, selectTokenPoolInfo, selectTokenPoolInfosForDecompression, serializeMint, sliceLast, sumUpTokenAmount, thawAccountsLayout, type thawAccountsLayoutParams, toAccountInfo, toOffChainMetadataJson, toTokenPoolInfo, transfer, transferAccountsLayout, type transferAccountsLayoutParams, transferDelegated, transferInterface, unpackMintData, unpackMintInterface, unwrap, updateFreezeAuthority, updateMetadataAuthority, updateMetadataField, updateMintAuthority, validateSameTokenOwner, wrap };
+export { ADD_TOKEN_POOL_DISCRIMINATOR, APPROVE_DISCRIMINATOR, type AccountInterface, Action, type AddSplInterfaceParams, type AddTokenPoolParams, type ApproveAndMintToParams, type ApproveParams, BASE_RENT_PER_EPOCH, BATCH_COMPRESS_DISCRIMINATOR, type BaseMint, type BatchCompressInstructionData, COMPRESSED_MINT_SEED, COMPRESSIBLE_LIGHT_TOKEN_ACCOUNT_SIZE, COMPRESSIBLE_LIGHT_TOKEN_RENT_PER_EPOCH, COMPRESSION_COST, COMPRESSION_INCENTIVE, COMPRESS_SPL_TOKEN_ACCOUNT_DISCRIMINATOR, CPI_AUTHORITY_SEED, CREATE_TOKEN_POOL_DISCRIMINATOR, type CompressParams, type CompressSplTokenAccountInstructionData, type CompressSplTokenAccountParams, type CompressedMint, type CompressedTokenInstructionDataApprove, CompressedTokenInstructionDataApproveLayout, type CompressedTokenInstructionDataRevoke, CompressedTokenInstructionDataRevokeLayout, type CompressedTokenInstructionDataTransfer, CompressedTokenInstructionDataTransferLayout, CompressedTokenProgram, type CompressibleConfig, CpiContextLayout, type CreateAssociatedLightTokenAccountParams, type CreateMintParams, type CreateSplInterfaceParams, type CreateTokenPoolParams, type CreateTokenProgramLookupTableParams, DEFAULT_COMPRESSIBLE_CONFIG, DEFAULT_PREPAY_EPOCHS, DEFAULT_WRITE_TOP_UP, type DecompressParams, type DelegatedTransfer, DelegatedTransferLayout, ERROR_MIXED_TREE_TYPES, ERROR_NO_ACCOUNTS_FOUND, ExtensionType, IDL, type InputTokenDataWithContext, type InterfaceOptions, LIGHT_TOKEN_CONFIG, LIGHT_TOKEN_RENT_SPONSOR, type LightCompressedToken, type LightTokenConfig, MAX_TOP_UP, MINT_TO_DISCRIMINATOR, type MergeTokenAccountsParams, type MintContext, type MintExtension, type MintInterface, type MintToInstructionData, type MintToParams, type OffChainTokenMetadata, type OffChainTokenMetadataJson, POOL_SEED, type PackCompressedTokenAccountsParams, type PackedTokenTransferOutputData, RENT_PER_BYTE_PER_EPOCH, REVOKE_DISCRIMINATOR, type RevokeParams, SLOTS_PER_RENT_EPOCH, SPL_TOKEN_MINT_RENT_EXEMPT_BALANCE, type SelectInputAccountsOptions, type SelectedAccountsResult, type SplInterfaceActivity, type SplInterfaceInfo, TOTAL_COMPRESSION_COST, TRANSFER_DISCRIMINATOR, type TokenAccountSource, type TokenData, TokenDataVersion, type TokenMetadata, type TokenMetadataInstructionData, type TokenPoolActivity, type TokenPoolInfo, type TokenTransferOutputData, type TransferParams, addSplInterfaces, addTokenPoolAccountsLayout, type addTokenPoolAccountsLayoutParams, addTokenPools, approve, approveAccountsLayout, type approveAccountsLayoutParams, approveAndMintTo, approveInterface, batchCompressLayout, calculateFeePayerCostAtCreation, checkMint, checkSplInterfaceInfo, checkTokenPoolInfo, compress, compressSplTokenAccount, compressSplTokenAccountInstructionDataLayout, convertTokenDataToAccount, createApproveInterfaceInstructions, createAssociatedLightTokenAccountIdempotentInstruction, createAssociatedLightTokenAccountInstruction, createAssociatedTokenAccountInterfaceIdempotentInstruction, createAssociatedTokenAccountInterfaceInstruction, createAtaInterface, createAtaInterfaceIdempotent, createAtaInterfaceIdempotentInstruction, createDecompressOutputState, createLightTokenApproveInstruction, createLightTokenFreezeAccountInstruction, createLightTokenRevokeInstruction, createLightTokenThawAccountInstruction, createLightTokenTransferCheckedInstruction, createLightTokenTransferInstruction, createLoadAtaInstructions, createMint, createMintInstruction, createMintInterface, createMintToCompressedInstruction, createMintToInstruction, createMintToInterfaceInstruction, createRemoveMetadataKeyInstruction, createRevokeInterfaceInstructions, createSplInterface, createTokenMetadata, createTokenPool, createTokenPoolAccountsLayout, type createTokenPoolAccountsLayoutParams, createTokenProgramLookupTable, createTransferInterfaceInstructions, createTransferOutputState, createTransferToAccountInterfaceInstructions, createUnwrapInstruction, createUnwrapInstructions, createUpdateFreezeAuthorityInstruction, createUpdateMetadataAuthorityInstruction, createUpdateMetadataFieldInstruction, createUpdateMintAuthorityInstruction, createWrapInstruction, decodeApproveInstructionData, decodeBatchCompressInstructionData, decodeCompressSplTokenAccountInstructionData, decodeMintToInstructionData, decodeRevokeInstructionData, decodeTokenMetadata, decodeTransferInstructionData, decompress, decompressDelegated, deriveCMintAddress, deriveSplInterfaceInfo, deriveTokenPoolInfo, deserializeMint, encodeApproveInstructionData, encodeBatchCompressInstructionData, encodeCompressSplTokenAccountInstructionData, encodeMintToInstructionData, encodeRevokeInstructionData, encodeTokenMetadata, encodeTransferInstructionData, extractTokenMetadata, findMintAddress, freezeAccountsLayout, type freezeAccountsLayoutParams, getAccountInterface, getAssociatedLightTokenAddress, getAssociatedLightTokenAddressAndBump, getAssociatedTokenAddressInterface, getAtaInterface, getMintInterface, getOrCreateAtaInterface, getSplInterfaceInfos, getTokenPoolInfos, groupAccountsByTreeType, isSingleSplInterfaceInfo, isSingleTokenPoolInfo, loadAta, mergeTokenAccounts, mintTo, mintToAccountsLayout, type mintToAccountsLayoutParams, mintToCompressed, mintToInterface, mintToLayout, mintTo$1 as mintToLightToken, packCompressedTokenAccounts, parseLightTokenCold, parseLightTokenHot, parseMaybeDelegatedTransfer, parseTokenData, removeMetadataKey, rentPerEpoch, revoke, revokeAccountsLayout, type revokeAccountsLayoutParams, revokeInterface, selectAccountsByPreferredTreeType, selectMinCompressedTokenAccountsForDecompression, selectMinCompressedTokenAccountsForTransfer, selectMinCompressedTokenAccountsForTransferOrPartial, selectSmartCompressedTokenAccountsForTransfer, selectSmartCompressedTokenAccountsForTransferOrPartial, selectSplInterfaceInfo, selectSplInterfaceInfosForDecompression, selectTokenAccountsForApprove, selectTokenPoolInfo, selectTokenPoolInfosForDecompression, serializeMint, sliceLast, sumUpTokenAmount, thawAccountsLayout, type thawAccountsLayoutParams, toAccountInfo, toOffChainMetadataJson, toTokenPoolInfo, transfer, transferAccountsLayout, type transferAccountsLayoutParams, transferDelegated, transferInterface, transferToAccountInterface, unpackMintData, unpackMintInterface, unwrap, updateFreezeAuthority, updateMetadataAuthority, updateMetadataField, updateMintAuthority, validateSameTokenOwner, wrap };