How to whitelist source contracts on ICM (AWM) relayers?

By default ICM (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

Benefits of whitelisting

  • 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.