Account Abstraction using Etherspot Prime SDK
In this guide, you will learn how to use the Etherspot Prime SDK to deploy an Account Abstraction dApp on the Rootstock network. By following these steps, you will empower your users to interact with your dApp without managing private keys directly.
Add a Protocol To DefiLlama
DefiLlama is the largest TVL aggregator for DeFi. Learn how to list a DeFi project and write an SDK adapter to add a Protocol to DefiLlama.
Adding Rootstock to Metamask Programmatically
Learn how to add and initiate a network switch on Metamask from a website.
Bitcoin Writing Contest
The #bitcoin Writing Contest, presented by Rootstock and HackerNoon, is now live with a total prize pool of $17,500 up for grabs! Whether you're a thought leader, a skilled writer, a talented developer, or simply passionate about blockchain technology, this contest invites you to showcase your expertise in various Bitcoin-related topics.
Building the Most Secure, Permissionless and Uncensorable Bitcoin Peg
Transfer BTC to RBTC, and RBTC to BTC through the Powpeg.
Common Errors and Tips
Learn about some potential issues you can run into and tips on how to resolve them.
Common errors when using the app
Here, we will learn how to perform a peg-out using Metamask Wallet.
Concepts Overview
This section of the documentation covers the core concepts about the Rootstock blockchain. Working with Rootstock requires an understanding of blockchain technology, bitcoin and smart contracts.
Configuration of Limits for JSON-RPC Interface
The JSON-RPC methods supported by Rootstock nodes.
Configure
Setting your own config preferences, when using the Java command, Ubuntu, Azure, AWS, or Docker
Configure Hardhat for Rootstock
Learn how to configure your Hardhat project for development on Rootstock testnet and mainnet
Configure MetaMask Wallet for Rootstock
Learn how to connect to Rootstock with a MetaMask Wallet
Configure Verbosity
Configure RSKj for desired log verbosity, finding log files, and using logback.
Contribute to Rootstock
An overview of different ways you can contribute to Rootstock.
Contribute to RootstockLabs platforms security
RootstockLabs has created the bug bounty program to reward researchers that submit valid vulnerabilities to improve the RootstockLabs platforms security.
Conversion using a Ledger hardware wallet
How to perform the Powpeg mechanism using Ledger.
Converting BTC to RBTC and vice versa
Converting BTC to RBTC (peg-in) and RBTC to BTC (peg-out) on Mainnet and Testnet.
Courses on Rootstock
Welcome to Rootstock Courses; Explore learning materials and courses to enable you get started on building on Rootstock and RIF Technologies.
Create a Hardhat Project
Learn how to set up your environment for development using Hardhat
dApp Automation with Cucumber & Playwright
Testing decentralized applications (dApps) is crucial for delivering a smooth user experience and ensuring the reliability of decentralized systems. Cucumber and Playwright form a dynamic duo in automated testing, blending behavior-driven development (BDD) and powerful browser automation capabilities.
Deploy and Interact with a Smart Contract using Web3.py
Deploy and Interact with a Smart Contract Using Web3.py.
Deploy Smart Contracts
Learn how to deploy your Rootstock smart contract on your local environment and the Rootstock network.
Deploy Smart Contracts on Bitcoin
Learn how to write, interact and deploy smart contracts on Bitcoin.
Design and Architecture
Two way peg design and architecture.
Developer Tools
Explore a curated selection of smart contract development tools and languages. From the familiar Solidity to Rust or Developer Environments like Hardhat, you'll find everything you need to interact and deploy your smart contracts on Rootstock.
Developers Overview
Leverage your existing knowledge of Solidity and tools like Rust, Hardhat, and Wagmi to deploy and scale your dApps on the pioneering layer 2 solution that combines the best of Bitcoin security and Ethereum Smart Contract capabilities.
Exploring Rootstock Transactions
Learn how to interact with Rootstock in your web browser, how to look at Rootstock transactions, develop and deploy your very first smart contract to the Rootstock network.
Foundry on Rootstock
How to write, test, and deploy smart contracts with Foundry
Frequently Asked Questions
Explore frequently asked questions about Rootstock and RIF
Frequently Asked Questions (FAQs)
Frequently asked questions.
Get Started with Rootstock Blockscout Explorer
Blockscout is a robust open-source tool for exploring transactions on any EVM blockchain, including Rootstock, the leading Bitcoin sidechain1. With Blockscout, you can access in-depth information, verify and interact with smart contracts, create and manage your account, view advanced statistics, and more.
Getting Started with Foundry
How to write, test, and deploy smart contracts with Foundry
Getting Started with Hardhat
Get started with creating a dApps on Rootstock using Hardhat.
Getting Started with Rootstock (RSK) Development
Learn how to interact with Rootstock in your web browser, how to look at Rootstock transactions, develop and deploy your very first smart contract to the Rootstock network.
Getting Started with the RPC API
Easily create, interact and deploy EVM compatible smart contracts using a robust set of JSON RPC methods available through the RPC API.
Glossary
Welcome to the glossary section for the 2 way peg app documentation.
Gradle building
A deterministic build process used to build Rootstock node JAR file. Provides a way to be reasonable sure that the JAR is built from GitHub RSKj repository. Makes sure that the same tested dependencies are used and statically built into the executable.
Hackathon and Workshop Resources
Hackathon resources and tools
Hardhat on Rootstock
How to get started with writing, deploying and testing smart contracts on Rootstock using Hardhat.
Interact with dApp using MyCrypto
This guide describes the necessary steps to perform a token transfer between two blockchain networks, which we will refer to as Mainchain and Sidechain, through interaction with special contracts that make up a subsystem called Token Bridge.
Interact with Rootstock using Rust
Rust is extensively getting used on backend side of many defi applications, dApps, developer tools, indexers and bridges. This guide will help developers to start using Rust on Rootstock blockchain.
Interact with the Front-end
Learn how to integrate your Rootstock smart contract with front-end applications.
Management API Methods
The JSON-RPC methods supported by Rootstock nodes.
Node Operators Overview
Learn about RSKj, a node implementation for the Rootstock blockchain and merged mining on Rootstock.
Overview
Welcome to the overview section of the 2 way peg app documentation.
Overview | Advanced Operations
See how to perform advanced operations on the two way peg app
Overview | Peg-in
Here, we will learn how to perform a peg-in transaction using the 2 way peg app.
Overview | Pegout
Here, we will learn how to perform a peg-out transaction using the 2 way peg app.
Overview of the Rootstock Explorer
Explore transaction
Performing a peg-in in using Trezor Hardware Wallet
Here, we will learn how to perform a peg-in transaction using the Trezor Hardware Wallet.
Performing a peg-in using Leather Software Wallet
Here, we will learn how to perform a peg-in transaction using the Leather Software Wallet.
Performing a peg-in using Ledger Hardware Wallet
Here, we will learn how to perform a peg-in transaction using the 2 way peg app.
Performing a peg-out transaction using Trezor
Here, we will learn how to perform a peg-out using Trezor.
Performing a peg-out using Ledger Hardware Wallet
Here, we will learn how to perform a peg-out using Ledger Hardware Wallet.
Performing a peg-out using Metamask and hardware wallet
Here, we will learn how to perform a peg-out using Metamask and hardware wallet.
Performing a peg-out using Metamask Wallet
Here, we will learn how to perform a peg-out using Metamask Wallet.
Personal Module Methods
The JSON-RPC methods supported by Rootstock nodes.
Port a dApp from other Chains to Rootstock
Port a dApp from other Chains to Rootstock.
Port an Ethereum dApp to Rootstock
Porting an Ethereum decentralized application (dApp) to Rootstock (RSK) presents an exciting opportunity to leverage the benefits of the Rootstock network, a Bitcoin L2 compatible with Ethereum. This guide will walk you through porting an Ethereum dApp to the Rootstock network using the Hardhat Ignition deployment tool and leveraging the compatibility between Solidity (used for Rootstock) and Ethereum.
Powpeg HSM Firmware Attestation
Learn how to verify Powpeg nodes using the HSM Firmware Attestation.
Prerequisites
Minimum hardware requirements for Rootstock.
Prerequisites
Welcome to the overview section of the 2 way peg app documentation.
Quick Starts
Quick starts, demos and starter kits to develop on Rootstock.
RBTC Conversion: Peg in and Peg Out
Converting BTC to RBTC (peg-in) and RBTC to BTC (peg-out), for both Mainnet and Testnet.
RBTC Gas Fees: Optimizing Transaction Costs
Gas is the internal pricing for running a transaction or contract.
REMASC
Reward Manager Smart Contract (REMASC) is a pre-compiled smart-contract that is executed on every block and has the responsibility to fairly distribute rewards collected from transaction fees into several participants of the network. However the distribution of rewards of a block is only performed once the block reaches a certain maturity. In other words, the rewards are paid only after a fixed number of blocks have confirmed a block. With the exception of the first blocks in the blockchain after genesis, every time a block is added to the blockchain, another previous block reaches maturity and its rewards are paid.
Resources Overview
Find all the resources you need to get started on rootstock whether you're from a developer background, an open source contributor, a startup, or a just looking to learn via tutorials or courses.
RIF Wallet Libraries
RIF Wallet is an open source smart contract wallet which enables businesses to create and deploy fully customizable on-chain wallets.
Rootstock Accounts
EIP-1191 chainId is used in Rootstock addresses as a checksum. m/44'/137'/0'/0 is the derivation path used for BIP-44 compatible wallets.
Rootstock Blockchain Essentials
Learn how to interact with Rootstock in your web browser, how to look at Rootstock transactions, develop and deploy your very first smart contract to the Rootstock network.
Rootstock Contract Addresses
All Contract Addresses on Rootstock.
Rootstock Fundamentals
Rootstock is the first and longest-lasting Bitcoin sidechain. It is the only layer 2 solution that combines the security of Bitcoin's proof of work with Ethereum's smart contract capabilities.
Rootstock Hardhat Starter dApp
Whether you are a seasoned developer or just starting your journey into smart contract development, the hardhat starter kit provides a solid foundation for building decentralized applications (dApps) on the Rootstock network.
Rootstock Node Configuration Reference
Configuration reference for RSKj
Rootstock Stack
Learn about how Rootstock combines the security of Bitcoin PoW with Ethereum's smart contract functionality to build dApps on Bitcoin and also how RIF's Open-source tools and technologies designed to streamline and incentivize development on Bitcoin.
Rootstock Token Bridge
Safely move your ERC20 tokens between Rootstock and Ethereum with the Tokenbridge dApp. This user-friendly interface lets you interact with the Token Bridge contracts directly. It is available on Mainnet or Testnet.
Rootstock Token Bridge Troubleshooting Guide
Having issues crossing your tokens on the token bridge? See the troubleshooting guide for help.
Rootstock Wagmi Starter dApp
The Rootstock Wagmi Starter Kit provides a solid foundation for developing decentralized applications (dApps) on the Rootstock blockchain. It streamlines development by leveraging the React, Wagmi, and Shadcn libraries.
RPC API Methods
Easily create, interact and deploy EVM compatible smart contracts using a robust set of JSON RPC methods available through the RPC API.
RSKj Node Installation
Install RSKj on different OS.
Run with autominer (Ganache-like)
Learn how to run the Rootstock node with autominer - similar to Ganache default config
Security model
Achieving security in a Powpegged sidechain using proofs of payment
Setup node on Docker
Install RSKj using Docker.
Setup node using Java
Install RSKj using Java.
Smart Bitcoin RBTC Token on RBTC - BTC to RBTC
RBTC is the token used to pay for the execution of transactions in Rootstock. You can convert BTC into RBTC by sending BTC through the Powpeg (both in Testnet and Mainnet), or by using the faucet in Testnet, or via decentralized exchanges.
Supported Addresses
See supported addresses on the two way peg app
Supported Browsers
See browsers which support the two way peg app
Supported JSON-RPC Methods
The JSON-RPC methods supported by Rootstock nodes.
Supported Wallets
See wallets which supports the two way peg app
Test Smart Contracts
Learn how to test your Rootstock smart contract
Token Bridge dApp Guide - Cross-Chain Transactions
This guide describes the steps to transfer tokens using the Web Interface for the Rootstock Token Bridge dApp. Please refer to the project documentation, if you’d like to know more about how this bridge works. It is possible to test the transfer of tokens between Rootstock Testnet and Sepolia networks, or Rootstock Mainnet and Ethereum networks using the Rootstock Tokenbridge web interface.
Token Bridge FAQs
Find a list of frequently asked questions about the Token Bridge.
Token Bridge Mainnet Addresses and Links
Here, you can find a list of mainnet, testnet addresses, and ABIs used by the Token Bridge.
Transport Protocols
The JSON-RPC methods supported by Rootstock nodes.
Troubleshooting
How to solve some known or frequently encountered issues when working with RSKj
Tutorials
Tutorials and learning resources
Universal Smart Contract Interface Registry
See the ERC1820 standard interface, address support and smart contract implementation
Updating the Node
How to introduce consensus rules changes using network upgrades on an RSK node. What to consider. Adding a new rule. Running tests with new rules.
Using Rootstock with a Browser Extension
Learn how to interact with Rootstock in your web browser, how to look at Rootstock transactions, develop and deploy your very first smart contract to the Rootstock network.
Verify a Smart Contract using the Hardhat Verification Plugin
Configuring Hardhat Verification plugin for Rootstock
Viewing a derived bitcoin address
Here, we will learn how to view a derived address using Electrum.
Viewing the status of a transaction after peg-out
Here, we will learn how to view a transaction status after a peg-out.
Viewing Transaction Status
Here, we will learn how to view a transaction status on the 2 way peg app.
Virtual Testnets: Use Tenderly to Fork the Rootstock Mainnet for Development
Tenderly's virtual testing environment allows the creation of simulated networks, managing account balances, and manipulating contract storage – all without needing to interact with the Rootstock mainnet or testnet.
Wallets compatible with Rootstock
Learn how to connect to Rootstock with a compatible Wallet
What is Merged Mining?
How merge mining Rootstock with Bitcoin works, and its benefits.
Write a Smart Contract
Learn how to write a smart contract using Solidity and OpenZeppellin