Quickstart Development

​

Welcome to the Nexus Layer 1

Nexus Layer 1 is designed to be familiar and accessible to Ethereum developers. If you’ve built on Ethereum before, you’re already equipped to build on Nexus. Our platform is fully EVM-compatible, which means you can use all your existing tools, libraries, and code without any modifications.

​

Why Build on Nexus?

• Familiar Development Environment: Use your existing Ethereum development setup without any changes
• Proven Tools: Leverage battle-tested Ethereum tools like Hardhat, Foundry, or Remix
• Standard Libraries: Work with your preferred libraries (ethers.js, web3.js, or viem)
• Zero Code Changes: Deploy your Solidity contracts as-is, no modifications needed

​

Network Configuration

​

Accessing Your Wallet

• Every Nexus user automatically receives an Ethereum wallet
• You can also use any existing Ethereum wallet (like MetaMask)
• Your ETH address works seamlessly on the Nexus Chain

​

Network Connection

To connect your wallet to the Nexus Chain:

​

Network Information

{
  "chainId": "393",
  "rpcUrl": "https://rpc.nexus.xyz/http",
  "wsUrl": "wss://rpc.nexus.xyz/ws",
  "explorerUrl": "https://explorer.nexus.xyz"
}

​

Getting Started in Three Steps

​

1. Configure Your Development Environment

Add Nexus Layer 1 to your existing development setup with these simple configurations:

// hardhat.config.ts
require("dotenv").config();
require("@nomicfoundation/hardhat-verify");

module.exports = {
  networks: {
    nexus: {
      url: "https://rpc.nexus.xyz/http",
      chainId: 393,
      accounts: [process.env.PRIVATE_KEY]
    }
  },
  etherscan: {
    apiKey: {
      nexus: process.env.ETHERSCAN_API_KEY
    },
    customChains: [
      {
        network: "nexus",
        chainId: 393,
        urls: {
          apiURL: "https://explorer.nexus.xyz/api",
          browserURL: "https://explorer.nexus.xyz"
        }
      }
    ]
  }
}

To enable contract verification, you’ll need to:

1. Install the verification plugin:

npm install --save-dev @nomicfoundation/hardhat-verify

2. Create a .env file with your credentials:

PRIVATE_KEY=your_private_key_here
ETHERSCAN_API_KEY=your_etherscan_key_here

​

2. Explore the blockchain and receive NEX from the faucet

​

3. Deploy Your Smart Contract

Use your familiar deployment commands to deploy to Nexus:

npx hardhat deploy --network nexus

Note: For Hardhat deployments, you’ll need to create a deployment script in the scripts/ directory. See our Developing your first app guide for a complete example.

​

4. Verify Your Contract on Explorer

After deploying your contract, you can verify it to make your contract’s source code publicly available and build trust with users.

You have two options for verification:

Option 1: Via Terminal

npx hardhat verify --network nexus <CONTRACT_ADDRESS> [constructor arguments...]

Option 2: Via Web Interface
Visit: https://explorer.nexus.xyz/contract-verification

Note: Make sure you’ve completed the verification setup steps above, including:

• Installing the verification plugin
• Setting up your API key
• Configuring your hardhat.config.js