Relayers
A relayer is a simple web service that receives signed transactions from NEAR users, and relays them to the network while attaching tokens to sponsor their GAS expenses. This can be useful to create applications in which the users are not required to purchase NEAR in order to be able to transact. In this document we present a high-level overview on how relayers work. Please check the build a relayer page if you want to learn how to build your own relayer.
How it works​
Relayers are a natural consequence of Meta Transactions (NEP-366), a special type of transaction that can be best understood as an intent.
The user expresses: "I want to do a specific action on chain" and signs this intent off-chain, but does not send it to the network. Instead, they send the intent to a Relayer, which wraps the message into an actual transaction, attaches the necessary funds, and sends it to the network.
Technical Details
Technically, the end user (client) creates a SignedDelegateAction that contains the data necessary to construct a Transaction, signs the SignedDelegateAction using their key, and send it to the relayer service.
When the request is received, the relayer uses its own key to sign a Transaction using the fields in the SignedDelegateAction as input to create a SignedTransaction.
The SignedTransaction is then sent to the network via RPC call, and the result is sent back to the client. The Transaction is executed in such a way that the relayer pays the GAS fees, but all actions are executed as if the user had sent the transaction.
Why use a Relayer?​
There are multiple reasons to use a relayer:
- Your users are new to NEAR and don't have any gas to cover transactions
- Your users have an account on NEAR, but only have a Fungible Token Balance. They can now use the FT to pay for gas
- As an enterprise or a large startup you want to seamlessly onboard your existing users onto NEAR without needing them to worry about gas costs and seed phrases
- As an enterprise or large startup you have a user base that can generate large spikes of user activity that would congest the network. In this case, the relayer acts as a queue for low urgency transactions
- In exchange for covering the gas fee costs, relayer operators can limit where users spend their assets while allowing users to have custody and ownership of their assets
- Capital Efficiency: Without relayer if your business has 1M users they would have to be allocated 0.25 NEAR to cover their gas costs totalling 250k NEAR. However, only ~10% of the users would actually use the full allowance and a large amount of the 250k NEAR is just sitting there unused. So using the relayer, you can allocate 50k NEAR as a global pool of capital for your users, which can refilled on an as needed basis.
