docs
how holoholona works. no surprises, just the ocean.
how it works
holoholona is a on-chain lottery and gaming platform built on Solana. every draw is trustless: ticket purchases, pool accumulation, winner selection, and prize distribution all happen via open-source smart contracts with no admin keys.
players connect a Solana wallet (Phantom, Solflare, or Backpack), purchase tickets in SOL, and wait for the scheduled draw. winners are determined by a Verifiable Random Function (VRF) — a cryptographic proof that the outcome was random and could not have been predicted or manipulated by anyone.
- player purchases ticket — SOL is sent to the game's on-chain pool account
- draw triggers at scheduled time or pool threshold
- VRF oracle (Switchboard) generates a verifiable random seed on-chain
- smart contract selects winner(s) deterministically from seed
- prize SOL is distributed automatically — no claim needed
- draw record is written to chain: seed, proof, tx signature, winner (anonymized)
provable fairness & VRF
holoholona uses Switchboard VRF — Solana's decentralized oracle network for verifiable randomness. each draw produces:
- VRF seed — the random value generated by the oracle network
- proof — a cryptographic proof that the seed is genuinely random and unmanipulated
- tx signature — the Solana transaction that records the draw result on-chain
any player can independently verify any draw on the Solana Explorer using the transaction signature. the draws history page provides a verify link for each draw.
fees & conservation allocation
the 3% conservation allocation is sent to a transparent multi-sig wallet. quarterly disbursements to verified Hawaiian wildlife conservation partners are posted on-chain. the wallet address and full transaction history are public.
smart contracts
core lottery program
HoLoHoLoNaXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
devnet — audit pending
conservation fund multi-sig
MaLaMaCoNsErVaXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
3-of-5 multi-sig — signers include 2 conservation partners
smart contract source code will be published on GitHub prior to mainnet launch. third-party audit report will be linked here.
hawaiian glossary
every hawaiian word used on holoholona — with pronunciation guides. we use these words because they carry meaning. if you want to learn more, the Wehewehe Hawaiian Dictionary is the authoritative resource.
| word | pronunciation | meaning | used for |
|---|---|---|---|
| holoholona | hō-lō-hō-lō-nah | animal, creature | platform name |
| honu | hō-noo | green sea turtle | instant scratch game mascot |
| manō | mah-nō | shark | progressive jackpot game |
| pueo | poo-eh-oh | hawaiian owl | night-draw game |
| nēnē | nay-nay | hawaiian goose | daily draw game |
| humuhumunukunukuāpuaʻa | hoo-moo-hoo-moo-noo-koo-noo-koo-ah-poo-ah-ah | reef triggerfish — hawaiʻi state fish | wildcard number-pick game |
| ʻōpae | oh-pah-eh | shrimp / small creatures | micro-lottery |
| ʻīlio-holo-i-ka-uaua | ee-lee-oh hoh-loh ee kah oo-ah-oo-ah | dog that runs in rough water — hawaiian monk seal | rare jackpot events |
| ʻohana | oh-hah-nah | family | community & referral system |
| mālama | mah-lah-mah | to care for, protect | responsible gaming page |
| ʻāina | ah-ee-nah | land | phase 2 — mainnet soft launch |
| kai | kye | ocean, sea | thematic / flavor text |
| mahalo | mah-hah-loh | thank you, gratitude | win state copy |
| kamaʻāina | kah-mah-ah-ee-nah | local, native | referral tier 1 |
| koa | koh-ah | warrior, brave | referral tier 2 |
| aliʻi | ah-lee-ee | royalty, chief | referral tier 3 |
| makahiki | mah-kah-hee-kee | annual festival season | seasonal event |
| mana | mah-nah | spiritual power | design principle |
| pono | poh-noh | righteousness, balance | design principle |
| kohola | koh-hoh-lah | humpback whale | seasonal game (Jan–Mar) |
| wai | why | water, fresh water | phase 1 — devnet beta |
| lewa | leh-vah | sky, air, space | phase 3 — full launch |
| ao | ow | world, light, cloud | phase 4 — growth |