A8: public results, reproducible proof, guide and rules (WEB-12, WEB-13, RND-37)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
42e5e33371
commit
58d1a38ac0
15 files changed
+454
-10
No files matched your search
@@ -0,0 +1,63 @@
|
||||
"""The public proof of a round's draw (WEB-12, RND-37): everything anyone needs to recompute the winner, and the
|
||||
recomputation itself. It carries no username and no account data — participants appear only under the pseudonymous
|
||||
address of the public draw list (DAT-65) — and a field not yet available is `None`, never invented."""
|
||||
|
||||
from typing import Any
|
||||
|
||||
from plm_engine.draw import draw_index, draw_seed, participants_hash, server_seed_commitment
|
||||
|
||||
from .addresses import participant_address
|
||||
from .format import plm_text
|
||||
from .models import Participation, Round
|
||||
|
||||
|
||||
def round_proof(round_: Round) -> dict[str, Any]:
|
||||
drawn = round_.participants_hash is not None # the list is fixed once the round enters `drawing` (RND-14)
|
||||
rows = []
|
||||
if drawn:
|
||||
participants = (Participation.objects.filter(round=round_, draw_position__isnull=False)
|
||||
.select_related("user").order_by("draw_position"))
|
||||
rows = [{"position": p.draw_position, "txid": p.bet_txid, "vout": p.bet_vout,
|
||||
"address": participant_address(p.user), "amount_sats": p.bet_amount_sats} for p in participants]
|
||||
|
||||
data: dict[str, Any] = {
|
||||
"round_id": round_.pk, "status": round_.status,
|
||||
"server_seed_hash": round_.server_seed_hash, "pool_address": round_.pool_address or None,
|
||||
"participants": rows, "participants_hash": round_.participants_hash,
|
||||
"draw_height": round_.draw_height, "draw_confirmations": round_.draw_confirmations,
|
||||
"server_seed": round_.server_seed, "draw_block_hash": round_.draw_block_hash,
|
||||
"seed": None, "index": None, "winner_address": None, "winner_position": None,
|
||||
"pool_amount_sats": round_.pool_amount_sats, "winner_amount_sats": round_.winner_amount_sats,
|
||||
"fee_amount_sats": round_.fee_amount_sats,
|
||||
"payout_txid": None, "payout_confirmed": False,
|
||||
"checks": None,
|
||||
}
|
||||
if round_.pool_amount_sats is not None:
|
||||
data["pool_text"] = plm_text(round_.pool_amount_sats)
|
||||
if round_.winner_amount_sats is not None:
|
||||
data["winner_amount_text"] = plm_text(round_.winner_amount_sats)
|
||||
if round_.payout_transaction_id is not None:
|
||||
payout = round_.payout_transaction
|
||||
data["payout_txid"] = payout.current_txid
|
||||
data["payout_confirmed"] = payout.status == "confirmed" # confirmed only when it is (WEB-12)
|
||||
|
||||
if round_.server_seed and round_.draw_block_hash and drawn and rows:
|
||||
seed = draw_seed(round_.server_seed, round_.draw_block_hash, round_.participants_hash)
|
||||
index = draw_index(seed, len(rows))
|
||||
data.update(seed=f"{seed:064x}", index=index, winner_position=index, winner_address=rows[index]["address"])
|
||||
data["checks"] = _checks(round_, rows, index)
|
||||
elif round_.server_seed: # closed with nobody in it: the secret is revealed, there is nothing to draw
|
||||
data["checks"] = {"commitment": server_seed_commitment(round_.server_seed) == round_.server_seed_hash}
|
||||
return data
|
||||
|
||||
|
||||
def _checks(round_: Round, rows: list[dict[str, Any]], index: int) -> dict[str, bool]:
|
||||
"""The recomputation the page shows, done with the same primitives anyone can reimplement from the guide."""
|
||||
stored_winner = (Participation.objects.filter(round=round_, user_id=round_.winner_id).values_list("draw_position", flat=True)
|
||||
.first() if round_.winner_id else None)
|
||||
return {
|
||||
"commitment": server_seed_commitment(round_.server_seed) == round_.server_seed_hash,
|
||||
"order": [r["position"] for r in rows] == list(range(len(rows))) and [r["txid"] for r in rows] == sorted(r["txid"] for r in rows),
|
||||
"fingerprint": participants_hash([(r["txid"], r["vout"], r["address"]) for r in rows]) == round_.participants_hash,
|
||||
"winner": stored_winner == index,
|
||||
}
|
||||
Reference in new issue
Block a user