How to whitelist source contracts on ICM relayers?

By default ICM relayers (also known as AWM relayers) are open and will accept transactions from all source contracts.

This behavior can be modified to only allow source contracts that have been whitelisted to be processed, all other contracts would be blocked.

The benefits of whitelisting include:

Makes the relayer more secure
- Only contracts that have been allowed can utilize it
Better control of relayer funds
- The relayer will only pay the fees for transactions coming from whitelisted contracts, thus preventing unwanted cost coming from non-whitelisted contracts

Start by clicking on the Add new source contract, a popup window will open for selecting a connected L1 and entering the contract address. Once the information has been entered, click Add contract.

Note: the description field is optional.

The new contract will be added to the allowed source contract table

Note: modifying the allowed list will temporarily put the relayer in an updating state.

Repeat the process for whitelisting additional contracts

To remove a whitelisted contract, click on the delete button

A confirmation window will open, confirming will delete that contract from the allowed list

To reset the relayer back to allowing all source contracts, simply delete all of the whitelisted contracts.

For any additional questions, please view our other knowledge base articles or contact a support team member via the chat button. Examples are for illustrative purposes only.

Learn More About AvaCloud | Download Case Studies | Schedule an AvaCloud Demo