Loot 基元

Loot 是協議的核心基元：一場託管在鏈上的可驗證獎勵活動。合約層實作為 Pool；產品、UI 和 API 統稱 Loot，兩者一對一對應。

Loot 的組成

每場 Loot 在創建時就固定這些參數：

屬性	含義
資產類型	ETH（原生幣）、ERC20、ERC721。不混用。
玩法	拼手氣、均分、自訂——獎池怎麼分。
時間	startTime（0 = 立刻開始）、endTime（0 = 永不過期）。
名額	maxClaimers——最多幾個錢包能領，必須大於 0。
開放贊助	創作者以外的人能否加碼。
Gate	參與者須通過的資格條件。見 Gate。
狀態	Pending → Active → Ended，由鏈上狀態推算。

狀態

Loot 只有三種狀態，由鏈上資料推算，不另外存：

• Pending（籌備中） — 已創建，尚未上線。這時存入獎勵。
• Active（進行中） — 開始時間已到且獎池有資金；可以領取。
• Ended（已結束） — 時間到、名額滿或獎池空了。

生命週期

1. 創建。 創作者呼叫工廠，部署專屬最小代理獎池，設定寫入鏈上。
2. 存入。 創作者在 Pending 期間存入獎勵。若開放贊助，他人也能加碼——但只在 Pending 期間。進入 Active 後，獎池鎖定。
3. 驗證。 參與者通過 Gate；驗證服務簽發 EIP-712 憑證。
4. 領取。 參與者提交憑證；獎池計算或讀取份額並轉帳。一個錢包只能領一次。
5. 取回。 活動結束後，出資者按比例取回沒人領的部分。見 取回。

為什麼叫「Loot」

在 GameFi 語境裡，Loot（戰利品）有探索、挑戰、收穫的感覺——完整的「參與 → 達標 → 拿到」循環，不是單向送禮。比 Gift、Reward 更有感，比 Drop 更具體：它指的是被領取的那個東西，而不只是「發送」這個動作。合約層沿用 Pool，因為獎勵託管在採用 OpenZeppelin Clones 最小代理的獎池裡。見 智能合約。