Skip to main content

Fee Setup and Management

Setting up fees is essential for your app to interact with both the offchainVM and supported blockchains. There are two types of fees you need to manage:

  1. OffchainVM transaction fees
  2. Onchain transaction sponsorship

OffchainVM Transaction Fees​

OffchainVM transactions require its native gas token. You can:

Transaction fees work similarly to standard blockchain transactions - specify gasPrice and gasLimit or use automatic estimation.

Onchain Transaction Sponsorship​

1. Deposit Sponsorship Tokens to pay for transactions​

First, deposit ETH to the PayloadDeliveryPlug contract on your chosen chain:

cast send <PLUG_ADDRESS> "deposit(address,uint256,address)" \
    0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE \
    <AMOUNT> \
    $COUNTER_APPGATEWAY \
    --value <AMOUNT> \
    --rpc-url $SEPOLIA_RPC \
    --private-key $PRIVATE_KEY
info

Currently only ETH is supported. Support for additional tokens is coming soon.

2. Configure Fee Data​

Set up the FeesData structure for your app:

struct FeesData {
    uint32 feePoolChain;
    address feePoolToken;
    uint256 maxFees;
}

FeesData feesData = FeesData({
    feePoolChain: <chain_slug>,
    feePoolToken: 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE,
    maxFees: <max_fee_per_tx>
});

3. Apply Fee Configuration​

Set the fee configuration in your contracts:

AppGateway(appGateway).setFees(feesData);
Deployer(deployer).setFees(feesData);

or set them in the constructor of the AppGateway and Deployer.

_setFeesData(feesData_);

Contract Deployment​

1. Deploy to offchainVM​

Deploy your contracts using the DeployGateway.s.sol script by running:

forge script script/super-token/SetupSuperToken.s.sol --broadcast

2. Fund Your App​

After deployment, deposit fees against your SuperTokenAppGateway's address on any supported chain to enable offchainVM to execute transactions on your behalf.

3. Deploy to Target Chains​

Below is an example of how to complete the script DeployContracts.s.sol:

contract DeployContracts is Script {
    function run() public {
        (...)
        SuperTokenDeployer superTokenDeployer = SuperTokenDeployer(<deployerAddress>);
        superTokenDeployer.deployContracts(84532);     // Base Sepolia
        superTokenDeployer.deployContracts(11155420);  // OP Sepolia
        superTokenDeployer.deployContracts(421614);    // Arbitrum Sepolia
    }
}

Use DeployContracts.s.sol to deploy your token to desired chains:

forge script ./script/super-token/DeployContracts.s.sol --broadcast

Deployment typically takes a few minutes. Track deployment status and verify contract addresses using our APIs.