Investments（Farm Miner）与 TIP tiers

在当前系统中（当前如何运作）

1) 创建 investment 的核心规则

  • 仅当系统存在 active assets 时才可创建投资：
    • USDT (BSC) 与 USDO (Internal)
  • 投资用户必须有 referredByUserId（即必须通过 invite code 注册）。
  • investment 需要 investmentInviteCode（8 characters, 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

重要：用户整体 programTier 通过 所有 ACTIVE farm miners 的 principal 总和计算（不只是单笔投资）。这使得可通过多笔投资实现 TIP upgrades。

3) Farm Miner 的 term/return 与 “hourly mint”

投资后，会按以下逻辑创建 FarmMiner：

  • termMonths 与 returnMinPercent/returnMaxPercent 来自 TIP 对应 settings。
  • returnPercent 有两层：
    • 投资时设置初始 returnPercent（random in [min, max]）。
    • earn worker 在每次 mint/credit 时可能 re-randomize 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）奖励

在当前系统中，referral commission 发给 marketing inviter（referredByUserId）—— 即用户注册时使用的 invite code 所属人：

  • Referral percent 来自 settings（referralPercent, default: 10%）。
  • 资格取决于 接收方 TIP：
    • TIP1 → 0%（不接收）
    • TIP2/TIP3 → 可接收，但有最大 cap（tip2ReferralMaxBase / tip3ReferralMaxBase）。

7) 多个 miners 与 “upgrade”（仅增额）

  • 用户可拥有多个 farm miners（多笔 investments）。
  • 在当前 API 中，可对已有 miner 的 principal 进行 increase（upgrade）。此时：
    • principal 增加
    • TIP 可能随新 principal 改变
    • term 和 returnPercent 重新计算（returnPercent 再次随机）
    • miner “从当前时刻”重新开始（mintedBase=0, accruedHours=0, endsAt 重新计算）