/** The dotenv file the agent reads from / writes the key to. */
export declare const ENV_FILE = ".env";
/** Where the resolved eth key came from. */
export type EthKeySource = 'env' | 'dotenv' | 'file';
export type ResolvedEthKey = {
    /** Raw 0x-hex 32-byte scalar. */
    privateKey: string;
    /** Lowercase eth address derived from the scalar. */
    address: string;
    source: EthKeySource;
    /** Absolute path the key was read from (for `dotenv` / `file` sources). */
    path?: string;
};
/** Validate + normalize a raw Ethereum private key to lowercase 0x-hex. */
export declare function normalizeEthHex(value: string): string;
/**
 * Resolve the eth proof-owner key without prompting. Returns `undefined` when
 * no key is configured anywhere — the caller decides whether to generate or
 * ask for one (see `resolve_owner_key`).
 */
export declare function resolveEthKey(projectDir?: string): ResolvedEthKey | undefined;
/**
 * Persist a raw eth private key to the project `.env` as
 * `RECLAIM_PRIVATE_KEY=0x…` (upsert; mode 0600; `.env` added to `.gitignore`).
 * Used by `issue_credentials` (generate) and `import_credentials` (supplied
 * hex). Returns the derived address and the `.env` path.
 */
export declare function writeEthKey(privateKeyHex: string, projectDir?: string): {
    path: string;
    address: string;
};