Created using remix-ide: Realtime Ethereum Contract Compiler and Runtime. Load this file by pasting this gists URL or ID at https://remix.ethereum.org/#version=soljson-v0.8.18+commit.87f61d96.js&optimize=false&runs=200&gist=

.prettierrc.json

{
    "overrides": [
        {
            "files": "*.sol",
            "options": {
                "printWidth": 80,
                "tabWidth": 4,
                "useTabs": false,
                "singleQuote": false,
                "bracketSpacing": false
            }
        },
        {
            "files": "*.yml",
            "options": {}
        },
        {
            "files": "*.yaml",
            "options": {}
        },
        {
            "files": "*.toml",
            "options": {}
        },
        {
            "files": "*.json",
            "options": {}
        },
        {
            "files": "*.js",
            "options": {}
        },
        {
            "files": "*.ts",
            "options": {}
        }
    ]
}

README.txt

REMIX DEFAULT WORKSPACE

Remix default workspace is present when:
i. Remix loads for the very first time 
ii. A new workspace is created with 'Default' template
iii. There are no files existing in the File Explorer

This workspace contains 3 directories:

1. 'contracts': Holds three contracts with increasing levels of complexity.
2. 'scripts': Contains four typescript files to deploy a contract. It is explained below.
3. 'tests': Contains one Solidity test file for 'Ballot' contract & one JS test file for 'Storage' contract.

SCRIPTS

The 'scripts' folder has four typescript files which help to deploy the 'Storage' contract using 'web3.js' and 'ethers.js' libraries.

For the deployment of any other contract, just update the contract's name from 'Storage' to the desired contract and provide constructor arguments accordingly 
in the file `deploy_with_ethers.ts` or  `deploy_with_web3.ts`

In the 'tests' folder there is a script containing Mocha-Chai unit tests for 'Storage' contract.

To run a script, right click on file name in the file explorer and click 'Run'. Remember, Solidity file must already be compiled.
Output from script will appear in remix terminal.

Please note, require/import is supported in a limited manner for Remix supported modules.
For now, modules supported by Remix are ethers, web3, swarmgw, chai, multihashes, remix and hardhat only for hardhat.ethers object/plugin.
For unsupported modules, an error like this will be thrown: '<module_name> module require is not supported by Remix IDE' will be shown.

contracts...1_Storage.sol

// SPDX-License-Identifier: GPL-3.0

pragma solidity >=0.8.2 <0.9.0;

/**
 * @title Storage
 * @dev Store & retrieve value in a variable
 * @custom:dev-run-script ./scripts/deploy_with_ethers.ts
 */
contract Storage {

    uint256 number;

    /**
     * @dev Store value in variable
     * @param num value to store
     */
    function store(uint256 num) public {
        number = num;
    }

    /**
     * @dev Return value 
     * @return value of 'number'
     */
    function retrieve() public view returns (uint256){
        return number;
    }
}

contracts...2_Owner.sol

// SPDX-License-Identifier: GPL-3.0

pragma solidity >=0.7.0 <0.9.0;

import "hardhat/console.sol";

/**
 * @title Owner
 * @dev Set & change owner
 */
contract Owner {

    address private owner;

    // event for EVM logging
    event OwnerSet(address indexed oldOwner, address indexed newOwner);

    // modifier to check if caller is owner
    modifier isOwner() {
        // If the first argument of 'require' evaluates to 'false', execution terminates and all
        // changes to the state and to Ether balances are reverted.
        // This used to consume all gas in old EVM versions, but not anymore.
        // It is often a good idea to use 'require' to check if functions are called correctly.
        // As a second argument, you can also provide an explanation about what went wrong.
        require(msg.sender == owner, "Caller is not owner");
        _;
    }

    /**
     * @dev Set contract deployer as owner
     */
    constructor() {
        console.log("Owner contract deployed by:", msg.sender);
        owner = msg.sender; // 'msg.sender' is sender of current call, contract deployer for a constructor
        emit OwnerSet(address(0), owner);
    }

    /**
     * @dev Change owner
     * @param newOwner address of new owner
     */
    function changeOwner(address newOwner) public isOwner {
        emit OwnerSet(owner, newOwner);
        owner = newOwner;
    }

    /**
     * @dev Return owner address 
     * @return address of owner
     */
    function getOwner() external view returns (address) {
        return owner;
    }
} 

contracts...3_Ballot.sol

// SPDX-License-Identifier: GPL-3.0

pragma solidity >=0.7.0 <0.9.0;

/** 
 * @title Ballot
 * @dev Implements voting process along with vote delegation
 */
contract Ballot {

    struct Voter {
        uint weight; // weight is accumulated by delegation
        bool voted;  // if true, that person already voted
        address delegate; // person delegated to
        uint vote;   // index of the voted proposal
    }

    struct Proposal {
        // If you can limit the length to a certain number of bytes, 
        // always use one of bytes1 to bytes32 because they are much cheaper
        bytes32 name;   // short name (up to 32 bytes)
        uint voteCount; // number of accumulated votes
    }

    address public chairperson;

    mapping(address => Voter) public voters;

    Proposal[] public proposals;

    /** 
     * @dev Create a new ballot to choose one of 'proposalNames'.
     * @param proposalNames names of proposals
     */
    constructor(bytes32[] memory proposalNames) {
        chairperson = msg.sender;
        voters[chairperson].weight = 1;

        for (uint i = 0; i < proposalNames.length; i++) {
            // 'Proposal({...})' creates a temporary
            // Proposal object and 'proposals.push(...)'
            // appends it to the end of 'proposals'.
            proposals.push(Proposal({
                name: proposalNames[i],
                voteCount: 0
            }));
        }
    }

    /** 
     * @dev Give 'voter' the right to vote on this ballot. May only be called by 'chairperson'.
     * @param voter address of voter
     */
    function giveRightToVote(address voter) public {
        require(
            msg.sender == chairperson,
            "Only chairperson can give right to vote."
        );
        require(
            !voters[voter].voted,
            "The voter already voted."
        );
        require(voters[voter].weight == 0);
        voters[voter].weight = 1;
    }

    /**
     * @dev Delegate your vote to the voter 'to'.
     * @param to address to which vote is delegated
     */
    function delegate(address to) public {
        Voter storage sender = voters[msg.sender];
        require(!sender.voted, "You already voted.");
        require(to != msg.sender, "Self-delegation is disallowed.");

        while (voters[to].delegate != address(0)) {
            to = voters[to].delegate;

            // We found a loop in the delegation, not allowed.
            require(to != msg.sender, "Found loop in delegation.");
        }
        sender.voted = true;
        sender.delegate = to;
        Voter storage delegate_ = voters[to];
        if (delegate_.voted) {
            // If the delegate already voted,
            // directly add to the number of votes
            proposals[delegate_.vote].voteCount += sender.weight;
        } else {
            // If the delegate did not vote yet,
            // add to her weight.
            delegate_.weight += sender.weight;
        }
    }

    /**
     * @dev Give your vote (including votes delegated to you) to proposal 'proposals[proposal].name'.
     * @param proposal index of proposal in the proposals array
     */
    function vote(uint proposal) public {
        Voter storage sender = voters[msg.sender];
        require(sender.weight != 0, "Has no right to vote");
        require(!sender.voted, "Already voted.");
        sender.voted = true;
        sender.vote = proposal;

        // If 'proposal' is out of the range of the array,
        // this will throw automatically and revert all
        // changes.
        proposals[proposal].voteCount += sender.weight;
    }

    /** 
     * @dev Computes the winning proposal taking all previous votes into account.
     * @return winningProposal_ index of winning proposal in the proposals array
     */
    function winningProposal() public view
            returns (uint winningProposal_)
    {
        uint winningVoteCount = 0;
        for (uint p = 0; p < proposals.length; p++) {
            if (proposals[p].voteCount > winningVoteCount) {
                winningVoteCount = proposals[p].voteCount;
                winningProposal_ = p;
            }
        }
    }

    /** 
     * @dev Calls winningProposal() function to get the index of the winner contained in the proposals array and then
     * @return winnerName_ the name of the winner
     */
    function winnerName() public view
            returns (bytes32 winnerName_)
    {
        winnerName_ = proposals[winningProposal()].name;
    }
}

contracts...Raffle.sol

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;

import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/utils/math/Math.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "@chainlink/contracts/src/v0.8/VRFConsumerBaseV2.sol";
import "@chainlink/contracts/src/v0.8/interfaces/VRFCoordinatorV2Interface.sol";

import "./interfaces/IMetaData.sol";
import "./interfaces/IRaffle.sol";
import "./utils/RandomUtils.sol";
import "./utils/ArrayUtils.sol";

import "hardhat/console.sol";

contract Raffle is IRaffle, VRFConsumerBaseV2, Ownable {
    using AddressArrayUtils for address[];
    using UintArrayUtils for uint256[];

    uint16 private constant REQUEST_CONFIRMATIONS = 3;

    bytes32 private immutable i_keyHash;
    uint32 private immutable i_callbackGasLimit;
    uint64 private immutable i_subscriptionId;
    VRFCoordinatorV2Interface private immutable i_vrfCoordinator;
    IMetaData private immutable i_metaData;

    mapping(uint256 => bytes32) private s_poolOpenings;
    mapping(bytes32 => RafflePrizePool) private s_pools;
    bytes32[] s_poolIds;

    mapping(uint256 => bytes32) private s_requestIdToPoolId;
    mapping(bytes32 => Winner[]) s_poolWinners;

    constructor(
        // VRF Requirements
        uint64 subscriptionId,
        bytes32 keyHash,
        uint32 callbackGasLimit,
        address vrfCoordinator,
        // VRF Requirements
        IMetaData metaData,
        bytes[4][] memory prizePoolSettings
    ) Ownable() VRFConsumerBaseV2(vrfCoordinator) {
        i_subscriptionId = subscriptionId;
        i_keyHash = keyHash;
        i_callbackGasLimit = callbackGasLimit;
        i_vrfCoordinator = VRFCoordinatorV2Interface(vrfCoordinator);
        i_metaData = metaData;

        unchecked {
            for (uint256 index = 0; index < prizePoolSettings.length; index++) {
                initializePool(prizePoolSettings[index], index);
            }
        }
    }

    function initializePool(
        bytes[4] memory prizePoolSetting,
        uint index
    ) private {
        uint256 opensAt = abi.decode(
            prizePoolSetting[uint256(PrizePoolSettings.OPENS_AT)],
            (uint256)
        );
        string[] memory prizeNames = abi.decode(
            prizePoolSetting[uint256(PrizePoolSettings.PRIZE_NAMES)],
            (string[])
        );
        uint256[] memory prizeQuantities = abi.decode(
            prizePoolSetting[uint256(PrizePoolSettings.PRIZE_QUANTITIES)],
            (uint256[])
        );
        uint256[] memory prizeAmounts = abi.decode(
            prizePoolSetting[uint256(PrizePoolSettings.PRIZE_AMOUNTS)],
            (uint256[])
        );

        string memory name = string.concat(
            "Second Chance #",
            Strings.toString(index + 1)
        );
        bytes32 poolId = keccak256(abi.encodePacked(name));
        address[] memory users;
        uint256[][] memory tokens;

        RafflePrizePool memory prizePool = RafflePrizePool(
            poolId,
            opensAt,
            0,
            name,
            prizeNames,
            prizeQuantities,
            prizeAmounts,
            users,
            tokens,
            false,
            false,
            true
        );

        s_poolOpenings[opensAt] = poolId;
        s_pools[poolId] = prizePool;
        s_poolIds.push(poolId);
    }

    function openPrizePool(
        bytes32 poolId,
        uint256 openForSeconds
    ) external override {
        if (msg.sender != address(i_metaData) && msg.sender != owner()) {
            revert Raffle_Unauthorized();
        }

        RafflePrizePool memory pool = s_pools[poolId];

        if (!pool.exists) {
            revert Raffle_PrizePoolNotFound(poolId);
        }

        if (pool.isOpen) {
            revert Raffle_PoolAlreadyOpen(poolId);
        }

        pool.isOpen = true;
        pool.openUntil = block.timestamp + openForSeconds;

        s_pools[poolId] = pool;

        emit Raffle_PoolOpened(poolId, pool.openUntil);
    }

    function addPrizePool(
        string calldata name,
        uint256 openForSeconds,
        string[] calldata prizeNames,
        uint256[] calldata prizeQuantities,
        uint256[] calldata prizeAmounts
    ) external override onlyOwner {
        bytes32 poolId = keccak256(abi.encodePacked(name));

        if (s_pools[poolId].exists) {
            revert Raffle_PrizePoolAlreadyExists(poolId);
        }

        uint256 openUntil = block.timestamp + openForSeconds;
        address[] memory users;
        uint256[][] memory tokens;

        RafflePrizePool memory prizePool = RafflePrizePool(
            poolId,
            0,
            openUntil,
            name,
            prizeNames,
            prizeQuantities,
            prizeAmounts,
            users,
            tokens,
            false,
            false,
            true
        );

        s_pools[poolId] = prizePool;
    }

    function registerUser(
        bytes32 poolId,
        address user
    ) external override onlyOwner {
        RafflePrizePool memory pool = s_pools[poolId];

        if (!pool.exists) {
            revert Raffle_PrizePoolNotFound(poolId);
        }

        if (!pool.isOpen) {
            revert Raffle_PoolNotOpen(poolId);
        }

        if (pool.openUntil < block.timestamp) {
            revert Raffle_RegistrationClosedByTime(poolId);
        }

        address[] memory registeredUsers = new address[](
            pool.registeredUsers.length + 1
        );

        bool isDuplicate = false;

        unchecked {
            for (uint256 i = 0; i < pool.registeredUsers.length; i++) {
                registeredUsers[i] = pool.registeredUsers[i];
                if (pool.registeredUsers[i] == user) {
                    isDuplicate = true;
                }
            }
        }

        if (isDuplicate) {
            revert Raffle_UserAlreadyRegistered(poolId, user);
        }

        registeredUsers[registeredUsers.length - 1] = user;

        pool.registeredUsers = registeredUsers;
        s_pools[poolId] = pool;

        emit Raffle_UserRegisteredIntoPool(user, poolId);
    }

    function initiateRaffle(
        bytes32 poolId,
        uint256[][] memory tokenIds
    ) external override onlyOwner {
        RafflePrizePool memory pool = s_pools[poolId];

        if (!pool.exists) {
            revert Raffle_PrizePoolNotFound(poolId);
        }

        if (pool.registeredUsers.length != tokenIds.length) {
            revert Raffle_RaffleTokenCountMismatch(poolId);
        }

        // Maybe this is an unnecessary check
        if (!pool.isOpen) {
            revert Raffle_PoolNotOpen(poolId);
        }

        if (pool.openUntil > block.timestamp) {
            revert Raffle_PoolNotReadyForRaffle(
                pool.openUntil - block.timestamp
            );
        }

        console.log(
            "Closing pool: ",
            pool.name,
            "Users: ",
            pool.registeredUsers.length
        );
        console.log("Tokens: ", tokenIds.length);

        pool.isOpen = false;
        pool.registeredTokens = tokenIds;

        s_pools[poolId] = pool;

        uint256 requestId = i_vrfCoordinator.requestRandomWords(
            i_keyHash,
            i_subscriptionId,
            REQUEST_CONFIRMATIONS,
            i_callbackGasLimit,
            100
        );

        s_requestIdToPoolId[requestId] = poolId;

        emit Raffle_Initiated(poolId, requestId);
    }

    string[] private s_logs;

    function getLogs() public view returns (string[] memory logs) {
        return s_logs;
    }

    event Raffle_ResultsWinners(
        bytes32 indexed poolId,
        Winner[] indexed winners
    );

    function fulfillRandomWords(
        uint256 requestId,
        uint256[] memory randomWords
    ) internal override {
        console.log("RequestId: ", requestId);

        RafflePrizePool memory pool = s_pools[s_requestIdToPoolId[requestId]];

        console.log("FulfillRandomWords: ", pool.name);

        uint drawablePrizes = Math.min(
            pool.registeredUsers.length,
            pool.prizeQuantities.sum()
        );

        console.log("drawablePrizes: ", drawablePrizes);

        uint[] memory prizes = getPrizes(pool);
        uint256[] memory entries = new uint256[](pool.registeredUsers.length);

        unchecked {
            for (uint256 i = 0; i < pool.registeredUsers.length; i++) {
                entries[i] = calculateEntries(pool.registeredTokens[i].length);
            }
        }

        uint256 totalEntries = entries.sum();

        console.log("Registered users: ", pool.registeredUsers.length);
        console.log("Total entries", totalEntries);

        address[] memory winners = new address[](drawablePrizes);

        uint256 randomOffset = 0;
        uint256 winnerIterator = 0;

        while (winnerIterator < drawablePrizes) {
            console.log(
                "\nNew round: ",
                randomOffset,
                randomWords[randomOffset]
            );

            uint256 winnerIndex;

            unchecked {
                winnerIndex = RandomUtils.weightDistributedRandom(
                    randomWords[randomOffset++],
                    entries,
                    totalEntries,
                    true
                );
            }

            address winner = pool.registeredUsers[winnerIndex];
            console.log("user", winner);

            if (winners.contains(winner)) {
                console.log("User already won", winnerIndex);
                // The same user can't win multiple prizes
                continue;
            }

            console.log(
                "Winner iterator/index: ",
                winnerIterator,
                " / ",
                winnerIndex
            );

            winners[winnerIterator] = winner;

            uint prize = prizes[winnerIterator];
            console.log("prize", prize);

            registerWinner(pool.id, winner, prize);

            winnerIterator++;
        }

        console.log("Raffle ended");

        emit Raffle_Results(pool.id, winners);
    }

    function registerWinner(
        bytes32 poolId,
        address winner,
        uint256 prize
    ) internal {
        console.log("registerWinner: ", winner, prize);
        console.log("winners count before: ", s_poolWinners[poolId].length);

        s_poolWinners[poolId].push(Winner(winner, prize));

        logWinners(poolId);
        console.log("winners count after: ", s_poolWinners[poolId].length);
    }

    function logWinners(bytes32 poolId) public view {
        RafflePrizePool memory pool = s_pools[poolId];

        for (uint256 i = 0; i < s_poolWinners[pool.id].length; i++) {
            console.log(
                "poolwinners: ",
                s_poolWinners[pool.id][i].user,
                s_poolWinners[pool.id][i].prize
            );
        }
    }

    function getPrizes(
        RafflePrizePool memory pool
    ) internal view returns (uint256[] memory) {
        uint numOfPrizes = pool.prizeQuantities.sum();

        uint256[] memory prizes = new uint256[](numOfPrizes);

        uint k = 0;

        for (uint256 i = 0; i < pool.prizeQuantities.length; i++) {
            for (uint256 j = 0; j < pool.prizeQuantities[i]; j++) {
                prizes[k++] = pool.prizeAmounts[i];
                console.log("K: ", prizes[k - 1]);
            }
        }

        console.log("Prizes: ", prizes.length);

        return prizes;
    }

    function setPaid(bytes32 poolId) external onlyOwner {
        s_pools[poolId].isPaid = true;
    }

    function calculateEntries(
        uint256 numOfScratchedTickets
    ) public pure override returns (uint256) {
        if (numOfScratchedTickets >= 1 && numOfScratchedTickets < 5) {
            return numOfScratchedTickets * 10;
        }

        if (numOfScratchedTickets >= 5 && numOfScratchedTickets < 10) {
            return numOfScratchedTickets * 15;
        }

        if (numOfScratchedTickets >= 10 && numOfScratchedTickets < 15) {
            return numOfScratchedTickets * 20;
        }

        if (numOfScratchedTickets >= 15 && numOfScratchedTickets < 20) {
            return numOfScratchedTickets * 25;
        }

        if (numOfScratchedTickets >= 20 && numOfScratchedTickets < 25) {
            return numOfScratchedTickets * 30;
        }

        if (numOfScratchedTickets >= 25 && numOfScratchedTickets < 30) {
            return numOfScratchedTickets * 35;
        }

        if (numOfScratchedTickets >= 30) {
            return 1200;
        }

        return 0;
    }

    function needsToOpenPool(
        uint256 scratchedOffCount
    ) external view override returns (bool, bytes32) {
        if (s_poolOpenings[scratchedOffCount] == bytes32(0)) {
            return (false, 0);
        }

        return (true, s_poolOpenings[scratchedOffCount]);
    }

    function validateEligibleTokenIds(
        uint256[] calldata tokenIds
    ) public view override returns (uint256[] memory) {
        uint256[] memory eligibleTokenIds;
        uint256 counter = 0;
        unchecked {
            for (uint256 i = 0; i < tokenIds.length; i++) {
                IMetaData.TokenMetaData memory metadata = i_metaData
                    .getTokenMetaData(tokenIds[i]);
                if (
                    metadata.status == IMetaData.NFTStatus.PRIZE_REVEALED &&
                    metadata.winner == false
                ) {
                    eligibleTokenIds[counter] = (tokenIds[i]);
                    counter++;
                }
            }
        }

        return eligibleTokenIds;
    }

    function getPrizePools() external view returns (RafflePrizePool[] memory) {
        RafflePrizePool[] memory pools = new RafflePrizePool[](
            s_poolIds.length
        );

        for (uint i = 0; i < s_poolIds.length; i++) {
            pools[i] = s_pools[s_poolIds[i]];
        }

        return pools;
    }

    function getPrizePool(
        bytes32 poolId
    ) external view returns (RafflePrizePool memory) {
        return s_pools[poolId];
    }

    function getWinners(
        bytes32 poolId
    ) external view returns (Winner[] memory) {
        return s_poolWinners[poolId];
    }
}

scripts...deploy_with_ethers.ts

// This script can be used to deploy the "Storage" contract using ethers.js library.
// Please make sure to compile "./contracts/1_Storage.sol" file before running this script.
// And use Right click -> "Run" from context menu of the file to run the script. Shortcut: Ctrl+Shift+S

import { deploy } from './ethers-lib'

(async () => {
    try {
        const result = await deploy('Storage', [])
        console.log(`address: ${result.address}`)
    } catch (e) {
        console.log(e.message)
    }
  })()

scripts...deploy_with_web3.ts

// This script can be used to deploy the "Storage" contract using Web3 library.
// Please make sure to compile "./contracts/1_Storage.sol" file before running this script.
// And use Right click -> "Run" from context menu of the file to run the script. Shortcut: Ctrl+Shift+S

import { deploy } from './web3-lib'

(async () => {
    try {
        const result = await deploy('Storage', [])
        console.log(`address: ${result.address}`)
    } catch (e) {
        console.log(e.message)
    }
})()

scripts...ethers-lib.ts

import { ethers } from 'ethers'

/**
 * Deploy the given contract
 * @param {string} contractName name of the contract to deploy
 * @param {Array<any>} args list of constructor' parameters
 * @param {Number} accountIndex account index from the exposed account
 * @return {Contract} deployed contract
 */
export const deploy = async (contractName: string, args: Array<any>, accountIndex?: number): Promise<ethers.Contract> => {    

    console.log(`deploying ${contractName}`)
    // Note that the script needs the ABI which is generated from the compilation artifact.
    // Make sure contract is compiled and artifacts are generated
    const artifactsPath = `browser/contracts/artifacts/${contractName}.json` // Change this for different path

    const metadata = JSON.parse(await remix.call('fileManager', 'getFile', artifactsPath))
    // 'web3Provider' is a remix global variable object
    
    const signer = (new ethers.providers.Web3Provider(web3Provider)).getSigner(accountIndex)

    const factory = new ethers.ContractFactory(metadata.abi, metadata.data.bytecode.object, signer)

    const contract = await factory.deploy(...args)   

    // The contract is NOT deployed yet; we must wait until it is mined
    await contract.deployed()
    return contract
}

scripts...web3-lib.ts

import Web3 from 'web3'
import { Contract, ContractSendMethod, Options } from 'web3-eth-contract'

/**
 * Deploy the given contract
 * @param {string} contractName name of the contract to deploy
 * @param {Array<any>} args list of constructor' parameters
 * @param {string} from account used to send the transaction
 * @param {number} gas gas limit
 * @return {Options} deployed contract
 */
export const deploy = async (contractName: string, args: Array<any>, from?: string, gas?: number): Promise<Options> => {

    const web3 = new Web3(web3Provider)
    console.log(`deploying ${contractName}`)
    // Note that the script needs the ABI which is generated from the compilation artifact.
    // Make sure contract is compiled and artifacts are generated
    const artifactsPath = `browser/contracts/artifacts/${contractName}.json`

    const metadata = JSON.parse(await remix.call('fileManager', 'getFile', artifactsPath))

    const accounts = await web3.eth.getAccounts()

    const contract: Contract  = new web3.eth.Contract(metadata.abi)

    const contractSend: ContractSendMethod = contract.deploy({
        data: metadata.data.bytecode.object,
        arguments: args
    })

    const newContractInstance = await contractSend.send({
        from: from || accounts[0],
        gas: gas || 1500000
    })
    return newContractInstance.options    
}

tests...Ballot_test.sol

// SPDX-License-Identifier: GPL-3.0

pragma solidity >=0.7.0 <0.9.0;
import "remix_tests.sol"; // this import is automatically injected by Remix.
import "hardhat/console.sol";
import "../contracts/3_Ballot.sol";

contract BallotTest {

    bytes32[] proposalNames;

    Ballot ballotToTest;
    function beforeAll () public {
        proposalNames.push(bytes32("candidate1"));
        ballotToTest = new Ballot(proposalNames);
    }

    function checkWinningProposal () public {
        console.log("Running checkWinningProposal");
        ballotToTest.vote(0);
        Assert.equal(ballotToTest.winningProposal(), uint(0), "proposal at index 0 should be the winning proposal");
        Assert.equal(ballotToTest.winnerName(), bytes32("candidate1"), "candidate1 should be the winner name");
    }

    function checkWinninProposalWithReturnValue () public view returns (bool) {
        return ballotToTest.winningProposal() == 0;
    }
}

tests...storage.test.js

// Right click on the script name and hit "Run" to execute
const { expect } = require("chai");
const { ethers } = require("hardhat");

describe("Storage", function () {
  it("test initial value", async function () {
    const Storage = await ethers.getContractFactory("Storage");
    const storage = await Storage.deploy();
    await storage.deployed();
    console.log('storage deployed at:'+ storage.address)
    expect((await storage.retrieve()).toNumber()).to.equal(0);
  });
   it("test updating and retrieving updated value", async function () {
    const Storage = await ethers.getContractFactory("Storage");
    const storage = await Storage.deploy();
    await storage.deployed();
    const storage2 = await ethers.getContractAt("Storage", storage.address);
    const setValue = await storage2.store(56);
    await setValue.wait();
    expect((await storage2.retrieve()).toNumber()).to.equal(56);
  });
});