deploy a smart contract

Moonbeam is EVM-compatible, so contracts deploy with the standard Solidity toolchain — Foundry, Hardhat, or Remix — pointed at a GetBlock endpoint. This guide covers adding the network to a wallet and deploying a first contract to Moonbeam.

Prerequisites

• Node.js 18+ and a package manager, or Foundry

• An EVM wallet (such as MetaMask) with GLMR on Moonbeam for gas — see Add Network to Your Wallet and Funding Your Deployer

• A GetBlock access token — the endpoint is https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

• A funded deployer address with GLMR on Moonbeam

Network Details

Property	Value
Network Name	Moonbeam
RPC URL	https://shared.eu-central-1.getblock.io//
Chain ID	1284 (0x504)
Currency Symbol	GLMR
Block Explorer	moonbeam.moonscan.io

Add Network to Your Wallet

Ethereum Mainnet is pre-configured in MetaMask by default. Moonbeam is not, so it must be added manually — use the button below or the manual steps that follow.

The button uses the EIP-3085 wallet_addEthereumChain request. Review the parameters before approving in your wallet.

add-network-to-metamask.html

<button
    style="background: #6b7280; color: white; border: 0; padding: 10px 20px; border-radius: 6px; cursor: pointer; font-weight: 600;"
    onclick="addNetwork('0x504', 'Moonbeam', 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', 'https://moonbeam.moonscan.io')">
    Add Moonbeam
</button>

<script>
async function addNetwork(chainIdHex, chainName, rpcUrl, explorerUrl) {
  if (typeof window.ethereum === 'undefined') {
    alert('No EVM wallet detected. Install MetaMask or a compatible EIP-3085 wallet first.');
    return;
  }
  try {
    await window.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [{
        chainId: chainIdHex,
        chainName: chainName,
        rpcUrls: [rpcUrl],
        nativeCurrency: { name: 'Glimmer', symbol: 'GLMR', decimals: 18 },
        blockExplorerUrls: [explorerUrl]
      }]
    });
  } catch (err) {
    console.error('Failed to add network:', err);
    alert('Failed to add network: ' + (err.message || err));
  }
}
</script>

To add the network manually:

1

Open your wallet

Open MetaMask (or your EVM wallet of choice).

2

Add a custom network

Open the network selector and choose Add a custom network.

3

Enter network details

Enter the values from the Network Details table above.

4

Confirm the Chain ID

Confirm the Chain ID resolves to 1284.

5

Save and switch networks

Save and switch to the newly added Moonbeam network.

Funding Your Deployer

Moonbeam gas is paid in GLMR.

• Mainnet — acquire GLMR from an exchange or bridge, then send it to your deployer's address.

• Testnet (Moonbase Alpha, chain ID 1287) — request free DEV tokens from the Moonbase Alpha faucet; see docs.moonbeam.network for the current faucet and endpoints.

Deploy with Foundry

1

Install Foundry and initialize

curl -L https://foundry.paradigm.xyz | bash
foundryup
forge init hello-moonbeam && cd hello-moonbeam

2

Write the contract

src/Hello.sol

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

contract Hello {
    string public greeting = "Hello, Moonbeam";

    function setGreeting(string calldata greeting_) external {
        greeting = greeting_;
    }
}

3

Deploy

export MOONBEAM_RPC_URL=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/
export PRIVATE_KEY=0xyour_deployer_private_key

forge create src/Hello.sol:Hello \
  --rpc-url $MOONBEAM_RPC_URL \
  --private-key $PRIVATE_KEY \
  --broadcast

4

Verify on the block explorer

Moonbeam uses a Moonscan (Etherscan-compatible) explorer:

forge verify-contract <DEPLOYED_ADDRESS> src/Hello.sol:Hello \
  --chain-id 1284 \
  --verifier etherscan \
  --verifier-url https://api-moonbeam.moonscan.io/api \
  --etherscan-api-key <MOONSCAN_API_KEY>

Deploy with Hardhat

1

Create the project

mkdir hello-moonbeam && cd hello-moonbeam
npm init --yes
npm install --save-dev hardhat
npx hardhat init

2

Configure the network

hardhat.config.js

require('@nomicfoundation/hardhat-toolbox');

const MOONBEAM_CHAIN_ID = 1284;

module.exports = {
  solidity: '0.8.24',
  networks: {
    moonbeam: {
      url: process.env.MOONBEAM_RPC_URL,
      chainId: MOONBEAM_CHAIN_ID,
      accounts: [process.env.PRIVATE_KEY]
    }
  },
  etherscan: {
    apiKey: { moonbeam: process.env.MOONSCAN_API_KEY },
    customChains: [
      {
        network: 'moonbeam',
        chainId: MOONBEAM_CHAIN_ID,
        urls: {
          apiURL: 'https://api-moonbeam.moonscan.io/api',
          browserURL: 'https://moonbeam.moonscan.io'
        }
      }
    ]
  }
};

3

Write the contract

contracts/Hello.sol

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

contract Hello {
    string public greeting = "Hello, Moonbeam";

    function setGreeting(string calldata greeting_) external {
        greeting = greeting_;
    }
}

4

Deploy

export MOONBEAM_RPC_URL=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/
export PRIVATE_KEY=0xyour_deployer_private_key

npx hardhat ignition deploy ./ignition/modules/Hello.js --network moonbeam

5

Verify on the block explorer

export MOONSCAN_API_KEY=your_moonscan_api_key
npx hardhat verify --network moonbeam <DEPLOYED_ADDRESS>

Moonbeam exposes Substrate features (staking, XCM, batching, native-asset ERC-20s) to Solidity through precompiles at fixed addresses in the 0x0000...08xx range. See the Moonbeam documentation for each precompile's address and interface.

After Deploying

• Read contract state through the eth_call method against your GetBlock endpoint

• Watch contract events with eth_getLogs

• Explore Moonbeam's precompiles to call staking, XCM, and batch operations from your contracts