Send a user operation

curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/user-operations/{userOpHash}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "signature": "0x1b0c9cf8cd4554c6c6d9e7311e88f1be075d7f25b418a044f4bf2c0a42a93e212ad0a8b54de9e0b5f7e3812de3f2c6cc79aa8c3e1c02e7ad14b4a8f42012c2c01b"
}'

{
  "network": "base",
  "userOpHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "calls": [
    {
      "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "value": "0",
      "data": "0xa9059cbb000000000000000000000000fc807d1be4997e5c7b33e4d8d57e60c5b0f02b1a0000000000000000000000000000000000000000000000000000000000000064"
    },
    {
      "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "value": "1000000000000000",
      "data": "0x"
    }
  ],
  "status": "pending",
  "transactionHash": "0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
  "receipts": [
    {
      "revert": {
        "data": "0x123",
        "message": "reason for failure"
      },
      "blockHash": "0x386544b58930c0ec9e8f3ed09fb4cdb76b9ae0a1a37ddcacebe3925b57978e65",
      "blockNumber": 29338819,
      "gasUsed": "100000"
    }
  ]
}

EVM Smart Accounts

Send a user operation

Sends a user operation with a signature. The payload to sign must be the userOpHash field of the user operation. This hash should be signed directly (not using personal_sign or EIP-191 message hashing). The signature must be 65 bytes in length, consisting of: - 32 bytes for the r value - 32 bytes for the s value - 1 byte for the v value (must be 27 or 28) If using the CDP Paymaster, the user operation must be signed and sent within 2 minutes of being prepared.

POST

evm

smart-accounts

{address}

user-operations

{userOpHash}

send

Send a user operation

curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/evm/smart-accounts/{address}/user-operations/{userOpHash}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "signature": "0x1b0c9cf8cd4554c6c6d9e7311e88f1be075d7f25b418a044f4bf2c0a42a93e212ad0a8b54de9e0b5f7e3812de3f2c6cc79aa8c3e1c02e7ad14b4a8f42012c2c01b"
}'

{
  "network": "base",
  "userOpHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "calls": [
    {
      "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "value": "0",
      "data": "0xa9059cbb000000000000000000000000fc807d1be4997e5c7b33e4d8d57e60c5b0f02b1a0000000000000000000000000000000000000000000000000000000000000064"
    },
    {
      "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "value": "1000000000000000",
      "data": "0x"
    }
  ],
  "status": "pending",
  "transactionHash": "0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
  "receipts": [
    {
      "revert": {
        "data": "0x123",
        "message": "reason for failure"
      },
      "blockHash": "0x386544b58930c0ec9e8f3ed09fb4cdb76b9ae0a1a37ddcacebe3925b57978e65",
      "blockNumber": 29338819,
      "gasUsed": "100000"
    }
  ]
}

Authorizations

Authorization

string

header

required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.

Path Parameters

address

string

required

The address of the Smart Account to send the user operation from.

userOpHash

string

required

The hash of the user operation to send.

Body

application/json

signature

string

required

The hex-encoded signature of the user operation. This should be a 65-byte signature consisting of the r, s, and v values of the ECDSA signature. Note that the v value should conform to the personal_sign standard, which means it should be 27 or 28.

Example:

"0x1b0c9cf8cd4554c6c6d9e7311e88f1be075d7f25b418a044f4bf2c0a42a93e212ad0a8b54de9e0b5f7e3812de3f2c6cc79aa8c3e1c02e7ad14b4a8f42012c2c01b"

Response

The sent user operation.

network

enum<string>

required

The network the user operation is for.

Available options:

base-sepolia,

base,

arbitrum,

optimism,

zora,

polygon,

bnb,

avalanche,

ethereum,

ethereum-sepolia

Example:

"base"

userOpHash

string

required

The hash of the user operation. This is not the transaction hash, as a transaction consists of multiple user operations. The user operation hash is the hash of this particular user operation which gets signed by the owner of the Smart Account.

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

calls

object[]

required

The list of calls in the user operation.

Show child attributes

string

required

The address the call is directed to.

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

value

string

required

The amount of ETH to send with the call, in wei.

Example:

"0"

data

string

required

The call data to send. This is the hex-encoded data of the function call consisting of the method selector and the function arguments.

Example:

"0xa9059cbb000000000000000000000000fc807d1be4997e5c7b33e4d8d57e60c5b0f02b1a0000000000000000000000000000000000000000000000000000000000000064"

overrideGasLimit

string

The override gas limit to use for the call instead of the bundler's estimated gas limit.

Example:

"100000"

Example:

[
  {
    "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "value": "0",
    "data": "0xa9059cbb000000000000000000000000fc807d1be4997e5c7b33e4d8d57e60c5b0f02b1a0000000000000000000000000000000000000000000000000000000000000064"
  },
  {
    "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "value": "1000000000000000",
    "data": "0x"
  }
]

status

enum<string>

required

The status of the user operation.

Available options:

pending,

signed,

broadcast,

complete,

dropped,

failed

Example:

"pending"

transactionHash

string

The hash of the transaction that included this particular user operation. This gets set after the user operation is broadcasted and the transaction is included in a block.

Example:

"0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"

receipts

object[]

The list of receipts associated with the user operation.

The receipt that contains information about the execution of user operation.

Show child attributes

revert

object

The revert data if the user operation has reverted.

Show child attributes

revert.data

string

required

The 0x-prefixed raw hex string.

Example:

"0x123"

revert.message

string

required

Human-readable revert reason if able to decode.

Example:

"reason for failure"

Example:

{
  "data": "0x123",
  "message": "reason for failure"
}

transactionHash

string

The hash of this transaction as 0x-prefixed string.

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

blockHash

string

The block hash of the block including the transaction as 0x-prefixed string.

Example:

"0x386544b58930c0ec9e8f3ed09fb4cdb76b9ae0a1a37ddcacebe3925b57978e65"

blockNumber

integer

The block height (number) of the block including the transaction.

Example:

29338819

gasUsed

string

The gas used for landing this user operation.

Example:

"100000"

Example:

{
  "revert": {
    "data": "0x123",
    "message": "reason for failure"
  },
  "blockHash": "0x386544b58930c0ec9e8f3ed09fb4cdb76b9ae0a1a37ddcacebe3925b57978e65",
  "blockNumber": 29338819,
  "gasUsed": "100000"
}

Example:

[
  {
    "revert": {
      "data": "0x123",
      "message": "reason for failure"
    },
    "blockHash": "0x386544b58930c0ec9e8f3ed09fb4cdb76b9ae0a1a37ddcacebe3925b57978e65",
    "blockNumber": 29338819,
    "gasUsed": "100000"
  }
]

Revoke a spend permission

Update an EVM Smart Account

⌘I

CDP API V2

REST API

Send a user operation

Authorizations

Path Parameters

Body

Response