Hackathon Guidebook.

Welcome to the Build Week Hackathon! The goal is simple: Build something real. Deploy it. Let people use it.

Timeline

Rules & Eligibility

• Team Size: 1 - 3 people. You can go solo or form a team.
• Chain: BOT Chain (EVM). All smart contracts must be deployed on the BOT Chain testnet/mainnet.
• Cost: 100% Free.
• AI Tools: Allowed! Claude, ChatGPT, Cursor — use whatever helps. Paste error messages and ask for fixes. Vibe code the whole thing if you want. The only requirement is that it works and you can explain what it does in your demo.

What You Are Building

A DApp (Decentralized Application) in plain language has two parts that work together:

• Smart Contract: The rules of who can do what. It holds BOT or data on-chain. Written in Solidity. Deployed once via Remix IDE. It cannot be faked or changed.
• Frontend (Website): The page people see and use. Buttons, layout, your design. One HTML file is enough! Hosted on GitHub Pages and served from your own live domain (a cheap $1 – $1.50 one is fine — we reimburse it), and it connects to MetaMask.

Project Ideas

Pick an idea from either track below and build it well — or come up with your own!

AI Track

RWA Track

Submission Requirements

Submit all four items via the submission form by 11:59 PM on September 23 (GMT+7 / Asia/Bangkok Time). If any item is missing your project will not be judged. No late submissions accepted.

1. Contract Address: Your deployed smart contract address on BOT Chain. Example: 0xAbC123... Judges will check it on the block explorer to confirm it is real and has on-chain activity.
2. Live Website Link: Your project must run on a live domain — it doesn't have to be a .com, any live domain works. Choose one in the $1 – $1.50 range (plenty of registrars offer first-year domains this cheap), and we'll reimburse your purchase once you've submitted. Judges will open this link and try to connect their wallet and interact with your project during evaluation.
3. GitHub Repository: Must contain your .sol contract file and a README.md written in plain English explaining what your project does and how someone would use it. In your README, add a "Deployment" section where you write your BOT Chain testnet contract address and mainnet contract address for us to check.
4. X Post: Create an X account dedicated to your project, then post and share your project on X and tag @BOTChain_ai. Show what you built — a short clip or screenshots of your live page work great. Paste the link to your post in the submission form.

What We Look For

You do not need a perfect project. One feature done well beats five features that are broken. Judges open your link and try to use it — if the main action works, you are in good shape.

Judging Criteria

Day 1 Guide — Step by Step

The full guide: from MetaMask to BOT Chain Mainnet smart contract deployment — a complete, general-purpose walkthrough to go from zero to a deployed smart contract on BOT Chain Mainnet.

Phase 1 — Install & Set Up MetaMask

Step 1: Install a Wallet

• MetaMask: go to metamask.io → Click "Download" → choose your browser (Chrome, Firefox, Brave, Edge) → "Add to Chrome" (or your browser) → "Add Extension"
• The wallet icon will appear in your browser toolbar

Step 2: Create a New Wallet

1. Click the wallet icon → "Get Started"
2. Choose "Create a new wallet"
3. Agree to the terms
4. Create a strong password (used to unlock the app locally)
5. CRITICAL — Write down your Secret Recovery Phrase (12 words) on paper
   • Never store it digitally
   • Never share it with anyone
   • This is the only way to recover your wallet
6. Confirm the phrase by selecting words in order → Click "Confirm"
7. Your wallet is now created

Phase 2 — Add BOT Chain Testnet

Step 3: Add BOT Chain Testnet Manually

We test on testnet first before spending real BOT on mainnet.

1. Open MetaMask → Click the network dropdown (top left)
2. Click "Add a network" → "Add a network manually"
3. Fill in these details:

Click "Save" → Switch to BOT Chain Testnet.

Phase 3 — Get Testnet BOT (Faucet)

Step 4: Get Free Testnet BOT

You need BOT to pay for gas (transaction fees), even on testnet.

1. Copy your wallet address from MetaMask (click your account name at the top)
2. Go to the official BOT Chain testnet faucet: faucet.botchain.ai/basic
3. Paste your wallet address → request test BOT
4. Wait 1–2 minutes → Check your wallet balance

Phase 4 — Write Your Smart Contract in Remix

Tip: You can use AI or vibe-code for this one — it will help you throughout your project building.

Step 5: Open Remix IDE

Go to remix.ethereum.org — since BOT Chain is EVM-compatible, Remix works exactly as it does for Ethereum.

Step 6: Create Your Contract File

1. In the file explorer, click the "+" icon to create a new file
2. Name it something like MyCertificate.sol
3. Write your Solidity smart contract. Example:

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

contract MyCertificate {
    address public owner;

    struct Certificate {
        string recipientName;
        string courseName;
        uint256 issueDate;
        bool isValid;
    }

    mapping(bytes32 => Certificate) public certificates;

    event CertificateIssued(bytes32 indexed certId, string recipientName);

    constructor() {
        owner = msg.sender;
    }

    modifier onlyOwner() {
        require(msg.sender == owner, "Not the owner");
        _;
    }

    function issueCertificate(
        bytes32 certId,
        string memory recipientName,
        string memory courseName
    ) public onlyOwner {
        certificates[certId] = Certificate(
            recipientName,
            courseName,
            block.timestamp,
            true
        );
        emit CertificateIssued(certId, recipientName);
    }

    function verifyCertificate(bytes32 certId) public view returns (bool) {
        return certificates[certId].isValid;
    }
}

Step 7: Compile the Contract

1. Click the "Solidity Compiler" icon (left sidebar — looks like <S>)
2. Select compiler version matching your pragma (e.g., 0.8.20)
3. Click "Compile MyCertificate.sol"
   • Green checkmark = compiled successfully
   • Red = fix the errors shown below

Phase 5 — Deploy to BOT Chain Testnet

Step 8: Connect Remix to Your Wallet

1. Click the "Deploy & Run Transactions" icon (left sidebar)
2. Under "Environment", select "Injected Provider - MetaMask"
3. Your wallet will pop up → Click "Connect" → Select your account → "Next" → "Connect"
4. You should see your wallet address and testnet BOT balance in Remix

Step 9: Deploy to BOT Chain Testnet

1. Make sure BOT Chain Testnet (Chain ID 968) is selected in your wallet
2. In Remix, under "Contract", select your compiled contract
3. Click the orange "Deploy" button
4. Your wallet will pop up showing the transaction → Review gas fees (paid in BOT) → Click "Confirm"
5. Wait for confirmation
6. Your contract address appears in Remix under "Deployed Contracts"

Step 10: Verify on Testnet Explorer

1. Copy the deployed contract address from Remix
2. Go to scan.bohr.life
3. Paste the address in the search bar
4. You'll see your contract transaction

Phase 6 — Prepare for Mainnet

Step 11: Add BOT Chain Mainnet

1. In your wallet, click the network dropdown → "Add a network manually"
2. Fill in these details:

Switch to BOT Chain Mainnet — your balance will show (starts at 0 if new).

Step 12: Get Real BOT for Mainnet

You need real BOT to pay gas fees on mainnet. Contact the organizer for a BOT allocation to cover your gas fees.

Wait for confirmation, then check your wallet — your BOT balance should appear.

Phase 7 — Deploy to Mainnet

Step 13: Connect Remix to Mainnet Wallet

1. Make sure your wallet is on BOT Chain Mainnet
2. In Remix, go to "Deploy & Run Transactions"
3. Environment = "Injected Provider - MetaMask"
4. Confirm the network shows BOT Chain Mainnet and your real BOT balance

Step 14: Deploy Contract to Mainnet

1. In Remix, select your compiled contract
2. Click "Deploy"
3. Your wallet pops up — carefully review:
   • The contract being deployed
   • Gas fee (in BOT)
   • Total cost
4. If everything looks correct → Click "Confirm"
5. Wait for the transaction to be mined
6. Contract address appears in Remix

Step 15: Verify on BOTScan (Mainnet)

1. Copy your deployed contract address
2. Go to scan.botchain.ai
3. Paste the address → You'll see your live contract

Phase 8 — Post-Deployment

Step 16: Get a Cheap Domain and Go Live

Your final submission needs to run on a live domain — it doesn't have to be a .com, any live domain works. Buy one in the $1 – $1.50 range, then point it at your GitHub Pages site (repo → Settings → Pages → Custom domain, adding the DNS records your registrar shows). Keep your purchase receipt: we reimburse it once you've submitted.

Quick Reference Checklist

Setup

• MetaMask installed
• Wallet created + seed phrase backed up
• BOT Chain Testnet added (Chain ID 968)

Testnet

• Got testnet BOT from faucet.botchain.ai/basic
• Contract written in Remix
• Contract compiled (no errors)
• Contract deployed to BOT Chain Testnet
• All functions tested on testnet

Mainnet Prep

• BOT Chain Mainnet added (Chain ID 677)
• Contacted organizer for BOT allocation to cover gas fees
• Real BOT in wallet (via organizer allocation or B DEX, enough for gas)
• Contract code double-checked

Mainnet Deploy

• Contract deployed to BOT Chain Mainnet
• Contract visible on scan.botchain.ai
• Contract address saved

Network Reference

Sourced from the official BOT Chain Developer Docs.