Automate Contract Balance Top-up

1. Open the EthBalanceMonitor.sol contract in Remix.

   Open in Remix What is Remix?

2. Compile the contract in Remix.

3. On the Deploy & Run Transactions tab in Remix, set your Environment to Injected Provider and allow Remix to connect to MetaMask.

4. The constructor requires a keeperRegistryAddress value and a minWaitPeriodSeconds value. Specify these in the Deploy fields in Remix. You can find these registry addresses on the Automation Supported Networks page. For this example using Polygon Mumbai, enter the following values:

   • keeperRegistryAddress: 0xE16Df59B887e3Caa439E0b29B42bA2e7976FD8b2
   • minWaitPeriodSeconds: 60

5. Click Transact to deploy the contract with the defined constructor settings and accept the transaction in MetaMask. After the contract is deployed, it will appear in your Deployed Contracts list with several functions available to configure.

6. Use metamask to Send 0.001 MATIC to your contract address. The funds are used to top-up other contracts with MATIC. See the Fund Your Contracts page to learn how to find your contract address and send funds to those contracts. For this example, 0.001 MATIC is sufficient for demonstration purposes. In a production environment, you might store a larger amount of funds in the contract so Chainlink Automation can automatically distribute them to several different addresses as they are needed over time.

Before your contract will fund an address, you must set the watchList address array with minBalancesWei and topUpAmmountsWei variables. For this example on Polygon Mumbai, you are using testnet MATIC instead of wei (ETH). For demonstration purposes, you configure your own wallet as the top-up address. This makes it easy to see the MATIC being sent as part of the automated top-up function. After you complete this tutorial, you can configure any wallet or contract address that you want to keep funded.

1. In the list of functions for your deployed contract, run the setWatchList function. This function requires an addresses array, a minBalancesWei array that maps to the addresses, and a topUpAmountsWei array that also maps to the addresses. In Remix, arrays require brackets and quotes around both addresses and integer values. For this example, set the following values:

   • addresses: ["YOUR_WALLET_ADDRESS_OR_CONTRACT_ADDRESS"]
   • minBalancesWei: ["100000000000000000000"]
   • topUpAmountsWei: ["000100000000000000"]

   These values tell the top up contract to top up the specified address with 0.0001 MATIC if the address balance is less than 100 MATIC. These settings are intended to demonstrate the example using testnet faucet funds. For a production application, you might set more reasonable values that top up a smart contract with 10 MATIC if the balance is less than 1 MATIC.

2. After you configure the function values, click transact to run the function. MetaMask asks you to confirm the transaction.

3. In the functions list, click the getWatchList function to confirm your settings are correct.

Now that the contract is deployed, funded, and configured, register the upkeep and Chainlink Automation will automatically run the example code.

1. Go to the automation.chain.link registration UI.

2. Click Connect wallet in the top right of the UI to connect your wallet.

3. After the site recognizes your wallet, click Register new Upkeep. The registration interface opens.

4. Select the Custom logic trigger option.

5. Copy your contract address from Remix and paste it into the Target contract address field.

6. Click Next to go to the Upkeep details page.

7. Specify a name for your upkeep and set a Starting balance of 2 LINK. Leave the other settings at their default values.

8. Click Register Upkeep to complete the registration process.

Now that you've registered the upkeep, Chainlink Automation handles the rest of the process.

The upkeep runs the checkUpkeep function in your contract, which checks the balances of all addresses in the watchList against their defined limits. If any of the addresses are below their specified minimum balances, the upkeep runs the topUp function for that specific address, which distributes the MATIC in your contract to that address. Unless your wallet happens to have more than 100 testnet MATIC, you will receive MATIC in your wallet every 60 seconds as defined by minWaitPeriodSeconds in your contract. Check to make sure the example is running correctly:

1. Go to automation.chain.link, view your new upkeep, and confirm that it is performing upkeeps in the History list.

2. View your contract address and your wallet address at mumbai.polygonscan.com to see the transactions happening between your contract and your wallet address.

The example continues to run until your upkeep runs out of LINK, your contract runs out of MATIC, or until you manually pause or cancel the upkeep.

After you are done with this example, you can run the withdraw function on your contract to withdraw any remaining testnet MATIC so you can use it later. Also, you can cancel your upkeep in the Automation UI and withdraw any remaining unspent LINK.