For the complete documentation index, see llms.txt. This page is also available as Markdown.

📺Liquidity Pool Manual

This guide covers participating in the Liquidity Pool infrastructure.

Liquidity Pool

This guide provides step-by-step instructions on how to participate in the protocol’s primary liquidity infrastructure. By depositing tokens, you act as the "house," earning rewards from the mathematical edge of all integrated games.

How to Deposit

  1. Membership: Ensure you hold a soulbound membership Pass NFT. Membership is mandatory for all liquidity providers.

  2. Approval: Approve the Core contract to spend the amount of native tokens you wish to deposit.

  3. Execution: Call Core.deposit with your wallet address as the provider. The tokens will be routed through the Hub to the Liquidity Pool.

  4. Receive BLP NFT: Upon a successful transaction, a Betfin Liquidity Position (BLP) NFT is minted to your wallet. This NFT is your receipt and serves as the single source of truth for your shares and rewards.

Understanding Your Position

  • Shares: Your deposit is converted into shares based on the pool’s current value. More shares represent a larger percentage of ownership in the pool.

  • Fair Entry: Your position snapshots the current global profit and debt counters at the moment of entry. This ensures you only accumulate rewards or losses from game activity that occurs after your deposit.

  • 80-Week Lock: Principal deposits are subject to a mandatory 80-week lock period. While rewards can be claimed at any time, the original tokens cannot be withdrawn until this period expires to ensure long-term stability for the protocol.

How to Withdraw

  1. Check Lock Status: Verify that your 80-week lock has elapsed by checking getPosition(tokenId).unlockTime.

  2. Withdraw Function: Once unlocked, call the withdraw function.

  3. Settlement: You will receive your proportional share of the pool (initial principal adjusted by any realized profits or losses).

  4. Position Closure: Your Position NFT is burned, and your participation in the pool is permanently closed.

Safety Circuit Breakers

  • Daily Drawdown Limit: To protect your capital, games are capped at withdrawing no more than 5% of the pool's daily balance.

  • Loss Threshold: If sustained player wins reduce the pool balance below 50% of expected principal, the "Circuit Breaker" automatically stops all new betting until the pool recovers via the next sync.

Last updated