What is a transaction relayer?
A transaction relayer is a communications service that broadcasts the transaction you have already signed with your own keys to the blockchain. The relayer does not take custody of your tokens or private keys. World App allows you to configure a custom transaction relayer for your transactions.
By default, your World App transactions will utilize the World Transaction Proxy, which routes them to third-party ERC-4337 bundlers (such as Pimlico or Alchemy) that support World Chain.
While many users may choose not to change this setting, those seeking additional control over how their ERC-4337 smart account transactions are submitted to the blockchain may choose to do so.
What happens if I change it?
If you set a custom relayer:
- All blockchain transactions in World App will use your selected relayer
- This includes token transfers and Mini App transactions
If your relayer is unavailable, incorrectly configured, or does not support bundler sponsored transactions (also called boosted paymasters), transactions may fail.
Please note that depending on where you or your chosen relayer operate, relayer activity can be regulated as money services or crypto-asset services. World App itself does not provide transfer services and does not intermediate or hold customer funds. If you opt to use a custom relayer, you are responsible for ensuring that the relayer meets any licensing or registration requirements in your jurisdiction.
How do I change the transaction relayer in World App?
- Navigate to the World ID tab
- Tap on Settings (gear icon)
- Select Wallet
- Open Advanced Settings
- Select Transaction Relayer
- Paste your ERC-4337-compatible relayer URL
- Save your changes
Once saved, World App will use your selected relayer for future transactions.
If the URL is invalid or not supported, you will see an error message in the app.
You can switch back to the default setting at any time.
Understanding Network Fees
Network fees fluctuate based on network congestion and are outside World App’s control.
World App displays estimated network fees. Always review the quote on-screen before approving the transaction.
Network fees are paid directly to block validators. World App does not receive or retain any pay or part of network fees. If you switch to a custom relayer, World App cannot guarantee or display how much you may be charged per transaction.
When using a custom relayer, you are responsible for configuring your relayer’s network fee policies, including any maximum fee limits.
World App does not control third-party relayers and is not responsible for transaction costs incurred through custom relayer configurations.
Support Information
- If you are using the default relayer configuration (World Transaction Proxy), World App Support can help investigate issues within the app experience.
- If you are using a custom relayer, issues related to transaction submission, delays, or failures may need to be resolved with the relayer provider you selected.
World App Support cannot troubleshoot or manage third-party relayer infrastructure.
If you’re experiencing transaction failures and are unsure whether your relayer is the cause, you can switch back to the default relayer and try again.
Translations may differ slightly from the original English content. For the most accurate information, please refer to the article's English version if any discrepancies occur.