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

1

Connect your wallet

Open your web3 wallet extension or app.

2

Add a new network

Use the Nexus network details to add the Nexus Chain to your wallet.

3

Start transacting

Begin using the Nexus Chain for transactions.

Network Information

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

Network Details (JSON)

{
  "chainId": "3940",
  "rpcUrl": "https://testnet3.rpc.nexus.xyz",
  "wsUrl": "wss://testnet3.rpc.nexus.xyz",
  "explorerUrl": "https://testnet3.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 configuration:

hardhat.config.ts

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

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

To enable contract verification, you’ll need to:

• Install the verification plugin:

Install verification plugin

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

• Create a .env file with your credentials:

.env

PRIVATE_KEY=your_private_key_here
ETHERSCAN_API_KEY=your_etherscan_key_here

2

Explore the blockchain and receive NEX from the faucet

• Explorer: https://testnet3.explorer.nexus.xyz/

• Faucet: https://faucets.alchemy.com/faucets/nexus-testnet

3

Deploy Your Smart Contract

Use your familiar deployment commands to deploy to Nexus.

Hardhat deployment example:

Deploy with Hardhat

npx hardhat deploy --network nexus

Note: For Hardhat deployments, you’ll need to create a deployment script in the scripts/ directory. See the Developing your first app guide for a complete example: https://docs.nexus.xyz/layer-1/developer/deploy-for-beginners

4

Verify Your Contract on Explorer

After deploying your contract, you can verify it so the source code is publicly available.

Option 1: Via Terminal

Verify via Hardhat

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

Option 2: Via Web Interface

Visit: https://testnet3.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

For more detailed guides, check out: https://docs.nexus.xyz/layer-1/developer/deploy-for-beginners

---

Related pages:

• Marching towards Mainnet: https://docs.nexus.xyz/layer-1/testnet/testnet-transition

• Developing your first app: https://docs.nexus.xyz/layer-1/developer/deploy-for-beginners