Rootstock DeFi Developer Guide
The Rootstock DeFi Developer Guide covers token standards, oracle integration, AMM patterns, and security practices for protocols on Rootstock. Use it to review fundamentals before you deploy vault, lending, or stablecoin flows to mainnet.
This guide provides practical workflows, example code, and best practices for building DeFi protocols on Rootstock.
This guide assumes you have basic knowledge of Solidity, blockchain fundamentals, and the Rootstock ecosystem. You should have a development environment set up (Hardhat or Foundry) and a testnet wallet with tRBTC. See Shared Setup.
Why Rootstock for DeFi?
- Bitcoin security: Rootstock is merge-mined with Bitcoin and secured by over 85% of Bitcoin hash power.
- EVM compatibility: Write and deploy contracts in Solidity with Ethereum-familiar tooling.
- Lower fees: Transactions on Rootstock typically cost less than on Ethereum mainnet.
- DeFi tooling: Bridges, oracles, and protocol integrations are documented in this portal.
- rBTC: The native asset is Bitcoin-pegged (1 rBTC = 1 BTC). Bitcoin holders can use rBTC as gas and collateral in DeFi protocols.
What You Will Learn
This guide is divided into five main sections, each building on the previous:
1. Token Standards & Best Practices
Learn how to implement and extend ERC-20, ERC-721, and ERC-4626 tokens on Rootstock. Understand wrapping RBTC (wRBTC), gas optimization, and security considerations specific to token development.
2. Oracle Integration
Fetch reliable off-chain data using Chainlink or other oracles. Implement price feeds, randomness (VRF), and oracle patterns that reduce manipulation risk.
3. Automated Market Makers (AMM) Basics
Build a simple constant-product AMM from scratch. Understand liquidity pools, swap mechanics, fees, and slippage. Test your contract with Hardhat and integrate it with a React frontend.
4. Security Patterns
Review security practices for DeFi: reentrancy protection, access control, integer safety, upgradeability, circuit breakers, and flash loan resistance. Learn how to audit your code and avoid common pitfalls.
5. Example Templates
Get started quickly with full-stack templates. Each template includes smart contracts, Hardhat deployment scripts, and a React frontend with ethers.js integration. Templates cover price oracles, AMMs, ERC-20 with permit, yield vaults (ERC-4626), and upgradeable contracts.
Target Audience
This guide is designed for:
- Solidity developers who are new to Rootstock and want to deploy their first DeFi dApp.
- DeFi protocols planning to expand to Rootstock and seeking best practices.
- Web3 developers looking for reusable patterns and templates to accelerate development.
- Students and researchers interested in learning how DeFi protocols work under the hood.
Prerequisites
Before diving in, ensure you have:
- Basic Solidity knowledge: You should understand functions, modifiers, events, and inheritance.
- Familiarity with Ethereum concepts: Transactions, gas, wallets, and ERC standards.
- A development environment: We recommend Hardhat, but Foundry or Truffle also work.
- A Rootstock testnet wallet: You'll need tRBTC (testnet RBTC) to deploy and test contracts.
Setting Up Your Environment
Follow these steps to prepare your development environment:
1. Install Node.js and npm
Download from nodejs.org (LTS version recommended).
2. Create a new Hardhat project
mkdir my-defi-project
cd my-defi-project
npm init -y
npm install --save-dev hardhat @nomiclabs/hardhat-waffle ethereum-waffle chai @nomiclabs/hardhat-ethers ethers
npx hardhat
Choose "Create a basic sample project" and follow the prompts.
3. Set up the test environment
To ensure all JavaScript test snippets execute correctly, make sure your test environment is properly configured:
# Install additional testing dependencies if needed
npm install --save-dev hardhat @nomiclabs/hardhat-ethers ethers chai
Your hardhat.config.js should include:
require("@nomiclabs/hardhat-ethers");
module.exports = {
solidity: "0.8.0",
};
This ensures that all test files can properly import chai, ethers, and use the describe/it testing structure without execution errors.
4. Install OpenZeppelin contracts
npm install @openzeppelin/contracts
5. Configure Hardhat for Rootstock
Edit hardhat.config.js to add Rootstock networks:
require("@nomiclabs/hardhat-waffle");
module.exports = {
solidity: "0.8.0",
networks: {
hardhat: {},
rsktestnet: {
url: "https://public-node.testnet.rsk.co",
chainId: 31,
accounts: [process.env.PRIVATE_KEY] // Use environment variable for security
},
rskmainnet: {
url: "https://public-node.rsk.co",
chainId: 30,
accounts: [process.env.PRIVATE_KEY]
}
}
};
Create a .env file to store your private key (never commit this):
PRIVATE_KEY=your_testnet_private_key_here
6. Get tRBTC from the Rootstock testnet faucet
Visit the Rootstock Testnet Faucet and request tRBTC to your testnet address. You'll need this to pay for gas when deploying contracts.
7. (Optional) Set up a frontend with React
If you plan to build a dApp, create a React app:
npx create-react-app frontend
cd frontend
npm install ethers
How to Use This Guide
Follow sequentially: Each section builds on concepts from the previous one. Start with Token Standards, then move to Oracles, AMM, Security, and finally Templates.
Jump directly: If you're already familiar with a topic, feel free to skip to the section you need.
Run the code: All code examples are tested on Rootstock testnet. Copy, deploy, and experiment.
Refer to the templates: The final section provides complete, working projects that you can use as a starting point.