Skip to main content
EVM chains like Ethereum, Polygon, Base etc support the following signature kinds:
  • Transaction: unsigned transaction.
  • Message: an arbitrary message.
  • 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.
FieldDescriptionType - Optional
blockchainKindEvmString
kindTransactionString
transactionThe unsigned hex encoded transaction as shown below.String
{
  "blockchainKind": "Evm",
  "kind": "Transaction",
  "transaction": "0x02e783aa36a71503850d40e49def82520894e5a2ebc128e262ab1e3bd02bffbe16911adfbffb0180c0"
}

​
Typescript Example with EthersJs

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

const walletId = 'wa-6lbfv-9esgj-88s80c0qsih0a393'

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 },
})

​
Message

Signs an arbitrary hex encoded message.
FieldDescriptionType - Optional
blockchainKindEvmString
kindMessageString
messageAn arbitrary hex encoded message.String
{
  "blockchainKind": "Evm",
  "kind": "Message",
  "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
}
⌘I