Get Fee Quotes
pm_getFeeQuoteOrData
All paymaster URLs allow you to use both Sponsorship and Token Paymasters. To switch between paymasters you will simply change the Mode of a specific request. We will highlight both types of requests below.
This endpoint returns the MODE
and paymasterAndData
for sponsored requests and returns specific fee quote information for token paymaster requests.
Parameters
Body
Param | Type | Description | Required |
---|---|---|---|
method | string | Name of method in this case: pm_getFeeQuoteOrData | Required |
params | array | An array consisting of the Useroperation object and Paymaster mode information | Required |
id | string | id for request determined by client for JSON RPC requests | Required |
jsonrpc | string | JSON RPC version in this case 2.0.0 | Required |
Params Array for Sponsorship requests
Index | Type | Description | Required |
---|---|---|---|
0 | object | A partial userOperation object for the userOp that needs to be sponsored | Required |
1 | object | Mode specified as "SPONSORSHIP" as well as sposorship information which includes any webhook data and smart account information: name and version | Required |
Params Array for ERC20 paymaster requests
Index | Type | Description | Required |
---|---|---|---|
0 | object | A partial userOperation object for the userOp that needs to be sponsored | Required |
1 | object | Mode specified as "ERC20" as well as tokenInfo: a preferred token address and list of tokens to include | Required |
Partial UserOperation Object is basically a userOp object which has paymasterAndData
and signature
fields as optional, and the gas price values are not final.
1. Mode is SPONSORED:
POST Request
{
"jsonrpc": "2.0",
"method": "pm_getFeeQuoteOrData",
"id": 1,
"params": [
{
"sender": "sender SA address",
"nonce": "0x2f",
"initCode": "0x",
"callData": "0x0...",
"signature": "0x0...",
"maxFeePerGas": "0xc02244",
"maxPriorityFeePerGas": "0xf4240",
"verificationGasLimit": "77101",
"callGasLimit": "2290252",
"preVerificationGas": "480527",
"paymasterAndData": "0x"
},
{
"mode": "SPONSORED",
"calculateGasLimits": true,
"sponsorshipInfo": {
"webhookData": {},
"smartAccountInfo": {
"name": "BICONOMY",
"version": "2.0.0"
}
}
}
]
}
Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"MODE": "SPONSORED",
"paymasterAndData": "0x......",
"preVerificationGas": "75388",
"verificationGasLimit": 57121,
"callGasLimit": 108848
}
}
If Mode is set as SPONSORED
, this request will behave as a sponsored request and paymasterAndData
field will be populated by the paymaster service.
2. Mode is ERC20:
POST Request
{
"jsonrpc": "2.0",
"method": "pm_getFeeQuoteOrData",
"id": 1,
"params": [
{
"sender": "sender SA address",
"nonce": "0x2f",
"initCode": "0x",
"callData": "0x0...",
"signature": "0x0...",
"maxFeePerGas": "0xc02244",
"maxPriorityFeePerGas": "0xf4240",
"verificationGasLimit": "77101",
"callGasLimit": "2290252",
"preVerificationGas": "480527",
"paymasterAndData": "0x"
},
{
"mode": "ERC20",
"tokenInfo": {
"preferredToken": "0xbf22b04e250a5921ab4dc0d4ced6e391459e92d4",
"tokenList": [
"0xdA5289FCAAF71d52A80A254dA614A192B693e975",
"0xda5289fcaaf71d52a80a254da614a192b693e977",
"0xeabc4b91d9375796aa4f69cc764a4ab509080a58"
]
}
}
]
}
Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"MODE": "ERC20",
"paymasterAddress": "0x716bc27e1b904331c58891cc3ab13889127189a7",
"feeQuotes": [
{
"symbol": "USDT",
"decimal": 18,
"tokenAddress": "0xbf22b04e250a5921ab4dc0d4ced6e391459e92d4",
"maxGasFee": 0.25267043311569887,
"maxGasFeeUSD": 0.0010842277144671015,
"exchangeRate": 232808808808808800000,
"premiumPercentage": "13",
"validUntil": 1686847490,
"logoUrl": "https://raw.githubusercontent.com/spothq/cryptocurrency-icons/master/128/color/usdt.png"
}
],
"unsupportedTokens": [
"0xbf22b04e250a5921ab4dc0d4ced6e391459e92d3",
"0xda5289fcaaf71d52a80a254da614a192b693e977",
"0xeabc4b91d9375796aa4f69cc764a4ab509080a58"
]
}
}
If both preferredToken
& tokenList
are present in the request body, and some of these tokens are not supported by our paymaster, those will also be returned in the response body under unsupportedTokens
.