@1inch/solidity-utils 4.0.0 → 4.2.0

package/contracts/mixins/BySig.sol

@@ -0,0 +1,220 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8.0;
+
+import { Context } from "@openzeppelin/contracts/utils/Context.sol";
+import { Address } from "@openzeppelin/contracts/utils/Address.sol";
+import { EIP712 } from "@openzeppelin/contracts/utils/cryptography/EIP712.sol";
+import { ECDSA } from "../libraries/ECDSA.sol";
+import { BySigTraits } from "../libraries/BySigTraits.sol";
+import { AddressArray } from "../libraries/AddressArray.sol";
+
+/**
+ * @title BySig
+ * @notice Mixin that provides signature-based accessibility to every external method of the smart contract.
+ * @dev Inherit your contract from this mixin and use `_msgSender()` instead of `msg.sender` everywhere.
+ */
+abstract contract BySig is Context, EIP712 {
+    using Address for address;
+    using BySigTraits for BySigTraits.Value;
+    using AddressArray for AddressArray.Data;
+
+    /// @notice Emitted when the nonce used for a call is incorrect.
+    error WrongNonce();
+    /// @notice Emitted when a call is made by an unauthorized relayer.
+    error WrongRelayer();
+    /// @notice Emitted when the signature provided for a call does not match the expected signature.
+    error WrongSignature();
+    /// @notice Emitted when a call is attempted after the specified deadline has passed.
+    error DeadlineExceeded();
+
+    /**
+     * @notice Represents a call to be signed and executed.
+     * @dev This structure encapsulates all necessary information for executing a signed call,
+     * including traits that specify how the call should be authorized and the actual data to be executed.
+     * @param traits An instance of `Value` from the `BySigTraits` library, specifying the nonce type,
+     * nonce value, deadline, whether a relayer is allowed for this call and another params, see {BySigTraits-Value}.
+     * These traits define the authorization strategy and replay protection for the signed call.
+     * @param data The encoded function call data to be executed. This should be generated, for instance,
+     * using `encodeFunctionData` of the target contract's interface, containing the function signature and arguments.
+     * It represents the exact action to be taken, including which function to call of which contract and with what parameters.
+     */
+    struct SignedCall {
+        BySigTraits.Value traits;
+        bytes data;
+    }
+
+    bytes32 constant public SIGNED_CALL_TYPEHASH = keccak256("SignedCall(uint256 traits,bytes data)");
+
+    // Various nonces used for signature verification and replay protection.
+    AddressArray.Data /* transient */ private _msgSenders;
+    mapping(address => uint256) private _bySigAccountNonces;
+    mapping(address => mapping(bytes4 => uint256)) private _bySigSelectorNonces;
+    mapping(address => mapping(uint256 => uint256)) private _bySigUniqueNonces;
+
+    /**
+     * @notice Retrieves the account nonce for the specified account.
+     * @param account The address of the account.
+     * @return The current nonce for the account.
+     */
+    function bySigAccountNonces(address account) public view returns(uint256) {
+        return _bySigAccountNonces[account];
+    }
+
+    /**
+     * @notice Retrieves the selector nonce for a specific account and selector.
+     * @param account The address of the account.
+     * @param selector The selector for which the nonce is being retrieved.
+     * @return The current nonce for the specified selector and account.
+     */
+    function bySigSelectorNonces(address account, bytes4 selector) public view returns(uint256) {
+        return _bySigSelectorNonces[account][selector];
+    }
+
+    /**
+     * @notice Checks if a unique nonce has already been used for a given account.
+     * @dev This function divides the nonce space into slots to efficiently manage storage.
+     * A unique nonce is considered used if its corresponding bit in the storage slot is set.
+     * @param account The address of the account for which the nonce is being checked.
+     * @param nonce The unique nonce to check. It is divided into slots for storage efficiency.
+     * @return bool True if the nonce has been used, false otherwise.
+     */
+    function bySigUniqueNonces(address account, uint256 nonce) public view returns(bool) {
+        return (_bySigUniqueNonces[account][nonce >> 8] & (1 << (nonce & 0xff))) != 0;
+    }
+
+    /**
+     * @notice Retrieves the storage slot value for a given account and nonce slot.
+     * @dev This function allows access to the raw storage slot used to track used nonces, divided into slots for efficiency.
+     * Each bit in the returned value represents the used/unused status of a nonce within that slot.
+     * @param account The address of the account for which the nonce slot is being retrieved.
+     * @param nonce The nonce for which the storage slot is being retrieved. The function calculates the correct slot based on this value.
+     * @return uint256 The raw value of the storage slot that tracks the used/unused status of nonces in the specified slot for the given account.
+     */
+    function bySigUniqueNoncesSlot(address account, uint256 nonce) public view returns(uint256) {
+        return _bySigUniqueNonces[account][nonce >> 8];
+    }
+
+    /**
+     * @notice Hashes a `SignedCall` struct using EIP-712 typed data hashing rules.
+     * @param sig The `SignedCall` structure containing the call traits and data.
+     * @return The EIP-712 compliant hash of the `SignedCall` struct.
+     */
+    function hashBySig(SignedCall calldata sig) public view returns(bytes32) {
+        return _hashTypedDataV4(
+            keccak256(abi.encode(
+                SIGNED_CALL_TYPEHASH,
+                sig.traits,
+                keccak256(sig.data)
+            ))
+        );
+    }
+
+    /**
+     * @notice Executes a signature-authorized call on behalf of the signer.
+     * @param signer The address of the signer authorizing the call.
+     * @param sig The `SignedCall` structure containing the call traits and data.
+     * @param signature The signature authorizing the call.
+     * @return ret The bytes result of the executed call.
+     */
+    function bySig(address signer, SignedCall calldata sig, bytes calldata signature) public payable returns(bytes memory ret) {
+        if (block.timestamp > sig.traits.deadline()) revert DeadlineExceeded(); // solhint-disable-line not-rely-on-time
+        // Using _msgSender() in the next line allows private relay execution redelegation
+        if (!sig.traits.isRelayerAllowed(_msgSender())) revert WrongRelayer();
+        if (!_useNonce(signer, sig.traits, sig.data)) revert WrongNonce();
+        if (!ECDSA.recoverOrIsValidSignature(signer, hashBySig(sig), signature)) revert WrongSignature();
+
+        _msgSenders.push(signer);
+        ret = address(this).functionDelegateCall(sig.data);
+        _msgSenders.pop();
+    }
+
+    /**
+     * @notice Executes a call sponsored by the signer (for instance, by fee), intended to be used,
+     * for instance, in conjunction with `bySig`.
+     * @dev Facilitates execution of a delegate call where the signer covers the transaction fees.
+     * Requires `_chargeSigner` to be overridden to define the fee transfer logic.
+     * @param token Address of the token used for sponsored logic (for instance, for fee payment).
+     * @param amount amount value used for sponsored logic (for instance, fee amount to be charged to the signer).
+     * @param data Encoded function call to execute.
+     * @param extraData Additional data for sponsored process in `_chargeSigner` method.
+     * @return ret Result of the executed call.
+     */
+    function sponsoredCall(address token, uint256 amount, bytes calldata data, bytes calldata extraData) public payable returns(bytes memory ret) {
+        ret = address(this).functionDelegateCall(data);
+        _chargeSigner(_msgSender(), msg.sender, token, amount, extraData);
+    }
+
+    /**
+     * @dev Placeholder for custom logic to charge the signer for sponsored calls.
+     * Override this method to implement sponsored call accounting.
+     * Example imeplementation:
+     *
+     * function _chargeSigner(address signer, address relayer, address token, uint256 amount, bytes calldata extraData) internal override {
+     *    balances[token][signer] -= amount;
+     *    balances[token][relayer] += amount;
+     * }
+     *
+     * @param signer The address of the signer being charged.
+     * @param relayer The address of the relayer facilitating the call.
+     * @param token The token address used for charging.
+     * @param amount The amount to be charged.
+     * @param extraData Additional data for sponsored call accounting and executions.
+     */
+    function _chargeSigner(address signer, address relayer, address token, uint256 amount, bytes calldata extraData) internal virtual;
+
+    /**
+     * @notice Advances the account nonce for the sender by a specified amount.
+     * @param advance The amount by which to advance the nonce.
+     */
+    function useBySigAccountNonce(uint32 advance) public {
+        _bySigAccountNonces[_msgSender()] += advance;
+    }
+
+    /**
+     * @notice Advances the selector nonce for the sender and a specific selector by a specified amount.
+     * @param selector The selector for which the nonce is being advanced.
+     * @param advance The amount by which to advance the nonce.
+     */
+    function useBySigSelectorNonce(bytes4 selector, uint32 advance) public {
+        _bySigSelectorNonces[_msgSender()][selector] += advance;
+    }
+
+    /**
+     * @notice Marks a unique nonce as used for the sender.
+     * @param nonce The nonce being marked as used.
+     */
+    function useBySigUniqueNonce(uint256 nonce) public {
+        _bySigUniqueNonces[_msgSender()][nonce >> 8] |= 1 << (nonce & 0xff);
+    }
+
+    /**
+     * @dev Returns the address of the message sender, replacing the traditional `msg.sender` with a potentially signed sender.
+     * @return The address of the message sender.
+     */
+    function _msgSender() internal view override virtual returns (address) {
+        uint256 length = _msgSenders.length();
+        if (length == 0) {
+            return super._msgSender();
+        }
+        return _msgSenders.at(length - 1);
+    }
+
+    function _useNonce(address signer, BySigTraits.Value traits, bytes calldata data) private returns(bool) {
+        BySigTraits.NonceType nonceType = traits.nonceType();
+        uint256 nonce = traits.nonce();
+        if (nonceType == BySigTraits.NonceType.Account) {
+            return nonce == _bySigAccountNonces[signer]++;
+        }
+        if (nonceType == BySigTraits.NonceType.Selector) {
+            return nonce == _bySigSelectorNonces[signer][bytes4(data)]++;
+        }
+        if (nonceType == BySigTraits.NonceType.Unique) {
+            mapping(uint256 => uint256) storage map = _bySigUniqueNonces[signer];
+            uint256 cache = map[nonce >> 8];
+            map[nonce >> 8] |= 1 << (nonce & 0xff);
+            return cache != map[nonce >> 8];
+        }
+        return false;
+    }
+}

package/contracts/mixins/EthReceiver.sol

@@ -0,0 +1,27 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8.0;
+
+/**
+ * @title EthReceiver
+ * @dev Abstract contract for rejecting direct ETH transfers from EOAs.
+ * Implements a custom error and logic to reject ETH deposits from non-contract addresses.
+ */
+abstract contract EthReceiver {
+    /// @dev Error thrown when an ETH deposit from an EOA is attempted.
+    error EthDepositRejected();
+
+    /// @dev External payable function to receive ETH, automatically rejects deposits from EOAs.
+    receive() external payable {
+        _receive();
+    }
+
+    /**
+     * @dev Internal function containing the logic to reject ETH deposits.
+     * Can be overridden by derived contracts for specific behaviors while maintaining the base rejection mechanism.
+     */
+    function _receive() internal virtual {
+        // solhint-disable-next-line avoid-tx-origin
+        if (msg.sender == tx.origin) revert EthDepositRejected();
+    }
+}

package/contracts/mixins/OnlyWethReceiver.sol

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8.0;
+
+import "./EthReceiver.sol";
+
+/**
+ * @title OnlyWethReceiver
+ * @dev Abstract contract extending EthReceiver to accept only ETH deposits from a specified WETH contract.
+ * This contract ensures that only wrapped ETH (WETH) can be deposited, rejecting all other direct ETH transfers.
+ */
+abstract contract OnlyWethReceiver is EthReceiver {
+    /// @notice Address of the WETH contract allowed to deposit ETH.
+    address private immutable _WETH; // solhint-disable-line var-name-mixedcase
+
+    /**
+     * @dev Sets the WETH contract address during construction.
+     * @param weth Address of the WETH contract.
+     */
+    constructor(address weth) {
+        _WETH = address(weth);
+    }
+
+    /**
+     * @dev Overrides _receive to restrict ETH transfers solely to the WETH contract.
+     * Reverts with EthDepositRejected if ETH is sent from any other address.
+     */
+    function _receive() internal virtual override {
+        if (msg.sender != _WETH) revert EthDepositRejected();
+    }
+}

package/contracts/mixins/PermitAndCall.sol

@@ -0,0 +1,39 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8.0;
+
+import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
+import { SafeERC20 } from "../libraries/SafeERC20.sol";
+
+/**
+ * @title PermitAndCall
+ * @dev Abstract contract to support permit and action execution in a single transaction.
+ * Allows tokens that implement EIP-2612 permits, DAI-like permits, USDC-like permits and Permit2 to be approved and spent in a single transaction.
+ */
+abstract contract PermitAndCall {
+    using SafeERC20 for IERC20;
+
+    /**
+     * @notice Executes a permit for an ERC20 token and then a specified action in a single transaction.
+     * @param permit ERC20 token address (20 bytes) concatinated with the permit data, allowing this contract to spend the token.
+     * Format: [token address (20 bytes)][permit data]
+     * @param action The data representing the action to be executed after the permit.
+     */
+    function permitAndCall(bytes calldata permit, bytes calldata action) external payable {
+        IERC20(address(bytes20(permit))).tryPermit(permit[20:]);
+        // solhint-disable-next-line no-inline-assembly
+        assembly ("memory-safe") {
+            let ptr := mload(0x40)
+            calldatacopy(ptr, action.offset, action.length)
+            let success := delegatecall(gas(), address(), ptr, action.length, 0, 0)
+            returndatacopy(ptr, 0, returndatasize())
+            switch success
+            case 0 {
+                revert(ptr, returndatasize())
+            }
+            default {
+                return(ptr, returndatasize())
+            }
+        }
+    }
+}

package/contracts/mixins/SelfdestructEthSender.sol

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8.25;
+
+/**
+ * @title SelfdestructEthSender
+ * @notice A one-time-use contract for cost-effective ETH transfers using the `selfdestruct` mechanism.
+ * @dev Upon construction, this contract verifies EVM compatibility with the Cancun upgrade, specifically
+ * testing for support of transient storage via `tload`. It is intended for single-use, allowing for ETH to
+ * be sent more cheaply by self-destructing and sending its balance to a designated address.
+ */
+abstract contract SelfdestructEthSender {
+    /**
+     * @dev Initializes the contract, verifying compatibility with the Cancun EVM upgrade through transient storage support check.
+     */
+    constructor() {
+        // solhint-disable-next-line no-inline-assembly
+        assembly ("memory-safe") {
+            pop(tload(0))
+        }
+    }
+
+    /**
+     * @notice Makes the selfdestruct call, transferring the entire ETH balance of the contract to the specified address.
+     * Due to EIP-6780 chnges selfdestruct will destroy the contract only if it was created in the same transaction.
+     * In other cases it will stop the execution and transfer all the ETH balance saving about 1700 gas comparing to trivial transfer.
+     * @param receiver The recipient address of the contract's ETH balance.
+     */
+    function stopAndTransferBalance(address payable receiver) external {
+        selfdestruct(receiver);
+    }
+}

package/contracts/mocks/ERC20PermitMock.sol

@@ -5,7 +5,19 @@ pragma solidity ^0.8.0;
 import "@openzeppelin/contracts/token/ERC20/extensions/ERC20Permit.sol";
 import "./TokenMock.sol";
 
+/**
+ * @title ERC20PermitMock
+ * @dev Extends ERC20Permit and TokenMock for testing purposes, incorporating permit functionality.
+ * This contract simplifies the testing of ERC20 tokens with permit capabilities by allowing easy setup of initial states.
+ */
 contract ERC20PermitMock is ERC20Permit, TokenMock {
+    /**
+     * @dev Creates an instance of `ERC20PermitMock` with specified token details and initial token distribution.
+     * @param name Name of the ERC20 token.
+     * @param symbol Symbol of the ERC20 token.
+     * @param initialAccount Address to receive the initial token supply.
+     * @param initialBalance Amount of tokens to mint to the `initialAccount`.
+     */
     constructor(
         string memory name,
         string memory symbol,

package/contracts/mocks/SelfdestructEthSenderMock.sol

@@ -0,0 +1,27 @@
+// SPDX-License-Identifier: MIT
+
+pragma solidity ^0.8.25;
+
+import "../mixins/SelfdestructEthSender.sol";
+
+/**
+ * @title SelfdestructEthSenderMock
+ * @notice Mock contract extending SelfdestructEthSender for testing purposes, with added functionality to transfer ETH.
+ */
+contract SelfdestructEthSenderMock is SelfdestructEthSender {
+    /// @notice Indicates that an attempt to transfer ETH has failed.
+    error ETHTransferFailed();
+
+    /// @notice Allows the contract to receive ETH.
+    receive() external payable {}
+
+    /**
+     * @notice Transfers the contract's entire ETH balance to the specified address.
+     * @param receiver The address to which the contract's ETH balance will be transferred.
+     */
+    function transferBalance(address payable receiver) external payable {
+        // solhint-disable-next-line avoid-low-level-calls
+        (bool success, ) = receiver.call{value: address(this).balance}("");
+        if (!success) revert ETHTransferFailed();
+    }
+}

package/contracts/mocks/TokenCustomDecimalsMock.sol

@@ -5,9 +5,20 @@ pragma solidity ^0.8.0;
 import "@openzeppelin/contracts/access/Ownable.sol";
 import "@openzeppelin/contracts/token/ERC20/extensions/ERC20Permit.sol";
 
+/**
+ * @title TokenCustomDecimalsMock
+ * @dev Extends ERC20Permit token with custom number of decimals and only owner access to `mint` and `burn` functionality.
+ */
 contract TokenCustomDecimalsMock is ERC20Permit, Ownable {
     uint8 internal immutable _DECIMALS;
 
+    /**
+     * @dev Sets up the ERC20 token with a name, symbol, initial amount to mint, and custom decimals.
+     * @param name Name of the token.
+     * @param symbol Symbol of the token.
+     * @param amount Initial amount of tokens to mint to the owner.
+     * @param decimals_ Custom number of decimal places for the token.
+     */
     constructor(
         string memory name,
         string memory symbol,
@@ -18,19 +29,29 @@ contract TokenCustomDecimalsMock is ERC20Permit, Ownable {
         _DECIMALS = decimals_;
     }
 
+    /**
+     * @notice Mints tokens to a specified account, callable only by the owner.
+     * @param account The address to mint tokens to.
+     * @param amount The amount of tokens to mint.
+     */
     function mint(address account, uint256 amount) external onlyOwner {
         _mint(account, amount);
     }
 
+    /**
+     * @notice Burns tokens from a specified account, callable only by the owner.
+     * @param account The address to burn tokens from.
+     * @param amount The amount of tokens to burn.
+     */
     function burn(address account, uint256 amount) external onlyOwner {
         _burn(account, amount);
     }
 
+    /**
+     * @dev Returns the number of decimal places of the token.
+     * @return Number of decimal places.
+     */
     function decimals() public view virtual override returns (uint8) {
         return _DECIMALS;
     }
-
-    function getChainId() external view returns (uint256) {
-        return block.chainid;
-    }
 }

package/contracts/mocks/TokenMock.sol

@@ -5,14 +5,33 @@ pragma solidity ^0.8.0;
 import "@openzeppelin/contracts/access/Ownable.sol";
 import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
 
+/**
+ * @title TokenMock
+ * @dev Simple ERC20 token mock for testing purposes, with minting and burning capabilities restricted to the owner.
+ */
 contract TokenMock is ERC20, Ownable {
+    /**
+     * @dev Initializes the contract with token name and symbol, setting the deployer as the owner.
+     * @param name Name of the ERC20 token.
+     * @param symbol Symbol of the ERC20 token.
+     */
     // solhint-disable-next-line no-empty-blocks
     constructor(string memory name, string memory symbol) ERC20(name, symbol) Ownable(msg.sender) {}
 
+    /**
+     * @notice Mints tokens to a specified account, callable only by the owner.
+     * @param account The address to mint tokens to.
+     * @param amount The amount of tokens to mint.
+     */
     function mint(address account, uint256 amount) external onlyOwner {
         _mint(account, amount);
     }
 
+    /**
+     * @notice Burns tokens from a specified account, callable only by the owner.
+     * @param account The address to burn tokens from.
+     * @param amount The amount of tokens to burn.
+     */
     function burn(address account, uint256 amount) external onlyOwner {
         _burn(account, amount);
     }

package/dist/docgen/index.d.ts

@@ -0,0 +1,2 @@
+export * from './templates';
+export * from './templates';

package/dist/docgen/index.js

@@ -0,0 +1,7 @@
+"use strict";
+// created from 'create-ts-index'
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./templates"), exports);
+tslib_1.__exportStar(require("./templates"), exports);
+//# sourceMappingURL=index.js.map

package/dist/docgen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../docgen/index.ts"],"names":[],"mappings":";AAAA,iCAAiC;;;AAEjC,sDAA4B;AAC5B,sDAA4B"}

package/dist/docgen/templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @category Docgen
+ * @notice A helper method to get the path to the templates folder.
+ * @returns The the path to templates folder.
+ */
+export declare function oneInchTemplates(): string;

package/dist/docgen/templates.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oneInchTemplates = void 0;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+/**
+ * @category Docgen
+ * @notice A helper method to get the path to the templates folder.
+ * @returns The the path to templates folder.
+ */
+function oneInchTemplates() {
+    return path_1.default.normalize(path_1.default.join(__dirname, '../../docgen/templates'));
+}
+exports.oneInchTemplates = oneInchTemplates;
+//# sourceMappingURL=templates.js.map

package/dist/docgen/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../docgen/templates.ts"],"names":[],"mappings":";;;;AAAA,wDAAwB;AAExB;;;;GAIG;AACH,SAAgB,gBAAgB;IAC5B,OAAO,cAAI,CAAC,SAAS,CAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC,CAAC;AAC1E,CAAC;AAFD,4CAEC"}

package/dist/hardhat-setup/networks.d.ts

@@ -1,17 +1,40 @@
 import { ChainConfig } from '@nomicfoundation/hardhat-verify/src/types';
 import { Network, NetworksUserConfig } from 'hardhat/types';
+/** @internal */
 export type Etherscan = {
     apiKey: {
         [key: string]: string;
     };
     customChains: ChainConfig[];
 };
+/**
+ * @category Hardhat-Setup
+ * @notice A helper method to get the network name from the command line arguments.
+ * @returns The network name.
+ */
 export declare function getNetwork(): string;
+/**
+ * @category Hardhat-Setup
+ * @notice A helper method to parse RPC configuration strings. Checks that the string is in the expected format.
+ * @param envRpc The RPC configuration string to parse.
+ * @returns An object containing the RPC URL and optional auth key HTTP header.
+ */
 export declare function parseRpcEnv(envRpc: string): {
     url: string;
     authKeyHttpHeader?: string;
 };
+/**
+ * @category Hardhat-Setup
+ * @notice A helper method to reset the Hardhat network to the local network or to a fork.
+ * @param network The Hardhat network object.
+ * @param networkName The name of the network to reset to.
+ */
 export declare function resetHardhatNetworkFork(network: Network, networkName: string): Promise<void>;
+/**
+ * @category Hardhat-Setup
+ * @notice The Network class is a helper class to register networks and Etherscan API keys.
+ * See the [README](https://github.com/1inch/solidity-utils/tree/master/hardhat-setup/README.md) for usage.
+ */
 export declare class Networks {
     networks: NetworksUserConfig;
     etherscan: Etherscan;

package/dist/hardhat-setup/networks.js

@@ -3,11 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Networks = exports.resetHardhatNetworkFork = exports.parseRpcEnv = exports.getNetwork = void 0;
 const tslib_1 = require("tslib");
 const dotenv_1 = tslib_1.__importDefault(require("dotenv"));
+/**
+ * @category Hardhat-Setup
+ * @notice A helper method to get the network name from the command line arguments.
+ * @returns The network name.
+ */
 function getNetwork() {
     const index = process.argv.findIndex((arg) => arg === '--network') + 1;
     return index !== 0 ? process.argv[index] : 'unknown';
 }
 exports.getNetwork = getNetwork;
+/**
+ * @category Hardhat-Setup
+ * @notice A helper method to parse RPC configuration strings. Checks that the string is in the expected format.
+ * @param envRpc The RPC configuration string to parse.
+ * @returns An object containing the RPC URL and optional auth key HTTP header.
+ */
 function parseRpcEnv(envRpc) {
     const [url, authKeyHttpHeader, overflow] = envRpc.split('|');
     if (overflow || url === '') {
@@ -16,6 +27,12 @@ function parseRpcEnv(envRpc) {
     return { url, authKeyHttpHeader };
 }
 exports.parseRpcEnv = parseRpcEnv;
+/**
+ * @category Hardhat-Setup
+ * @notice A helper method to reset the Hardhat network to the local network or to a fork.
+ * @param network The Hardhat network object.
+ * @param networkName The name of the network to reset to.
+ */
 async function resetHardhatNetworkFork(network, networkName) {
     if (networkName.toLowerCase() === 'hardhat') {
         await network.provider.request({
@@ -37,6 +54,11 @@ async function resetHardhatNetworkFork(network, networkName) {
     }
 }
 exports.resetHardhatNetworkFork = resetHardhatNetworkFork;
+/**
+ * @category Hardhat-Setup
+ * @notice The Network class is a helper class to register networks and Etherscan API keys.
+ * See the [README](https://github.com/1inch/solidity-utils/tree/master/hardhat-setup/README.md) for usage.
+ */
 class Networks {
     constructor(useHardhat = true, forkingNetworkName, saveHardhatDeployments = false) {
         this.networks = {};

package/dist/hardhat-setup/networks.js.map

@@ -1 +1 @@
-{"version":3,"file":"networks.js","sourceRoot":"","sources":["../../hardhat-setup/networks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"networks.js","sourceRoot":"","sources":["../../hardhat-setup/networks.ts"],"names":[],"mappings":";;;;AAAA,4DAA4B;AAO5B;;;;GAIG;AACH,SAAgB,UAAU;IACtB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC;IACvE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAHD,gCAGC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,MAAc;IACtC,MAAM,CAAE,GAAG,EAAE,iBAAiB,EAAE,QAAQ,CAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/D,IAAI,QAAQ,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,6EAA6E,CAAC,CAAC;IAC/H,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC;AACtC,CAAC;AAND,kCAMC;AAED;;;;;GAKG;AACI,KAAK,UAAU,uBAAuB,CAAC,OAAgB,EAAE,WAAmB;IAC/E,IAAI,WAAW,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC3B,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,EAAE;SACb,CAAC,CAAC;IACP,CAAC;SAAM,CAAC;QACJ,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1G,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC3B,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,CAAC;oBACL,OAAO,EAAE;wBACL,UAAU,EAAE,GAAG;wBACf,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS;qBACjF;iBACJ,CAAC;SACL,CAAC,CAAC;IACP,CAAC;AACL,CAAC;AAlBD,0DAkBC;AAED;;;;GAIG;AACH,MAAa,QAAQ;IAIjB,YAAY,aAAsB,IAAI,EAAE,kBAA2B,EAAE,yBAAkC,KAAK;QAH5G,aAAQ,GAAuB,EAAE,CAAC;QAClC,cAAS,GAAc,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;QAGpD,gBAAM,CAAC,MAAM,EAAE,CAAC;QAEhB,IAAI,UAAU,IAAI,kBAAkB,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG;gBACpB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,KAAK;gBACnD,6DAA6D;gBAC7D,aAAa;gBACb,eAAe,EAAE,sBAAsB;aAC1C,CAAC;QACN,CAAC;QAED,IAAI,kBAAkB,EAAE,CAAC;YACrB,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;YACjH,IAAI,CAAC,QAAQ,CAAC,OAAQ,CAAC,OAAO,GAAG;gBAC7B,GAAG;gBACH,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS;aACjF,CAAC;QACN,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,OAAe,EAAE,GAAY,EAAE,UAAmB,EAAE,oBAA6B,EAAE,YAAqB,EAAE,WAAmB,UAAU;QAC1J,IAAI,GAAG,IAAI,UAAU,IAAI,oBAAoB,IAAI,YAAY,EAAE,CAAC;YAC5D,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG;gBAClB,GAAG;gBACH,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS;gBAC9E,OAAO;gBACP,QAAQ,EAAE,CAAC,UAAU,CAAC;gBACtB,QAAQ;aACX,CAAC;YACF,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,YAAY,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,cAAc,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,kBAAkB,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED,cAAc,CAAC,IAAY,EAAE,OAAe,EAAE,GAAY,EAAE,UAAmB,EAAE,YAAqB,EAAE,SAAiB,EAAE,EAAE,aAAqB,EAAE,EAAE,QAAQ,GAAG,OAAO;QACpK,IAAI,GAAG,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;YAC5E,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC/F,CAAC;IACL,CAAC;IAED,cAAc,CAAC,IAAY,EAAE,OAAe,EAAE,GAAY,EAAE,UAAmB,EAAE,UAAmB,EAAE,SAAkB,EAAE,WAAmB,OAAO;QAChJ,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG;gBAClB,GAAG;gBACH,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS;gBAC9E,MAAM,EAAE,IAAI;gBACZ,OAAO;gBACP,QAAQ,EAAE,CAAC,UAAU,CAAC;gBACtB,QAAQ;gBACR,SAAS;gBACT,UAAU;aACQ,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,cAAc,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,kBAAkB,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED,WAAW;QACP,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACtJ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACnI,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAC7J,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,UAAU,EAAE,oBAAoB,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QAC9K,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAChJ,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAClK,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACzI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACzJ,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAC3J,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAC1J,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC1I,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,2BAA2B,EAAE,2BAA2B,CAAC,CAAC,CAAC,8BAA8B;QACzO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACvJ,yGAAyG;QACzG,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,UAAU,CAAC,CAAC;QACtI,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,CAAC,CAAC;QAC9J,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACzK,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IAClE,CAAC;CACJ;AAzFD,4BAyFC"}