Het contract: hoe en waarom het werkt

Een smart contract is een programma dat wordt uitgevoerd door de nodes van het Solana-netwerk en niet op een server van het project. De code is voor iedereen gelijk en elke handeling is een openbare transactie. Het FAIRDRUM-contract is geschreven in Rust met de bibliotheek Anchor; de broncode is open.

Het adres van het programma verschijnt hier zodra de site met het contract is verbonden.

Een belangrijk gevolg: als de site fairdrum.to verdwijnt, blijven de tegoeden van de spelers in het contract staan en kun je ze opnemen met elk programma dat de opname-opdracht met de handtekening van je wallet kan versturen.

• Kluis. Eén account in wrapped SOL waarover alleen het programma zelf beschikt. Daarin zit alles: de saldi van de spelers, de prijzenbank, de jackpots, de reserve en het nog niet opgenomen aandeel van de beheerder.
• Gedeeld spelaccount. De registratie van hoe het bedrag in de kluis is verdeeld: prijzenbank, jackpot, mini-jackpot, superjackpot, reserve voor startbedragen, aandeel van de beheerder, startbedragen van de jackpots, rondetellers per spel.
• Spelersaccount. Wordt aangemaakt met de opdracht register, die de site samen met de eerste storting verstuurt, en is gekoppeld aan het walletadres: spelsaldo, tijdstip van de laatste storting, onafgemaakte ronde, nog niet uitbetaald deel van de jackpot.
• Sessieaccount (als ‘spelen zonder handtekeningen’ aanstaat): een tijdelijke sleutel, een looptijd en een inzetlimiet.

De boekhouding is zo opgezet dat de som van alle saldi en potten gelijk is aan het bedrag in de kluis. Een test controleert die gelijkheid na elk van tienduizenden willekeurige bewerkingen.

1. Inzet. De opdracht spin_commit schrijft de ronde af van je saldo en maakt in dezelfde transactie bij het orakel ORAO een aanvraag voor een willekeurig getal aan. Het adres van de aanvraag wordt berekend uit je wallet en het rondenummer, dus de aanvraag van iemand anders onderschuiven kan niet.
2. Getal. Meerdere onafhankelijke ORAO-nodes ondertekenen het willekeurige getal en schrijven het naar het netwerk. Tot dat moment kent niemand het: jij niet, het project niet en ook geen afzonderlijke node.
3. Afrekening. De opdracht spin_settle leest het getal uit de registratie van het orakel, controleert of het de aanvraag van precies jouw ronde is en berekent de uitbetaling. De site verstuurt die zelf; is de pagina gesloten, dan doet het dienstdoende programma van het project het, of jijzelf bij je volgende bezoek.
4. Weergave. Kaarten, mijnen, raket, stenen: het zijn manieren om de al berekende uitbetaling te tonen. Wat je in het spel aanklikt, heeft er geen invloed op.

Waarom het resultaat niet vooraf te kennen en niet te vervalsen is. Het uiteindelijke getal van een ronde is het getal van het orakel, gemengd met de hash van het blok waarin de inzet is vastgelegd. Op het moment van de inzet bestaat die hash nog niet, en het getal van het orakel komt later en van een derde partij: niemand kan de uitkomst vooraf berekenen — de speler niet, het project niet en het orakel zelf ook niet. Het spel, de startbedragen van de jackpots en het prijsplafond worden vastgelegd op het moment van de inzet, en de rekenformule staat in open code. Een te late afrekening is nooit gunstiger dan een tijdige. De regels zijn alleen te veranderen door de code van het programma te vervangen, en dat ziet iedereen (zie het deel over de beheerder).

Een ronde bestaat uit 1 tot 100 inzetten van 0,01 SOL (op het rad tot 1000). Het getal van het orakel wordt uitgewerkt tot een onafhankelijke willekeurige waarde voor elke inzet, en voor elke inzet beantwoordt het contract achtereenvolgens deze vragen:

1. Superjackpot, jackpot, mini-jackpot? De kans op elke pot is gelijk aan de bijdrage van de inzet aan die pot, gedeeld door het startbedrag van de pot. Een pot wordt alleen verloot als er minstens 25% van het startbedrag in zit.
2. Prijs van het spel? Elk spel heeft een eigen prijskans en een eigen tabel van zes treden met gewichten. Op het rad valt er bijvoorbeeld bij 10% van de inzetten een prijs. De tabellen van alle spellen staan op hun pagina's.
3. ‘Nog een keer’? Met een kans van 11,6% wordt de inzet gratis herhaald op kosten van de prijzenbank.
4. Anders is het een inzet zonder prijs. Die wordt net zo verdeeld als elke andere: prijzenbank, jackpots en aandeel van de beheerder.

De tabellen van de spellen verschillen, maar de verwachte uitbetaling is overal gelijk (tot op honderdsten van een procent; bij een prijzenbank vanaf 40 SOL, wanneer prijzen niet tegen het plafond lopen): ongeveer 77,5% van de inzet aan gewone prijzen, en samen met de herhalingen ‘Nog een keer’ ongeveer 88% van de betaalde inzetten. De compiler controleert die gelijkheid: als de verwachting van een spel hoger uitkomt dan die van het rad, of meer dan een half procent lager, laat het programma zich niet bouwen.

• Eén prijs is niet meer dan een kwart van de prijzenbank. Het contract kan niet meer beloven dan het heeft, en één grote winst maakt de bank niet leeg voor de anderen. Wat niet wordt uitbetaald, blijft in de bank.
• Opnemen kan 12 uur na de laatste storting. De regel is voor iedereen gelijk en als constante vastgelegd: hij kan alleen met een nieuwe versie van het programma worden gewijzigd.
• De startbedragen van de jackpots veranderen met een vertraging van 24 uur. De kansen van een ronde worden vastgelegd op het moment van de inzet; ze aanpassen ‘op een al geplaatste inzet’ kan dus niet.
• 20 minuten voor de afrekening. Als het orakel niet heeft gereageerd, gaat de inzet volledig terug naar de speler: zolang het getal er niet is, kent niemand de uitkomst, dus op deze manier kan niemand onder een verlies uitkomen. Als het wel reageerde maar de afrekening te laat kwam, worden de gewone prijzen uitbetaald en worden de jackpots in die ronde niet verloot. Kluisbeveiliging. Vóór elke uitbetaling en na elke afrekening controleert het contract of er in de kluis niet minder zit dan het aan spelers en potten verschuldigd is; anders wordt de bewerking geweigerd. Bewaker. Als het orakel niet meer reageert, wordt het aannemen van nieuwe inzetten automatisch gepauzeerd; afrekeningen en opnemen blijven werken.
• De jackpot wordt in delen uitbetaald: de winnaar heeft recht op 95% van de pot, waarvan 20% direct en 8% per week. Het nog niet uitbetaalde deel staat op het account van de winnaar.
• Eén onafgemaakte ronde per speler. Zolang de ronde niet is afgerekend, wordt er geen nieuwe inzet aangenomen.

• Tests van het contract: aandeel van de beheerder 10% in elk spel, vrijwel gelijk rendement van alle spellen bij een bank van 50 SOL, de kwartregel en het prijsplafond van het moment van de inzet, het opnameslot, de uitgestelde wijziging van startbedragen, een late afrekening is niet gunstiger dan een tijdige.
• Controle op behoud van tegoeden: tienduizenden willekeurige bewerkingen; na elke bewerking wordt het bedrag in de kluis vergeleken met de som van saldi en potten.
• Lange runs: twee miljoen inzetten per spel — hoeveel er aan spelers is uitbetaald en hoeveel de beheerder heeft gekregen.
• Echte transacties op een lokale Solana-node: storting, geweigerde opname vóór de termijn, inleg in de reserve, wijziging van startbedragen.
• Tests van de site: de site berekent de kansen met dezelfde formules als het contract en vergelijkt ze met voorbeelden die het contract heeft vastgelegd.

Wat niet is getest en niet is gedaan, staat onverbloemd op de pagina ‘Waarom FAIRDRUM’. Hoe je zelf een willekeurige ronde controleert, staat op de pagina ‘Ronde controleren’.