/** * @name hosted-gateway/receipt-verifier * @description On-chain receipt verification for premium session activation. * * Solking disclosure 2026-09-07 (Finding 2): activation accepted any 8-character * receipt string. This module implements the `ReceiptVerifier` contract by * resolving the receipt as a Solana transaction signature and requiring it to * be FINALIZED on-chain. Amount/payTo binding is enforced at the facilitator * settlement layer; this check guarantees the receipt is a real, landed * transaction rather than an invented placeholder. * * @module hosted-gateway/receipt-verifier */ /** * @name ReceiptVerificationConfig * @description RPC endpoint used to resolve receipt signatures. */ export interface ReceiptVerificationConfig { rpcUrl: string; commitment?: 'confirmed' | 'finalized'; } /** * @name createOnChainReceiptVerifier * @description Build a ReceiptVerifier that resolves the receipt as a Solana * transaction signature and requires it to be confirmed on-chain. * * Returns `valid: false` with a structured reason when the signature is * malformed, not found, or failed on-chain. Never throws for invalid receipts — * errors inside the verification flow surface as `receipt_verification_error` * at the activation-manager layer. * * @param config - RPC endpoint configuration. * @returns A ReceiptVerifier backed by Solana RPC lookups. */ export declare function createOnChainReceiptVerifier(config: ReceiptVerificationConfig): { verify(receipt: string, expectedAmountUsd?: number): Promise<{ valid: boolean; payer?: string; reason?: string; }>; }; /** Re-exported for unit conversion in amount-binding follow-ups. */ export declare const SOL_LAMPORTS = 1000000000; //# sourceMappingURL=receipt-verifier.d.ts.map