Get Started¶
This resource provides quick-starts for building smart contracts on Polkadot Hub. Use the tables below to jump directly to the tools and workflows you need.
Quick Starts¶
Kick off development fast with curated links for connecting, funding, exploring, and deploying your first contract.
| Quick Start | Tools | Description |
|---|---|---|
| Connect to Polkadot | Polkadot.js, MetaMask | Add the network, configure RPC, verify activity in the explorer |
| Get Test Tokens | - | Request test funds to deploy and interact with contracts |
| Explore Transactions | Subscan | Inspect transactions, logs, token transfers, and contract state |
| Deploy with Remix | Remix | One‑click browser deployment to Polkadot Hub |
| Deploy with Foundry | Foundry | Scripted deployments and testing from the CLI |
| Deploy with Hardhat | Hardhat | Project scaffolding, testing, and deployments |
Build and Test Locally¶
Set up local environments and CI-friendly workflows to iterate quickly and validate changes before deploying.
| Build and Test Locally | Tools | Description |
|---|---|---|
| Run a Local Dev Node | Polkadot SDK node | Spin up a local node for iterative development |
| Remix: Get Started | Remix | Connect Remix to Polkadot Hub and configure accounts |
| Remix: Verify a Contract | Remix | Publish verified source on explorers |
| Foundry: Install and Config | Foundry | Install toolchain and configure networks |
| Foundry: Compile and Test | Foundry | Write and run Solidity tests locally |
| Foundry: Verify a Contract | Foundry | Verify deployed bytecode and metadata |
| Hardhat: Install and Config | Hardhat | Initialize a project and configure networks |
| Hardhat: Compile and Test | Hardhat | Unit test contracts and run scripts |
| Hardhat: Verify a Contract | Hardhat | Verify deployments on explorers |
Ethereum Developer Resources¶
Bridge your Ethereum knowledge with Polkadot Hub specifics: account mapping, fees, JSON‑RPC, and deployment.
| Ethereum Developer Guides | Description |
|---|---|
| Accounts | How 20‑byte Ethereum addresses map to 32‑byte Polkadot accounts |
| Blocks, Transactions, and Fees | Transaction types, fees, and multi‑dimensional metering |
| Gas Model | Gas vs. weight, proof size, and storage deposits |
| Contract Deployment | Deployment patterns and best practices on Polkadot Hub |
| JSON‑RPC APIs | Supported Ethereum JSON‑RPC methods and examples |
| Migration | Port existing apps and tooling to Polkadot Hub |
| Dual VM Stack | Overview of EVM and native execution on the Hub |
Cookbook: Hands‑on Tutorials¶
Follow step‑by‑step guides that walk through common tasks and complete dApp examples.
| Tutorial | Tools | Description |
|---|---|---|
| Deploy a Basic Contract | Remix | Minimal deployment walkthrough |
| Deploy an ERC‑20 | Remix, OpenZeppelin | Create, deploy, and mint a fungible token |
| Deploy an NFT (ERC‑721) | Remix, OpenZeppelin | Build and deploy an NFT collection |
| Uniswap V2 | Hardhat | Full dApp project: compile, test, deploy |
| Zero‑to‑Hero dApp | Multiple | End‑to‑end dApp patterns and practices |
Libraries¶
Choose the client libraries that fit your stack for connecting wallets and calling contracts.
| Library | Description |
|---|---|
| Ethers.js | Connect, sign, and interact with contracts using Ethers |
| viem | Type‑safe EVM interactions and utilities |
| Wagmi | React hooks for wallet connections and contract calls |
| Web3.js | Web3 provider and contract APIs |
| Web3.py | Python toolkit for on‑chain interactions and scripts |
Integrations¶
Integrate essential services like wallets, indexers, and oracles to round out your dApp.
| Integration | Description |
|---|---|
| Wallets | Supported wallets and configuration notes |
| Indexers | Index and query blockchain data |
| Oracles | Bring external data on‑chain |
Precompiles¶
Discover precompiled system contracts available on the Hub and how to use them.
| Topic | Description |
|---|---|
| Overview of Precompiles | What precompiles are available on the Hub |
| ETH Native | EVM precompiles and interfaces |
| Staking | Interact with staking functionality via precompiles |
| XCM | Cross‑chain messaging helpers for contracts |
From here, follow the quick starts to get connected, iterate locally with your preferred tools, and use the guides, libraries, integrations, and precompiles as you grow into production‑ready dApps. If you get stuck, open an issue or reach out in the community channels.
| Created: September 30, 2025