How to whitelist source contracts on AWM relayers?

By default 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
- Note: the description field is optional


Once the information has been entered, click "Add contract"


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