ORBION DOCS
WebsiteWhitepaper
  • ๐Ÿ”นIntroduction
  • ๐Ÿ”นCore Architecture
  • ๐Ÿ”นWhy Modular
  • ๐Ÿ”นGovernance
  • ๐Ÿ”นFee Model & Token Utility
  • ๐Ÿ”นArchitecture Overview
  • Core Team
  • ๐Ÿ”นFAQ
  • Network
    • ๐Ÿ”นOverview
    • ๐Ÿ”นPublic RPC Endpoints
    • ๐Ÿ”นExplorer & Faucet
    • ๐Ÿ”นValidator Setup
    • ๐Ÿ”นNetwork Parameters
  • Developer Guide
    • ๐Ÿ”นHow to Connect with MetaMask
    • ๐Ÿ”นDeploy Smart Contracts on Orbion
    • ๐Ÿ”นUsing the Testnet Faucet
    • ๐Ÿ”นValidator Setup Guide
  • RPC Access
    • ๐Ÿ”นPublic RPC Specs
    • ๐Ÿ”นRate Limits & Best Practices
    • ๐Ÿ”นRunning a Node
  • for user
    • ๐Ÿ”นTokenomics
    • ๐Ÿ”นOrbion Roadmap
  • Ecosystem
    • ๐Ÿ”นOrb Coin
    • ๐Ÿ”นOrbion Finance
    • ๐Ÿ”นOrbion Bridge
    • ๐Ÿ”นOrbion Tools (Telegram Bot Suite)
    • ๐Ÿ”นOrbion Locker
    • ๐Ÿ”นOrbion Explorer
    • ๐Ÿ”นOrbion SDK & API
    • ๐Ÿ”นThird-Party Integrations
Powered by GitBook
On this page
  1. Developer Guide

Deploy Smart Contracts on Orbion

Orbion is fully EVM-compatible, allowing developers to deploy smart contracts using familiar tools such as Hardhat, Remix, and Foundry without modification.

The testnet mimics mainnet conditions, with stable RPC endpoints, dynamic fee markets, and full support for contract verification. This guide provides step-by-step instructions for deploying contracts using Hardhat.


โœ… Requirements

Before deploying, ensure you have the following:

  • Node.js & npm installed

  • MetaMask or a funded private key with Testnet ORB

  • Hardhat installed in your project

  • RPC endpoint from Orbion Testnet

  • Chain ID: 9119


๐Ÿ”ง 1. Initialize Hardhat Project

If you havenโ€™t already:

mkdir orbion-contract && cd orbion-contract
npm init -y
npm install --save-dev hardhat
npx hardhat

Choose โ€œCreate a basic sample projectโ€ and follow the prompts.


๐Ÿ“ 2. Configure hardhat.config.js

Update the file to include Orbion Testnet:

require("@nomiclabs/hardhat-ethers");

module.exports = {
  networks: {
    orbion: {
      url: "https://rpctestnet-1.orbionchain.com",
      accounts: [process.env.PRIVATE_KEY],
      chainId: 9119,
    },
  },
  solidity: "0.8.20",
};

โš ๏ธ Store your private key safely using .env:

PRIVATE_KEY=your_wallet_private_key

๐Ÿ“œ 3. Compile Contract

Make sure your smart contract (e.g., contracts/Greeter.sol) is ready. Then compile:

npx hardhat compile

๐Ÿš€ 4. Deploy to Orbion

Create a new file scripts/deploy.js:

async function main() {
  const Greeter = await ethers.getContractFactory("Greeter");
  const greeter = await Greeter.deploy("Hello from Orbion!");
  await greeter.deployed();
  console.log("Greeter deployed to:", greeter.address);
}
main()
  .then(() => process.exit(0))
  .catch((error) => {
    console.error(error);
    process.exit(1);
  });

Run the deployment script:

npx hardhat run scripts/deploy.js --network orbion

You should see the deployed contract address in your terminal.


๐Ÿง  5. Verify on Explorer (Optional)

Once deployed, you can verify your smart contract on the Orbion Explorer (supports ABI, source code, and constructor args).

Steps:

  1. Navigate to https://scantestnet.orbionchain.com

  2. Paste your contract address

  3. Select โ€œVerify Contractโ€

  4. Upload your source files or input constructor args manually

Verification ensures public transparency and allows anyone to interact via the web UI.


๐Ÿงช Tips for Testing on Orbion

  • Test estimateGas behavior under load โ€” Orbion uses dynamic fees

  • Retry failed txs with higher maxPriorityFeePerGas

  • Use npx hardhat verify if auto-verification is supported (coming soon)


๐Ÿ’ก Advanced: Foundry & Remix

Orbion also supports:

  • Foundry (via forge deploy & custom RPC)

  • Remix IDE (add network manually using Chain ID 9119)

  • Custom private RPCs or local node deployment for power users


Need to test staking, token logic, or upgradeable proxies? Orbion Testnet supports full simulation of validator interactions, gas accounting, and governance triggers โ€” just like mainnet.

PreviousHow to Connect with MetaMaskNextUsing the Testnet Faucet

Last updated 6 days ago

Use the to fund your deployer wallet

๐Ÿ”น
Faucet