Dokumentace

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áč

    • register
    • deposit
    • withdraw_sol
    • withdraw
    • spin_commithráč nebo jeho klíč relace
    • session_open
    • session_close
    • checkin
  • kdokoli

    • deposit_sweep
    • spin_settle
    • spin_expire
    • spin_seal
    • donate
    • roll_epoch
    • fund_pools
  • správce

    • set_jackpot_starts
    • rescale_pools
    • set_paused
    • set_guardian
    • guard_pausestrážní klíč nebo správce
    • propose_dev_authority
    • accept_dev_authoritynový klíč správce
    • init_unwrap
    • claim_dev
    • promo_payklíč promo fondu
    • set_house_rootkořenový klíč; dokud není určen, držitel oprávnění k aktualizaci
    • set_root_authoritydržitel oprávnění k aktualizaci programu
    • propose_root_authoritykořenový klíč
    • accept_root_authoritynový kořenový klíč
    • initializedržitel oprávnění k aktualizaci programu
Kontraktdrží herní zůstatky, počítá výsledky a připisuje výhry

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říkazKdo podepisujeCo dělá
registerhráčVytvoří účet hráče. Web jej posílá spolu s prvním dobitím.
deposithráčDobije herní zůstatek z peněženky. Částku lze hned použít ke hře nebo vybrat.
deposit_sweepkdokoliPř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_solhráč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.
withdrawhráč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_commithráč nebo jeho klíč relaceSázka: odečte kolo ze zůstatku a zapamatuje si hru, platné šance, blok sázky a číslo tajemství kola.
spin_settlekdokoliVyúč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_expirekdokoliVrá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_sealkdokoliZapečetí kolo: zaznamená hash bloku sázky, dokud je dostupný (přibližně 3,5 minuty). Obvykle to dělá provozovatel.
session_openhráč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_closehráč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.
donatekdokoliVloží SOL do rezervy pro počáteční částky jackpotů. Opačný příkaz neexistuje.
set_jackpot_startssprávceNastaví nové počáteční částky jackpotu a superjackpotu; začnou platit po 24 hodinách.
rescale_poolssprávcePř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_pausedsprávcePozastaví 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_guardiansprávceSprá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_pausestrážní klíč nebo správceSprá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_authoritysprávcePř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_authoritynový klíč správcePřevod práv správce na jiný klíč ve dvou krocích: současný klíč určí nový a nový to sám potvrdí.
init_unwrapsprávceJednorázový příkaz. Vytvoří servisní účet, přes který pracuje withdraw_sol. Zpětný příkaz neexistuje.
claim_devsprávceVybere nahromaděný podíl správce a nic jiného.
promo_payklíč promo fonduVýplata z promo fondu, nejvýše do výše jeho zbývajícího zůstatku.
set_house_rootkořenový klíč; dokud není určen, držitel oprávnění k aktualizaciNastaví 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_authoritydržitel oprávnění k aktualizaci programuUrčí kořenový klíč nebo ho nahradí. Funguje jen, dokud má program oprávnění k aktualizaci.
propose_root_authoritykoř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_authoritynový 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_epochkdokoliÚdržba. Aktualizuje týdenní statistiky. Prostředky nepřesouvá.
checkinhráčÚdržba. Aktualizuje značku dne hráče. Prostředky nepřesouvá.
initializedržitel oprávnění k aktualizaci programuJednorázové spuštění. Vytvoří účty kontraktu a zapíše nastavení spuštění.
fund_poolskdokoliJednorá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

  1. 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.
  2. Čí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.
  3. 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.
  4. 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:

  1. 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.
  2. 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.
  3. „Točit znovu“? S pravděpodobností 11,6 % se sázka zdarma zopakuje na účet výherní banky.
  4. 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

KamPodí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

  1. Vyvolíte hru a své akce schvalujete vlastní peněženkou
  2. Webukazuje, co kontrakt zaznamenal, a posílá mu vaše akce
  3. 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ý.

Čtěte dál