Developer guides
Gnosis Chain is EVM-equivalent: the contracts, tools and libraries you use on Ethereum work here unchanged. This section takes you from a first deployment to a production setup. Everything you deploy today carries over to Gnosis EEZ at the same address.
Start here
New to Gnosis Chain? Pick one of these. Each ends in a result you can check on-chain.
| If you want to | Start with | Time |
|---|---|---|
| Deploy from the browser, with nothing to install | Quickstart, using Remix and MetaMask | About 15 minutes |
| Work from the terminal, with tests and verification | Deploy your first contract, using Foundry | About 30 minutes |
| Call live protocols instead of deploying your own | Buy a tokenised asset with CoW Swap, using viem | About 40 minutes |
Network details
| Gnosis Chain | Chiado testnet | |
|---|---|---|
| Chain ID | 100 | 10200 |
| RPC | https://rpc.gnosischain.com | https://rpc.chiadochain.net |
| Explorer | Gnosisscan | Blockscout |
| Gas token | xDai | xDai (test), from the faucet |
More endpoints are on RPC providers, and the full network reference is in networks.
What is in this section
0-1 guides
Each guide starts from an empty directory and ends in a result you can verify on-chain. Work through them in order.
| Guide | What you build | Time |
|---|---|---|
| Deploy your first contract | A verified contract, with a state change you read back two ways | 30 minutes |
| Accept stablecoin payments | A payment receiver that pulls a stablecoin, records who paid and what for, and lets you withdraw | 40 minutes |
| Launch a tokenised asset | A capped-supply token bound to an off-chain asset, with issuance controls you have tested | 45 minutes |
Set up your environment
| Tool | Use it for |
|---|---|
| Foundry | Solidity-native testing, scripting and deployment from the terminal |
| Hardhat | A JavaScript or TypeScript project with plugins and scripted deploys |
| Cookbook | Finding, deploying and reusing open-source Solidity contracts |
Build from templates
| Template | What you get |
|---|---|
| ERC-20 token | A fungible token deployed to Gnosis |
| ERC-721 NFT | An NFT collection deployed to Gnosis |
| Full-stack dApp | A Hello World app with a contract and a frontend |
Call contracts from your app
| Library | Use it for |
|---|---|
| Ethers.js | Reading and writing contracts from JavaScript |
| Web3.js | The same, with the web3.js library |
| MetaMask API | Detecting the wallet and adding Gnosis Chain and tokens to it |
Verify your contracts
Publish your source code so anyone can read the contract they are calling.
- Verification overview: what verification does.
- Blockscout and Sourcify: step-by-step guides.
Go further
- Useful contracts: contract, bridge and validator addresses for Gnosis Chain, Chiado and Ethereum.
- Developer tutorials: smart accounts, custom signers, EIP-7702 and EIP-5792.