MonadHackerthon — Monadハッカソン向けMVP（Web3 Treasure Hunt）

概要

MonadHackerthonは、Web3トレジャーハント（宝探し）をテーマにしたハッカソン向けMVPです。プロジェクトは「contracts（スマートコントラクト）」「backend（AIサービス）」「frontend（Web UI）」の3つのコアコンポーネントで構成され、Solidityで実装されたTreasureMapコントラクトにより宝の作成・ロック・解読といったゲームロジックを管理します。バックエンドはPythonベースでOpenAIなどのAIを使い、パズルの生成やヒントの提供、解読ロジックを補助します。.env.exampleにAPIキーや秘密鍵のテンプレートがあり、ローカルでの開発・デプロイ手順を想定した設計です。

リポジトリの統計情報

スター数: 3
フォーク数: 1
ウォッチャー数: 3
コミット数: 14
ファイル数: 6
メインの言語: Python

主な特徴

SolidityベースのTreasureMapスマートコントラクトで宝の作成・ロック・解読のコアロジックを実装
PythonバックエンドがOpenAIなどのAIサービスと連携してヒント生成や解読支援を提供
フロントエンドでウォレット連携（署名/トランザクション）を前提としたユーザーインターフェースを想定
.env.exampleに必要なAPIキー/秘密鍵のテンプレートを含み、ローカルでの開発が容易

技術的なポイント

リポジトリは典型的なWeb3ハッカソンMVPの設計思想を体現しており、スマートコントラクト層・サーバー層・クライアント層が明確に分離されています。contracts配下にはTreasureMap.solがあり、宝の作成、ロック（アクセス制御）、解読（復号や条件達成）などのオンチェーンロジックを担います。Solidityのインターフェースを分離しているため拡張性が高く、HardhatやFoundryといったツールチェーンでローカルテストやデプロイが想定されています。backendはPythonで実装され、.env.exampleにOpenAIキーやウォレットの秘密鍵などを置く設計から、AIを使った動的ヒント生成や自然言語を介した解読支援、オンチェーンとオフチェーンの橋渡しを行います。具体的には、ユーザーの入力やゲーム状態を受けてAIがヒントやパズル文を生成し、その結果をフロントエンド経由でユーザーに提示、必要に応じてスマートコントラクトの呼び出し（署名付きトランザクション）へとつなげます。セキュリティ面では秘密鍵の管理をローカル環境変数に依存しており、実運用ではより堅牢なシークレット管理や鍵管理（KMSやハードウェアウォレット）の採用が望まれます。全体としては、プロトタイプとして迅速に検証できる構成であり、AIとWeb3を組み合わせたゲーム化ユースケースの実装例として参考になります。

プロジェクトの構成

主要なファイルとディレクトリ：

.env.example: file
.gitignore: file
README.md: file
backend: dir
contracts: dir

…他 1 ファイル

（READMEからの抜粋構成） web3-treasure-hunt/ ├── README.md # プロジェクト説明 ├── .gitignore # グローバル ignore ├── .env.example # 環境変数テンプレート（OpenAI Key、秘密鍵等） ├── contracts/ # スマートコントラクト（Solidity & Hardhat/Foundry） │ ├── contracts/ │ │ ├── TreasureMap.sol # コアビジネスロジック（作成・解錠・解読） │ │ ├── interfaces/ │ │ │ └── IX402.sol # インターフェース例 ├── backend/ # AIサービスやAPIを担うPythonコード ├── frontend/ # Web UI（リポジトリ内に存在すると想定）

まとめ

AIとスマートコントラクトを組み合わせた実践的なMVPで、ハッカソンのプロトタイプとして非常に有用。

リポジトリ情報：

名前: MonadHackerthon
説明: MVP for Monad Hackerthon
スター数: 3
言語: Python
URL: https://github.com/sjhana/MonadHackerthon
オーナー: sjhana
アバター: https://avatars.githubusercontent.com/u/160087617?v=4