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,48 @@
|
||||
from django.core.paginator import Paginator
|
||||
from django.http import JsonResponse
|
||||
from django.shortcuts import get_object_or_404, render
|
||||
from django.views.decorators.cache import never_cache
|
||||
|
||||
from apps.lottery.format import plm_text
|
||||
from apps.lottery.models import LotteryConfig, Round
|
||||
from apps.lottery.proof import round_proof
|
||||
from apps.lottery.rules import WINNER_PERCENT
|
||||
|
||||
PAGE_SIZE = 20
|
||||
|
||||
|
||||
def results(request):
|
||||
"""Concluded rounds, newest first (WEB-12): who won is only ever an address of the public draw list."""
|
||||
rounds = Round.objects.filter(status=Round.Status.CLOSED).order_by("-id")
|
||||
page = Paginator(rounds, PAGE_SIZE).get_page(request.GET.get("pagina"))
|
||||
rows = [{"id": r.pk, "closed_at": r.closed_at, "pool_text": plm_text(r.pool_amount_sats or 0),
|
||||
"winner_text": plm_text(r.winner_amount_sats) if r.winner_amount_sats else "",
|
||||
"has_winner": r.winner_id is not None} for r in page]
|
||||
return render(request, "web/results.html", {"rows": rows, "page": page})
|
||||
|
||||
|
||||
@never_cache
|
||||
def result_detail(request, round_id):
|
||||
round_ = get_object_or_404(Round.objects.select_related("payout_transaction"), pk=round_id)
|
||||
return render(request, "web/result_detail.html", {"p": round_proof(round_), "round": round_})
|
||||
|
||||
|
||||
@never_cache
|
||||
def result_proof_json(request, round_id):
|
||||
round_ = get_object_or_404(Round.objects.select_related("payout_transaction"), pk=round_id)
|
||||
return JsonResponse(round_proof(round_))
|
||||
|
||||
|
||||
def _terms():
|
||||
config = LotteryConfig.get()
|
||||
return {"bet_text": plm_text(config.bet_amount_sats), "winner_percent": WINNER_PERCENT,
|
||||
"platform_percent": 100 - WINNER_PERCENT, "duration_minutes": max(1, config.round_duration_seconds // 60),
|
||||
"confirmations": config.draw_confirmations}
|
||||
|
||||
|
||||
def guide(request):
|
||||
return render(request, "web/guide.html", _terms())
|
||||
|
||||
|
||||
def rules(request):
|
||||
return render(request, "web/rules.html", _terms())
|
||||
@@ -122,3 +122,14 @@ input[type=text].address { width: auto; }
|
||||
.movements td::before { content: attr(data-label); color: var(--muted); font-size: .9rem; text-align: left; }
|
||||
.movements td.num { text-align: right; }
|
||||
}
|
||||
|
||||
/* A8 — public results, guide, rules */
|
||||
.break { overflow-wrap: anywhere; word-break: break-all; }
|
||||
.facts dt { color: var(--muted); font-size: .9rem; margin-top: .8rem; }
|
||||
.facts dd { margin: .15rem 0 0; }
|
||||
.checks li { padding: .35rem 0 .35rem 1.6rem; position: relative; }
|
||||
.checks li::before { position: absolute; left: 0; font-weight: 700; }
|
||||
.checks li[data-ok="1"]::before { content: "✓"; color: var(--ok); }
|
||||
.checks li[data-ok="0"]::before { content: "✗"; color: var(--error); }
|
||||
.movements tr.winner td { font-weight: 600; }
|
||||
.steps li, .rules li { margin-bottom: .7rem; max-width: 42rem; }
|
||||
@@ -15,6 +15,9 @@
|
||||
<a class="brand" href="{% url 'web:home' %}">PLM Lottery</a>
|
||||
<nav class="nav" aria-label="Principale">
|
||||
<a href="{% url 'web:home' %}">Home</a>
|
||||
<a href="{% url 'web:results' %}">Risultati</a>
|
||||
<a href="{% url 'web:guide' %}">Guida</a>
|
||||
<a href="{% url 'web:rules' %}">Regole</a>
|
||||
{% if user.is_authenticated %}
|
||||
{% with current=request.resolver_match.view_name %}
|
||||
<a href="{% url 'web:app-home' %}"{% if current == 'web:app-home' or current == 'web:bet' %} aria-current="page"{% endif %}>Gioca</a>
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
{% extends "web/base.html" %}
|
||||
{% block title %}Guida · PLM Lottery{% endblock %}
|
||||
{% block content %}
|
||||
<h1>Guida</h1>
|
||||
<p class="lead">Come si gioca, in quattro passi. I termini sono gli stessi che trovi nell'area giocatore.</p>
|
||||
<ol class="steps">
|
||||
<li><strong>Registrati e accedi.</strong> Bastano nome utente e password: non chiediamo email.</li>
|
||||
<li><strong>Deposita.</strong> Dal <a href="{% url 'web:wallet' %}">portafoglio</a> trovi il tuo indirizzo. I fondi compaiono «in conferma» e diventano spendibili solo dopo le conferme: l'accredito non è immediato.</li>
|
||||
<li><strong>Punta.</strong> La quota è {{ bet_text }}. Una puntata per round, con una schermata di conferma prima dell'invio.</li>
|
||||
<li><strong>Attendi l'estrazione.</strong> A scadenza si attende la conferma delle puntate, poi un blocco della catena sceglie il vincitore. Il premio arriva sul suo saldo quando il pagamento è confermato.</li>
|
||||
</ol>
|
||||
<p>Ogni estrazione si può controllare: vedi i <a href="{% url 'web:results' %}">risultati</a> e le <a href="{% url 'web:rules' %}">regole</a>.</p>
|
||||
{% endblock %}
|
||||
@@ -7,4 +7,5 @@
|
||||
|
||||
{% url 'web:state' as poll_url %}
|
||||
{% include "web/_round_card.html" with poll_url=poll_url show_participate=True %}
|
||||
<p><a href="{% url 'web:results' %}">Risultati e prove delle estrazioni passate</a> · <a href="{% url 'web:guide' %}">Come si gioca</a></p>
|
||||
{% endblock %}
|
||||
@@ -0,0 +1,85 @@
|
||||
{% extends "web/base.html" %}
|
||||
{% block title %}Round {{ p.round_id }} · PLM Lottery{% endblock %}
|
||||
{% block content %}
|
||||
<p><a href="{% url 'web:results' %}">← Tutti i risultati</a></p>
|
||||
<h1>Round {{ p.round_id }}</h1>
|
||||
|
||||
<section class="card" aria-labelledby="esito">
|
||||
<h2 id="esito">Esito</h2>
|
||||
{% if p.winner_address %}
|
||||
<p>Vincitore: posizione <strong>{{ p.winner_position }}</strong>, indirizzo <code class="break">{{ p.winner_address }}</code>.</p>
|
||||
{% if p.winner_amount_text %}<p>Montepremi {{ p.pool_text }}; al vincitore {{ p.winner_amount_text }} ({{ p.winner_amount_sats|default:0 }} sat), il resto alla piattaforma.</p>{% endif %}
|
||||
<p>
|
||||
{% if p.payout_confirmed %}Pagamento <strong>confermato</strong>{% if p.payout_txid %} · transazione <code class="break">{{ p.payout_txid }}</code>{% endif %}.
|
||||
{% elif p.payout_txid %}Pagamento inviato, <strong>in attesa di conferma</strong>.
|
||||
{% else %}Pagamento non ancora inviato.{% endif %}
|
||||
</p>
|
||||
{% elif round.status == "closed" %}
|
||||
<p>Nessun partecipante: non c'è stata estrazione e nulla da pagare.</p>
|
||||
{% else %}
|
||||
<p>L'estrazione non è ancora avvenuta: il round è «{{ round.get_status_display }}».</p>
|
||||
{% endif %}
|
||||
</section>
|
||||
|
||||
{% if p.checks %}
|
||||
<section class="card" aria-labelledby="ricalcolo">
|
||||
<h2 id="ricalcolo">Ricalcolo</h2>
|
||||
<ul class="plain checks">
|
||||
<li data-ok="{{ p.checks.commitment|yesno:'1,0' }}">Impegno: lo sha256 del segreto rivelato coincide con quello pubblicato prima dell'estrazione.</li>
|
||||
{% if p.checks.order is not None %}
|
||||
<li data-ok="{{ p.checks.order|yesno:'1,0' }}">Ordine: i partecipanti sono in ordine crescente di txid, posizioni da 0 a {{ p.participants|length|add:"-1" }}.</li>
|
||||
<li data-ok="{{ p.checks.fingerprint|yesno:'1,0' }}">Impronta: lo sha256 delle righe <code>txid:vout:indirizzo</code> coincide con l'impronta pubblicata.</li>
|
||||
<li data-ok="{{ p.checks.winner|yesno:'1,0' }}">Vincitore: la posizione {{ p.index }} è quella che ha ricevuto il premio.</li>
|
||||
{% endif %}
|
||||
</ul>
|
||||
</section>
|
||||
{% endif %}
|
||||
|
||||
<section class="card" aria-labelledby="dati">
|
||||
<h2 id="dati">Dati della prova</h2>
|
||||
<dl class="facts">
|
||||
<dt>Impegno sul segreto (<code>server_seed_hash</code>)</dt><dd><code class="break">{{ p.server_seed_hash|default:"non ancora disponibile" }}</code></dd>
|
||||
<dt>Indirizzo del montepremi</dt><dd><code class="break">{{ p.pool_address|default:"non ancora disponibile" }}</code></dd>
|
||||
<dt>Impronta dei partecipanti</dt><dd><code class="break">{{ p.participants_hash|default:"non ancora disponibile" }}</code></dd>
|
||||
<dt>Altezza del blocco</dt><dd>{{ p.draw_height|default_if_none:"non ancora disponibile" }} (conferme attese: {{ p.draw_confirmations }})</dd>
|
||||
<dt>Hash del blocco</dt><dd><code class="break">{{ p.draw_block_hash|default:"non ancora disponibile" }}</code></dd>
|
||||
<dt>Segreto rivelato (<code>server_seed</code>)</dt><dd><code class="break">{{ p.server_seed|default:"si rivela all'estrazione" }}</code></dd>
|
||||
<dt>Seme</dt><dd><code class="break">{{ p.seed|default:"non ancora disponibile" }}</code></dd>
|
||||
<dt>Posizione estratta</dt><dd>{{ p.index|default_if_none:"non ancora disponibile" }}</dd>
|
||||
</dl>
|
||||
<p><a href="{% url 'web:result-proof' p.round_id %}">Scarica la prova in JSON</a></p>
|
||||
</section>
|
||||
|
||||
{% if p.participants %}
|
||||
<section class="card" aria-labelledby="lista">
|
||||
<h2 id="lista">Partecipanti ({{ p.participants|length }})</h2>
|
||||
<div class="table-wrap">
|
||||
<table class="movements">
|
||||
<caption class="visually-hidden">Lista pubblica dell'estrazione, in ordine di posizione</caption>
|
||||
<thead><tr><th scope="col" class="num">Posizione</th><th scope="col">Transazione</th><th scope="col" class="num">Uscita</th><th scope="col">Indirizzo</th></tr></thead>
|
||||
<tbody>
|
||||
{% for r in p.participants %}
|
||||
<tr{% if r.position == p.winner_position and p.winner_address %} class="winner"{% endif %}>
|
||||
<td data-label="Posizione" class="num">{{ r.position }}</td>
|
||||
<td data-label="Transazione"><code class="break">{{ r.txid }}</code></td>
|
||||
<td data-label="Uscita" class="num">{{ r.vout }}</td>
|
||||
<td data-label="Indirizzo"><code class="break">{{ r.address }}</code></td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</section>
|
||||
{% endif %}
|
||||
|
||||
<section class="card" aria-labelledby="come">
|
||||
<h2 id="come">Come rifare il calcolo</h2>
|
||||
<ol>
|
||||
<li>Verifica che lo sha256 dei 32 byte del segreto sia uguale all'impegno.</li>
|
||||
<li>Ricostruisci le righe <code>txid:vout:indirizzo</code>, ognuna terminata da un a capo, nell'ordine della lista, e verifica che il loro sha256 sia l'impronta.</li>
|
||||
<li>Calcola lo sha256 della concatenazione di segreto, hash del blocco e impronta (32 byte ciascuno) e leggilo come intero big-endian: è il seme.</li>
|
||||
<li>Il resto della divisione del seme per il numero di partecipanti è la posizione vincente.</li>
|
||||
</ol>
|
||||
<p class="hint">I dati sono quelli del protocollo e si controllano con un qualunque nodo o explorer PLM.</p>
|
||||
</section>
|
||||
{% endblock %}
|
||||
@@ -0,0 +1,34 @@
|
||||
{% extends "web/base.html" %}
|
||||
{% block title %}Risultati · PLM Lottery{% endblock %}
|
||||
{% block content %}
|
||||
<h1>Risultati</h1>
|
||||
<p class="lead">Ogni round concluso ha una prova che chiunque può ricalcolare. I giocatori compaiono solo con un indirizzo pseudonimo.</p>
|
||||
{% if rows %}
|
||||
<div class="table-wrap">
|
||||
<table class="movements">
|
||||
<caption class="visually-hidden">Round conclusi, dal più recente</caption>
|
||||
<thead><tr><th scope="col">Round</th><th scope="col">Chiuso (UTC)</th><th scope="col" class="num">Montepremi</th><th scope="col" class="num">Al vincitore</th><th scope="col">Prova</th></tr></thead>
|
||||
<tbody>
|
||||
{% for row in rows %}
|
||||
<tr>
|
||||
<td data-label="Round">{{ row.id }}</td>
|
||||
<td data-label="Chiuso (UTC)"><time datetime="{{ row.closed_at|date:'c' }}">{{ row.closed_at|date:"d/m/Y H:i:s" }}</time></td>
|
||||
<td data-label="Montepremi" class="num">{{ row.pool_text }}</td>
|
||||
<td data-label="Al vincitore" class="num">{% if row.has_winner %}{{ row.winner_text }}{% else %}<span class="hint">nessun partecipante</span>{% endif %}</td>
|
||||
<td data-label="Prova"><a href="{% url 'web:result' row.id %}">Vedi la prova</a></td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
{% if page.paginator.num_pages > 1 %}
|
||||
<nav class="pager" aria-label="Pagine dei risultati">
|
||||
{% if page.has_previous %}<a class="button secondary small" href="?pagina={{ page.previous_page_number }}">← Più recenti</a>{% endif %}
|
||||
<span class="hint">Pagina {{ page.number }} di {{ page.paginator.num_pages }}</span>
|
||||
{% if page.has_next %}<a class="button secondary small" href="?pagina={{ page.next_page_number }}">Meno recenti →</a>{% endif %}
|
||||
</nav>
|
||||
{% endif %}
|
||||
{% else %}
|
||||
<p class="card">Nessun round è ancora concluso. Torna dopo la prima estrazione.</p>
|
||||
{% endif %}
|
||||
{% endblock %}
|
||||
@@ -0,0 +1,13 @@
|
||||
{% extends "web/base.html" %}
|
||||
{% block title %}Regole · PLM Lottery{% endblock %}
|
||||
{% block content %}
|
||||
<h1>Regole</h1>
|
||||
<ul class="rules">
|
||||
<li><strong>Quota.</strong> Ogni giocatore punta la stessa quota ({{ bet_text }}), al massimo una volta per round. Ogni puntata ha le stesse probabilità, qualunque sia il saldo.</li>
|
||||
<li><strong>Durata.</strong> Un round dura {{ duration_minutes }} minuti dall'apertura. Dopo la scadenza non si accettano più puntate; quelle già inviate vanno confermate.</li>
|
||||
<li><strong>Ripartizione.</strong> Il montepremi si divide {{ winner_percent }}% al vincitore e {{ platform_percent }}% alla piattaforma; l'eventuale resto dell'arrotondamento va alla piattaforma. Le commissioni di rete sono a carico del vincitore.</li>
|
||||
<li><strong>Attesa delle conferme.</strong> Depositi, puntate e pagamento contano quando la catena li conferma. L'estrazione usa un blocco che non esisteva alla chiusura del round, con {{ confirmations }} conferme.</li>
|
||||
<li><strong>Estrazione verificabile.</strong> Il segreto è impegnato prima dell'apertura delle puntate e rivelato dopo l'estrazione; la lista dei partecipanti è fissata prima del blocco. Chiunque ricalcola il vincitore dalla <a href="{% url 'web:results' %}">prova pubblica</a>.</li>
|
||||
<li><strong>Pause.</strong> La lotteria può fermarsi dopo il round in corso, o sospendere le nuove puntate; i round avviati si concludono e i fondi restano dei giocatori.</li>
|
||||
</ul>
|
||||
{% endblock %}
|
||||
+6
-1
@@ -1,6 +1,6 @@
|
||||
from django.urls import path
|
||||
|
||||
from . import player_views, views
|
||||
from . import player_views, public_views, views
|
||||
|
||||
app_name = "web"
|
||||
urlpatterns = [
|
||||
@@ -13,5 +13,10 @@ urlpatterns = [
|
||||
path("app/portafoglio/qr.svg", player_views.wallet_qr, name="wallet-qr"),
|
||||
path("app/portafoglio/deposito-prova/", player_views.simulated_deposit, name="simulated-deposit"),
|
||||
path("app/movimenti/", player_views.movements, name="movements"),
|
||||
path("risultati/", public_views.results, name="results"),
|
||||
path("risultati/<int:round_id>/", public_views.result_detail, name="result"),
|
||||
path("risultati/<int:round_id>/prova.json", public_views.result_proof_json, name="result-proof"),
|
||||
path("guida/", public_views.guide, name="guide"),
|
||||
path("regole/", public_views.rules, name="rules"),
|
||||
path("health/live", views.health_live, name="health-live"),
|
||||
]
|
||||
Reference in new issue
Block a user