DeFi Garden

🌱 DeFi Garden

穏やかで誠実なDeFi利回りの発見と、目標に基づく貯蓄計画。

DeFi Gardenは、DefiLlama yields APIを基盤とする、静的でバックエンドもビルド工程も不要なWebアプリケーションです。投機的な宣伝よりも信頼性、現実的な予測、数学的な透明性を重視する慎重な貯蓄者やDeFi運用者向けに設計されています。

---

🌟 DeFi Gardenの2つの主要な機能

DeFi Gardenは、インラインのフラッシュのないIAルーター（home.html内のwindow.__APP_MODE）を通じて、2種類のワークフローを提供します。

1. 🪴 ガーデンプランナー（デフォルトの体験 — / と plan.html）

• 目標優先の対話型貯蓄計画： 抽象的なAPYの数値を追うのではなく、実生活の目標（サブスクリプション、ガジェット、人生の節目）を軸に貯蓄を計画します。
• 利回りで資金を賄うパラダイム： 「買い切りにするとお金はなくなります。ガーデンで運用すれば、お金を手元に残したまま、欲しいものも手に入ります。」
• 複合利回り率： 継続的なライブ利回りで定期的な支出を自動的に賄うために必要な資本を、誠実な「永続運用の数値」として算出します。
• DeFi投機への誠実さ： 変動するファーム／報酬の排出に必ず⅓の減衰分を差し引き、現実的な長期収益を基に計画できるようにします。

2. 📊 分析と利回りの発見（/?token=、/?chain=、/?pool=、/?app=1）

• マルチチェーンプールエクスプローラー： 50以上のブロックチェーン（Ethereum、Arbitrum、Base、Hyperliquid、Solanaなど）と、主要なプロトコル種別（レンディング、ステーキング、LP／DEX、イールドファーミング）全体の利回りをリアルタイムで監視します。
• プールの詳細分析（PoolDetail.js）： プールの詳細な分析、30日間の平均APY追跡、ベース利回りと報酬排出の分離、インパーマネントロスのリスク指標を提供します。
• 資金調達利回り獲得モジュール（/hype-harvest.html ／ /?module=hype-harvest）： Hyperliquidの無期限先物向けデルタニュートラルなキャッシュ・アンド・キャリー資金調達利回り計算ツールです。ライブのベーシススプレッド追跡と、2つのオラクル間の乖離に対するトリップワイヤーを備えています。

---

🛡️ 信頼性の基盤（中核となる優位性）

DeFi Gardenに表示されるすべての指標は、厳格で譲れない信頼性の基盤を通じて、オンチェーンおよびAPIのライブデータから取得されます。

1. APY_SANITY_LIMIT = 1000%： 異常な短期スパイクが計画に入ることはありません。分析では、異常なプールの優先度を下げ、⚠を付けて、高リスクに分類します。
2. DEFAULT_MIN_TVL = $100K： 安全基準を下回る低流動性プールを除外し、貯蓄者を流動性の低い状態での退出や突然のサービス廃止から保護します。
3. 2つのオラクル間の乖離ガード： 各モジュールがマーク価格とオラクル価格の乖離（トリップワイヤー：$<15\text{ bps}$）を確認し、ベーシスの乖離やスクイーズのリスクを警告します。
4. 決定論的な計算レイヤー： LLMは仕組みの説明や解説に利用できますが、数値、予測、複利利回りは決定論的に計算されます。

---

🎨 デザインシステム —「Quiet」

DeFi Garden は、明快さと集中しやすさを重視して設計された、落ち着いたクリーンでミニマルな、テーブルを中心とするインターフェースである 「Quiet」 デザインシステムを採用しています。

• サーフェストークン（--ui-*）：
  • 背景：--ui-bg（ライト #F7F8FA ／ダーク #161A20）、--ui-surface（#FFFFFF ／ #1E242C）、--ui-surface-muted、--ui-surface-sunken。
  • 区切り：1 ピクセルの細い境界線（--ui-border: #E4E7EE、--ui-border-strong: #CBD2DF）。
  • テキスト：コントラストの高い階層（--ui-text: #10151F、--ui-text-secondary: #5A6478、--ui-text-muted: #8A93A6）。
  • アクセント：固定の信頼感のあるブルーパレット（--ui-accent: #3B82F6、--ui-accent-hover: #2563EB、--ui-accent-soft: #EFF5FF）。
  • 角丸：すっきりとした幾何学的なスクワークル（--ui-radius-sm: 8px、--ui-radius-md: 12px、--ui-radius-lg: 16px、--ui-radius-pill: 999px）。
• **強いシャドウやスキューモーフィックな装飾は使用しません：**奥行きは、人工的な双方向のシャドウや背景グラデーションではなく、くっきりした細い境界線と、さりげないサーフェスの色調差で表現します。
• **物理的な押し込みの動き：**インタラクティブなコントロールは :active 時に 1px 沈みます（transform: translateY(1px)）。prefers-reduced-motion にも対応しています。
• **第一級のバイリンガル対応（translations.js）：**ユーザー向けのすべての文字列で、英語（en）と韓国語（ko）のローカライズが完全に同期されています。

---

🛠️ アーキテクチャと技術スタック

• **ビルド工程不要：**バニラのウェブ標準でネイティブに動作します。React 18 UMD はスクリプトタグで読み込み、コンポーネントは純粋な React.createElement で記述するため、JSX のコンパイル工程は必要ありません。
• データ取り込み：https://yields.llama.fi/pools および Hyperliquid Info API（https://api.hyperliquid.xyz/info）とクライアントサイドで連携します。
• 状態管理：
  • テーマ：localStorage.getItem('theme') を使用し、<html> に data-theme="light|dark" 属性を設定します。
  • 言語：URL パラメーター ?lang= と localStorage.getItem('defi-garden-lang') を使用します。
  • 保存済みプラン：localStorage.getItem('garden-plan')。
• SEO と機械可読性：
  • 動的サイトマップを自動生成します（generate-sitemap.js）。
  • AI コンテキスト用エンドポイント：llms.txt と llms-full.txt（generate-llms.js）。
  • Model Context Protocol（MCP）サーバーとの連携（mcp_server.js）。

---

📁 リポジトリ構成

defi_garden/
├── home.html                   # Master router & analytics app shell
├── plan.html                   # Standalone Garden Planner entry
├── hype-harvest.html           # HYPE Funding Harvest module
├── planner.js                  # Conversational Garden Planner engine
├── app.js                      # Core analytics grid & pool filtering
├── PoolDetail.js               # In-depth pool analytics & calculator
├── hype-harvest.js             # HYPE funding harvest React UMD module
├── translations.js             # Bilingual dictionary (EN + KO)
├── translations.min.js         # Production-minified translation dictionary
├── style.css                   # "Quiet" design system tokens & base styles
├── planner-styles.css          # Planner-specific layout styles
├── pool-detail-styles.css      # Pool detail drawer styles
├── hype-harvest.css            # Funding harvest layout styles
├── trust-rails.js              # Shared trust-rail constants
├── canonical.js                # URL canonicalization logic
├── keeper/                     # Autonomous execution & risk keeper scripts
│   ├── keeper_engine.py        # Core risk keeper engine
│   └── hype_funding_harvest.py # Hyperliquid HYPE funding rate worker
├── tests/                      # Python unit & integration test suite
│   ├── test_keeper_engine.py
│   └── test_keeper_hype_harvest.py
└── test_*.js                   # JavaScript offline test suite (71+ test files)

---

🧪 開発とテスト

DeFi Garden ではビルドパイプラインは不要です。任意の静的 HTTP サーバーを使ってローカルで配信できます。

# Start local server
python3 -m http.server 8000
# Open in browser: http://localhost:8000

テストの実行

# Run all unit tests in fast plain mode
npm run test:fast

# Run the complete test suite (plain + browser)
npm test

# Minify production assets
npm run minify

---

📜 ライセンス

MIT License。詳細は LICENSE を参照してください。