<h2 class="heading-node">Imagine if Twitch, Kickstarter and the NASDAQ had a baby. That’s star - a fundraising platform where founders raise capital in live, public token sales.</h2>Star was born in February (7 months ago). We were a bunch of serial builders who tried launching a token for an AI startup on <a class="link" href="http://pump.fun">pump.fun</a> - long story short, it wasn’t fun. So we decided to build a better platform where ambitious startups and founders could get funded.In June we launched star with our own fundraiser and raised $450K in 48 hours, largely due to an experiment where we turned on a livestream. Since then, we’ve earned $200K in trading fees on our token and helped 1 team raise $350K (in a single hour). Our $STAR is worth about $3.5M at the moment and we hosted the first ever livestreamed fundraising event in crypto, which over 50,000 people tuned in to.<h2 class="heading-node">Bounty: DAMM v2 Honorary Quote‑Only Fee Position + 24h Distribution Crank</h2><ul class="list-node"><li>Goal: Ship a small, standalone, Anchor‑compatible module we can import that:<ul class="list-node"><li>Creates and manages an “honorary” DAMM v2 LP position that is owned by our program (PDA) and accrues fees in the quote mint only.</li><li>Provides a permissionless, once‑per‑24h crank that claims those quote fees and distributes them to investors pro‑rata to still‑locked amounts (from Streamflow), with the complement routed to the creator wallet.</li></ul></li></ul><h3 class="heading-node">Hard requirements</h3><ul class="list-node"><li>Quote‑only fees: The honorary position must accrue fees exclusively in the quote mint. If this cannot be guaranteed by pool/config parameters, the module must detect and fail without accepting base‑denominated fees.</li><li>Program ownership: The fee position is owned by a program PDA (e.g., <code class="inline" spellcheck="false">InvestorFeePositionOwnerPda</code> with seeds <code class="inline" spellcheck="false">[VAULT_SEED, vault, "investor_fee_pos_owner"]</code>).</li><li>No dependency on any creator position: This is an independent position solely for fee accrual in quote.</li></ul><h3 class="heading-node">Work package A — Initialize the honorary fee position (quote‑only)</h3><ul class="list-node"><li>Create an empty DAMM v2 position owned by our PDA that, under the chosen pool/tick/price configuration, accrues only quote‑token fees.</li><li>Validate pool token order and confirm which mint is the quote mint.</li><li>Provide a deterministic preflight/validation step that rejects any config that could accrue base fees.</li></ul><h3 class="heading-node">Work package B — Permissionless 24h distribution crank (quote only)</h3><ul class="list-node"><li>Crank can be called once per 24h window; supports pagination across multiple calls within the same day.</li><li>On each crank:<ol class="list-node"><li>Claim fees from the honorary position via <code class="inline" spellcheck="false">cp-amm</code> into a program‑owned quote treasury ATA.</li><li>Read still‑locked amounts per investor at the current timestamp from Streamflow (team will pass the investor page accounts and stream pubkeys).</li><li>Compute investor share and distribute quote fees only:<ul class="list-node"><li>Define:<ul class="list-node"><li><code class="inline" spellcheck="false">Y0</code> = total investor streamed allocation minted at TGE (stored/provided).</li><li><code class="inline" spellcheck="false">locked_total(t)</code> = sum of still‑locked across investors at time t (from Streamflow).</li><li><code class="inline" spellcheck="false">f_locked(t) = locked_total(t) / Y0</code> in [0, 1].</li><li><code class="inline" spellcheck="false">eligible_investor_share_bps = min(investor_fee_share_bps, floor(f_locked(t) * 10000))</code>.</li><li><code class="inline" spellcheck="false">investor_fee_quote = floor(claimed_quote * eligible_investor_share_bps / 10000)</code>.</li><li>Apply per‑day cap and dust threshold; carry remainder forward.</li></ul></li><li>Distribute pro‑rata: <code class="inline" spellcheck="false">weight_i(t) = locked_i(t) / locked_total(t)</code>, payout <code class="inline" spellcheck="false">floor(investor_fee_quote * weight_i(t))</code>.</li></ul></li><li>After the final page of the day, route the remainder of that day’s claimed quote fees to the creator’s quote ATA.</li></ol></li><li>Idempotent, resumable pagination:<ul class="list-node"><li>Track a daily window with <code class="inline" spellcheck="false">last_distribution_ts</code>, cumulative distributed, carry‑over, and pagination cursor.</li><li>Re‑running pages must not double‑pay. Safe to resume mid‑day after partial success.</li></ul></li></ul><h3 class="heading-node">Inputs we will provide at integration time</h3><ul class="list-node"><li>Creator wallet quote ATA (destination for remainder).</li><li>Investor distribution set (paged): per‑investor Streamflow stream pubkey and investor quote ATA.</li><li>Pool/program IDs and all <code class="inline" spellcheck="false">cp-amm</code> accounts/keys.</li><li><code class="inline" spellcheck="false">Y0</code> and policy config (<code class="inline" spellcheck="false">investor_fee_share_bps</code>, optional daily cap, <code class="inline" spellcheck="false">min_payout_lamports</code>).</li></ul><h3 class="heading-node">Required accounts and state (document clearly)</h3><ul class="list-node"><li>For initialization:<ul class="list-node"><li><code class="inline" spellcheck="false">cp-amm</code> program + pool accounts/config; token vaults; system and token programs.</li><li><code class="inline" spellcheck="false">InvestorFeePositionOwnerPda</code> (program PDA) and the new position account(s).</li><li>Verification of quote mint identity.</li></ul></li><li>For crank:<ul class="list-node"><li>Honorary position + its owner PDA.</li><li>Program quote treasury ATA (for pool’s quote mint).</li><li>Creator quote ATA.</li><li>Streamflow program ID.</li><li>Paged investor accounts: Streamflow stream pubkey and investor quote ATA.</li><li>Policy PDA (fee share, caps, dust) and Progress PDA (last ts, daily spent, carry, cursor, day state).</li></ul></li></ul><h3 class="heading-node">Protocol rules and invariants</h3><ul class="list-node"><li>24h gate: First crank in a day requires <code class="inline" spellcheck="false">now &gt;= last_distribution_ts + 86400</code>. Subsequent pages share the same “day”.</li><li>Quote‑only enforcement: If any base fees are observed or a claim returns non‑zero base, the crank must fail deterministically (no distribution).</li><li>Math: Use floor on proportional math; enforce <code class="inline" spellcheck="false">min_payout_lamports</code>; carry dust to later pages/day; apply daily caps net of prior payouts.</li><li>In‑kind: Distribute quote mint only; no price conversions.</li><li>Liveness: Missing investor ATAs may be made if needed per policy with accounting and continuation; creator remainder must not be blocked.</li></ul><h3 class="heading-node">Acceptance criteria</h3><ul class="list-node"><li>Honorary position:<ul class="list-node"><li>Owned by program PDA; validated quote‑only accrual or clean rejection.</li></ul></li><li>Crank:<ul class="list-node"><li>Claims quote fees, distributes to investors by still‑locked share, routes complement to creator on day close.</li><li>Enforces 24h gating, supports pagination with idempotent retries, respects caps and dust handling.</li></ul></li><li>Tests (local validator/bankrun):<ul class="list-node"><li>Initialize pool and honorary position; simulate quote fee accrual; run crank across multiple pages.</li><li>Cases:<ul class="list-node"><li>partial locks: investor payouts match weights within rounding tolerance; creator gets complement.</li><li>All unlocked: 100% to creator.</li><li>Dust and cap behavior: dust is carried; caps clamp payouts.</li><li>Base‑fee presence causes deterministic failure with no distribution.</li></ul></li></ul></li><li>Quality:<ul class="list-node"><li>Anchor‑compatible; no <code class="inline" spellcheck="false">unsafe</code>; deterministic seeds.</li><li>Clear README with integration steps, account tables, error codes, and day/pagination semantics.</li><li>Emit events: <code class="inline" spellcheck="false">HonoraryPositionInitialized</code>, <code class="inline" spellcheck="false">QuoteFeesClaimed</code>, <code class="inline" spellcheck="false">InvestorPayoutPage</code>, <code class="inline" spellcheck="false">CreatorPayoutDayClosed</code>.</li></ul></li></ul><h3 class="heading-node">Deliverables</h3><ul class="list-node"><li>Public Git repo containing:<ul class="list-node"><li>The module/crate (Anchor‑compatible) with clear instruction interfaces and account requirements.</li><li>Tests demonstrating end‑to‑end flows against <code class="inline" spellcheck="false">cp-amm</code> and Streamflow on a local validator.</li><li><code class="inline" spellcheck="false">README.md</code> documenting setup, wiring, PDAs, policies, and failure modes.</li></ul></li></ul>

Build Permissionless Fee Routing Anchor Program for Meteora DAMM V2

Build Permissionless Fee Routing Anchor Program for Meteora DAMM V2