🌾 FlutterFarm - Blockchain Farming Game

FlutterFarm은 FlutterDev Chain에서 실행되는 블록체인 기반 농장 시뮬레이션 게임입니다.

✨ 주요 기능

• 가스리스 트랜잭션 - 가스비 없이 플레이
• 100 FARM 에어드랍 - 신규 플레이어 환영 보너스
• 작물 재배 - 작물을 키워 FARM 토큰 획득
• 온체인 게임 상태 - 모든 진행상황이 블록체인에 저장

🔗 링크

서비스	URL
게임	game.flutterdev.online
지갑	wallet.flutterdev.online
익스플로러	scan.flutterdev.online

---

🏗️ 시스템 아키텍처

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   Frontend      │     │   Gas Relay     │     │   Blockchain    │
│   (Next.js)     │────▶│   (Express)     │────▶│   (FlutterDev)  │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                                               │
        │                                               ▼
        │                                       ┌───────────────┐
        │                                       │  FarmGame.sol │
        │                                       │  FARM Token   │
        │                                       │  GameItems    │
        │                                       └───────────────┘
        │
        ▼
┌─────────────────┐
│   Backend API   │
│   (Express)     │
└─────────────────┘

컴포넌트

컴포넌트	경로	설명	기술
Smart Contracts	contracts/	FarmGame, FARM Token, GameItems NFT	Solidity, Hardhat
Frontend	frontend/	Next.js 게임 인터페이스	Next.js, TypeScript
Backend API	backend/	오프체인 기능 서버	Node.js, Express
Gas Relay	faucet/	가스리스 트랜잭션 릴레이	Node.js, ethers.js

---

📜 스마트 컨트랙트

배포된 컨트랙트

이름	주소	설명
FarmGame	0xd1Fbb0C9403705094d6FBE9007C35c0f811AE93B	메인 게임 로직
FARM Token	0xe5a8F6fF531734be23DF8CaCB63aF154730EF777	ERC20 보상 토큰
GameItems	0x8708A7399BAb2D118619372349747E4bc1d7aac3	ERC1155 NFT 아이템

주요 함수

// 농장 생성 (100 FARM 에어드랍)
createFarm()

// 작물 심기
plant(uint256 plotIndex, uint8 cropType)

// 물 주기 (성장 가속)
water(uint256 plotIndex)

// 수확
harvest(uint256 plotIndex)
harvestAll()

// 보상 청구
claimRewards()

// 농장 확장
buyPlot()

작물 종류

이모지	이름	ID	성장시간	보상
🌾	Wheat	1	2분	10 FARM
🥕	Carrot	2	5분	25 FARM
🍅	Tomato	3	10분	50 FARM
🌽	Corn	4	15분	100 FARM

---

🎮 게임 플레이

시작하기

1. 지갑 연결 - FlutterWallet로 연결
2. 농장 생성 - "Create Farm" 버튼 클릭
3. 에어드랍 수령 - 자동으로 100 FARM 지급 🎁

농사짓기

1. 🛒 Shop 클릭 → 작물 선택
2. 빈 땅 (🟫) 클릭 → 작물 심기
3. 자라는 작물 클릭 → 물 주기 💧
4. 다 자란 작물 클릭 → 수확 🌾

보상 받기

1. 수확할 때마다 pending rewards에 추가
2. "Claim" 버튼 클릭 → FARM 토큰 수령
3. 지갑에서 FARM 잔액 확인

UI 버튼 가이드

버튼	기능
🎒	인벤토리 보기
🛒	작물 선택 (Shop)
🏦	스테이킹
⚒️	업그레이드
🎁	가챠
🏪	마켓플레이스
💬	소셜
❓	도움말
🚪	로그아웃

---

⚙️ 가스리스 시스템

FlutterFarm은 Gas Relay를 통해 가스비 없이 플레이할 수 있습니다.

작동 방식

1. 사용자가 트랜잭션 서명
2. 프론트엔드 → Gas Relay로 전송
3. Gas Relay가 서명 검증
4. createFarm() → createFarmFor(player) 변환
5. Relay 지갑이 가스비 대납하여 실행

Relay 서버

• URL: https://faucet.flutterdev.online/api/relay
• 지원 함수: createFarm, plant, water, harvest, claimRewards

---

📊 이벤트

컨트랙트에서 발생하는 이벤트:

event FarmCreated(address indexed player);
event WelcomeAirdrop(address indexed player, uint256 amount);
event CropPlanted(address indexed player, uint256 indexed plotIndex, uint8 cropType);
event CropWatered(address indexed player, uint256 indexed plotIndex);
event CropHarvested(address indexed player, uint256 indexed plotIndex, uint256 reward);
event RewardsClaimed(address indexed player, uint256 amount);
event PlotPurchased(address indexed player, uint8 newPlotCount);

---

🛠️ 개발 참고

프론트엔드 주요 파일

파일	설명
frontend/components/GameCanvas.tsx	메인 게임 UI
frontend/config/contracts.ts	컨트랙트 주소 및 ABI
frontend/context/WalletContext.tsx	지갑 상태 관리
frontend/lib/wallet-connector.ts	FlutterWallet 연동

컨트랙트 파일

파일	설명
contracts/contracts/FarmGame.sol	메인 게임 컨트랙트
contracts/contracts/FarmToken.sol	FARM ERC20 토큰
contracts/contracts/GameItems.sol	ERC1155 아이템 NFT

Docker 배포

# 프론트엔드 빌드 및 재시작
npm run build
docker restart farm-frontend