Adventure Awaits

Galactic Pools

Fueling fearless DeFi explorers with verifiable randomness, curated yields, and cinematic mission control.

galacticpools.io

Field Manual

Galactic Pools - Expedition Handbook

Everything explorers and Mission Control need to launch, join, and resolve a prize expedition.

Network: GOAT Testnet3
Download Security Audit (PDF)

Mission Copy & Rich Text Editor

The launch wizard and admin console share a lightweight rich text editor for section bodies, disclosures, and announcement copy. It stores cleaned HTML so explorers see identical formatting across desktop and mobile.

  • Use the toolbar to apply bold, italics, underline, bullets, numbered lists, and inline links without pasting raw HTML.
  • The Image button accepts a hosted URL (PNG, JPG, GIF, or SVG). Prefer CDN links over data URIs so content loads quickly for explorers.
  • Paste tables or headings from Google Docs or Notion—unsupported styles are stripped automatically to keep markup safe.
  • Use the “Docs” shortcut in the editor to revisit these guidelines or share them with collaborators drafting mission lore.
  • Click Clear to reset the editor to a blank state. Draft in staging first; production updates publish immediately to the metadata registry.

Explorer Briefing

Fuel missions with stablecoins, push odds higher with boosts and referrals, and claim rewards once Goat VRF names the winner. Deposits remain locked until a draw completes or Mission Control opens emergency refunds, and every mission now surfaces a queued airdrop manifest so you know what non-winners will receive.

  • Mission weight equals principal (USD 6-dec) plus capped referral credits plus optional boost credits.
  • Boosting charges the displayed premium fee but never touches principal.
  • Non-winners reclaim only their yield unless a mission abort window is active.

Mission Control Briefing

Use the admin console to deploy expeditions, configure fuel tokens and caps, seed prizes, and fund Goat VRF. Every pool is single-use: after the draw or an abort, launch a fresh expedition from the factory.

  • Create pools with duration and target, then tune fees, caps, boosts, and eligible stablecoins.
  • Fund VRF before the deadline; draws revert without sufficient fee balance.
  • Emergency and refund tools unlock principal and sponsor funds if a mission aborts.

Explorer Parameters

Mission Metrics

  • Target Fuel - USD 6-dec amount required for the expedition to draw without refunds.
  • Launch Deadline - countdown to lock deposits; after this, deposits close and Mission Control must draw or abort.
  • Prize Capsule - token and amount the winner receives (native or ERC-20).
  • VRF Fuel Indicator - shows whether enough Goat VRF fee token is funded. Draws revert if this is empty.
  • Status Chips - Open, Closed, Draw Requested, or Complete match the phases below.
  • Queued Airdrop - lists any ERC-20 or native rewards that non-winners will receive after the draw.

Deposit Form Inputs

  • Fuel Token - pick any supported stablecoin; the app validates decimals automatically.
  • Fuel Amount - quantity to deposit. Per-address caps (default 20 percent of target) show in the odds panel.
  • Current Balance - the form reads your wallet balance for the chosen token and blocks the Fuel action if the deposit plus boost premium would exceed it.
  • Boost Percent - optional weight increase. Selecting a boost displays the premium fee charged at confirmation.
  • Referral Code - set once per wallet. Invited explorers grant capped referral credits that count toward odds.
  • Payment Prompts - the app attempts permit signatures first, then Permit2, and finally raw approvals. After signatures, an x402 payment window opens in advance with a “preparing” screen—keep the pop-up open until the processor finalizes the transfer.

Explorer Checklist

  1. Connect your wallet, pick the correct GOAT network, and open the mission page from /pool/{address}.
  2. Review the mission card: target fuel, countdown, prize capsule, queued airdrop summary, and VRF readiness.
  3. Select a fuel token, enter the amount, optionally choose a boost level, and set a referral code (or leave blank).
  4. Approve the presented signature flow. The router handles permit or Permit2 interactions, charges boost premiums automatically, and opens an x402 pop-up with a staging screen—allow the window and keep it open until the processor finishes the transfer.
  5. Share your referral link from the odds panel to earn capped referral credits while the mission is open.
  6. When the deadline passes, watch the mission status: withdraw only if an abort window opens; otherwise wait for the draw to complete.
  7. After the draw, winners are paid instantly. Everyone else can claim yield and prepare for the next expedition.

Fueling (Open)

Launch window is open. Deadline has not passed and no randomness request exists.

  • Deposit any supported fuel token to increase your mission weight; the form blocks attempts that exceed your current balance.
  • Review the queued airdrop panel to see which partner rewards non-winners will receive.
  • Optional: apply a boost (paying the displayed premium) and share your referral link to stack capped credits.
  • Sponsors can add to the prize capsule. All deposits remain locked until the draw or an abort window opens.

Awaiting Draw (Deadline Passed)

Countdown reached zero but Mission Control has not requested VRF yet.

  • No additional deposits are accepted in this state.
  • If the target was missed and randomness request id is zero (or emergency refund is enabled), the Withdraw (Excursion Aborted) panel becomes active so you can reclaim principal plus harvested yield.
  • Otherwise, wait for Mission Control to trigger the draw or announce an abort.

Draw Pending (VRF Requested)

Mission Control or the keeper has called performUpkeep; Goat VRF is selecting a winner.

  • Sit tight; funds stay locked until Goat VRF resolves.
  • Track the request id in the mission log; notifications fire once the draw settles.
  • If VRF takes unusually long, Mission Control can reset the request after 24 hours.

Complete (Winner Selected)

Goat VRF delivered randomness and the prize was paid.

  • Winners receive the prize automatically; transaction hash appears in round history.
  • Non-winners can click Claim Yield to withdraw their pro-rata rewards for the round.
  • Mission Control may withdraw residual principal to prep the next expedition; deposits do not auto-roll.

Abort Window (Emergency Refund or Target Miss)

Emergency refund is toggled on or the target was missed with no VRF request outstanding.

  • Use Withdraw (Excursion Aborted) to reclaim each fuel token plus any harvested yield.
  • Sponsor prizes are returned once Mission Control runs Refund Sponsors.
  • No future draw can occur until a new expedition is deployed from the factory.

Live Telemetry Snapshot

Active Pool

0xbE076aDD2dbcDF463FE6E5AB63dB724f02522d1A

Deadline

11/18/2025, 3:15:35 AM

Pool Value (USD6)

0.0

Prize

0 TOKEN

Protocol Fee (%)

10

Snapshot pulls the freshest pool from all configured factories on the selected network.

Mission Control Launch Sequence

  1. Navigate to /admin, connect the admin wallet, and pick the target GOAT network.
  2. (Optional) From the Yield Source panel, deploy or whitelist the shared BasicYieldSource adapter so partner rewards can be donated to any pool.
  3. Use Create Pool to set duration (seconds), target amount (USD 6-dec), and optionally point the pool at a default universal yield source. Record the resulting pool address.
  4. Configure Pool Parameters: add fuel tokens, adjust per-address caps, referral settings, protocol, airdrop, and principal fees, and set the boost premium split. Flight Presets apply common fee bundles.
  5. Define the prize in Prize Capsule. Set the token address (blank for native) and amount; invite partners to sponsor via the public widget on the pool page.
  6. Prep Goat VRF: review the recommended fee, set a multiplier or gas price cap, and click Fund Fee so the pool holds enough WGOATBTC before the deadline.
  7. Verify live telemetry, branding, and mission copy on the public pool page, then announce launch. Continue monitoring fuel, odds, and VRF readiness in the Mission Control dashboard.

Fueling (Before Deadline)

Explorers are depositing and the odds panel is live.

  • Monitor total fuel, caps, and referral or boost utilisation in the Mission Control dashboard.
  • Add or remove supported stablecoins via Fuel Tokens; tweak caps, referral weight, and boost split in Pool Parameters.
  • Seed extra prize or register airdrops, and ensure the VRF fee balance stays above the recommended multiplier.

Deadline Reached - Target Met

The pool is ready to draw.

  • Verify the VRF fuel card shows READY with the recommended amount funded.
  • Trigger the draw with performUpkeep (or confirm automation executed) and monitor the request id.
  • Avoid toggling emergency refund until the VRF request resolves; explorers cannot withdraw while randomness is pending.

Deadline Reached - Target Missed

Principal is still locked because no winner exists and target is below goal.

  • Decide whether to enable Emergency Refund to let explorers reclaim deposits.
  • Offer sponsors the option to top up fuel or accept refunds; Refund Sponsors returns prize contributions automatically.
  • Communicate status to explorers and consider deploying a fresh expedition from the factory.

Draw Pending (VRF Active)

Randomness request id is non-zero.

  • Watch for Goat VRF fulfilment; the UI flips Prize Delivered to Yes when complete.
  • If the request stalls for 24 hours, top up VRF balance if needed and use Reset Randomness Request to reopen performUpkeep.
  • Do not call Refund Sponsors until any active request resolves or is reset.

Complete (Prize Awarded)

Prize paid, round finalised.

  • Announce the winner and prompt explorers to claim yield.
  • Withdraw all principal back to the host wallet once ready; this zeros total principal on-chain.
  • Withdraw unused VRF fees, archive telemetry, and start configuring the next expedition.

Emergency or Abort Flow

Emergency refund is enabled or you intentionally cancel a round.

  • Keep randomness request id at zero; once explorers withdraw, run Refund Sponsors to return the remaining prize.
  • Disable emergency refund only after confirming no further refunds are required.
  • Principal stays in the pool contract until a new expedition is deployed or you withdraw all principal after a completed draw.

Mission Control Controls Reference

Fuel Tokens and Parameters

  • Add supported ERC-20 fuel tokens directly or use quick presets for common stablecoins.
  • Adjust per-address caps, referral caps, referral weight, and boost premium split from Pool Parameters.
  • Apply Flight Presets for fast protocol fee and boost configurations.

Prize Capsule and Airdrops

  • Set or update the prize token and amount; leave the address blank to use native currency.
  • Register airdrops to distribute ERC-20 rewards automatically after the draw.
  • Use Refund Sponsors to unwind prizes when aborting a mission.

VRF Operations

  • Prep VRF Fuel calculates the recommended Goat VRF fee using your chosen multiplier.
  • Fund Fee sends the selected amount in the fee token directly to the pool contract.
  • Reset Randomness Request (after 24 hours) and Withdraw VRF Fees keep the mission unblocked and balances tidy.

Emergency and Post-Draw Tools

  • Toggle Emergency Refund when you need to unlock principal before a draw.
  • Withdraw All Principal once a prize is awarded to recover funds to the host wallet.
  • Review mission telemetry and round history in the admin UI for post-launch reporting.
Back to Home