Building on Shibarium

This section of the documentation provides guidance on building on the Shibarium PoS network. It offers a concise architectural overview of the PoS network and demonstrates the seamless compatibility of various developer tools commonly used on Ethereum with Shibarium PoS.

It details how developers can engage with Shibarium PoS by integrating commonly used wallets such as Metamask and Arkane, deploying Ethereum smart contracts using Remix, or developing decentralized apps (dApps) using Fauna.

Building on Shibarium-

Developers familiar with Ethereum are essentially Shibarium developers.

Welcome aboard! Simply switch to the Shibarium RPC and kickstart your journey. All the familiar tools used on Ethereum are fully supported on Shibarium. Whether you're using Truffle, Remix, or Web3js, Shibarium offers the same user experience as Ethereum.

Connect your wallet and deploy any decentralized application to either Shibarium Mainnet or Shibarium Puppynet Testnet.

Shibarium Puppynet Testnet is connected to Ethereum Sepolia Testnet, serving as its ParentChain, a testnet layer 1 (L1).

Refer to the network documentation for comprehensive details on network-related information.


Shibarium functions as a layer 2 (L2) network to Ethereum, employing a proof-of-stake (PoS) consensus mechanism, consisting of the following two layers:

Heimdall layer, a consensus layer comprising a set of proof-of-stake Heimdall nodes that monitor staking contracts deployed on the Ethereum mainnet and commit the Polygon Network checkpoints to the Ethereum mainnet. Heimdall is built on Tendermint. Bone layer, an execution layer composed of a set of block-producing Bone nodes shuffled by Heimdall nodes. Bone is based on Go Ethereum (Geth). To become a validator on the Shibarium Network, you need to:

Run a sentry node, which is a separate machine running a Heimdall node and a Bone node. A sentry node is open to all nodes on the Shibarium Network. Run a validator node, which is a separate machine running a Heimdall node and a Bone node. A validator node is only open to its sentry node and closed to the rest of the network. Stake the BONE tokens in the staking contracts deployed on the Ethereum mainnet.


To interact with the Shibarium Network, you need an Ethereum-based wallet because Shibarium operates on the Ethereum Virtual Machine (EVM). Set up a Metamask or Arkane Wallet to get started.

Smart contracts-

Shibarium supports various services for testing, compiling, debugging, and deploying decentralized applications onto the Shibarium Network. These include deployment using thirdweb, Alchemy, Chainstack, QuickNode, Remix, Truffle, Hardhat, and Replit.

Connecting to Shibarium- You can add Shibarium to MetaMask or use Arkane directly, facilitating connection to Shibarium using RPC.

For connecting with the Shibarium network to read blockchain information, we recommend using the Alchemy SDK.

// Javascript // Setup: npm install alchemy-sdk const { Alchemy, Network } = require("alchemy-sdk");

const settings = { apiKey: "demo", // Can replace with your API Key from network: Network.BONE_MAINNET, // Can replace with BONE_Puppynet };

const alchemy = new Alchemy(settings);

async function main() { const latestBlock = await alchemy.core.getBlockNumber(); console.log("The latest block number is", latestBlock); }


Take it easy!

If this seems overwhelming, don't worry! You can dive right into action and start hacking. Before you begin exploring resources, repositories, and documentation, keep in mind:

Beware the cost of being on the bleeding edge: Like typical niche programming, dApps and blockchain development move rapidly. You may encounter complex code repositories, 404s on a documentation site, or even no documentation. Use that opportunity to open an issue on the Shibarium Knowledge Layer’s GitHub repository. The learning curve may be daunting, but the barrier to entry is low: The community is open and welcoming! Projects welcome pull requests from outsiders and actively address any blockers. We're working on creating a better world, and any contribution is appreciated. We'll be grateful to onboard you into this amazing Web3 ecosystem.

Building a new dApp on Shibarium?

Decentralized applications (dApps) serve as the bridge between users and their data privacy on the blockchain. The increasing number of dApps validates their usefulness within the blockchain ecosystem, addressing challenges like executing transactions between two participants without the need for a central authority via smart contracts.

If you have no prior experience building decentralized applications (dApps), the resources mentioned below will give you a head start on the tools required to build, debug, and deploy dApps on the Shibarium Network.

  • Full Stack dApp: Tutorial Series

  • Web3.js

  • Ethers.js

  • thirdweb

  • Remix

  • Truffle

  • Metamask

  • Arkane

  • Develop a dApp using Fauna, Shibarium, and React

Already have a dApp?

If you already have a decentralized application (dApp) and are seeking a platform to help you scale efficiently, you're in the right place. Shibarium allows you to:

  • Easily migrate from Ethereum Virtual Machine (EVM)-based chain: Shibarium prides itself as the ultimate Layer-2 scaling solution for Ethereum. You don't have to worry about the underlying architecture when moving or deploying your dApps to the Shibarium Network, as long as it is EVM-compatible.

  • Use Shibarium as a faster transaction layer: Deploying your dApp to the Shibarium Mainnet allows you to leverage Shibarium as a faster transaction layer. Additionally, you can get your tokens mapped by us.

Last updated