pm_sponsorUserOperation

This method sponsors a user operation by providing all necessary paymaster-related fields and updated gas parameters. The context parameter can be an object with either a token field (for ERC-20 mode) or a sponsorshipPolicyId field (for sponsorship mode), or null.

EntryPoint v0.7

Usage

{
    "jsonrpc": "2.0",
    "method": "pm_sponsorUserOperation",
    "params": [
        {
            "sender": "0x5a6b47F4131bf1feAFA56A05573314BcF44C9149",
            "nonce": "0x845ADB2C711129D4F3966735ED98A9F09FC4CE5700000000000000000000",
            "factory": "0xd703aaE79538628d27099B8c4f621bE4CCd142d5",
            "factoryData": "0xc5265d5d000000000000000000000000aac5d4240af87249b3f71bc8e4a2cae074a3e4190000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001243c3b752b01845ADb2C711129d4f3966735eD98a9F09fC4cE570000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000014375d883Cb4afb913aC35c4B394468C4bC73d77C40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
            "callData": "0xe9ae5c53",
            "callGasLimit": "0x13880",
            "verificationGasLimit": "0x60B01",
            "preVerificationGas": "0xD3E3",
            "maxPriorityFeePerGas": "0x3B9ACA00",
            "maxFeePerGas": "0x7A5CF70D5",
            "paymaster": null,
            "paymasterVerificationGasLimit": null,
            "paymasterPostOpGasLimit": null,
            "paymasterData": null,
            "eip7702Auth": {
                "address": "0x1234567890123456789012345678901234567890",
                "chainId": "0x1",
                "nonce": "0x1",
                "r": "0x1234567890123456789012345678901234567890123456789012345678901234",
                "s": "0x1234567890123456789012345678901234567890123456789012345678901234",
                "v": "0x1b",
                "yParity": "0x1"
            }
        },
        "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
        "0x1",
        {
            "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
            // Or alternatively: "sponsorshipPolicyId": "policy-123456"
        }
    ],
    "id": 1
}

Parameters

The method accepts an array with the following parameters:

userOperation - Object: The user operation object containing the following fields:
- sender - Address: The account making the operation.
- nonce - HexString: Unique identifier for the request from this sender.
- factory - Address: The factory contract address used to create the account if it doesn't exist yet.
- factoryData - HexData: The initialization data for the factory contract.
- callData - HexData: The data to pass to the sender during the main execution call.
- callGasLimit - HexNumber: The amount of gas to allocate the main execution call.
- verificationGasLimit - HexNumber: The amount of gas to allocate for the verification step.
- preVerificationGas - HexNumber: The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.
- maxFeePerGas - HexNumber: Maximum fee per gas (similar to EIP-1559 max_fee_per_gas).
- maxPriorityFeePerGas - HexNumber: Maximum priority fee per gas (similar to EIP-1559 max_priority_fee_per_gas).
- paymaster - Address | null: The paymaster contract address, or null if not using a paymaster.
- paymasterVerificationGasLimit - HexNumber | null: The amount of gas to allocate for the verification step of the paymaster.
- paymasterPostOpGasLimit - HexNumber | null: The amount of gas to allocate for the post-operation step of the paymaster.
- paymasterData - HexData | null: The data to pass to the paymaster during verification.
- eip7702Auth - Object (optional): EIP-7702 authorization data, can be null. This can be a dummy authorization. Contains the following fields:
  - address - Address: The contract address that signed the authorization.
  - chainId - HexNumber: The chain ID as a hex string.
  - nonce - HexNumber: The nonce as a hex string.
  - r - HexData32: The r component of the signature.
  - s - HexData32: The s component of the signature.
  - v - HexNumber: The v component of the signature.
  - yParity - HexNumber: The y-parity of the signature.
entryPoint - Address: The entry point contract address.
chainId - HexNumber: The chain ID in hexadecimal format.
context - Object | null: Additional context information. Can be one of:
- An object with token - Address: The ERC-20 token address to use for payment.
- An object with sponsorshipPolicyId - String: The ID of the sponsorship policy to use.
- null: No additional context.

Returns

The method returns an object containing paymaster-related fields and updated gas parameters for EntryPoint v0.7.

{
    "jsonrpc": "2.0",
    "result": {
        "paymaster": "0x0000000000000039cd5e8aE05257CE51C473ddd1",
        "paymasterData": "0x01000066d1a1a4000000000000036cbd53842c5426634e7929541ec2318f3dcf7e0000000000000000000000000000c350000000000000000000000000000000000000000000000000000000009666598f0b846603deb0a8e59b78ba3dce9c3466394ccf07795d38ecf7925dfe12c07a022c27bb199099fa54de2f5e3e87dd9c581df52e9d3d199166a31124cc1227a9921b",
        "preVerificationGas": "0x350f7",
        "verificationGasLimit": "0x501ab",
        "callGasLimit": "0x212df",
        "paymasterVerificationGasLimit": "0x6dae",
        "paymasterPostOpGasLimit": "0x706e"
    },
    "id": 1
}

Return Fields

The response includes the following fields:

paymaster - Address: The address of the paymaster contract.
paymasterData - HexData: The data to be used in the paymasterData field of the user operation.
preVerificationGas - HexNumber: The updated preVerificationGas value to use in the user operation.
verificationGasLimit - HexNumber: The updated verificationGasLimit value to use in the user operation.
callGasLimit - HexNumber: The updated callGasLimit value to use in the user operation.
paymasterVerificationGasLimit - HexNumber: The amount of gas to allocate for the verification step of the paymaster.
paymasterPostOpGasLimit - HexNumber: The amount of gas to allocate for the post-operation step of the paymaster.

EntryPoint v0.6