gnodice state

SetPaused

SetPaused met le jeu en pause (true) ou le relance (false). En pause, les nouvelles mises sont refusées mais les parties en cours peuvent se terminer.

SetCroupier

SetCroupier désigne l'adresse du service qui tire les dés.

SetBlocked

SetBlocked interdit (true) ou autorise de nouveau (false) une adresse à jouer. Les parties déjà en cours de cette adresse se terminent normalement.

SetLimits

SetLimits règle le coupe-circuit (gains maximum par jour) et le seuil d'alerte de la banque, en ugnot.

TransferOwnership

TransferOwnership PROPOSE un nouveau propriétaire. Il ne devient propriétaire qu'en appelant AcceptOwnership : une faute de frappe dans l'adresse ne fait donc jamais perdre le contrôle du contrat.

AcceptOwnership

AcceptOwnership : le propriétaire proposé accepte le contrôle du contrat.

Owner

Croupier

assertOwner

GetInfoJSON

GetInfoJSON renvoie l'état global du jeu et les dernières parties terminées.

GetPlayerJSON

GetPlayerJSON renvoie les statistiques d'un joueur, son temps d'attente, ses parties en cours et ses 10 dernières parties terminées.

GetGameJSON

GetGameJSON renvoie une partie, ou {"error":...} si elle n'existe pas.

GetOpenGamesJSON

GetOpenGamesJSON renvoie les parties en cours (en attente de tirage ou de révélation), de la plus ancienne à la plus récente, à partir du numéro \`after\` exclu (pagination ; 0 pour commencer). Utilisé par le croupier.

writePlayerOpenGames

writeGameIDs

writeGameIDs écrit les parties de la plus récente à la plus ancienne.

writeGame

str

Chaque champ est suivi d'une virgule ; le dernier champ d'un objet est écrit à la main, sans virgule.

num

boolean

Fund

Fund alimente la banque. N'importe qui peut l'appeler en envoyant des GNOT.

Withdraw

Withdraw retire des GNOT DISPONIBLES vers le propriétaire. L'argent réservé aux parties en cours ne peut pas être retiré. amount est en ugnot.

Bankroll

Bankroll renvoie le solde total de la banque en ugnot.

Reserved

Reserved renvoie la somme réservée aux parties en cours, en ugnot.

Available

Available renvoie le solde libre (non réservé), en ugnot.

MaxCoverableBet

MaxCoverableBet renvoie la plus grosse mise (en ugnot) acceptée en ce moment. Une mise b arrive dans la banque puis réserve 5 x b : il faut donc disponible + b >= 5 x b, soit b \<= disponible / 4. Renvoie 0 si le jeu est en pause ou si la limite du jour est atteinte.

available

rollDay

rollDay remet le compteur de gains à zéro quand on change de jour.

dailyLimitReached

recordPayout

recordPayout compte un gain payé. Coupe-circuit : si les gains du jour dépassent la limite (signe possible d'une attaque ou d'un croupier compromis), le jeu se met en pause tout seul. Le gain en cours est quand même payé : le joueur a gagné honnêtement.

checkLowBankroll

checkLowBankroll émet une alerte quand le solde disponible passe sous le seuil.

hexLen

// 32 octets écrits en hexadécimal

Commitment

Commitment calcule l'empreinte d'un chiffre caché. Lecture seule : le site et le croupier peuvent l'appeler pour vérifier leurs calculs.

rollFromSeed

rollFromSeed calcule le dé à partir de la graine du croupier, de l'empreinte du joueur et du numéro de la partie. Le modulo 6 sur 64 bits a un biais inférieur à 1 sur 3 milliards de milliards : négligeable.

RollFor

RollFor : version publique de rollFromSeed, pour que chacun puisse vérifier un tirage passé (graine et empreinte sont publiques après le tirage).

isHex64

isHex64 : exactement 64 caractères hexadécimaux minuscules.

itoa64

Play

Play mise sur un chiffre caché. Le joueur envoie sa mise (1 à 10 GNOT) avec la transaction et l'empreinte de son chiffre (voir Commitment). Renvoie le numéro de la partie, par exemple "id=42".

Resolve

Resolve tire le dé d'une partie en attente. Réservé au croupier, qui fournit une graine aléatoire de 32 octets (64 caractères hexadécimaux) sans connaître le chiffre du joueur. La graine est publiée : chacun peut refaire le calcul.

Reveal

Reveal dévoile le chiffre caché et termine la partie. N'importe qui peut l'appeler (le joueur ou le service du site) : le gain va toujours au joueur. Renvoie le résultat, par exemple "roll=4;won=true;payout=50000000".

Refund

Refund rend sa mise au joueur si le croupier n'a pas tiré le dé à temps (ResolveTimeout). N'importe qui peut le déclencher : l'argent va au joueur.

Expire

Expire termine une partie dont le chiffre n'a jamais été dévoilé (RevealWindow) : elle compte comme perdue et la réserve est libérée. N'importe qui peut l'appeler.

receivedBet

receivedBet vérifie la mise envoyée avec la transaction et renvoie son montant.

finish

finish : partie terminée. Libère la réserve, la retire des parties en cours et l'ajoute aux historiques.

pay

pay envoie des GNOT de la banque vers une adresse.

cooldownRemaining

cooldownRemaining renvoie le nombre de secondes à attendre avant de pouvoir rejouer (0 si le joueur peut jouer maintenant).

formatDuration

formatDuration transforme un nombre de secondes en texte, ex. "7 min 12 s".

Denom

Paramètres du jeu. 1 GNOT = 1 000 000 ugnot (la plus petite unité).

UgnotPerGnot

Paramètres du jeu. 1 GNOT = 1 000 000 ugnot (la plus petite unité).

MinBet

// mise minimale : 1 GNOT

MaxBet

// mise maximale : 10 GNOT

PayoutMultiplier

// gain = 5 x la mise

CooldownSeconds

// 10 minutes entre deux lancers

HistorySize

// nombre de parties gardées par joueur

DieFaces

Paramètres du jeu. 1 GNOT = 1 000 000 ugnot (la plus petite unité).

ResolveTimeout

// sans tirage au bout de 30 min : le joueur peut être remboursé

RevealWindow

// 7 jours pour dévoiler son chiffre après le tirage

DefaultDailyPayoutLimit

// au-delà, le jeu se met en pause tout seul

DefaultLowBankroll

// en dessous, un événement d'alerte est émis

maxPageSize

// nombre maximal de parties renvoyées par une lecture

Status

Status : étape d'une partie.

StatusPending

// mise reçue, en attente du tirage

StatusRolled

// dé tiré, en attente du chiffre dévoilé

StatusWon

// chiffre dévoilé : gagné et payé

StatusLost

// chiffre dévoilé : perdu

StatusRefunded

// croupier trop lent : mise rendue

StatusExpired

// chiffre jamais dévoilé : perdu

Game

Game décrit une partie.

playerData

playerData regroupe les informations d'un joueur.

owner

// propriétaire : retraits, pause, réglages

pendingOwner

// propriétaire proposé, qui doit accepter (TransferOwnership en 2 temps)

croupier

// service autorisé à tirer les dés (Resolve)

realmAddr

// adresse du contrat = adresse de la banque

paused

games

// numéro (texte à zéros) -> \*Game

openGames

// parties en cours, même clé -> true

players

// adresse -> \*playerData

blocked

// adresses interdites de jeu -> true

recent

// dernières parties, tous joueurs confondus

reserved

// somme des gains maximaux des parties en cours

totalGames

// parties créées (= dernier numéro)

totalWins

totalLosses

totalRefunded

totalExpired

totalWagered

totalPaid

totalFunded

totalWithdrawn

dailyPayoutLimit

lowBankroll

payoutDay

payoutToday

init.92

now

height

gameKey

gameKey : clé de tri des parties (zéros devant pour garder l'ordre).

getGame

mustGetGame

getPlayer

isBlocked

pushID

pushID ajoute un numéro de partie en ne gardant que les HistorySize derniers.

Render

Render affiche une page lisible sur gnoweb (le site officiel de gno.land). - chemin "" : règles, banque et dernières parties - chemin "player/\<g1...>" : statistiques et historique d'un joueur - chemin "game/\<numéro>" : une partie, avec de quoi vérifier le tirage Le chemin est choisi par le visiteur : on ne l'affiche jamais tel quel, on n'utilise qu'une adresse ou un numéro validés.

renderHome

renderPlayer

renderGame

writeGamesTable

digitOrDash

shortAddress

shortAddress raccourcit une adresse : g1abcd...wxyz

formatGnot

formatGnot convertit des ugnot en GNOT lisibles : 1500000 -> "1.5"