import { Fr } from '@aztec/foundation/curves/bn254';
import { GrumpkinScalar } from '@aztec/foundation/curves/grumpkin';
import { EthAddress } from '@aztec/foundation/eth-address';
import type { LogFn } from '@aztec/foundation/log';
import type { PXE } from '@aztec/pxe/server';
import { FunctionSelector } from '@aztec/stdlib/abi/function-selector';
import { AztecAddress } from '@aztec/stdlib/aztec-address';
import { PublicKeys } from '@aztec/stdlib/keys';
import { LogCursor, Tag } from '@aztec/stdlib/logs';
import { TxHash } from '@aztec/stdlib/tx/tx-hash';
import { type Command, Option } from 'commander';
export { LogCursor };
/**
 * If we can successfully resolve 'host.docker.internal', then we are running in a container, and we should treat
 * localhost as being host.docker.internal.
 */
export declare const getLocalhost: () => Promise<string>;
export declare const LOCALHOST: string;
export declare const ETHEREUM_HOSTS: string, PRIVATE_KEY: string | undefined, MNEMONIC: string | undefined, API_KEY: string | undefined, CLI_VERSION: string | undefined;
export declare function addOptions(program: Command, options: Option[]): Command;
export declare const makeNodeOption: (mandatory: boolean) => Option;
export declare const nodeOption: Option;
export declare const l1ChainIdOption: Option;
export declare const createSigningKeyOption: (description: string, mandatory: boolean, argsParser?: ((value: string, previous: import("@aztec/foundation/curves/bn254").Fq) => import("@aztec/foundation/curves/bn254").Fq) | undefined) => Option;
export declare const logJson: (log: LogFn) => (obj: object) => void;
/**
 * Updates a file in place atomically.
 * @param filePath - Path to file
 * @param contents - New contents to write
 */
export declare function atomicUpdateFile(filePath: string, contents: string): Promise<void>;
/**
 * Utility to select a TX sender either from user input
 * or from the first account that is found in a PXE instance.
 * @param pxe - The PXE instance that will be checked for an account.
 * @param _from - The user input.
 * @returns An Aztec address. Will throw if one can't be found in either options.
 */
export declare function getTxSender(pxe: PXE, _from?: string): Promise<AztecAddress>;
/**
 * Parses and validates a hex string. Removes leading 0x if present, checks for hex validity,
 * and enforces an optional minimum length.
 * @param hex - The hex string to validate.
 * @param minLen - Optional minimum length (in hex characters, after stripping '0x').
 * @returns The normalized hex string (without leading 0x).
 * @throws InvalidArgumentError if the string is not valid hex or does not meet the minimum length.
 */
export declare function parseHex(hex: string, minLen?: number): `0x${string}`;
export declare function parseBigint(bigint: string): bigint | undefined;
/**
 * Parses a hex encoded string to an Fr integer
 * @param str - Hex encoded string
 * @returns A integer
 */
export declare function parseFieldFromHexString(str: string): Fr;
/**
 * Parses an AztecAddress from a string.
 * @param address - A serialized Aztec address
 * @returns An Aztec address
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parseAztecAddress(address: string): AztecAddress;
/**
 * Parses an Ethereum address from a string.
 * @param address - A serialized Ethereum address
 * @returns An Ethereum address
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parseEthereumAddress(address: string): EthAddress;
/**
 * Parses an AztecAddress from a string.
 * @param address - A serialized Aztec address
 * @returns An Aztec address
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parseOptionalAztecAddress(address: string): AztecAddress | undefined;
/**
 * Parses an optional `<blockNumber>-<txIndexWithinBlock>-<logIndexWithinTx>` triple into a {@link LogCursor},
 * used as the `--after-log` argument of `get-logs` to resume pagination strictly after a previously-seen log.
 * Thin wrapper over {@link LogCursor.parseOptional} that surfaces parse errors as commander's
 * {@link InvalidArgumentError}.
 */
export declare function parseOptionalLogCursor(value: string): LogCursor | undefined;
/**
 * Parses a log tag from a string. Tags are field-element values; we delegate to the {@link parseField} parser.
 *
 * @param tag - A hex string, integer, or boolean string representing the tag.
 * @returns A {@link Tag} wrapping the parsed field.
 */
export declare function parseTag(tag: string): Tag;
/**
 * Parses a selector from a string.
 * @param selector - A serialized selector.
 * @returns A selector.
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parseOptionalSelector(selector: string): FunctionSelector | undefined;
/**
 * Parses a string into an integer or returns undefined if the input is falsy.
 *
 * @param value - The string to parse into an integer.
 * @returns The parsed integer, or undefined if the input string is falsy.
 * @throws If the input is not a valid integer.
 */
export declare function parseOptionalInteger(value: string, min?: number, max?: number): number | undefined;
/**
 * Parses a TxHash from a string.
 * @param txHash - A transaction hash
 * @returns A TxHash instance
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parseTxHash(txHash: string): TxHash;
/**
 * Parses an optional TxHash from a string.
 * Calls parseTxHash internally.
 * @param txHash - A transaction hash
 * @returns A TxHash instance, or undefined if the input string is falsy.
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parseOptionalTxHash(txHash: string): TxHash | undefined;
/**
 * Parses a public key from a string.
 * @param publicKey - A public keys object serialised as a string
 * @returns A PublicKeys instance
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parsePublicKey(publicKey: string): PublicKeys | undefined;
/**
 * Parses a partial address from a string.
 * @param address - A partial address
 * @returns A Fr instance
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parsePartialAddress(address: string): Fr;
/**
 * Parses an account signing key from a string.
 * @param signingKey - A string
 * @returns A signing key
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parseSigningKey(signingKey: string): GrumpkinScalar;
/**
 * Parses a field from a string.
 * @param field - A string representing the field.
 * @returns A field.
 * @throws InvalidArgumentError if the input string is not valid.
 */
export declare function parseField(field: string): Fr;
/**
 * Parses an array of strings to Frs.
 * @param fields - An array of strings representing the fields.
 * @returns An array of Frs.
 */
export declare function parseFields(fields: string[]): Fr[];
/**
 * Pretty prints an object as JSON
 * @param data - The object to stringify
 * @returns A JSON string
 */
export declare function prettyPrintJSON(data: Record<string, any>): string;
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbWFuZHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9jb21tYW5kcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBQ25FLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUMzRCxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNuRCxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUM3QyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUN2RSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDM0QsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ2hELE9BQU8sRUFBRSxTQUFTLEVBQUUsR0FBRyxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDcEQsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBRWxELE9BQU8sRUFBRSxLQUFLLE9BQU8sRUFBd0MsTUFBTSxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBSXZGLE9BQU8sRUFBRSxTQUFTLEVBQUUsQ0FBQztBQUVyQjs7O0dBR0c7QUFDSCxlQUFPLE1BQU0sWUFBWSx1QkFHSSxDQUFDO0FBRTlCLGVBQU8sTUFBTSxTQUFTLFFBQXVCLENBQUM7QUFDOUMsZUFBTyxNQUFRLGNBQWMsVUFBK0IsV0FBVyxzQkFBRSxRQUFRLHNCQUFFLE9BQU8sc0JBQUUsV0FBVyxvQkFBZ0IsQ0FBQztBQUV4SCx3QkFBZ0IsVUFBVSxDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxXQUc3RDtBQUVELGVBQU8sTUFBTSxjQUFjLGdDQUlRLENBQUM7QUFFcEMsZUFBTyxNQUFNLFVBQVUsUUFBdUIsQ0FBQztBQUUvQyxlQUFPLE1BQU0sZUFBZSxRQVN4QixDQUFDO0FBRUwsZUFBTyxNQUFNLHNCQUFzQix1TUFRQSxDQUFDO0FBRXBDLGVBQU8sTUFBTSxPQUFPLHVDQUFxRSxDQUFDO0FBRTFGOzs7O0dBSUc7QUFDSCx3QkFBc0IsZ0JBQWdCLENBQUMsUUFBUSxFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsTUFBTSxpQkFxQnhFO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsd0JBQXNCLFdBQVcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEtBQUssQ0FBQyxFQUFFLE1BQU0seUJBZ0J6RDtBQUVEOzs7Ozs7O0dBT0c7QUFFSCx3QkFBZ0IsUUFBUSxDQUFDLEdBQUcsRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLEVBQUUsTUFBTSxHQUFHLEtBQUssTUFBTSxFQUFFLENBaUJwRTtBQWNELHdCQUFnQixXQUFXLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxNQUFNLEdBQUcsU0FBUyxDQUU5RDtBQUVEOzs7O0dBSUc7QUFDSCx3QkFBZ0IsdUJBQXVCLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxFQUFFLENBcUJ2RDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLGlCQUFpQixDQUFDLE9BQU8sRUFBRSxNQUFNLEdBQUcsWUFBWSxDQU0vRDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLG9CQUFvQixDQUFDLE9BQU8sRUFBRSxNQUFNLEdBQUcsVUFBVSxDQU1oRTtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLHlCQUF5QixDQUFDLE9BQU8sRUFBRSxNQUFNLEdBQUcsWUFBWSxHQUFHLFNBQVMsQ0FLbkY7QUFFRDs7Ozs7R0FLRztBQUNILHdCQUFnQixzQkFBc0IsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLFNBQVMsR0FBRyxTQUFTLENBTTNFO0FBRUQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsUUFBUSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsR0FBRyxDQUV6QztBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLHFCQUFxQixDQUFDLFFBQVEsRUFBRSxNQUFNLEdBQUcsZ0JBQWdCLEdBQUcsU0FBUyxDQVNwRjtBQUVEOzs7Ozs7R0FNRztBQUNILHdCQUFnQixvQkFBb0IsQ0FDbEMsS0FBSyxFQUFFLE1BQU0sRUFDYixHQUFHLEdBQUUsTUFBZ0MsRUFDckMsR0FBRyxHQUFFLE1BQWdDLEdBQ3BDLE1BQU0sR0FBRyxTQUFTLENBZXBCO0FBRUQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsV0FBVyxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsTUFBTSxDQU1sRDtBQUVEOzs7Ozs7R0FNRztBQUNILHdCQUFnQixtQkFBbUIsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLE1BQU0sR0FBRyxTQUFTLENBS3RFO0FBRUQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsY0FBYyxDQUFDLFNBQVMsRUFBRSxNQUFNLEdBQUcsVUFBVSxHQUFHLFNBQVMsQ0FTeEU7QUFFRDs7Ozs7R0FLRztBQUNILHdCQUFnQixtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsTUFBTSxHQUFHLEVBQUUsQ0FNdkQ7QUFFRDs7Ozs7R0FLRztBQUNILHdCQUFnQixlQUFlLENBQUMsVUFBVSxFQUFFLE1BQU0sR0FBRyxjQUFjLENBTWxFO0FBRUQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsVUFBVSxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsRUFBRSxDQXlCNUM7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQWdCLFdBQVcsQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLEdBQUcsRUFBRSxFQUFFLENBRWxEO0FBRUQ7Ozs7R0FJRztBQUNILHdCQUFnQixlQUFlLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQyxNQUFNLEVBQUUsR0FBRyxDQUFDLEdBQUcsTUFBTSxDQWNqRSJ9