Method getError

src.ts/abi/interface.ts:702–745

* Get the [[ErrorFragment]] for %%key%%, which may be an error * selector, error name or error signature that belongs to the ABI. * * If %%values%% is provided, it will use the Typed API to handle * ambiguous cases where multiple errors match by name. * * If the %%

(key: string, values?: Array<any | Typed>)

     *  the ABI, this will throw.
     */
    getError(key: string, values?: Array<any | Typed>): null | ErrorFragment {
        if (isHexString(key)) {
            const selector = key.toLowerCase();

            if (BuiltinErrors[selector]) {
                return ErrorFragment.from(BuiltinErrors[selector].signature);
            }

            for (const fragment of this.#errors.values()) {
                if (selector === fragment.selector) { return fragment; }
            }

            return null;
        }

        // It is a bare name, look up the function (will return null if ambiguous)
        if (key.indexOf("(") === -1) {
            const matching: Array<ErrorFragment> = [ ];
            for (const [ name, fragment ] of this.#errors) {
                if (name.split("("/* fix:) */)[0] === key) { matching.push(fragment); }
            }

            if (matching.length === 0) {
                if (key === "Error") { return ErrorFragment.from("error Error(string)"); }
                if (key === "Panic") { return ErrorFragment.from("error Panic(uint256)"); }
                return null;
            } else if (matching.length > 1) {
                const matchStr = matching.map((m) => JSON.stringify(m.format())).join(", ");
                assertArgument(false, `ambiguous error description (i.e. ${ matchStr })`, "name", key);
            }

            return matching[0];
        }

        // Normalize the signature and lookup the function
        key = ErrorFragment.from(key).format()
        if (key === "Error(string)") { return ErrorFragment.from("error Error(string)"); }
        if (key === "Panic(uint256)") { return ErrorFragment.from("error Panic(uint256)"); }

        const result = this.#errors.get(key);
        if (result) { return result; }

        return null;
    }

    /**
     *  Iterate over all errors, calling %%callback%%, sorted by their name.