eth_signUserOperation

Sign a user operation using the eth_signUserOperation method.

POST /v1/wallets/{wallet_id}/rpc

cURL

curl --request POST \
  --url https://api.privy.io/v1/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "method": "eth_signUserOperation",
  "params": {
    "contract": "0x69007702764179f14F51cdce752f4f775d74E139",
    "user_operation": {
      "sender": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "nonce": "0x0",
      "call_data": "0x",
      "call_gas_limit": "0x30d40",
      "verification_gas_limit": "0x30d40",
      "pre_verification_gas": "0x5208",
      "max_fee_per_gas": "0xf4240",
      "max_priority_fee_per_gas": "0xf4240",
      "paymaster": "0x0000000000000000000000000000000000000000",
      "paymaster_data": "0x",
      "paymaster_verification_gas_limit": "0x0",
      "paymaster_post_op_gas_limit": "0x0"
    },
    "chain_id": "11155111"
  }
}'

200

{
  "method": "eth_signUserOperation",
  "data": {
    "signature": "0x1754782aea15e96189c3a85a7b7ac2f6339f6f4f3b29b1d3200a4c9907ef53e4776a84387583896b0a074cbc6de1a1c2a1eb53aba199da6ada8c99b0266171c41b",
    "encoding": "hex"
  }
}

This method is currently only supported for these smart contract addresses: 0x69007702764179f14F51cdce752f4f775d74E139, 0x00000000000002377B26b1EdA7b0BC371C60DD4f, 0xd6CEDDe84be40893d153Be9d467CD6aD37875b28, and 0x63c0c19a282a1B52b07dD5a65b58948A07DAE32B.

---

Idempotency on errors: On 4xx or 5xx, Privy caches the response and replays it for the same key. Generate a new key to retry after a server error. Policy violations are an exception and allow same-key retries.

cURL

curl --request POST \
  --url https://api.privy.io/v1/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "method": "eth_signUserOperation",
  "params": {
    "contract": "0x69007702764179f14F51cdce752f4f775d74E139",
    "user_operation": {
      "sender": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "nonce": "0x0",
      "call_data": "0x",
      "call_gas_limit": "0x30d40",
      "verification_gas_limit": "0x30d40",
      "pre_verification_gas": "0x5208",
      "max_fee_per_gas": "0xf4240",
      "max_priority_fee_per_gas": "0xf4240",
      "paymaster": "0x0000000000000000000000000000000000000000",
      "paymaster_data": "0x",
      "paymaster_verification_gas_limit": "0x0",
      "paymaster_post_op_gas_limit": "0x0"
    },
    "chain_id": "11155111"
  }
}'

200

{
  "method": "eth_signUserOperation",
  "data": {
    "signature": "0x1754782aea15e96189c3a85a7b7ac2f6339f6f4f3b29b1d3200a4c9907ef53e4776a84387583896b0a074cbc6de1a1c2a1eb53aba199da6ada8c99b0266171c41b",
    "encoding": "hex"
  }
}

Headers

privy-app-id · string · required

ID of your Privy app.

privy-authorization-signature · string

Request authorization signature. If multiple signatures are required, they should be comma separated.

privy-request-expiry · string

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

Path Parameters

wallet_id · string · required

ID of the wallet to get.

Body

method · string · required

Available options: eth_signUserOperation

params · object · required

Hide child attributes

contract · string · required

The smart contract address for the user operation. Currently supports 0x69007702764179f14F51cdce752f4f775d74E139, 0x00000000000002377B26b1EdA7b0BC371C60DD4f, 0xd6CEDDe84be40893d153Be9d467CD6aD37875b28, and 0x63c0c19a282a1B52b07dD5a65b58948A07DAE32B.

user_operation · object · required

Hide child attributes

sender · string · required

The account making the operation.

nonce · string · required

Anti-replay parameter; also used as the salt for first-time account creation.

factory · string

The account factory address, if deploying a new account.

factory_data · string

Additional data for the account factory.

call_data · string · required

The data to pass to the sender during the main execution call.

call_gas_limit · string · required

The amount of gas to allocate the main execution call.

verification_gas_limit · string · required

The amount of gas to allocate for the verification step.

pre_verification_gas · string · required

Extra gas to pay the bundler.

max_fee_per_gas · string · required

Maximum fee per gas (similar to EIP-1559 max_fee_per_gas).

max_priority_fee_per_gas · string · required

Maximum priority fee per gas (similar to EIP-1559 max_priority_fee_per_gas).

paymaster · string

Address of paymaster sponsoring the transaction, zero for self-sponsored.

paymaster_data · string

Extra data to send to the paymaster.

paymaster_verification_gas_limit · string

The amount of gas to allocate for the paymaster validation code.

paymaster_post_op_gas_limit · string

The amount of gas to allocate for the paymaster post-operation code.

chain_id · string · required

The chain ID for the user operation.

Response

method · enum<string> · required

Available options: eth_signUserOperation

data · object · required

Hide child properties

signature · string · required

The hex-encoded signature of the user operation.

encoding · enum<string>

Available options: hex