Skip to main content
EVM chains like Ethereum, Polygon, Base etc support the following signature kinds:
  • Transaction: unsigned transaction.
  • Eip191: personal_sign message defined in EIP-191. Also available as Message (they are equivalent).
  • Eip712: typed structured data defined in EIP-712.
  • Eip7702: authorization tuple for type 4 set code transaction defined in EIP-7702.

​
Transaction

Signs an unsigned transaction. The transaction field accepts either a hex-encoded string or a JSON object.
FieldDescriptionType - Optional
blockchainKindEvmString
kindTransactionString
transactionThe unsigned transaction formatted as JSON or a hex-encoded string.String or EvmTransactionJson

​
Hex string

{
  "blockchainKind": "Evm",
  "kind": "Transaction",
  "transaction": "0x02e783aa36a71503850d40e49def82520894e5a2ebc128e262ab1e3bd02bffbe16911adfbffb0180c0"
}

​
Typescript example with Ethers

First install the Ethers JS. You can find the full documentation here. Here a code sample to generate a signature via the Dfns TypeScript SDK: 
import { parseUnits, Transaction } from 'ethers'

const walletId = 'wa-6lbfv-9esgj-xxxxxxxxxxxxxxxx'

const transaction = Transaction.from({
  to: '0xa238b6008Bc2FBd9E386A5d4784511980cE504Cd',
  value: '1',
  gasLimit: '21000',
  maxPriorityFeePerGas: parseUnits('5', 'gwei'),
  maxFeePerGas: parseUnits('20', 'gwei'),
  nonce: 3,
  type: 2,
  chainId: 11155111,
})

const res = await dfnsClient.wallets.generateSignature({
  walletId,
  body: { kind: 'Transaction', transaction: transaction.unsignedSerialized },
})

​
EvmTransactionJson

FieldDescriptionType - Optional
typeEthereum transaction type. 0 for legacy transaction; 2 for EIP-1559 transaction; 4 for EIP-7702 transaction. Default is 2 if undefined.Integer (optional)
toThe destination address or target contract. Leave undefined when the transaction is a contract deployment.String (optional)
valueThe amount of native tokens to transfer in minimum denomination.String (optional)
dataABI encoded function call data in hex format. Can also be the encoded smart contract data when the transaction is a contract deployment.String (optional)
nonceThe transaction number to guarantee idempotency. If omitted, it will be provided automatically. Note the same nonce can be submitted multiple times with a higher maxFeePerGas to “overwrite” existing transactions in the mempool.Integer or String (optional)
gasLimitThe maximum amount of gas that can be spent for executing the transaction. If omitted, it will be calculated automatically.String (optional)
gasPriceThe amount of per unit gas. Only valid for a type 0 legacy transaction. If omitted, it will be calculated automatically.String (optional)
maxFeePerGasThe maximum amount of per unit gas willing to be paid for the transaction. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.String (optional)
maxPriorityFeePerGasThe maximum amount of per unit gas to be included as a tip to the validator. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.String (optional)
authorizationListA list that indicates what code the signer of each authorization desires to execute in the context of their EOA. Only valid for type 4 transaction.Authorization (optional)

​
Authorization

FieldDescriptionType - Optional
chainIdChain ID.Integer
addressThe address of the contract the signer’s EOA will be delegated to.String
nonceThe current nonce of the signer EOA.Integer
signatureThe signer signature.String
{
  "blockchainKind": "Evm",
  "kind": "Transaction",
  "transaction": {
    "to": "0x00fb58432ef9d418bf6688bcf0a226d2fcaa18e2",
    "data": "0x40d097c3000000000000000000000000d2f77f85a50cdd650ca562f3a180284e1d5b4934",
    "maxFeePerGas": "1626000000000",
    "maxPriorityFeePerGas": "1332000000000"
  }
}

​
EIP-191 personal_sign

Signs a personal_sign message as defined in EIP-191.
FieldDescriptionType - Optional
blockchainKindEvmString
kindEip191String
messageHex-encoded message.String
{
  "blockchainKind": "Evm",
  "kind": "Eip191",
  "message": "0x49206c6f76652044666e73"
}

​
EIP-712 TypedData

Signs a typed structured data defined in EIP-712.
FieldDescriptionType - Optional
blockchainKindEvmString
kindEip712String
typesType definitions.Map<String, TypedDataField[]>
domainDomain separator.Eip712Domain
messageStructured message to sign.Object

​
TypedDataField

FieldDescriptionType - Optional
nameField name.String
typeField type.String

​
Eip712Domain

FieldDescriptionType - Optional
nameName of the signing domain.String
versionCurrent major version of the signing domain.String
chainIdChain ID.Integer
verifyingContractThe address of the contract that will verify the signature.String
salt32-byte value as a last-resort domain separator.String
{
  "blockchainKind": "Evm",
  "kind": "Eip712",
  "types": {
    "Person": [
      { "name": "name", "type": "string" },
      { "name": "wallet", "type": "address" }
    ],
    "Mail": [
      { "name": "from", "type": "Person" },
      { "name": "to", "type": "Person" },
      { "name": "contents", "type": "string" }
    ]
  },
  "domain": {
    "name": "Ether Mail",
    "version": "1",
    "chainId": 1,
    "verifyingContract": "0x1b352de7a926ebd1bf52194dab487c2cb0793a9b",
    "salt": "0xf2d857f4a3edcb9b78b4d503bfe733db1e3f6cdc2b7971ee739626c97e86a558"
  },
  "message": {
    "from": {
      "name": "Chris",
      "wallet": "0x00e3495cf6af59008f22ffaf32d4c92ac33dac47"
    },
    "to": {
      "name": "Bob",
      "wallet": "0xcc0ee1a1c5e788b61916c8f1c96c960f9a9d3db7"
    },
    "contents": "Hello, Bob!"
  }
}

​
EIP-7702 Authorization

Signs an authorization tuple for type 4 set code transaction defined in EIP-7702.
FieldDescriptionType - Optional
blockchainKindEvmString
kindEip7702String
chainIdChain ID.Integer
addressThe address of the contract the signer’s EOA will be delegated to.String
nonceThe current nonce of the signer EOA.Integer
{
  "blockchainKind": "Evm",
  "kind": "Eip7702",
  "chainId": 1,
  "address": "0xcea43594f38316f0e01c161d8dabde0a07a1f512",
  "nonce": 0
}
Last modified on March 13, 2026