Skip to content

EVM Chain

The EVM (Ethereum Virtual Machine) chain implementation in Signet.js provides support for all EVM-compatible networks, including Ethereum, Binance Smart Chain, Polygon, Arbitrum, and more.

Overview

The EVM implementation allows you to:

  • Derive addresses and public keys
  • Check balances
  • Prepare, sign, and broadcast transactions
  • Sign messages (EIP-191)
  • Sign typed data (EIP-712)

Complete Transaction Example

Below is a complete example of sending a transaction on an EVM chain using Signet.js:

import { chainAdapters } from 'signet.js'
import { contracts, constants } from 'signet.js'
import { createPublicClient, createWalletClient, http } from 'viem'
import { privateKeyToAccount } from 'viem/accounts'
import { sepolia } from 'viem/chains'
 
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)
 
const publicClient = createPublicClient({
  chain: sepolia,
  transport: http(),
})
 
const walletClient = createWalletClient({
  account,
  chain: sepolia,
  transport: http(),
})
 
const evmChainSigContract = new contracts.evm.ChainSignatureContract({
  publicClient,
  walletClient,
  contractAddress: constants.CONTRACT_ADDRESSES.ETHEREUM
    .TESTNET_DEV as `0x${string}`,
})
 
const evm = new chainAdapters.evm.EVM({
  publicClient,
  contract: evmChainSigContract,
})
 
const path = 'eth'
const predecessorId = walletClient.account.address
 
const { address: from, publicKey } = await evm.deriveAddressAndPublicKey(
  predecessorId,
  path
)
 
const { balance, decimals } = await evm.getBalance(from)
 
const { transaction, hashesToSign } = await evm.prepareTransactionForSigning({
  from: from as `0x${string}`,
  to: '0x4174678c78fEaFd778c1ff319D5D326701449b25',
  value: 1n, // Amount in wei (1 wei in this example)
})
 
const rsvSignature = await evmChainSigContract.sign({
  payload: hashesToSign[0],
  path,
  key_version: 0,
})
 
const tx = evm.finalizeTransactionSigning({
  transaction,
  rsvSignatures: [rsvSignature],
})
 
const txHash = await evm.broadcastTx(tx)

Supported Networks

You can use any EVM-compatible network by providing the appropriate client:

import { chainAdapters } from 'signet.js'
import { polygon, bsc, mainnet } from "viem/chains";
 
// Ethereum Mainnet
const clientEthereum = createPublicClient({
  chain: mainnet,
  transport: http(),
});
 
const ethereumChain = new chainAdapters.evm.EVM({
  publicClient: clientEthereum,
  contract: evmChainSigContract,
})
 
// Polygon (Matic)
const clientPolygon = createPublicClient({
  chain: bsc,
  transport: http(),
});
 
const polygonChain = new chainAdapters.evm.EVM({
  publicClient: clientEthereum,
  contract: evmChainSigContract,
})
 
// Binance Smart Chain
const clientBSC = createPublicClient({
  chain: polygon,
  transport: http(),
});
 
const bscChain = new chainAdapters.evm.EVM({
  publicClient: clientBSC,
  contract: evmChainSigContract,
})