svm: CPI probe

import { createSauceSvmClient, SOLANA_CLUSTERS } from "@eco-incorp/sauce/svm";

export declare function staticCpiScreen(input: StaticScreenInput): StaticScreen;

export declare function probeCpiAcceptance(input: AcceptanceProbeInput): Promise<AcceptanceProbe>;

export declare function classifyVenue(screen: StaticScreen, probe?: AcceptanceProbe, opts?: {
    internalOracle?: boolean;
}): VenueClassification;

INSTRUCTIONS_SYSVAR: Address

export type CpiTier = "P-A" | "P-B" | "P-C";

export interface ScreenAccount {
    address?: Address;
    signer?: boolean;
}

export interface StaticScreenInput {
    accounts: readonly ScreenAccount[];
    userSigner?: Address;
}

export interface StaticScreen {
    introspects: boolean;
    foreignSigners: Address[];
    candidateTier: "P-A" | "P-C";
    reasons: string[];
}

export type CpiVerdict = "accept" | "reject" | "degrade" | "unknown";

export interface AcceptanceProbeInput {
    rpc: Rpc<SimulateTransactionApi & GetAccountInfoApi>;
    swapIx: Instruction;
    payer: TransactionSigner;
    outAta: Address;
    expectedOut?: bigint;
    degradeBps?: number;
}

export interface AcceptanceProbe {
    verdict: CpiVerdict;
    delta: bigint;
    cu?: bigint;
    detail?: string;
}

export interface VenueClassification {
    tier: CpiTier;
    reasons: string[];
    externalScanEligible: boolean;
}