3.2 Launching Your First Project

GRX Chain is EVM-compatible, low-fee, and built for scale—so you can deploy dApps and smart contracts quickly, then iterate with confidence. We strongly recommend starting on Testnet to rehearse deployments, validate flows, and catch issues before Mainnet.

Before you start

Consolidated network & tools

Mainnet

• RPC: https://rpc.grxchain.io

• Chain ID: 1110 (0x456)

• Symbol: GRX

• Explorer: https://grxscan.io

Testnet

• RPC: https://testnet.grxchain.io

• Chain ID: 2507 (0x9CB)

• Symbol: tGRX

• Explorer: https://testnet.grxscan.io

• Faucet: https://faucet.grxchain.io

Bridging (official, current): https://grovex.io

Canonical core contracts (Mainnet)

• WGRX (ERC-20): 0x45C7287F897B3A79Cd3f6e4F14B4CE568f023bD5 (18 decimals)

• Multicall: 0x2cd9E100Ca0d883A00eC8Ce635EbD4C17508FE3B

• GRXswap (DEX): https://grxswap.io

  • Factory: 0xc7316818841f355c5107753A3f3FDEA799BD25f6

  • Router v2: 0x28fC93b8a20570f2B59d5CA9f8a1dA02C4DBcDF5

  • Pair Init Code Hash: 0xb23d9a8f0a03ecd8f95e43ab1025c71bb79f1cb7128d40546417bfb4b2a74d9c

• Pegged assets (examples):

  • USDT: 0x173462F5eb7CA0D1ab6aaea846fEFe85A28029E2

  • BTC (pegged): 0x2F4632ABAd26A1FF9212a76597fb3c3d8539E275

  • ETH (pegged): 0x02D129c8A26839c814925eE0f1D320F63114E1FE

Safety: Always verify addresses on GRXscan and the Official Channels page before interacting.

Prerequisites

• Gas token: GRX in your wallet for fees (use Testnet faucet for test GRX).

• Tooling: Remix or Hardhat/Truffle + ethers.js/web3.js.

• Contracts: Solidity sources ready; prefer ERC-20/721/1155 standards where possible.

Key steps for deployment

1) Prepare your contracts

• Pin the Solidity compiler (e.g., 0.8.x exact).

• Add tests; run static analysis and (optionally) fuzzing.

2) Connect to GRX Chain

Hardhat config (example):

// hardhat.config.js
export default {
  solidity: "0.8.24",
  networks: {
    grx: { url: "https://rpc.grxchain.io", chainId: 1110, accounts: [process.env.PRIVATE_KEY].filter(Boolean) },
    grxTestnet: { url: "https://testnet.grxchain.io", chainId: 2507, accounts: [process.env.PRIVATE_KEY].filter(Boolean) }
  }
}

Remix: Deploy & Run → Environment: “Injected Provider” (MetaMask) → Select GRX/Testnet → set constructor params → Deploy.

3) Deploy

• Testnet first: run migration scripts; exercise all functions.

• Mainnet: when ready, deploy; GRX’s ultra-low fees keep even multi-contract deploys affordable.

4) Verify on GRXscan

• Verify each contract on grxscan.io (exact compiler + constructor args).

• Link verified addresses in your release notes/changelog.

5) Wire up your frontend

import { ethers } from "ethers";
const provider = new ethers.JsonRpcProvider("https://rpc.grxchain.io");
const contract = new ethers.Contract("<ADDRESS>", <ABI>, provider);
// For writes: obtain a signer from the user's wallet in your app.

Tip: For ERC-20 flows (approvals, swaps), use WGRX and pair against pegged assets on GRXswap.

---

One-Click “Add GRX Network” (MetaMask/Wallet)

<button id="add-grx">Add GRX Mainnet</button>
<script>
  document.getElementById('add-grx').onclick = async () => {
    if (!window.ethereum) return alert('Please install MetaMask or a compatible wallet.');
    try {
      await window.ethereum.request({
        method: 'wallet_addEthereumChain',
        params: [{
          chainId: '0x456', // 1110
          chainName: 'GRX Chain',
          nativeCurrency: { name: 'GRX', symbol: 'GRX', decimals: 18 },
          rpcUrls: ['https://rpc.grxchain.io'],
          blockExplorerUrls: ['https://grxscan.io']
        }]
      });
    } catch (e) { console.error(e); alert('Unable to add network.'); }
  };
</script>

MetaMask Chain Params (JSON)

Mainnet

{
  "chainId": "0x456",
  "chainName": "GRX Chain",
  "nativeCurrency": { "name": "GRX", "symbol": "GRX", "decimals": 18 },
  "rpcUrls": ["https://rpc.grxchain.io"],
  "blockExplorerUrls": ["https://grxscan.io"]
}

Testnet

{
  "chainId": "0x9CB",
  "chainName": "GRX Chain Testnet",
  "nativeCurrency": { "name": "tGRX", "symbol": "tGRX", "decimals": 18 },
  "rpcUrls": ["https://testnet.grxchain.io"],
  "blockExplorerUrls": ["https://testnet.grxscan.io"]
}

Token listing (frontend) — WGRX defaults

• Address: 0x45C7287F897B3A79Cd3f6e4F14B4CE568f023bD5

• Symbol/Decimals: WGRX / 18 Always pull decimals from chain at runtime and verify on GRXscan.

.env & .gitignore (prevent key leaks)

.env.example

PRIVATE_KEY=
GRX_RPC=https://rpc.grxchain.io
GRX_TESTNET_RPC=https://testnet.grxchain.io
GRXSCAN_API_KEY=

.gitignore

.env
.env.*
*.secret

Verification quick guide (GRXscan)

1. Build with the exact compiler version used at deploy.

2. Provide multi-file sources or a flattened file per GRXscan form.

3. Include constructor args and optimisation settings.

4. Verify libraries at the same addresses used at deploy.

5. Link the verified address in your release notes/changelog.

Frontend connect snippet (ethers v6)

import { ethers } from "ethers";

export async function getSigner() {
  if (!window.ethereum) throw new Error('Wallet not found');
  await window.ethereum.request({ method: 'eth_requestAccounts' });
  const provider = new ethers.BrowserProvider(window.ethereum);
  const signer = await provider.getSigner();
  return { provider, signer };
}

Best practices (quick checklist)

Before mainnet

• Tests pass (unit/integration); gas snapshots within budget

• Static analysis/fuzzing clean or reviewed

• Dry-run on Testnet; addresses recorded

• Multisig & timelock ready for admin/upgrade roles

• Audit completed or scheduled; critical issues resolved

Launch day

• Deploy & verify on GRXscan

• Transfer admin to multisig; timelock sensitive actions

• Publish: addresses, ABI links, audit report, known risks

• Set up dashboards & alerts (reverts, gas, role changes, liquidity)

Post-launch

• Monthly key/signer checks; quarterly dependency review

• Incident runbook pinned; postmortems published if needed

• Community AMA/office hours recap posted

Troubleshooting (fast fixes)

• Network not added: Manually add RPC/Chain ID 1110 (Mainnet) or 2507 (Testnet).

• Out of gas / high gas: Query eth_gasPrice, add a buffer; avoid unbounded loops.

• Token not visible: Import by contract address (don’t rely on name search).

• Verification failed: Compiler or constructor args mismatch—rebuild with exact config.

• Swaps failing: Confirm Router address, allowances, and path; inspect reverts on GRXscan.

Support matrix & turnaround

• Docs/email: [email protected] — initial acknowledgement within 2 business days (AET).

• Integration help: best-effort scheduling for qualified ecosystem projects.

• Security reports: follow Security & Privacy → Responsible Disclosure.

Governance & program hooks (reminders)

• Proposals: https://proposal.grxchain.io (idea → RFC → on-chain vote → timelock)

• Staking/validators: https://staking.grxchain.io

• Listings/co-marketing: email [email protected] with deck + repo + testnet demo

Bridging note (safety)

• Official bridge (current): https://grovex.io Do not endorse third-party bridges unless announced in Official Channels.

Legal & safety footers

• Documentation is informational, not financial or legal advice.

• Verify all addresses on GRXscan; never share seed phrases or private keys.

• © GRXCHAIN Inc. (BVI). GRX Chain is owned/operated by GRXCHAIN Inc. (BVI). GroveX is operated by GroveX Pty Ltd (AU).