Skip to main content

Getting Started with the EVM Interface

This guide walks through connecting an Ethereum wallet, obtaining tez, and interacting with the EVM Interface on the Tezos X testnet.

1. Connect a wallet​

Use any Ethereum-compatible wallet that supports custom networks (such as MetaMask). Add the Tezos X Previewnet as a custom network by pointing to the EVM RPC endpoint listed in the previewnet repository.

For detailed wallet connection instructions, see Using your wallet in the Etherlink documentation, replacing Mainnet/Shadownet endpoints with the Tezos X testnet parameters.

2. Get tez​

A faucet is available in the previewnet repository. Enter your EVM address and request testnet tez. Tez on the EVM interface has 18-decimal precision.

3. Deploy and interact with a smart contract​

Once your wallet is funded, you can deploy and interact with Solidity contracts using standard Ethereum tooling:

  • Use Hardhat or Foundry to compile and deploy contracts, pointing to the Previewnet EVM RPC endpoint.
  • Use ethers.js, viem, or web3.js to interact with deployed contracts.
  • Use the Tezos X block explorer (linked from the previewnet repository) to inspect transactions and contract state.

For detailed guidance, refer to the Deploying smart contracts and Sending transactions pages in the Etherlink documentation.

4. Try native atomic composability​

To call a Michelson contract from a Solidity contract, use the NAC gateway. See NAC Usage for the gateway address and call conventions. For a more hands-on presentation, check the Cross-interface counter tutorial.