> For the complete documentation index, see [llms.txt](https://docs.helio.bet/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helio.bet/liquidity-providers.md). # Liquidity providers The deployed CLOB accepts funded limit orders from makers. The source also includes a public fixed-range vault and factory, but neither appears in the current pilot deployment manifest. ## Place your own orders A maker supplies liquidity through ordinary limit orders. Use post-only execution when the order must rest instead of taking liquidity. Buy orders reserve collateral. Sell orders reserve outcome inventory. Splitting complete pairs is one way to obtain both UP and DOWN inventory. Makers receive the configured rebate on completed incoming fills, with no queue advantage over other accounts. A resting order can become unattractive as the underlying price changes. Cancellation is effective only when confirmed. Neither the spread nor the rebate guarantees a profit. ## Vault implementation `HelioLiquidityVault` pools collateral and issues ERC20 vault shares. Each vault fixes its series, UP bid and ask, allocation, and quote lifetime at construction. `HelioLiquidityVaultFactory` allows permissionless creation where that factory is deployed. The vault is a fixed inventory strategy. It does not continuously estimate fair value or refresh its prices. Its epoch follows this sequence: 1. During an idle period, users deposit collateral or redeem vault shares. 2. Anyone can start an eligible epoch. The vault allocates collateral and splits complete pairs for one round. 3. It posts an ordinary UP sell at its ask and a DOWN sell at one minus its bid, both post-only. 4. After quote expiry, anyone can cancel the remaining quotes. 5. After the round resolves or becomes invalid, anyone can finish the epoch, cancel outstanding orders, and redeem remaining outcomes. 6. Deposits and withdrawals reopen. At least 60 seconds must pass before another epoch begins. An existing crossing order book can cause the post-only placement to revert and prevent an epoch from starting. ## Depositor accounting Deposits and redemptions are allowed only when the vault is idle and its epoch has been reconciled. Capital remains committed through an unresolved epoch. During an active epoch, `liquidAssets` counts available cash. It does not value unresolved inventory or reserved orders. `totalAssets` deliberately reverts while the epoch is active. A vault can lose value from adverse fills and settlement outcomes. The implementation has no promised APY, automatic loss protection, or verified maker-profitability result. For this pilot, use the [deployed contract list](/contracts-and-deployment.md) as the availability record. A Liquidity panel in the source does not establish that a public vault is deployed or funded. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.helio.bet/liquidity-providers.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.