Skip to main content
The Chainrails Paymaster enables you to sponsor protocol fees (bridging and swap fees) on behalf of your users, creating a seamless and frictionless payment experience for your application.

​
What is a Paymaster?

Each cross-chain transaction on Chainrails incurs protocol fees to cover costs associated with bridges, AMMs and relayers. These fees are charged in the token being transferred, eliminating the need for users to hold multiple tokens for gas or fees.

​
Getting Started

Here’s how to enable and use the Paymaster in your application:

​
Step 1: Access the Dashboard

Navigate to the Chainrails Dashboard and go to the Billing section.

​
Step 2: Choose Your Billing Plan

Chainrails offers three billing options to suit different use cases:
Best for: Use cases that’s fine with users paying their own fees
  • Users pay their own protocol fees
  • No additional costs to you
  • Easy to get started

​
Step 3: Enable the Paymaster

Once you select either PAYG or Monthly Subscription, the Paymaster is automatically enabled for your account. All transactions using your API key will have protocol fees covered.

​
Using the Paymaster in Your Application

Once enabled, the Paymaster works automatically—no code changes required. Simply make transactions as usual: PS: Ignore the fees field returned in intents as that is returned to track usage, but you would notice the totalAmount field is same as the initialAmount field, which means the user is not charged any additional fees.

​
Managing Your Paymaster

​
For PAYG Plans

Funding Your Balance:
  1. Go to the Dashboard → Billing section
  2. Click “Add Funds” to deposit funds to your paymaster balance
  3. Choose your funding amount
Monitoring Usage:
  • View real-time balance in the Dashboard
  • Track transaction history and fee breakdowns
  • Set up low-balance alerts
We recommend maintaining a balance that covers at least 7 days of expected transaction volume.

​
For Monthly Subscription Plans

Transaction Quotas:
  • Your plan includes a set number of transactions per month
  • View your current usage and remaining quota in the Dashboard
  • Overages are automatically charged at the end of your billing cycle
No Manual Management:
  • Transactions never fail due to insufficient balance
  • Automatic renewal each month
  • Upgrade or downgrade anytime

​
FAQ

Transactions will fail if your paymaster balance is insufficient. Users will see an error and the transaction won’t be processed. To avoid this, regularly monitor your balance and top up as needed.
Yes, you can switch back to the Free plan at any time. This will require users to pay their own protocol fees for subsequent transactions.
Protocol fees vary based on the source and destination chains, token being transferred, and current network conditions. View detailed fee breakdowns for each transaction in your Dashboard.