/**
 * Burn Engine — novel burn mechanisms for the clawd vault.
 *
 * Mechanisms (ordered by novelty):
 *
 * 1. ENTROPY BURN
 *    Uses the DBC pool's on-chain volatility_accumulator as a deflationary signal.
 *    When accumulator > threshold: burns from inflation_reserve proportional to excess.
 *    Creates a negative-feedback loop: more volatility → more burns → price stabilises.
 *
 * 2. ANTI-GRAVITY SWEEP
 *    When token price falls below a % of ATH, vault uses accumulated fees to
 *    buy tokens from the DBC pool then IMMEDIATELY burns them.
 *    Self-funding: fuelled by normal trading fees, no separate treasury needed.
 *    Trigger is permissionless — anyone can call when floor is breached.
 *
 * 3. AGENT EPOCH BURN
 *    Every epoch, the bound AI agent reports activity metrics on-chain.
 *    High activity → large burn from inflation_reserve.
 *    Zero activity → zero burn. Aligns AI agent utility with token deflation.
 *
 * 4. BEHAVIORAL FINGERPRINT BURN
 *    Detects bot-like trading patterns and taxes pending rewards (not principal).
 *    Bots lose a fraction of unclaimed rewards on each update.
 *    Call is permissionless and requires only publicly observable trade data.
 */
import { PublicKey } from "@solana/web3.js";
import type { VaultState, EntropyBurnEstimate, AntiGravityEstimate, SdkInstructions } from "../types/index.js";
/**
 * Estimate whether an entropy burn would trigger and how much would burn.
 */
export declare function estimateEntropyBurn(vault: VaultState, currentVolatilityAccumulator: number): EntropyBurnEstimate;
/**
 * Build an entropy_burn instruction.
 * Reads the DBC pool's volatility_accumulator on-chain.
 */
export declare function buildEntropyBurnInstruction(vault: PublicKey, dbcPool: PublicKey, inflationReserveAccount: PublicKey, baseMint: PublicKey, caller: PublicKey, tokenProgram?: PublicKey): SdkInstructions;
/**
 * Estimate whether anti-gravity would trigger.
 */
export declare function estimateAntiGravity(vault: VaultState, currentSqrtPrice: bigint, feeReserveBalance: bigint): AntiGravityEstimate;
/**
 * Build an anti_gravity_sweep instruction.
 * Permissionless — anyone can call when price is below floor.
 */
export declare function buildAntiGravityInstruction(vault: PublicKey, feeReserveAccount: PublicKey, dbcPool: PublicKey, dbcPoolQuoteVault: PublicKey, dbcPoolBaseVault: PublicKey, baseMint: PublicKey, quoteMint: PublicKey, dbcProgram: PublicKey, caller: PublicKey): SdkInstructions;
export interface AgentEpochBurnParams {
    tasksCompleted: number;
    revenueGeneratedLamports: bigint;
    uptimeBps: number;
    maxExpectedTasks?: number;
    maxExpectedRevenueLamports?: bigint;
}
/**
 * Estimate the burn for a given epoch's agent activity.
 */
export declare function estimateAgentEpochBurn(vault: VaultState, params: AgentEpochBurnParams): {
    activityScore: number;
    estimatedBurnAmount: bigint;
};
/**
 * Build an agent_epoch_burn instruction.
 * Only callable by the registered agent wallet.
 */
export declare function buildAgentEpochBurnInstruction(vault: PublicKey, agentBinding: PublicKey, inflationReserveAccount: PublicKey, baseMint: PublicKey, agentSigner: PublicKey, params: AgentEpochBurnParams, tokenProgram?: PublicKey): SdkInstructions;
export interface BehaviorBurnParams {
    targetWallet: PublicKey;
    tradeCountLast60Slots: number;
    avgHoldSlots: bigint;
    normalizedPositionBps: number;
    rewardsEscrow: PublicKey;
    baseMint: PublicKey;
}
/**
 * Estimate behavioral score and potential reward burn.
 */
export declare function estimateBehavioralBurn(params: BehaviorBurnParams, pendingRewards: bigint): {
    behaviorScore: number;
    rewardBurnAmount: bigint;
    isBotFlagged: boolean;
};
/**
 * Build a behavioral_burn instruction.
 * Permissionless — anyone can report trade data for a wallet.
 */
export declare function buildBehavioralBurnInstruction(vault: PublicKey, params: BehaviorBurnParams, caller: PublicKey, tokenProgram?: PublicKey): SdkInstructions;
//# sourceMappingURL=burn-engine.d.ts.map