🚀Smart Contract Development on Polkadot

Polkadot enables smart contract deployment via PolkaVM. This allows using familiar Ethereum tools and libraries while leveraging Polkadot’s robust ecosystem. PolkaVM is live on Passet Hub, the Polkadot community testnet. ✅

Please provide feedback on your experience deploying smart contracts on Polkadot using this feedback form.

Refer to the known issues document if you're running into issues deploying contracts or using any of the tools below. If you have a new bug or problem, please raise an issue in the Contracts Bug tracker on Github.

📚 Solidity Development Environments

There are multiple development environments already available for Polkadot smart contract development. Here are some of the most popular ones:

• 🖥️ Polkadot Remix IDE - a web-based IDE that allows you to write, test, and deploy smart contracts directly in your browser. It's integrated with compatible chains: you can deploy right from the browser

• ⚒️ Hardhat - a popular Ethereum development environment that can be used for Polkadot smart contract development with the help of custom plugins

• 🤠 Foundry - a smart contract development toolchain that manages your dependencies, compiles your project, runs tests, deploys, and lets you interact with thec ontracts.

🦀 Rust Contracts

Besides Solidity, you can also write smart contracts in Rust using ink! — the go-to language for Rust-based smart contract development on Polkadot. Check out the ink! Docs (compatible with PolkaVM from v6 ) to get started.

👨‍💻 Contract Interaction Libraries

Several libraries can be used to interact with smart contracts deployed on Polkadot for both Solidity and Rust.

Solidity

• 🔵 Ethers.js

• ⚡ viem

• 🌐 Web3.js

• 🐍 Web3.py

• 🧙 Wagmi

ink!

• 🥸 PAPI

📚 Tutorials and Guides

Here you can find some useful tutorials and resources to help you get started with smart contract development on Polkadot:

• ✍️ Create a Smart Contract - a step-by-step guide to creating your first smart contract on Polkadot

• ⚙️ Test and Deploy with Hardhat - a guide to testing and deploying your smart contract using Hardhat

• 🎨 Deploy a NFT - a tutorial on deploying an NFT smart contract on Polkadot

• 💰 Deploy an ERC-20 - a tutorial on deploying an ERC-20 token smart contract on Polkadot

• 🛠️ Create a dApp with Viem - a tutorial on creating a simple dApp using the Viem library

• 🛠️ Create a dApp with Ethers.js - a tutorial on creating a simple dApp using the Ethers.js library

• 🎥 Deploy Rust and Solidity contracts – a workshop showcasing how to deploy and interact with Solidity and Rust contracts on the Polkadot Hub.

🔑 How to Connect to Polkadot Hub Testnet

You can use any Ethereum-compatible wallet wallet to connect to Polkadot Hub Testnet. Follow the Connect your Wallet guide to connect using MetaMask. We also recommend using Talisman, which is built for both Polkadot and Ethereum.

Testnet details:
* Network name: Passet Hub
* Chain ID: 420420421
* RPC URL: https://testnet-passet-hub-eth-rpc.polkadot.io
* Block Explorer URL: https://blockscout-passet-hub.parity-testnet.parity.io/

💧 Polkadot Faucet

Need testnet tokens? Get some from the Testnet Faucet 💧

Note: Make sure you've selected the Passet Hub chain on the Paseo network!

🏆 Starter Templates

Jumpstart your smart contract dApp with these templates:

• create-polkadot-dapp - a scaffolding tool to generate project boilerplates. Explore the react-solidity template located in the templates folder which comes pre-configured with React, Tailwind CSS, and Ethers.js for frontend interaction with your smart contracts

• hardhat-polkadot-example - a demo for how to use Hardhat with Polkadot.

Vibe coding with AI: LLM configuration helper

• If using AI tools like LLMs, remember to direct them to use the most up-to-date documentation.

• Especially if you are using Claude, this document contains configuration settings for using the testnet to deploy smart contracts, and we recommend informing your LLM to refer to it.