Account Abstraction

Send user operations and create smart accounts using this ERC-4337 bundler API.

Stackup's account abstraction add-on makes it easy to add smart accounts to your application. Connect with the ERC-4337 bundler network and instantly send user operations to improve your application's user experience.

Get started with ERC-4337 here: https://docs.stackup.sh/

RPC Methods

eth_sendUserOperation

Sends a UserOperation to the bundler. If accepted, the bundler will add it to the UserOperation mempool and return a userOpHash.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'eth_sendUserOperation',
  ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", "{   \"sender\": \"0xDE61343F4830Ddb2e978465Cf9D977A3aFDA14E2\",   \"nonce\": \"0x0\",   \"initCode\": \"0x9406cc6185a346906296840746125a0e449764545fbfb9cf000000000000000000000000a47ee947f81e6e8f38e0534ebb5191a33a4329250000000000000000000000000000000000000000000000000000000000000000\",   \"callData\": \"0xb61d27f6000000000000000000000000de61343f4830ddb2e978465cf9d977a3afda14e2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000\",   \"callGasLimit\": \"0x2f44\",   \"verificationGasLimit\": \"0x684eb\",   \"preVerificationGas\": \"0xc380\",   \"maxFeePerGas\": \"0xf4e16d3dc\",   \"maxPriorityFeePerGas\": \"0x1cb1c0e\",   \"paymasterAndData\": \"0x\",   \"signature\": \"0x1dbb968f1cee2b97387600fb4635ecbdc7335158a6f4e37bc3874877cff554b831c10cc29cdc34c0e19ea2d8a6e719acc0f56f7ebcb44ced71a4510d9dbb12821c\" }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"eth_sendUserOperation",
    "params": ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", "{   \"sender\": \"0xDE61343F4830Ddb2e978465Cf9D977A3aFDA14E2\",   \"nonce\": \"0x0\",   \"initCode\": \"0x9406cc6185a346906296840746125a0e449764545fbfb9cf000000000000000000000000a47ee947f81e6e8f38e0534ebb5191a33a4329250000000000000000000000000000000000000000000000000000000000000000\",   \"callData\": \"0xb61d27f6000000000000000000000000de61343f4830ddb2e978465cf9d977a3afda14e2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000\",   \"callGasLimit\": \"0x2f44\",   \"verificationGasLimit\": \"0x684eb\",   \"preVerificationGas\": \"0xc380\",   \"maxFeePerGas\": \"0xf4e16d3dc\",   \"maxPriorityFeePerGas\": \"0x1cb1c0e\",   \"paymasterAndData\": \"0x\",   \"signature\": \"0x1dbb968f1cee2b97387600fb4635ecbdc7335158a6f4e37bc3874877cff554b831c10cc29cdc34c0e19ea2d8a6e719acc0f56f7ebcb44ced71a4510d9dbb12821c\" }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "eth_sendUserOperation",
    ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", "{   \"sender\": \"0xDE61343F4830Ddb2e978465Cf9D977A3aFDA14E2\",   \"nonce\": \"0x0\",   \"initCode\": \"0x9406cc6185a346906296840746125a0e449764545fbfb9cf000000000000000000000000a47ee947f81e6e8f38e0534ebb5191a33a4329250000000000000000000000000000000000000000000000000000000000000000\",   \"callData\": \"0xb61d27f6000000000000000000000000de61343f4830ddb2e978465cf9d977a3afda14e2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000\",   \"callGasLimit\": \"0x2f44\",   \"verificationGasLimit\": \"0x684eb\",   \"preVerificationGas\": \"0xc380\",   \"maxFeePerGas\": \"0xf4e16d3dc\",   \"maxPriorityFeePerGas\": \"0x1cb1c0e\",   \"paymasterAndData\": \"0x\",   \"signature\": \"0x1dbb968f1cee2b97387600fb4635ecbdc7335158a6f4e37bc3874877cff554b831c10cc29cdc34c0e19ea2d8a6e719acc0f56f7ebcb44ced71a4510d9dbb12821c\" }"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_sendUserOperation","params": ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", "{   \"sender\": \"0xDE61343F4830Ddb2e978465Cf9D977A3aFDA14E2\",   \"nonce\": \"0x0\",   \"initCode\": \"0x9406cc6185a346906296840746125a0e449764545fbfb9cf000000000000000000000000a47ee947f81e6e8f38e0534ebb5191a33a4329250000000000000000000000000000000000000000000000000000000000000000\",   \"callData\": \"0xb61d27f6000000000000000000000000de61343f4830ddb2e978465cf9d977a3afda14e2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000\",   \"callGasLimit\": \"0x2f44\",   \"verificationGasLimit\": \"0x684eb\",   \"preVerificationGas\": \"0xc380\",   \"maxFeePerGas\": \"0xf4e16d3dc\",   \"maxPriorityFeePerGas\": \"0x1cb1c0e\",   \"paymasterAndData\": \"0x\",   \"signature\": \"0x1dbb968f1cee2b97387600fb4635ecbdc7335158a6f4e37bc3874877cff554b831c10cc29cdc34c0e19ea2d8a6e719acc0f56f7ebcb44ced71a4510d9dbb12821c\" }"],"id":1,"jsonrpc":"2.0"}'

eth_getUserOperationReceipt

Returns a transaction receipt associated with a given userOpHash.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'eth_getUserOperationReceipt',
  ["0xe66ff2ff969e2e9bea35a9311220eb902c60a9f6dcf36629258c5dd232e8a8ac"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"eth_getUserOperationReceipt",
    "params": ["0xe66ff2ff969e2e9bea35a9311220eb902c60a9f6dcf36629258c5dd232e8a8ac"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "eth_getUserOperationReceipt",
    ["0xe66ff2ff969e2e9bea35a9311220eb902c60a9f6dcf36629258c5dd232e8a8ac"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getUserOperationReceipt","params": ["0xe66ff2ff969e2e9bea35a9311220eb902c60a9f6dcf36629258c5dd232e8a8ac"],"id":1,"jsonrpc":"2.0"}'

eth_getUserOperationByHash

Returns the UserOperation associated with a given userOpHash.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'eth_getUserOperationByHash',
  ["0xe66ff2ff969e2e9bea35a9311220eb902c60a9f6dcf36629258c5dd232e8a8ac"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"eth_getUserOperationByHash",
    "params": ["0xe66ff2ff969e2e9bea35a9311220eb902c60a9f6dcf36629258c5dd232e8a8ac"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "eth_getUserOperationByHash",
    ["0xe66ff2ff969e2e9bea35a9311220eb902c60a9f6dcf36629258c5dd232e8a8ac"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getUserOperationByHash","params": ["0xe66ff2ff969e2e9bea35a9311220eb902c60a9f6dcf36629258c5dd232e8a8ac"],"id":1,"jsonrpc":"2.0"}'

eth_supportedEntryPoints

Returns all the EntryPoint addresses supported by the bundler. The first address in the array is the preferred EntryPoint.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'eth_supportedEntryPoints',
  []
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"eth_supportedEntryPoints",
    "params": []
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "eth_supportedEntryPoints",
    []
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_supportedEntryPoints","params": [],"id":1,"jsonrpc":"2.0"}'

eth_estimateUserOperationGas

This method returns estimates for PreVerificationGas, VerificationGas, and CallGasLimit given a UserOperation and EntryPoint address. The signature field and current gas values will not be validated although there should be dummy values in place for the most reliable results (e.g. a signature with the correct length and format).

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'eth_estimateUserOperationGas',
  ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", "{   \"sender\": \"0xDE61343F4830Ddb2e978465Cf9D977A3aFDA14E2\",   \"nonce\": \"0x0\",   \"initCode\": \"0x9406cc6185a346906296840746125a0e449764545fbfb9cf000000000000000000000000a47ee947f81e6e8f38e0534ebb5191a33a4329250000000000000000000000000000000000000000000000000000000000000000\",   \"callData\": \"0xb61d27f6000000000000000000000000de61343f4830ddb2e978465cf9d977a3afda14e2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000\",   \"callGasLimit\": \"0x2f44\",   \"verificationGasLimit\": \"0x684eb\",   \"preVerificationGas\": \"0xc380\",   \"maxFeePerGas\": \"0xf4e16d3dc\",   \"maxPriorityFeePerGas\": \"0x1cb1c0e\",   \"paymasterAndData\": \"0x\",   \"signature\": \"0x1dbb968f1cee2b97387600fb4635ecbdc7335158a6f4e37bc3874877cff554b831c10cc29cdc34c0e19ea2d8a6e719acc0f56f7ebcb44ced71a4510d9dbb12821c\" }"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"eth_estimateUserOperationGas",
    "params": ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", "{   \"sender\": \"0xDE61343F4830Ddb2e978465Cf9D977A3aFDA14E2\",   \"nonce\": \"0x0\",   \"initCode\": \"0x9406cc6185a346906296840746125a0e449764545fbfb9cf000000000000000000000000a47ee947f81e6e8f38e0534ebb5191a33a4329250000000000000000000000000000000000000000000000000000000000000000\",   \"callData\": \"0xb61d27f6000000000000000000000000de61343f4830ddb2e978465cf9d977a3afda14e2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000\",   \"callGasLimit\": \"0x2f44\",   \"verificationGasLimit\": \"0x684eb\",   \"preVerificationGas\": \"0xc380\",   \"maxFeePerGas\": \"0xf4e16d3dc\",   \"maxPriorityFeePerGas\": \"0x1cb1c0e\",   \"paymasterAndData\": \"0x\",   \"signature\": \"0x1dbb968f1cee2b97387600fb4635ecbdc7335158a6f4e37bc3874877cff554b831c10cc29cdc34c0e19ea2d8a6e719acc0f56f7ebcb44ced71a4510d9dbb12821c\" }"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "eth_estimateUserOperationGas",
    ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", "{   \"sender\": \"0xDE61343F4830Ddb2e978465Cf9D977A3aFDA14E2\",   \"nonce\": \"0x0\",   \"initCode\": \"0x9406cc6185a346906296840746125a0e449764545fbfb9cf000000000000000000000000a47ee947f81e6e8f38e0534ebb5191a33a4329250000000000000000000000000000000000000000000000000000000000000000\",   \"callData\": \"0xb61d27f6000000000000000000000000de61343f4830ddb2e978465cf9d977a3afda14e2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000\",   \"callGasLimit\": \"0x2f44\",   \"verificationGasLimit\": \"0x684eb\",   \"preVerificationGas\": \"0xc380\",   \"maxFeePerGas\": \"0xf4e16d3dc\",   \"maxPriorityFeePerGas\": \"0x1cb1c0e\",   \"paymasterAndData\": \"0x\",   \"signature\": \"0x1dbb968f1cee2b97387600fb4635ecbdc7335158a6f4e37bc3874877cff554b831c10cc29cdc34c0e19ea2d8a6e719acc0f56f7ebcb44ced71a4510d9dbb12821c\" }"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_estimateUserOperationGas","params": ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", "{   \"sender\": \"0xDE61343F4830Ddb2e978465Cf9D977A3aFDA14E2\",   \"nonce\": \"0x0\",   \"initCode\": \"0x9406cc6185a346906296840746125a0e449764545fbfb9cf000000000000000000000000a47ee947f81e6e8f38e0534ebb5191a33a4329250000000000000000000000000000000000000000000000000000000000000000\",   \"callData\": \"0xb61d27f6000000000000000000000000de61343f4830ddb2e978465cf9d977a3afda14e2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000\",   \"callGasLimit\": \"0x2f44\",   \"verificationGasLimit\": \"0x684eb\",   \"preVerificationGas\": \"0xc380\",   \"maxFeePerGas\": \"0xf4e16d3dc\",   \"maxPriorityFeePerGas\": \"0x1cb1c0e\",   \"paymasterAndData\": \"0x\",   \"signature\": \"0x1dbb968f1cee2b97387600fb4635ecbdc7335158a6f4e37bc3874877cff554b831c10cc29cdc34c0e19ea2d8a6e719acc0f56f7ebcb44ced71a4510d9dbb12821c\" }"],"id":1,"jsonrpc":"2.0"}'

pm_sponsorUserOperation

Sends a UserOperation to the paymaster. If approved for sponsorship, it returns the paymasterAndData along with updated gas values.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'pm_sponsorUserOperation',
  [{"sender":"0x0000000000000000000000000000000000000000", "nonce":"0x0", "initCode":"0x", "callData":"0x", "callGasLimit":"0x0", "verificationGasLimit":"0x0", "preVerificationGas":"0x0", "maxFeePerGas":"0x0", "maxPriorityFeePerGas":"0x0", "paymasterAndData":"0x", "signature":"0x"}, "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", {"type":"payg"}]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"pm_sponsorUserOperation",
    "params": [{"sender":"0x0000000000000000000000000000000000000000", "nonce":"0x0", "initCode":"0x", "callData":"0x", "callGasLimit":"0x0", "verificationGasLimit":"0x0", "preVerificationGas":"0x0", "maxFeePerGas":"0x0", "maxPriorityFeePerGas":"0x0", "paymasterAndData":"0x", "signature":"0x"}, "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", {"type":"payg"}]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "pm_sponsorUserOperation",
    [{"sender":"0x0000000000000000000000000000000000000000", "nonce":"0x0", "initCode":"0x", "callData":"0x", "callGasLimit":"0x0", "verificationGasLimit":"0x0", "preVerificationGas":"0x0", "maxFeePerGas":"0x0", "maxPriorityFeePerGas":"0x0", "paymasterAndData":"0x", "signature":"0x"}, "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", {"type":"payg"}]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"pm_sponsorUserOperation","params": [{"sender":"0x0000000000000000000000000000000000000000", "nonce":"0x0", "initCode":"0x", "callData":"0x", "callGasLimit":"0x0", "verificationGasLimit":"0x0", "preVerificationGas":"0x0", "maxFeePerGas":"0x0", "maxPriorityFeePerGas":"0x0", "paymasterAndData":"0x", "signature":"0x"}, "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789", {"type":"payg"}],"id":1,"jsonrpc":"2.0"}'

pm_accounts

Returns a list of contract accounts owned by the Paymaster that is associated with a given EntryPoint.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'pm_accounts',
  ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"pm_accounts",
    "params": ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "pm_accounts",
    ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"pm_accounts","params": ["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"],"id":1,"jsonrpc":"2.0"}'

This add-on is currently in Beta

Supported Chains

RPC Methods

Supported Chains

Plans & features

Account Abstraction

This add-on is currently in Beta

Supported Chains

RPC Methods

Supported Chains

Plans & features

Contact our sales team

Contact our sales team