Investments（Farm Miner）と TIP tiers

現行システムでの動作（現在の仕様）

1) 投資作成のコアルール

  • 投資はシステムに active assets がある場合のみ作成されます：
    • USDT (BSC) と USDO (Internal)
  • 投資ユーザーは referredByUserId を持っている必要があります（つまり invite code で登録済み）。
  • 投資には investmentInviteCode（8文字, A-Z/0-9）が必要です — これは Yield tree の placement code です。
  • 最低投資額: 10 USDT。

2) TIP 分類（TIP1/TIP2/TIP3）

TIP は Block settings に基づき投資額から計算されます：

  • tier1MaxBase（default: 480 USDT）
  • tier2MaxBase（default: 975 USDT）

If:

  • amount ≤ tier1Max → TIP1
  • amount ≤ tier2Max → TIP2
  • otherwise → TIP3

重要：ユーザーの overall programTier は すべての ACTIVE farm miners の principal 合計で計算されます（単一投資ではない）。これにより複数投資による TIP upgrade が可能です。

3) Farm Miner の term/return と “hourly mint”

投資後、次のロジックで FarmMiner が作成されます：

  • termMonths と returnMinPercent/returnMaxPercent は TIP ベース設定から取得。
  • returnPercent には2層があります：
    • 投資時に初期 returnPercent を設定（[min, max] の random）。
    • earn worker は各 mint/credit 時に returnPercent を 再ランダム化 し、最後の値を保存する場合があります。
  • profitBase = principal * returnPercent / 100
  • totalMintBase = principal + profitBase
  • Mint interval は farmMinerMintIntervalMinutes（default: 60 minutes）。

Earn/mint は経過時間ベースで prorata 計算されます：

  • worker は経過 hours（または interval < 60 の場合 minutes）と totalMintBase から mintedTarget を計算。
  • その後 mintDue = mintedTarget - mintedBase をユーザー USDO 残高へクレジット（ledger entry）。
  • term 終了または mintedBase >= totalMintBase で miner は COMPLETED になります。

4) Investment placement（LEFT/RIGHT）

investmentInviteCode はいずれかのユーザーに属している必要があります：

  • そのユーザーの inviteCodeLeft と同じ場合 → placementSide=LEFT
  • inviteCodeRight と同じ場合 → placementSide=RIGHT

UI では通常 USDOL（LEFT）と USDOR（RIGHT）で表示されます。

5) 最初の投資後、investment invite code はロックされる

  • 既に投資があり investmentInviteCodeLocked=true の場合、以後の投資では同じ investmentInviteCode を使用する必要があります。
  • 最初の投資後、backend は選択された placement code を常に保存/ロックします。

6) Referral（direct/word-of-mouth）bonus

現行システムでは referral commission は marketing inviter（referredByUserId）へ支払われます — つまり登録時にユーザーが使用した invite code の所有者です：

  • Referral percent は settings 由来（referralPercent, default: 10%）。
  • 適格性は 受取側の TIP に依存：
    • TIP1 → 0%（受け取らない）
    • TIP2/TIP3 → 受け取るが、最大 cap（tip2ReferralMaxBase / tip3ReferralMaxBase）あり。

7) 複数 miners と “upgrade”（増額のみ）

  • 1ユーザーは複数 farm miners（複数投資）を持てます。
  • 現行 API では既存 miner の principal を 増額（upgrade）可能です。この場合：
    • principal が増加
    • 新 principal に応じて TIP が変化する可能性
    • term と returnPercent が再計算（returnPercent は再ランダム）
    • miner は“現在時点から”再開始（mintedBase=0, accruedHours=0, endsAt 再計算）