Quickstart Development

Start building on the Nexus Layer 1 in minute

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:

1. Open your wallet

   Open your web3 wallet extension or app

2. Add a new network

   Use our network details to add the Nexus Chain

3. Start transacting

   Begin using the Nexus Chain for transactions

Network Information

Property	Value
Chain ID	3945
Native Token	Nexus Token (NEX)
RPC (HTTP)	https://testnet.rpc.nexus.xyz
RPC (WebSocket)	wss://testnet.rpc.nexus.xyz

Network Details

{
  "chainId": "3945",
  "rpcUrl": "https://testnet.rpc.nexus.xyz",
  "wsUrl": "wss://testnet.rpc.nexus.xyz",
  "explorerUrl": "https://nexus.testnet.blockscout.com"
}

Getting Started in Three Steps

1. Configure Your Development Environment

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

Hardhat Configuration

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

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

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

Testnet IIIExplorer

View transactions and contracts.

Testnet III Faucet

Get NEX to start building.

3. Deploy Your Smart Contract

Use your familiar deployment commands to deploy to Nexus:

Hardhat Deployment

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://nexus.testnet.blockscout.com/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

You’re all set! Start building on Nexus today using your existing Ethereum development knowledge and tools. For more detailed guides, check out our Developing your first app tutorial.