type DotnsAbiProfile = "poprules-startingPrice" | "v0.5.8-rc1" | "v0.6.0";
/** One DotNS ABI profile's provenance: the upstream artifact it corresponds to, and how the live probe recognises it. */
interface DotnsAbiProfileInfo {
    /**
     * The upstream `paritytech/dotns` tag that introduced this ABI shape, or
     * `null` when the floor is not established from the artifact diff we ran
     * (see this profile's own comment above `DOTNS_ABI_PROFILES`). Never
     * invent a tag here to fill this in — an unverified tag is exactly the
     * over-claim this field exists to prevent.
     */
    introducedAt: string | null;
    /** The `dotns-abis-<tag>.zip` release asset this profile's ABI shape matches, or `null` when unknown. */
    abiPackage: string | null;
    /**
     * The view function whose presence (probed live, never read from the
     * chain as a version) identifies this profile. For the first two
     * profiles this is a PopRules function; v0.6.0's discriminator
     * (isPopIssued) lives on DotnsPopController instead, because v0.6.0 is
     * signature-identical to v0.5.8-rc1 on every PopRules function — see the
     * module doc comment above for why that forced a different contract.
     */
    discriminator: string;
}
declare const DOTNS_ABI_PROFILES: Record<DotnsAbiProfile, DotnsAbiProfileInfo>;
/**
 * Newest DotNS release whose ABI has been diffed against what this client
 * calls. Every release from v0.6.0 through this one is the `v0.6.0` profile:
 * PopRules is byte-identical across them and the registration tuple is
 * unchanged, and the two differences that do exist (the `persist` field on
 * setSubnodeOwner, then its controller-only gate) have their own probes.
 *
 * Raise it only after re-running that diff. A new generation needing its own
 * profile also needs a release range here — this mapping is keyed by release,
 * so adding to DotnsAbiProfile alone will not fail the build the way
 * DOTNS_ABI_PROFILES and classifyLabelStatus do.
 */
declare const HIGHEST_VERIFIED_DOTNS_RELEASE = "0.8.0";
/** A usable `protocolVersion()` answer. */
interface DeclaredProtocolVersion {
    raw: string;
    profile: DotnsAbiProfile;
    aboveVerifiedCeiling: boolean;
}
/**
 * Classify DotnsProtocolRegistry.protocolVersion(), added in DotNS v0.8.0
 * (#1462). `null` means the probes have to decide instead: no such function
 * below v0.8.0, an empty string until an owner declares one, or junk.
 *
 * Junk is reachable — setProtocolVersion only requires a leading digit and
 * `[a-zA-Z0-9.-]`, leaving full semver validation to the tooling, so "0.8",
 * "9abc" and "0.8.0.1" all store. The pre-release suffix is dropped because a
 * deploy declares the rc tag before the owner re-declares the final one
 * (dotns RELEASE_ARTIFACTS.md) and both are the same ABI.
 */
declare function classifyDeclaredProtocolVersion(raw: string | null | undefined): DeclaredProtocolVersion | null;
/** Inputs to classifyProtocolVersion — the live dry-run results from connect(). */
interface DotnsProtocolProbe {
    /**
     * Whether POP_RULES has contract code at all (a prerequisite, not a
     * verdict) — `false` is a definitive "no code here" and `null` means code
     * presence could not be verified (the underlying `hasContractCode` read is
     * itself three-valued for the same reason: its own doc comment says
     * callers must not read `null` as "no code"). Only `false` short-circuits
     * classification; `null` falls through to the two live probes below,
     * because a probe answering is itself positive proof the contract exists
     * regardless of whether the code-presence read could confirm it.
     */
    hasCode: boolean | null;
    /** Whether a dry-run call to PopRules.pricingVersion() completed without reverting. */
    pricingVersionOk: boolean;
    /** Whether a dry-run call to PopRules.startingPrice() completed without reverting. */
    startingPriceOk: boolean;
    /**
     * Whether a dry-run call to DotnsPopController.isPopIssued(<label>)
     * completed without reverting — the v0.6.0-vs-v0.5.8-rc1 discriminator
     * (pricingVersion answers on BOTH, so it cannot tell them apart on its
     * own). Three-valued:
     *   - `true`  — the function answered: this IS v0.6.0.
     *   - `false` — the function reverted (or no data came back): the same
     *     "a probe not answering means this generation lacks it" posture
     *     already used for pricingVersion/startingPrice above.
     *   - `null`/`undefined` — the probe was never attempted, typically
     *     because DOTNS_POP_CONTROLLER has no configured address for this
     *     environment (the `custom` env, or a --contract override that
     *     supplies only POP_RULES). Falls back to v0.5.8-rc1 rather than
     *     erroring: v0.5.8-rc1 and v0.6.0 share an IDENTICAL registration
     *     tuple/ABI adapter (see the module doc comment), so this field only
     *     ever changes classifyLabelStatus's LOCAL advisory label semantics,
     *     never the on-chain transaction shape — misclassifying that is a
     *     preflight-message inaccuracy, not a broken deploy. Optional so
     *     every existing caller/test built before this field existed (which
     *     never needed to disambiguate v0.6.0) keeps compiling and keeps its
     *     exact old verdict.
     */
    isPopIssuedOk?: boolean | null;
}
type DotnsProtocolClassification = {
    profile: DotnsAbiProfile;
} | {
    profile: null;
    reason: string;
};
/**
 * Pure, three-valued classification of the live DotNS ABI profile.
 * Owns all three outcome branches AND their wording, including the
 * `hasCode === null` (code presence unverified) case — see
 * paritytech/bulletin-deploy#1349: that bug shipped because the null branch
 * lived at the dotns.ts call site instead of here, where it was one
 * incomplete `hasCodeResult === true` check away from collapsing `null` into
 * "no code" and aborting every deploy on a single transient RPC blip. Moving
 * it into this pure classifier means every caller gets the null-handling for
 * free and it is unit-testable without a stubbed clientWrapper.
 *
 * This is capability-based detection, NOT release detection: it never reads
 * a version/tag off the chain, only whether a given function answers a
 * dry-run call. The `introducedAt` tags in DOTNS_ABI_PROFILES are asserted
 * provenance from an offline artifact diff, unrelated to this runtime probe.
 *
 * - `hasCode === false` is NOT a profile verdict — it is a configuration
 *   problem (wrong/undeployed address), checked first so it always wins even
 *   if a probe happens to answer, and it gets its own reason distinct from
 *   "unknown generation". This is the same wording the dotns.ts call site
 *   used to throw directly; it has just moved here.
 * - `hasCode === null` does NOT short-circuit — code presence being
 *   unverified is not the same as code being absent, so classification falls
 *   through to the two live probes below: a probe answering is itself
 *   positive proof the contract exists, regardless of whether the
 *   code-presence read could confirm it.
 * - Neither probe answering is an explicit unknown-profile error naming BOTH
 *   probes, so the failure is diagnosable rather than silently falling back
 *   to the old profile (a silent poprules-startingPrice fallback here is
 *   exactly the failure mode this whole module exists to prevent). When
 *   `hasCode` was `null` rather than `true`, the reason also notes that code
 *   presence itself couldn't be verified — a wrong/undeployed POP_RULES
 *   address is then also a possible explanation, not just a genuinely
 *   unrecognised ABI profile.
 * - Both probes answering (a hypothetical future overlap) prefers
 *   v0.5.8-rc1 — it is the superset generation, and preferring the newer one
 *   avoids stranding a fully-upgraded deployment on the old ABI just because
 *   the old function selector happens to still resolve. (When
 *   `isPopIssuedOk` also answers `true`, v0.6.0 wins instead — see below.)
 * - When `pricingVersionOk` is true, `isPopIssuedOk` decides v0.6.0 vs
 *   v0.5.8-rc1: `true` → v0.6.0, anything else (`false`/`null`/`undefined`)
 *   → v0.5.8-rc1. See `DotnsProtocolProbe.isPopIssuedOk`'s own doc comment
 *   for why the fallback case is safe (identical adapter either way).
 */
declare function classifyProtocolVersion(probe: DotnsProtocolProbe): DotnsProtocolClassification;
/** The 4 fields every registration carries, regardless of ABI profile. */
interface DotnsRegistrationBase {
    label: string;
    owner: string;
    secret: string;
    reserved: boolean;
}
/**
 * Pricing facts needed to build a v0.5.8-rc1 registration tuple. Both fields
 * are optional at the type level so a poprules-startingPrice caller (which
 * ignores this argument entirely) can pass `{}`; the v0.5.8-rc1 adapter
 * enforces its own requirements at build time and throws with a specific,
 * named reason when a required field is missing.
 */
interface DotnsPricingInput {
    priceWei?: bigint;
    pricingVersion?: bigint;
}
/** A view-function call description: which function to call and with what args. */
interface DotnsDepositCall {
    functionName: string;
    args: unknown[];
}
interface DotnsProtocolAdapter {
    readonly profile: DotnsAbiProfile;
    /**
     * True when pricing (maxPrice + pricingVersion) must be resolved BEFORE
     * makeCommitment/commit, because it is part of the committed tuple
     * (v0.5.8-rc1). False when pricing is resolved after commit, unaffected by
     * the tuple (poprules-startingPrice — today's behaviour, must stay
     * byte-for-byte identical).
     */
    readonly needsPricingBeforeCommit: boolean;
    /** This profile's RegistrarController ABI fragment (makeCommitment/register vary in tuple shape; commit/commitments/minCommitmentAge/maxCommitmentAge are identical across profiles but included here too so callers have a single ABI source). */
    readonly controllerAbi: readonly any[];
    /** This profile's PopRules ABI fragment for the functions THIS adapter calls directly (the deposit-gate read, plus pricingVersion/priceWithCheckAtVersion on v0.5.8-rc1). Functions unchanged across profiles (price, priceWithCheck, classifyName, etc.) are called via the shared ABI in dotns.ts and never need to go through here. */
    readonly popRulesAbi: readonly any[];
    /** Build the on-chain registration tuple for this profile from the base fields + pricing facts. */
    buildRegistration(base: DotnsRegistrationBase, pricing: DotnsPricingInput): Record<string, unknown>;
    /** Which PopRules view function (and args) resolves the NoStatus deposit gate on this profile. */
    depositCall(label: string): DotnsDepositCall;
}
declare const OLD_CONTROLLER_ABI: readonly [{
    readonly inputs: readonly [{
        readonly name: "registration";
        readonly type: "tuple";
        readonly components: readonly [{
            readonly name: "label";
            readonly type: "string";
        }, {
            readonly name: "owner";
            readonly type: "address";
        }, {
            readonly name: "secret";
            readonly type: "bytes32";
        }, {
            readonly name: "reserved";
            readonly type: "bool";
        }];
    }];
    readonly name: "makeCommitment";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "bytes32";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}, {
    readonly inputs: readonly [{
        readonly name: "commitment";
        readonly type: "bytes32";
    }];
    readonly name: "commit";
    readonly outputs: readonly [];
    readonly stateMutability: "nonpayable";
    readonly type: "function";
}, {
    readonly inputs: readonly [];
    readonly name: "minCommitmentAge";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "uint256";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}, {
    readonly inputs: readonly [];
    readonly name: "maxCommitmentAge";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "uint256";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}, {
    readonly inputs: readonly [{
        readonly name: "commitment";
        readonly type: "bytes32";
    }];
    readonly name: "commitments";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "uint256";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}, {
    readonly inputs: readonly [{
        readonly name: "registration";
        readonly type: "tuple";
        readonly components: readonly [{
            readonly name: "label";
            readonly type: "string";
        }, {
            readonly name: "owner";
            readonly type: "address";
        }, {
            readonly name: "secret";
            readonly type: "bytes32";
        }, {
            readonly name: "reserved";
            readonly type: "bool";
        }];
    }];
    readonly name: "register";
    readonly outputs: readonly [];
    readonly stateMutability: "payable";
    readonly type: "function";
}];
declare const V0_5_8_RC1_CONTROLLER_ABI: readonly [{
    readonly inputs: readonly [{
        readonly name: "registration";
        readonly type: "tuple";
        readonly components: readonly [{
            readonly name: "label";
            readonly type: "string";
        }, {
            readonly name: "owner";
            readonly type: "address";
        }, {
            readonly name: "secret";
            readonly type: "bytes32";
        }, {
            readonly name: "reserved";
            readonly type: "bool";
        }, {
            readonly name: "maxPrice";
            readonly type: "uint256";
        }, {
            readonly name: "pricingVersion";
            readonly type: "uint256";
        }];
    }];
    readonly name: "makeCommitment";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "bytes32";
    }];
    readonly stateMutability: "pure";
    readonly type: "function";
}, {
    readonly inputs: readonly [{
        readonly name: "commitment";
        readonly type: "bytes32";
    }];
    readonly name: "commit";
    readonly outputs: readonly [];
    readonly stateMutability: "nonpayable";
    readonly type: "function";
}, {
    readonly inputs: readonly [];
    readonly name: "minCommitmentAge";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "uint256";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}, {
    readonly inputs: readonly [];
    readonly name: "maxCommitmentAge";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "uint256";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}, {
    readonly inputs: readonly [{
        readonly name: "commitment";
        readonly type: "bytes32";
    }];
    readonly name: "commitments";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "uint256";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}, {
    readonly inputs: readonly [{
        readonly name: "registration";
        readonly type: "tuple";
        readonly components: readonly [{
            readonly name: "label";
            readonly type: "string";
        }, {
            readonly name: "owner";
            readonly type: "address";
        }, {
            readonly name: "secret";
            readonly type: "bytes32";
        }, {
            readonly name: "reserved";
            readonly type: "bool";
        }, {
            readonly name: "maxPrice";
            readonly type: "uint256";
        }, {
            readonly name: "pricingVersion";
            readonly type: "uint256";
        }];
    }];
    readonly name: "register";
    readonly outputs: readonly [];
    readonly stateMutability: "payable";
    readonly type: "function";
}];
declare const OLD_POP_RULES_ABI: readonly [{
    readonly inputs: readonly [];
    readonly name: "startingPrice";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "uint256";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}];
declare const V0_5_8_RC1_POP_RULES_ABI: readonly [{
    readonly inputs: readonly [{
        readonly name: "name";
        readonly type: "string";
    }];
    readonly name: "price";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "uint256";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}, {
    readonly inputs: readonly [];
    readonly name: "pricingVersion";
    readonly outputs: readonly [{
        readonly name: "";
        readonly type: "uint256";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}, {
    readonly inputs: readonly [{
        readonly name: "name";
        readonly type: "string";
    }, {
        readonly name: "userAddress";
        readonly type: "address";
    }, {
        readonly name: "version";
        readonly type: "uint256";
    }];
    readonly name: "priceWithCheckAtVersion";
    readonly outputs: readonly [{
        readonly name: "metadata";
        readonly type: "tuple";
        readonly components: readonly [{
            readonly name: "price";
            readonly type: "uint256";
        }, {
            readonly name: "status";
            readonly type: "uint8";
        }, {
            readonly name: "userStatus";
            readonly type: "uint8";
        }, {
            readonly name: "message";
            readonly type: "string";
        }];
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}];
/**
 * DotnsPopController.isPopIssued(label) — new in v0.6.0, absent from every
 * earlier generation (confirmed against the release ABI zips). This is the
 * v0.6.0-vs-v0.5.8-rc1 discriminator: a dry-run call answering (not
 * reverting) is itself positive proof of the new function's presence. Lives
 * on a DIFFERENT contract (DOTNS_POP_CONTROLLER) than every other ABI in
 * this file, which is why it isn't part of either DotnsProtocolAdapter's
 * `popRulesAbi` — it's detection-only, never called again once the profile
 * is known.
 */
declare const POP_CONTROLLER_PROBE_ABI: readonly [{
    readonly inputs: readonly [{
        readonly name: "label";
        readonly type: "string";
    }];
    readonly name: "isPopIssued";
    readonly outputs: readonly [{
        readonly name: "issued";
        readonly type: "bool";
    }];
    readonly stateMutability: "view";
    readonly type: "function";
}];
/**
 * Well-formed, arbitrary label used only to probe isPopIssued's presence —
 * never registered, never sent in a real transaction. Plain lowercase
 * letters, no digits, no separator, so it can't trip any label-shape
 * validation the real contract might apply before the mapping lookup runs.
 */
declare const PROTOCOL_PROBE_LABEL = "probelabel";
/**
 * The +10% payment buffer shared by finalizeRegistration's payment, the
 * v0.5.8-rc1 committed `maxPrice`, and bufferedWeiToNative's wei→native
 * conversion (dotns.ts) — maxPrice must agree with the amount actually sent,
 * so all three share this exact formula rather than three independent copies
 * of `(x * 110n) / 100n` (#1350).
 */
declare function withTenPercentBuffer(priceWei: bigint): bigint;
declare function getAdapter(profile: DotnsAbiProfile): DotnsProtocolAdapter;

export { DOTNS_ABI_PROFILES, type DeclaredProtocolVersion, type DotnsAbiProfile, type DotnsAbiProfileInfo, type DotnsDepositCall, type DotnsPricingInput, type DotnsProtocolAdapter, type DotnsProtocolClassification, type DotnsProtocolProbe, type DotnsRegistrationBase, HIGHEST_VERIFIED_DOTNS_RELEASE, OLD_CONTROLLER_ABI, OLD_POP_RULES_ABI, POP_CONTROLLER_PROBE_ABI, PROTOCOL_PROBE_LABEL, V0_5_8_RC1_CONTROLLER_ABI, V0_5_8_RC1_POP_RULES_ABI, classifyDeclaredProtocolVersion, classifyProtocolVersion, getAdapter, withTenPercentBuffer };