Skip to main content
SUBMIT A PRSUBMIT AN ISSUElast edit: May 19, 2025

Bittensor EVM Smart Contracts

Full Ethereum virtual machine (EVM) compatibility is now available on subtensor (the blockchain in Bittensor). This allows users to deploy most EVM smart contracts on subtensor without changing the code, interact with deployed smart contracts on the subtensor blockchain, and access standard Ethereum JSON-RPC methods.

Bittensor EVM smart contracts are executed solely on the Bittensor blockchain, not on the Ethereum blockchain.

See: Examples and Precompiles

The following Bittensor-specific precompiles are available:

Networks

You can deploy smart contracts on Bittensor main net (aka 'finney'), test network, or on your own locally deployed Bittensor chain.

Network details
MAINNETTESTNETLOCALNET
RPC URLhttps://lite.chain.opentensor.aihttps://test.chain.opentensor.aihttp://localhost:9944
Chain ID964945see below
Test TAONoneAvailable on requestUse Alice account
Set-up GuideEVM Testnet with Metamask WalletEVM Localnet with Metamask Wallet for setting up a Local net.

Ethereum vs Bittensor EVM Smart Contracts

On the Ethereum network, nodes such as full nodes, validator nodes and archive nodes run the Ethereum Virtual Environment (EVM) run-time environment. Smart contracts operate under this EVM. See the below high-level diagram.

Note that all operations performed by Bittensor EVM are executed solely on the Bittensor blockchain, not on the Ethereum blockchain.

Local blockchain vs public subtensorLocal blockchain vs public subtensor Local blockchain vs public subtensorLocal blockchain vs public subtensor
Install Dependencies
Get started by installing dependencies first.
READ MORE
EVM Testnet with Metamask
Learn how to set up your Metamask wallet with EVM testnet.
READ MORE
EVM Localnet with Metamask
Set up your Metamask wallet for a localnet with EVM feature.
READ MORE
EVM Mainnet with Metamask
Learn how to set up your Metamask wallet with EVM mainnet.
READ MORE
Configure Hardhat for subtensor EVM
Using Hardhat? Configure it to work with subtensor EVM.
READ MORE
Configure Remix IDE for subtensor EVM
Remix IDE configuration to use with subtensor EVM.
READ MORE
TAO transfer from Metamask to SS58
Learn how to transfer TAO from Metamask to SS58.
READ MORE
Transfer TAO between two H160 addresses
Learn how to transfer TAO between two Ethereum H160 addresses.
READ MORE
Stake with a smart contract
Stake to a hotkey using precompiled smart contract.
READ MORE
Verify ed25519 with a precompile
Verify an ed25519 signature on subtensor EVM.
READ MORE
Troubleshooting
How to troubleshoot the most common issues.
READ MORE