Jak kontrakt funguje
Všechny prostředky a všechna pravidla FAIRDRUM jsou v jednom programu v síti Solana, ve smart kontraktu. Web mu jen posílá příkazy a zobrazuje odpověď.
hráč
registerdepositwithdraw_solwithdrawspin_commithráč nebo jeho klíč relacesession_opensession_closecheckin
kdokoli
deposit_sweepspin_settlespin_expirespin_sealdonateroll_epochfund_pools
správce
set_jackpot_startsrescale_poolsset_pausedset_guardianguard_pausestrážní klíč nebo správcepropose_dev_authorityaccept_dev_authoritynový klíč správceinit_unwrapclaim_devpromo_payklíč promo fonduset_house_rootkořenový klíč; dokud není určen, držitel oprávnění k aktualizaciset_root_authoritydržitel oprávnění k aktualizaci programupropose_root_authoritykořenový klíčaccept_root_authoritynový kořenový klíčinitializedržitel oprávnění k aktualizaci programu
Co je kontrakt a kde běží
Smart kontrakt je program, který vykonávají uzly sítě Solana, ne server projektu. Jeho kód je pro všechny stejný a každá akce je veřejná transakce. Kontrakt FAIRDRUM je napsán v jazyce Rust s knihovnou Anchor. Zda a kde byl zdrojový kód programu zveřejněn, je uvedeno na tomto místě, když je stránka otevřena se zapnutými skripty.
Adresa programu: 5ww3w4HrQrrrPcjfxVRvjLpL5vBJqLt7M5ThsnEkkngf
- Program
5ww3w4HrQrrrPcjfxVRvjLpL5vBJqLt7M5ThsnEkkngf- Účet s kódem programu
89B7dxfLfRyMcupeikVJZyUewPHim6Z7QfCV7amMJ3wJ- Trezor
Bhf8tXXrer3naZpDsx7LMxixCJcPpdxXzD5cE2NFM3G7- Společný herní účet
2QYMsfTvKkrf9vtsrnbx6WbQKZBj4zbwn8HqS2B1Dov7
Neposílejte SOL na adresu trezoru. SOL poslané přímo na ni se nikomu nepřipíšou a žádný příkaz programu je nemůže vrátit. Dobíjejte jen přes pokladnu nebo přes svou osobní adresu pro dobití.
Pokud web fairdrum.to zmizí, prostředky hráčů zůstanou v kontraktu a lze je vybrat jakýmkoli programem, který umí odeslat příkaz withdraw podepsaný vaší peněženkou. Výběr bez tohoto webu
Co kontrakt ukládá
- Trezor. Jediný účet s wrapped SOL, který ovládá pouze sám program. Je v něm všechno: zůstatky hráčů, výherní banka, jackpoty, rezerva a podíl správce, který ještě nebyl vybrán.
- Společný herní účet. Záznam o tom, jak je částka v trezoru rozdělena: výherní banka, jackpot, mini jackpot, superjackpot, rezerva pro počáteční částky, podíl správce, počáteční částky jackpotů a počítadla kol jednotlivých her. Je zde také kořen tajemství a veřejné počítadlo vrácených sázek.
- Účet hráče. Vytváří jej příkaz register, který web posílá spolu s prvním dobitím, a je svázán s adresou peněženky: herní zůstatek, čas posledního dobití, nedokončené kolo (s blokem sázky, číslem tajemství a kořenem tajemství) a nevyplacená část jackpotu.
- Účet relace (je-li zapnuta „hra bez podpisů“): dočasný klíč, čas vypršení a limit sázek.
Účetnictví je postaveno tak, aby se součet všech zůstatků a banků rovnal částce v trezoru. Test tuto rovnost kontroluje po každé z desítek tisíc náhodných operací.
Kterým příkazům kontrakt rozumí
| Příkaz | Kdo podepisuje | Co dělá |
|---|---|---|
register | hráč | Vytvoří účet hráče. Web jej posílá spolu s prvním dobitím. |
deposit | hráč | Dobije herní zůstatek z peněženky. Částku lze hned použít ke hře nebo vybrat. |
deposit_sweep | kdokoli | Připíše na herní zůstatek SOL zaslané na hráčovu osobní adresu pro dobití (z burzy nebo z jiné peněženky). Adresa je odvozena z hráčovy peněženky a nikdo k ní nemá klíč. Instrukce umí jen jedno: přesunout SOL z adresy vlastníka na zůstatek téhož vlastníka. |
withdraw_sol | hráč | Výběr do vlastní peněženky v běžných SOL, bez čekací lhůty po dobití. Peněženka platí jen síťový poplatek. Tento příkaz odesílá web. |
withdraw | hráč | Dřívější podoba výběru se stejnými pravidly: SOL jdou na účet wrapped SOL dané peněženky. Web ji používá, když withdraw_sol není k dispozici. |
spin_commit | hráč nebo jeho klíč relace | Sázka: odečte kolo ze zůstatku a zapamatuje si hru, platné šance, blok sázky a číslo tajemství kola. |
spin_settle | kdokoli | Vyúčtování: převezme tajemství kola, ověří je proti kořeni tajemství, smíchá je s hashem bloku sázky, vypočítá výplatu a připíše ji hráči. Správné tajemství zná jen provozovatel. |
spin_expire | kdokoli | Vrácení sázky za kolo, které provozovatel nedokončil: nebylo včas vyúčtováno ani zapečetěno, nebo tajemství zapečetěného kola nebylo odhaleno do přibližně 24 hodin. Sázka se hráči vrací v plné výši. |
spin_seal | kdokoli | Zapečetí kolo: zaznamená hash bloku sázky, dokud je dostupný (přibližně 3,5 minuty). Obvykle to dělá provozovatel. |
session_open | hráč | Umožní dočasnému klíči uzavírat sázky v rámci časového limitu a limitu sázek; klíč nemůže vybírat ani dobíjet. |
session_close | hráč | Uzavře relaci před uplynutím jejího časového limitu: dočasný klíč už nemůže sázet a síťová záloha za záznam relace se vrátí do peněženky. |
donate | kdokoli | Vloží SOL do rezervy pro počáteční částky jackpotů. Opačný příkaz neexistuje. |
set_jackpot_starts | správce | Nastaví nové počáteční částky jackpotu a superjackpotu; začnou platit po 24 hodinách. |
rescale_pools | správce | Převede část rezervy počátečních částek do výherní banky her, jen dokud banka drží méně než 1 600 SOL, a jen do této částky. Pouze tímto směrem; do jackpotů ji převést nelze. Jackpot a mini jackpot se po výhře doplňují z rezervy samy. |
set_paused | správce | Pozastaví nebo obnoví přijímání nových sázek. Již uzavřené sázky se vyúčtují a výplaty i výběr fungují jako obvykle. |
set_guardian | správce | Správce může určit samostatný klíč, který umí jen jedno: pozastavit přijímání nových sázek. Pozastavení může zrušit pouze správce. |
guard_pause | strážní klíč nebo správce | Správce může určit samostatný klíč, který umí jen jedno: pozastavit přijímání nových sázek. Pozastavení může zrušit pouze správce. |
propose_dev_authority | správce | Převod práv správce na jiný klíč ve dvou krocích: současný klíč určí nový a nový to sám potvrdí. |
accept_dev_authority | nový klíč správce | Převod práv správce na jiný klíč ve dvou krocích: současný klíč určí nový a nový to sám potvrdí. |
init_unwrap | správce | Jednorázový příkaz. Vytvoří servisní účet, přes který pracuje withdraw_sol. Zpětný příkaz neexistuje. |
claim_dev | správce | Vybere nahromaděný podíl správce a nic jiného. |
promo_pay | klíč promo fondu | Výplata z promo fondu, nejvýše do výše jeho zbývajícího zůstatku. |
set_house_root | kořenový klíč; dokud není určen, držitel oprávnění k aktualizaci | Nastaví kořen tajemství pro následující sázky. Na již uzavřené sázky nemá vliv: každá má svůj kořen zaznamenaný v okamžiku sázky. |
set_root_authority | držitel oprávnění k aktualizaci programu | Určí kořenový klíč nebo ho nahradí. Funguje jen, dokud má program oprávnění k aktualizaci. |
propose_root_authority | kořenový klíč | Předání kořenového klíče ve dvou krocích: současný klíč určí nový a nový to sám potvrdí. |
accept_root_authority | nový kořenový klíč | Předání kořenového klíče ve dvou krocích: současný klíč určí nový a nový to sám potvrdí. |
roll_epoch | kdokoli | Údržba. Aktualizuje týdenní statistiky. Prostředky nepřesouvá. |
checkin | hráč | Údržba. Aktualizuje značku dne hráče. Prostředky nepřesouvá. |
initialize | držitel oprávnění k aktualizaci programu | Jednorázové spuštění. Vytvoří účty kontraktu a zapíše nastavení spuštění. |
fund_pools | kdokoli | Jednorázové spuštění. Zapíše počáteční banku do jednotlivých banků; funguje jednou a jen tehdy, když trezor už obsahuje celou počáteční částku. |
V kódu není žádný příkaz, který by převedl výherní banku, jackpoty nebo zůstatky hráčů správci.
Kroky kola
- Sázka. Příkaz spin_commit odečte kolo z vašeho zůstatku a do účtu hráče zaznamená blok sázky, číslo dalšího tajemství v pořadí a kořen tajemství platný v daném okamžiku. Samotné tajemství zná jen provozovatel a hash bloku sázky ještě neexistuje.
- Číslo kola. Provozovatel odešle příkaz spin_settle s tajemstvím kola. Kontrakt ověří, že tajemství odpovídá kořeni zaznamenanému před sázkou, a smíchá je (SHA-256) s hashem bloku, který sázku obsahuje. Žádné jiné tajemství kontrakt nepřijme.
- Vyúčtování. V téže transakci kontrakt vypočítá výplatu, připíše ji a zveřejní událost RoundRevealed: číslo tajemství, kořen, tajemství a hash bloku sázky. Web sám kolo vyúčtovat nemůže, protože nemá tajemství. Od hráče se druhý podpis nevyžaduje.
- Zobrazení. Karty, miny, raketa a drahokamy jsou způsoby, jak ukázat výplatu, která už byla vypočítána. Vaše klepnutí ve hře ji neovlivňují.
Proč výsledek nelze v okamžiku sázky znát ani zfalšovat. Provozovatel vytváří tajemství všech budoucích kol předem a jejich společný otisk, kořen stromu tajemství, je zaznamenán v kontraktu před sázkami. Hash bloku sázky v okamžiku sázky neexistuje; nikdo jej nezná. Provozovatel nezná předem hash, hráč ani nikdo jiný nezná tajemství, takže v okamžiku sázky nikdo nezná výsledek. Hráč nemůže z prohraného kola vycouvat: nezná tajemství a vyúčtování nemůže zabránit. Hra, počáteční částky jackpotů a strop výhry se zaznamenávají v okamžiku sázky a vzorec vyúčtování je v programu kontraktu. Pozdní vyúčtování není nikdy výhodnější než včasné. Pravidla lze změnit jen výměnou kódu programu a to je viditelné pro všechny (viz oddíl o správci).
Shrnutí. Číslo kola se skládá ze dvou polovin: tajemství je před sázkou zafixováno svým otiskem v kontraktu a hash bloku vzniká až po ní, takže před sázkou nikdo nezná obě poloviny. Není-li kolo vyúčtováno včas, sázka se vrací v plné výši a případ se zapíše do veřejného počítadla kontraktu.
Jak se z čísla kola stane výsledek
Kolo tvoří 10 až 100 sázek po 0,01 SOL (na kole štěstí až 1 000); menší kolo program odmítne. Číslo kola se rozvine do nezávislé náhodné hodnoty pro každou sázku a pro každou z nich kontrakt postupně odpovídá na tyto otázky:
- Superjackpot, jackpot, mini jackpot? Šance každého banku se rovná příspěvku zatočení do něj vydělenému počáteční částkou banku. O bank se losuje jen tehdy, když je v něm alespoň 25 % jeho počáteční částky.
- Výhra ve hře? Každá hra má vlastní šanci na výhru a vlastní tabulku šesti stupňů s vahami. Například v Kole štěstí padne výhra při 10 % zatočení. Tabulky všech her jsou uvedeny na jejich stránkách.
- „Točit znovu“? S pravděpodobností 11,6 % se sázka zdarma zopakuje na účet výherní banky.
- Jinak sázka žádnou výhru nezíská. Rozdělí se stejně jako každá jiná: výherní banka, jackpoty a podíl správce.
Tabulky her se liší, ale očekávaná výplata z nich je stejná (s přesností na setiny procenta; při výherní bance 40 SOL a více, kdy výhry nenarážejí na strop): přibližně 77,5 % sázky v běžných výhrách a spolu s opakováními „Točit znovu“ přibližně 88 % placených sázek. Tuto rovnost kontroluje kompilátor: vyjde-li očekávaná hodnota některé hry vyšší než u kola štěstí, nebo nižší o více než půl procenta, program se nesestaví.
Kam kontrakt ukládá každou sázku
| Kam | Podíl z placené sázky | Účel |
|---|---|---|
| Výherní banka | ≈88% | běžné výhry všech her |
| Jackpot, mini jackpot, superjackpot a rezerva pro počáteční částky | ≈5% | tři společné banky |
| Správce | ≈7% | příjem projektu; žádný jiný poplatek není |
V kódu jsou podíly zapsány na provedenou sázku včetně bezplatných opakování, proto se tam uvádí 6,18 % a 4,43 %: v přepočtu na placené sázky jsou to podíly z tabulky výše.
Limity a jejich důvody
- Jedna výhra je nejvýše čtvrtina výherní banky. Kontrakt nemůže slíbit víc, než má, a jedna velká výhra nevyprázdní banku všem ostatním. Co se nevyplatí, zůstává v bance.
- Výběr nemá čekací lhůtu: jeden podpis vaší peněženky a SOL obvykle dorazí během několika sekund. Dobití lze hned vybrat.
- Výhra jackpotu má strop: počítá se nejvýše z 3 počátečních částek u jackpotu a mini jackpotu a z 2,5 cílových částek u superjackpotu, tak jak byly zaznamenány při sázce. Co bank obsahuje nad to, zůstává v něm pro dalšího výherce. Ať tedy banky obsahují cokoli, sázka nikdy nemá vyšší hodnotu, než kolik stojí: její očekávaná návratnost je nejvýše 98,4 %.
- Počáteční částky jackpotů se mění se zpožděním 24 hodin. Šance kola jsou zafixovány v okamžiku sázky, takže je nelze změnit „na míru již uzavřené sázce“.
- Vrácení sázky za nedokončené kolo. Pokud kolo nebylo do přibližně 3,5 minuty vyúčtováno ani zapečetěno, výsledek už mít nebude: několik minut po sázce jej může kdokoli uzavřít a sázka se hráči vrátí v plné výši. Je-li kolo zapečetěno, ale provozovatel do přibližně 24 hodin neodhalil tajemství, sázka se vrací také. Každé vrácení se započítává do veřejného počítadla kontraktu (pole refunds). Pozdní vyúčtování. Je-li kolo vyúčtováno později než 20 minut po sázce, běžné výhry se vyplácejí a o jackpoty se v tomto kole nehraje. Ochrana trezoru. Před každou výplatou a po každém vyúčtování kontrakt kontroluje, že v trezoru není méně, než kolik dluží hráčům a bankům; jinak je operace odmítnuta. Tajemství došla. Když se tajemství aktuálního kořene vyčerpají, sázky se nepřijímají, dokud není nastaven nový kořen; zůstatky jsou nedotčené a výběr funguje.
- Jackpot se vyplácí ve splátkách: výherci náleží 76 % banku, z toho 20 % ihned a 8 % týdně. Nevyplacená část je zaznamenána na účtu výherce. Z částky, ze které se výhra jackpotu počítá, obdrží výherce 76%, 4% jde do superjackpotu a 20% zůstává v banku jako začátek příštího jackpotu. Výherce mini jackpotu obdrží 66,67% a 33,33% zůstává v banku.
- Výherní banka si ponechává 1 600 SOL. Co drží nad tuto částku, přechází samo do rezervy na konci každého vyúčtování, nejvýše 0,5 % sázky za jedno provedené zatočení. Neúčastní se toho žádný klíč a tento přebytek si nikdo nemůže vzít. Z rezervy se k hráčům dostává jako doplnění jackpotu a mini jackpotu po výhře.
- Jedno nedokončené kolo na hráče. Dokud není kolo vyúčtováno, nová sázka se nepřijme.
Co správce může a co nemůže
Může
- vybírat svůj podíl z placených sázek;
- vkládat SOL do rezervy a přesouvat je z rezervy do výherní banky;
- vybrat přebytek, který se při spuštění ocitl v trezoru nad počáteční částky, a zbytky po zaokrouhlení;
- měnit počáteční částky jackpotů, a to se zpožděním a ve stanovených mezích;
- pozastavit a obnovit příjem nových sázek, určit strážní klíč, který je může pouze pozastavit, předat svá práva jinému klíči a jednou zapnout výběr v běžných SOL.
Nemůže
- vybrat výherní banku, jackpoty, rezervu ani zůstatky hráčů;
- měnit tabulky výher, šanci na výhru v jednotlivých hrách ani podíly ze sázky: jsou to konstanty v kódu;
- vypočítat číslo kola před sázkou (blok sázky ještě neexistuje) ani po ní zaměnit tajemství kola;
- pozastavením zastavit výběry nebo výplaty: pozastavení se týká jen nových sázek.
Program byl spuštěn jako beta verze. Dokud beta verze trvá, lze jej aktualizovat jedním klíčem, oprávněním k aktualizaci (upgrade authority) 5U4P8nEVaTdMb6ucsRG6qjKDrGFfn33iYwhmjvTtYYGD; projekt plánuje oprávnění k aktualizaci po skončení beta verze odebrat a poté už program nikdo nemůže změnit. Adresa správce je FEC3Hg6oUtMynvtbTrmtY4TvamohqSTy5QAsrPubx6k2; co může a co nemůže, je uvedeno na stránce „Kontrakt“. Kdo tyto klíče drží dnes, ukazuje stránka „Stav platformy“, která to čte ze sítě. Samostatný kořenový klíč umí jedinou věc: zapsat otisk další sady tajemství kol. Dokud takový klíč není určen, dělá to držitel oprávnění k aktualizaci. Kořenový klíč existuje proto, aby hra pokračovala i po odebrání oprávnění k aktualizaci. Kdo ho drží, zná tato tajemství před sázkami, takže nepoctivý držitel by mohl hrát, nechat vyúčtovat jen kola, která vyhraje, a ostatní nechat vrátit. Omezuje to pozastavení nových sázek: může ho nastavit správce nebo strážní klíč a kořenový klíč ho zrušit nemůže. Klíč správce může vybírat podíl projektu, měnit počáteční částky jackpotů v mezích programu s odkladem 24 hodin, převádět SOL z rezervy do výherní banky, dokud banka drží méně než 1 600 SOL, a jen do této částky, pozastavit a obnovit příjem nových sázek, určit strážní klíč, který je může pouze pozastavit, předat svá práva jinému klíči a jednou zapnout výběr v běžných SOL. Nemůže si vzít výherní banku, jackpoty, rezervu ani zůstatek hráče: program takový příkaz nemá. Tento seznam zůstává stejný i po odebrání oprávnění k aktualizaci.
Výhrada. Program má oprávnění k aktualizaci: dokud není zrušeno, může jeho držitel nahradit kód novou verzí a vše výše uvedené pak bude platit pro nový kód. Stav tohoto oprávnění a každá aktualizace jsou vidět v průzkumníku sítě Solana.
Jak se to testuje
- Testy kontraktu: stejný podíl správce v každé hře, velmi blízká návratnost všech her při bance 50 SOL, pravidlo čtvrtiny banky a strop výhry podle stavu v okamžiku sázky, výběr hned po dobití, strop výhry jackpotu, odložená změna počátečních částek, pozdní vyúčtování, které není výhodnější než včasné.
- Kontrola zachování prostředků: desítky tisíc náhodných operací a po každé se částka v trezoru porovná se součtem zůstatků a banků.
- Dlouhé běhy: dva miliony sázek pro každou hru a součet toho, kolik bylo vyplaceno hráčům a kolik dostal správce.
- Skutečné transakce na lokálním uzlu Solana: dobití, výběr hned po něm, příspěvek do rezervy, změna počátečních částek.
- Testy webu: web počítá šance stejnými vzorci jako kontrakt a kontroluje se podle vzorků zaznamenaných kontraktem.
Omezení projektu jsou uvedena na stránce „Proč FAIRDRUM“. Jak si sami ověříte libovolné kolo, najdete na stránce „Ověření kola“.
Parametry kontraktu v jedné tabulce
- Jednotková sázka
- 0,01 SOL
- Kolo
- až 100 sázek ve hrách, až 1 000 v Kole štěstí
- Hry (režimy)
- 16
- Šance na „Točit znovu“
- 11,6%
- Strop jedné výhry
- 1/4 výherní banky
- Minimální počáteční částka
- jackpot 0,2 SOL, superjackpot 2 SOL
- Mini jackpot
- začíná na 1/10 jackpotu · Výherci: 66,67% · Zůstává v banku: 33,33%
- Výherci jackpotu
- 76% · 4 % jde do superjackpotu · Zůstává v banku: 20%
- Výherci superjackpotu
- 90%
- Výběr
- bez čekací lhůty
- Strop výhry jackpotu
- jackpot a mini jackpot: 3násobek počáteční částky; superjackpot: 2,5násobek cílové částky
- Pozdní vyúčtování (bez jackpotů)
- po 3 000 slotech sítě, přibližně 20 minut
- Vrácení sázky za nedokončené kolo
- nezapečetěné kolo několik minut po sázce; zapečetěné asi po 24 hodinách (216 000 slotů sítě)
- Síťový poplatek Solana
- přibližně 0,00005 SOL za kolo; jde síti, ne projektu
Web je rozhraním smart kontraktu
- Vyvolíte hru a své akce schvalujete vlastní peněženkou
- Webukazuje, co kontrakt zaznamenal, a posílá mu vaše akce
- Kontraktdrží herní zůstatky, počítá výsledky a připisuje výhry
Tabulky výher a podíly z každé sázky jsou zapsány v kontraktu a jsou stejné pro každou peněženku. Podíl projektu je jedním z těchto zapsaných podílů.
Vaše SOL drží kontrakt v síti Solana, ne tento web. Kontrakt nemá žádnou instrukci, která by komukoli jinému umožnila pohnout s vaším zůstatkem, a k výběru stačí podpis vaší peněženky. Funguje to, i když je tento web nedostupný.