Sign in
EVM Accounts

Create EIP-7702 delegation

Creates an EIP-7702 delegation for an EVM EOA account, upgrading it with smart account capabilities.

This endpoint:

  • Retrieves delegation artifacts from onchain
  • Signs the EIP-7702 authorization for delegation
  • Assembles and submits a Type 4 transaction
  • Creates an associated smart account object

The delegation allows the EVM EOA to be used as a smart account, which enables batched transactions and gas sponsorship via paymaster.

post/v2/evm/accounts/{address}/eip7702/delegation

Request

  • Base URL: https://api.cdp.coinbase.com/platform
  • URL: https://api.cdp.coinbase.com/platform/v2/evm/accounts/{address}/eip7702/delegation
  • Auth: HTTP bearer

Path parameters

addressstring required
Example:0x742d35Cc6634C0532925a3b844Bc454e4438f44e

The 0x-prefixed address of the EVM account to delegate.

Headers

X-Wallet-Authstring required

A JWT signed using your Wallet Secret, encoded in base64. Refer to the Generate Wallet Token section of our Authentication docs for more details on how to generate your Wallet Token.

X-Idempotency-Keystring

An optional string request header for making requests safely retryable. When included, duplicate requests with the same key will return identical responses. Refer to our Idempotency docs for more information on using idempotency keys.

Request body

network'base-sepolia' | 'base' | 'arbitrum' | 'optimism' | 'polygon' | 'ethereum' | 'ethereum-sepolia' required

The network for the EIP-7702 delegation.

enableSpendPermissionsboolean

Whether to configure spend permissions for the upgraded, delegated account. When enabled, the account can grant permissions for third parties to spend on its behalf.

Example request

{
  "network": "base",
  "enableSpendPermissions": true
}

Response

Delegation operation created successfully.

delegationOperationIdstring uuid required

The unique identifier for the delegation operation. Use this to poll the operation status.

Example response

{
  "delegationOperationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Changes