createUserOp

Learn how to use the createUserOp JSON-RPC method.

POST /#particle_aa_createUserOp

createUserOp

cURL

curl --request POST \
  --url 'https://rpc.particle.network/evm-chain/#particle_aa_createUserOp' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "particle_aa_createUserOp",
  "params": [
    "<string>"
  ]
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "userOp": {},
    "userOpHash": "0xUserOpHash"
  },
  "chainId": 80001
}

Understanding createUserOp

• createUserOp will construct and return a UserOperation object and hash using a transaction or collection of transactions, alongside smart account and fee payment information. It takes:
  • Account config object:
    • name - string, either BICONOMY, CYBERCONNECT, or SIMPLE.
    • version - string, either 1.0.0 or 2.0.0.
    • ownerAddress - string.
    • biconomyApiKey - (optional, for using Biconomy’s Paymaster), string.
  • Array of transactions:
    • Standard transaction object.
  • Optionally, a token feeQuote object, retrieved from getFeeQuotes, only used if you’re paying the gas fee in an ERC-20 token.
  • Token paymaster address - (optional), string.

---

Query example

JSON

{
  "jsonrpc": "2.0",
  "id": "4259f7fe-87aa-44fd-89c8-fc1e41f6d3d8",
  "chainId": 80001,
  "method": "particle_aa_createUserOp",
  "params": [
    // account config
    {
      "name": "BICONOMY",
      "version": "1.0.0",
      "ownerAddress": "0xA60123a1056e9D38B64c4993615F27cCe9A9E8D5",
      "biconomyApiKey": "LdF-gC43H.6f0ec763-fde5-4d5e-89f6-1b9ef12ba4a4" // optional
    },
    // txs
    [
      {
        "to": "0x329a7f8b91Ce7479035cb1B5D62AB41845830Ce8",
        "value": "0x1",
        "data": "0x"
      }
    ],
    // optional: If you don't pass the following params, it'll create a gasless/user paid user op
    // token feeQuote
    {
      "tokenInfo": {
        "chainId": 80001,
        "name": "WMATIC",
        "symbol": "WMATIC",
        "decimals": 18,
        "address": "0x9c3C9283D3e44854697Cd22D3Faa240Cfb032889",
        "logoURI": "https://polygonscan.com/token/images/wMatic_32.png"
      },
      "fee": "374428266633331",
      "balance": "1019119852023946296",
      "premiumPercentage": "10"
    },
    // token paymaster address
    "0x00000f7365cA6C59A2C93719ad53d567ed49c14C"
  ]
}

Authorizations

Authorization · string · header · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Request to create a user operation.

jsonrpc · string · default: 2.0 · required

Version of the JSON-RPC protocol, should be 2.0.

Example:

"2.0"

id · integer · default: 1 · required

The request identifier.

Example:

1

method · enum<string> · required

API method being called.

Available options: particle_aa_createUserOp

params · string · object · object · string[] · required

Parameters for creating a user operation.

Response

200 - application/json

Successful response with created user operation details.

jsonrpc · string · default: 2.0 · required

Version of the JSON-RPC protocol, should be 2.0.

Example:

"2.0"

id · integer · default: 1 · required

The request identifier.

Example:

1

result · object · required

Show child attributes

chainId · integer

The blockchain chain ID.

Example:

80001