eth_signTypedData_v4

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_signTypedData_v4",
  "params": [
    "0x3b7252d007059ffc82d16d022da3cbf9992d2f70",
    {
      "types": {
        "EIP712Domain": [
          { "name": "name", "type": "string" },
          { "name": "version", "type": "string" },
          { "name": "chainId", "type": "uint256" },
          { "name": "verifyingContract", "type": "address" }
        ],
        "Person": [
          { "name": "name", "type": "string" },
          { "name": "wallet", "type": "address" }
        ]
      },
      "primaryType": "Person",
      "domain": {
        "name": "Example App",
        "version": "1",
        "chainId": 1,
        "verifyingContract": "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC"
      },
      "message": {
        "name": "Alice",
        "wallet": "0x3b7252d007059ffc82d16d022da3cbf9992d2f70"
      }
    }
  ]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x4355c47d63924e8a72e509b65029052eb6c299d53a04e167c5775fd466751c9d07299936d304c153f6443dfa05f40ff007d72911b6f72307f996231605b915621c"
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_signTypedData_v4",
  "params": [
    "0x3b7252d007059ffc82d16d022da3cbf9992d2f70",
    {
      "types": {
        "EIP712Domain": [
          { "name": "name", "type": "string" },
          { "name": "version", "type": "string" },
          { "name": "chainId", "type": "uint256" },
          { "name": "verifyingContract", "type": "address" }
        ],
        "Person": [
          { "name": "name", "type": "string" },
          { "name": "wallet", "type": "address" }
        ]
      },
      "primaryType": "Person",
      "domain": {
        "name": "Example App",
        "version": "1",
        "chainId": 1,
        "verifyingContract": "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC"
      },
      "message": {
        "name": "Alice",
        "wallet": "0x3b7252d007059ffc82d16d022da3cbf9992d2f70"
      }
    }
  ]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x4355c47d63924e8a72e509b65029052eb6c299d53a04e167c5775fd466751c9d07299936d304c153f6443dfa05f40ff007d72911b6f72307f996231605b915621c"
}

Defined in EIP-712

Signs structured data according to EIP-712, which provides a more secure way to sign data by providing context and structure to the data being signed.

Parameters

string

required

The address that should sign the data (20 bytes).

object

required

The typed structured data to be signed.

Show Typed Data Object Properties

object

required

An object containing type definitions for the structured data.

string

required

The primary type from the types object that will be signed.

object

required

The domain separator as defined by EIP-712.

Show Domain Properties

string

The user-readable name of the signing domain.

string

The current major version of the signing domain.

number

The chain ID of the network.

string

The address of the contract that will verify the signature.

string

A disambiguating salt for the protocol.

object

required

The data object to be signed according to the primary type.

Returns

string

The signature as a hexadecimal string.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_signTypedData_v4",
  "params": [
    "0x3b7252d007059ffc82d16d022da3cbf9992d2f70",
    {
      "types": {
        "EIP712Domain": [
          { "name": "name", "type": "string" },
          { "name": "version", "type": "string" },
          { "name": "chainId", "type": "uint256" },
          { "name": "verifyingContract", "type": "address" }
        ],
        "Person": [
          { "name": "name", "type": "string" },
          { "name": "wallet", "type": "address" }
        ]
      },
      "primaryType": "Person",
      "domain": {
        "name": "Example App",
        "version": "1",
        "chainId": 1,
        "verifyingContract": "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC"
      },
      "message": {
        "name": "Alice",
        "wallet": "0x3b7252d007059ffc82d16d022da3cbf9992d2f70"
      }
    }
  ]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x4355c47d63924e8a72e509b65029052eb6c299d53a04e167c5775fd466751c9d07299936d304c153f6443dfa05f40ff007d72911b6f72307f996231605b915621c"
}

Error Handling

Code	Message	Description
4001	User rejected the request	User denied the signing request
4100	Requested method not supported	The method is not supported by the wallet
-32602	Invalid params	Invalid typed data structure

Always validate the domain and verifying contract address to prevent signature replay attacks.

EIP-712 signatures provide better security than personal_sign by giving users context about what they’re signing.

SDKs

CRYPTO INFRASTRUCTURE

COINBASE APIs

INSTITUTIONAL APIs

COINBASE WALLET

Parameters

Returns

Error Handling

​Parameters

​Returns

​Error Handling

Parameters

Returns

Error Handling