Pay gas
- Overview
- Example
- Alternative gas payment methods for callContract
- Alternative gas payment methods for callContractWithToken
- Two-way Call
Overview
Axelar gas services provide methods to pay the relayer gas fee for both callContract
and callContractWithToken
. The fee can be paid in the native token of the source chain or any token supported by Axelar network. An application that wants Axelar to automatically execute contract calls on the destination chain needs to do three things:
-
Estimate the
gasLimit
that the contract call will require on your executable contract on the destination chain. -
Call the
estimateGasFee
method to get thesourceGasFee
in the desired gas-payment token on the destination chain. See this code snippet for reference. (As a prerequisite, Axelar SDK must be installed. Refer to AxelarJS SDK.) -
Pay the AxelarGasService smart contract on the source chain in the amount calculated in step 2.
Example
For example, assume the following smart contract is deployed on a source chain:
contract SimpleTransferContract {
...
function sendToMany(
string memory destinationChain,
string memory destinationContractAddress,
address[] calldata destinationAddresses,
string memory symbol,
uint256 amount
) external payable {
address tokenAddress = gateway.tokenAddresses(symbol);
IERC20(tokenAddress).transferFrom(msg.sender, address(this), amount);
IERC20(tokenAddress).approve(address(gateway), amount);
bytes memory payload = abi.encode(destinationAddresses);
if(msg.value > 0) {
// The line below is where we pay the gas fee
gasReceiver.payNativeGasForContractCallWithToken{value: msg.value}(
address(this),
destinationChain,
destinationContractAddress,
payload,
symbol,
amount,
msg.sender
);
}
gateway.callContractWithToken(destinationChain, destinationContractAddress, payload, symbol, amount);
}
}
The msg.value
is the gas amount we pay to the AxelarGasService
contract.
So, on the front-end side, we need to pass sourceGasFee
to msg.value
like below:
await contract.sendToMany("moonbeam", "0x...", ["0x.."], "USDC", 1, {
value: sourceGasFee, // This is the value we get from Step 2.
});
After sending a transaction out, our Executor Service will do the following:
- Monitor
AxelarGasReceiver
for receipt of payment, and get the amount paid asamountPaid
. - Match those to contract calls.
- Execute the specified contract call, specifying the
gasLimit
defined above.
Alternative gas payment methods for callContract
There are two available methods to pay gas for relaying callContract
. You can choose the one that fits your application design.
payGasForContractcall
This method receives any tokens for the relayer fee. The paid gas for this method must be in tokens Axelar supports. See the list of supported assets for the chains we support: Mainnet | Testnet.
function payGasForContractCall(
address sender,
string calldata destinationChain,
string calldata destinationAddress,
bytes calldata payload,
address gasToken,
uint256 gasFeeAmount,
address refundAddress
) external;
payNativeGasForContractCall
This method accepts the native tokens of the source chain.
// This is called on the source chain before calling the gateway to execute a remote contract.
function payNativeGasForContractCall(
address sender,
string calldata destinationChain,
string calldata destinationAddress,
bytes calldata payload,
address refundAddress
) external payable;
Alternative gas payment methods for callContractWithToken
Similar to the available gas payment methods for callContract
, there are two available methods to pay gas for relaying the callContractWithToken
.
payGasForContractCallWithToken
This method receives any tokens for the relayer fee. The paid gas for this method must be in tokens Axelar supports. See the list of supported assets: Mainnet | Testnet.
// This is called on the source chain before calling the gateway to execute a remote contract.
function payGasForContractCallWithToken(
address sender,