Skip to main content

Migrate your Smart Contract

This guide will teach you to deploy a smart contract to the Vaulta EVM using hardhat on both the Vaulta EVM mainnet and testnet.

Set up your MetaMask

Click either of these buttons to instantly add Vaulta EVM to your MetaMask.


Getting EOS tokens

Want some EOS tokens to play with? Click the button below to get some from the testnet faucet.

If you're on the testnet, you can get some EOS tokens using the testnet faucet.

If you're on the Vaulta Mainnet, ]you can transfer your native EOS using a standard EOS transfer:

  • Send tokens to: eosio.evm
  • Set the memo to your Vaulta EVM address

⚠️ Important If you have only Vaulta, you will need to swap it to EOS. See the EVM tokens page below for more information.

For more ways to get EOS tokens, check out the EVM Tokens page.

Hardhat configuration

If you want to set up a new hardhat project, head over to their quick start guide.

Open up your hardhat.config.js file and add the following configuration:

const config: HardhatUserConfig = {
// ...

networks: {
vaulta_evm: {
url: "https://api.evm.eosnetwork.com",
accounts:[process.env.PRIVATE_KEY],
},
vaulta_evm_testnet: {
url: "https://api.testnet.evm.eosnetwork.com",
accounts:[process.env.PRIVATE_KEY],
}
}
};

🔑 Private Keys

Note that we are using process.env.PRIVATE_KEY to make sure that our private key isn't exposed in our code. This means you need to be using either something like dotenv to inject the key into your environment, add it manually to your environment, or you can just replace the environment variable with your private key directly.

However, be careful putting your actual key into this file, as it may be committed to a public repository, and you should NEVER share your private key with anyone.

Deploying your contract

Now you can deploy your contract to the Vaulta EVM testnet:

npx hardhat run scripts/deploy.js --network vaulta_evm

// or for testnet
npx hardhat run scripts/deploy.js --network vaulta_evm_testnet

Once deployed, you will see the address of your new contract, and can view it an explorer by pasting it into the search field.

deploy hardhat

Congratulations!

You have successfully deployed your first smart contract to the Vaulta EVM! 🎉

If you already have a front-end application that interacts with your smart contract, you can now point it at the Vaulta EVM Endpoints, and it will work as expected.

Make sure you visit the Compatibility section to learn about the differences between the Vaulta EVM and Ethereum, and how to make sure your web3 application works on the Vaulta EVM as expected.