Skip to content

Auditoría, plan por fases e implementación de las fases 0-7 - #4

Merged
Adlgr87 merged 17 commits into
mainfrom
arena/de3be963-betpoly-bot
Oct 23, 2026
Merged

Adlgr87 merged 17 commits into
mainfrom
arena/de3be963-betpoly-bot

Conversation

@Adlgr87

@Adlgr87 Adlgr87 commented Oct 23, 2026 •

Copy link
Copy Markdown
Owner

Qué contiene

Diez commits sobre main, en orden:

  1. c50224b — Auditoría (AUDITORIA.md). 7 hallazgos críticos/altos, 15 medios y 25 menores, cada uno con archivo:línea y prueba reproducible.
  2. f7c156c — Plan (PLAN_IMPLEMENTACION.md). 8 fases con dependencias, criterios de aceptación y 11 ADRs con la alternativa descartada.
  3. f479839 — Fases 0 y 1 implementadas.
  4. 97c3988 — Fase 2 implementada (administración del contrato escrow).
  5. 6183291 — Fase 3 implementada (endurecimiento de la API).
  6. 6bc6619 — Fase 4 implementada (economía única, importes configurables, U-05).
  7. 03798e0 — Fase 5 implementada (capa Telegram: navegación, importes, grupo, notificaciones).
  8. 9b05bc1 — Fase 6 implementada (rendimiento y activos: R-01…R-06, R-08, R-09), más 3c684f5 que arregla el gate de npm audit con una lista de excepciones caducables.
  9. 596794b — R-07: verify_ton_proof y settle_prediction en pasos con nombre, con un trinquete de complejidad sobre el AST.
  10. 0644ec4 — Fase 7 implementada (mantenibilidad, dependencias y tooling del contrato).
  11. eb8a036 — Identidad visual: el logo de BetPoly pasa a ser el icono del bot y la marca de la Mini App.

Fase 0 — Red de seguridad

  • .github/workflows/ci.yml con 4 jobs: lint (ruff + vulture), tests + cobertura, contrato (hash reproducible + sandbox TVM + npm audit) y pip-audit. Los 4 en verde.
  • requirements-dev.txt separado del runtime; .gitignore cubre artefactos de test.
  • pyproject.toml fija las reglas de ruff → 0 hallazgos.
  • Guardarraíles nuevos: tests/test_architecture.py (dirección de dependencias entre capas) y tests/test_wiring.py (rutas sin consumidor, botones sin handler, handlers sin botón, builders on-chain inalcanzables, comandos prometidos en /help). Baseline en trinquete: solo puede encogerse.

Fase 1 — Integridad del dinero on-chain

Hallazgo Arreglo
S-01 el indexador perdía eventos para siempre El cursor solo avanza sobre transacciones aplicadas; reintento inmediato y dead-letter (chain_tx_failures) con backoff 60 s → 1 h para que una tx envenenada no detenga el stream
S-02 el marcador ganaba a los datos reales insert_market_placeholder vs enrich_market_from_event; metadata_source impide sobrescribir metadatos reales
S-07 desvincular reservaba la wallet para siempre wallet_links reconstruida con clave subrogada e índices únicos parciales; migración automática sin pérdida de historial
F-05 cancelar un mercado vivo por error force explícito solo desde el bot, con confirmación; la API HTTP nunca lo envía
F-06 carrera resolución/apuestas pending_resolve_at: 15 min de bloqueo de apuestas y aviso en la Mini App

Fase 2 — Administración del contrato (S-03, D-03)

Pieza Qué hace
bot/chain/toncenter.py run_get_method(address, method, stack) con el stack normalizado (hex/decimal → int) y error si el exit code no es 0
bot/chain/escrow_state.py EscrowState con los seis getters + balance y EscrowStateCache (TTL 30 s, stale-while-error)
bot/markets.py prepare_withdraw_fees, prepare_set_fee, prepare_set_paused, prepare_change_admin: validan antes de firmar y devuelven PreparedTx sin firmar
Bot /admin → ⚙️ Contrato escrow: estado on-chain, retirar comisiones, cambiar comisión, pausar/reanudar y cambiar administrador, con confirmación explícita
Mini App Tarjeta de estado en Admin y las cuatro acciones firmadas por TON Connect
API GET /api/admin/contract y POST /api/admin/contract/{withdraw,set-fee,set-paused,change-admin}/prepare

Invariantes respetados: el backend nunca firma ni custodia; withdraw_fees se valida contra fees leídas de la cadena y el contrato solo permite sacar comisiones; ESCROW_ADMIN_ADDRESS (antes muerta) ahora avisa/impide preparar cuando la wallet del operador no es la administradora.

Fase 3 — Endurecimiento de la API (S-04, S-05, D-01, D-02)

Hallazgo Arreglo
S-04 el limitador se eludía con X-Forwarded-For La cabecera solo se honra con TRUST_PROXY=true y un peer de TRUSTED_PROXIES; se recorre de derecha a izquierda. RateLimiter con evicción LRU real y 429 con Retry-After
S-04 (2ª vía) rotar claves abría sesiones infinitas Backstop global por endpoint (clave = ruta, no cliente) en /api/session, /api/wallet/* y /api/markets/prepare
S-05 el botón «Reintentar» no hacía nada Era un onclick inline que la propia CSP bloquea: pasa a data-reload con delegación y un test vigila la CSP publicada
D-01 duplicación en la API _user_payload, _market_id, _require_admin y un mapeo único de MarketError (403/503); un solo renderer para las dos cancelaciones del bot
D-02 endpoints sin consumidor «Desvincular wallet» y «Cancelar y reembolsar» en la Mini App; el baseline de test_wiring queda solo con /api/health, justificado

La configuración incoherente falla al arrancar (TRUST_PROXY sin lista, o lista sin TRUST_PROXY), para que no vuelva a haber ajustes sin efecto.

Fase 4 — Economía única y coherencia de lo mostrado (F-03, H-*, U-05)

Pieza Qué hace
bot/economics.py Única copia de la fórmula pari-mutuel: distributable, fee_of, payout, multiplier (neto), preview_payout
Consumidores bot/database.py (liquidación de puntos), bot/markets.py (estimate_payout, market_view, quote_payout), bot/handlers/{markets,admin}.py
API GET /api/markets/{id}/quote?option=&stake_ton= y multiplier/fee_bps/fee_percent netos en /api/markets/{id}
Mini App Deja de calcular: hoja de apuesta con debounce 250 ms y guarda de secuencia; si el quote falla muestra «—»
Configuración MAX_STAKE_NANO, BET/CREATE/ADMIN/CLAIM_GAS_NANO, MIN_MARKET_DURATION_MIN, MAX_MARKET_DURATION_DAYS, TX_TTL_SECONDS en Settings y en /api/config
Paridad contracts/vectors/economics.json ejecutado por pytest y por el sandbox TVM
Guardarraíles TestNoMoneyLiterals (literales de dinero) y TestNoLocalEconomics (app.js no reimplementa la fórmula ni deja de pedir el quote)

Con un pozo de 4 TON repartido 3:1 y 2 % de comisión el bot y la Mini App muestran
3.92x / 1.307x y el pago que anuncia el quote es exactamente el que liquida
economics.payout. U-05: la confirmación de apuestas de puntos ya no mezcla
puntos con formato x…. El contrato no se tocó.

Fase 5 — Capa Telegram: navegación, entrada y notificaciones (F-01, F-14, F-02, F-04, S-06, U-01…U-06)

Hallazgo Arreglo
F-01 / F-14 el botón «🔧 Admin» desaparecía menu_for(update) y back_keyboard(update) resuelven el rol en las 13 pantallas; back_to_menu_keyboard(is_admin) ya no ignora el parámetro
S-06 10.5 se convertía en 105 parse_points (miles sí, decimales → error explícito) y resumen con economics.preview_payout
F-02 «modo grupo» anunciado y roto Opción A: per_chat=True y el importe solo cuenta si responde al mensaje del bot
F-04 nadie avisaba de una resolución Outbox notifications + bot/notifications.py + job cada 30 s con backoff y dedupe; un fallo de Telegram no bloquea el indexador
U-01…U-04, U-06 Wallet en friendly, fecha de ejemplo dinámica, estado vacío coherente, panel = teclado, /help según rol

La capa que estaba al 0 % de cobertura pasa al 85 % (bot/keyboards.py, 86 %)
gracias a tests/telegram_fakes.py y dos suites nuevas de handlers. CI gana un
umbral específico del 70 % para esa capa.

Fase 6 — Rendimiento y activos (R-01…R-06, R-08, R-09)

Todo medido, no estimado: los planes de consulta se comprueban con
EXPLAIN QUERY PLAN, la caché con un cliente HTTP real y la complejidad con
McCabe sobre el AST.

Hallazgo Antes Después
R-01 N+1 en las listas 1 consulta + 3 por fila; la lista de predicciones pedía el pozo fila a fila 3 consultas con 1 mercado o con 50; la lista de predicciones, 1 (LEFT JOIN + GROUP BY)
R-02 perfil agregado en Python dos consultas de hasta 500 filas + bucle un SUM/COUNT (get_user_stats) con equivalencia exacta bajo test
R-03 «tu posición» mostraba puntos sin puesto calculado ranking_position() con desempate por user_id; el mensaje dice el puesto
R-04 SCAN en onchain_bets SCAN onchain_bets idx_onchain_bets_bettor(bettor, id DESC) → SEARCH … USING INDEX
R-05 dos TEMP B-TREE orden y GROUP BY en memoria idx_markets_status_close e idx_onchain_bets_mkt_opt; cero B-TREE temporales
R-06 icono de 921 KB 1024×1024, 921 682 B 512×512, 64 colores, 79 408 B (−91 %), regenerable con scripts/build_icon.py
R-08 sondeo fijo de 25 s setInterval sobre /api/markets backoff 15/30/60 s con reinicio por actividad + ETag/304 en /api/markets
R-09 sin caché ni compresión estáticos sin Cache-Control ni gzip ?v=<huella> + immutable un año, gzip memoizado por proceso y ETag para el resto
R-07 complejidad del núcleo de dinero verify_ton_proof 36, settle_prediction 20 2 y 1, en pasos con nombre y sin tocar su comportamiento; tests/test_complexity.py congela el techo

Presupuesto de arranque de la Mini App (HTML + CSS + JS + icono): 93.3 KB
comprimidos frente al tope de 350 KB. El presupuesto y los planes de consulta
son tests (tests/test_assets_caching.py, tests/test_performance.py), no
convenciones: un PNG de 900 KB o un SCAN vuelven a romper el CI.

Arreglo de CI incluido

npm audit se puso en rojo con un advisory nuevo contra zod (<4.6.6)
arrastrado por @ton/ton, sin parche publicado y sin cambios en el código. En
lugar de bajar el nivel de exigencia, contracts/scripts/audit.js aplica
npm audit con contracts/audit-allowlist.json: cada excepción lleva motivo y
caducidad, y falla si caduca, si no tiene justificación o si ya no aparece.
contracts/tests/audit.test.js (9 checks) fija las reglas.

Fase 7 — Mantenibilidad, dependencias y tooling (5.1, D-01, D-04, D-05, D-06, F-07, F-08, F-09, F-12, F-13, T-02, R-10)

Hallazgo Arreglo Prueba
5.1 19 símbolos muertos eliminados; bot/chain/__init__.py sin los 25 re-exports vulture --min-confidence 80 en CI, lista blanca vacía
D-04 esquema «migrado» con UPDATE … points = 1000 migraciones versionadas con PRAGMA user_version, idempotentes y forward-only; rechaza una base futura tests/test_migrations.py (11)
D-05 upsert_user borraba el @usuario COALESCE(excluded.username, users.username) test de usuario que se quita el alias
D-06 teclados al 17 % 15 tests contra el comportamiento real bot/keyboards.py al 100 %
F-07 except (AddressError, Exception) solo se degradan errores de parseo; un bug sube test con cuerpo malformado
F-08 panel admin sin paginar ADMIN_PREDICTIONS_PAGE = 6, navegación admin_preds:<p>, texto y botones de la misma página test que suma todas las páginas
F-09 dev_server.py con el manifest fijo en http:// flags --host/--port/--db/--public-base-url/--no-seed; aviso si el manifest no es HTTPS tests/test_dev_server.py + --help
F-12 script de firma desde CDN sin integridad @tonconnect/ui 5.0.1 vendorizado (159 KB gzip) con SRI recalculado por un test; CSP script-src 'self' https://telegram.org tests/test_web_assets.py
F-13 deploy.js cantaba despliegues inexistentes exit 1 y sin deploy.json si no llega a active; aborta si el hash no coincide contracts/tests/deploy.test.js (5)
T-02 PTB 21.6 22.8, suite completa sin cambios de código CI
D-01 duplicación _user_payload, _require_admin, _market_id, un formateador de línea y create_nonce → purge_nonces tests de cada extracción
R-10 ruff a medias UP006/UP045 normalizados (465 anotaciones) y PLR2004/ARG/PLC0415 activados con constantes con nombre ruff check .

El baseline de complejidad baja de 15 a 14 entradas: market_view (15 → 4) se
parte en _option_views y _open_now, y _show_admin_panel (14 → 13) delega la
paginación en su propio callback. Las excepciones del linter viven en
pyproject.toml por fichero y con motivo escrito, no en # noqa dispersos.

Identidad visual — logo

Pieza Detalle
web/branding/logo-source.png lámina original (emblema + rótulo), versionada para que el icono sea reproducible
web/branding/logo-card.png tarjeta 512×512 que abre el README
web/static/icon.png 54,2 KB, 512×512, recortado del emblema por scripts/build_icon.py
Mini App favicon + apple-touch-icon + og:image + icono de arranque + marca de la cabecera

El avatar es el emblema, no la lámina entera: Telegram recorta el avatar en
círculo y el rótulo es ilegible a 300 px. El recorte (CROP), el encaje sin
deformar (MARGIN) y el difuminado del borde (FEATHER) son constantes con
test; si la lámina cambia, el script falla en vez de generar un icono
descentrado. TestBranding además comprueba que toda imagen local del README
existe
y que la lámina no se cuela en web/static (donde contaría contra el
presupuesto de arranque).

Verificación

  • pytest: 676 tests (639 tras la Fase 6, 449 tras la Fase 4, 263 en el commit auditado), 0 fallos. Cobertura 55 % → 85,8 % (umbral en CI: 83 % global y 70 % para bot.handlers + bot.keyboards, hoy al 89 %; bot/keyboards.py, 100 %).
  • Contrato intacto: 25/25 checks en sandbox (incluye transferencia de administración y los vectores compartidos de la economía) y hash a29c5c51…92db9b idéntico al pineado; 9/9 checks de la política de auditoría.
  • ruff: limpio. vulture --min-confidence 80: limpio y obligatorio en CI.
  • Reproducción en vivo de la prueba de la auditoría: 40 POST /api/session rotando X-Forwarded-For → 30×200 y 10×429 (antes, 40×200).
  • Wiring: los cuatro builders de administración dejan de ser huérfanos y el baseline se vacía.
  • ruff check .: limpio sobre bot, config.py, main.py, scripts y tests. vulture --min-confidence 80: limpio.
  • CI del commit eb8a036 (Fase 7 + logo): 4/4 jobs en verde (lint, tests + cobertura, contrato + sandbox + audit, pip-audit).

Informe en español con hallazgos ordenados por severidad (S/F/D/H/R/T/U),
cada uno con evidencia archivo:línea y prueba reproducible:

- 7 críticos/altos: pérdida de eventos en el indexador (cursor avanza tras
  un fallo), upsert_market con INSERT OR IGNORE, funciones admin del contrato
  inalcanzables, rate limiter eludible vía X-Forwarded-For, CSP que anula un
  botón, importe de apuesta corrompido con decimales, reserva permanente de
  wallet tras unlink.
- 15 medios: navegación admin, modo grupo, multiplicadores sin fee,
  notificaciones de resolución, CI ausente, SRI del CDN, deploy.js, etc.
- 25 menores + 19 símbolos de código muerto, hardcodes, rendimiento y tests.

Solo documentación: no se modifica código de producción.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 58e68e03-5846-42c2-b06c-22bdb4453568
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ⚠️ Failed 2026-10-23T21:44:46.486269Z
We couldn’t complete this review. Comment @codex review to try again.
eb8a036 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

Traduce los hallazgos de AUDITORIA.md a 8 fases (0-7) con dependencias,
criterios de aceptación ejecutables y trazabilidad completa hallazgo→fase.

Incluye 11 ADRs con la alternativa descartada y el motivo, para dejar
justificado por qué cada pieza integrada es la óptima para un host de
512 MB con SQLite: cursor con dead-letter (no outbox), economías en un
único módulo puro, admin del contrato como PreparedTx sin firma servidor,
lectura de estado con runGetMethod + caché, notificaciones por outbox,
X-Forwarded-For solo tras proxy declarado, vendorización de tonconnect-ui
y guardarraíles de arquitectura como tests permanentes.

No modifica código de producción.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c50224b3dc

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread AUDITORIA.md
6. **`deploy.js`:** dry-run correcto, exit `1` con dirección inválida, exit `0` con datos válidos; no envía transacciones en dry-run.
7. **Validación de importes (crítica para dinero):** matriz probada contra `/api/markets/{id}/bets/prepare` → `-5e9` → `stake_too_low`, `1e18` → `stake_too_high`, `true` → `bad_amount`, `"1e9"` → `bad_amount`, `"0.000000001"` → `stake_too_low`, sin wallet → `wallet_required`. **Correcto.**
8. **Cadena de autenticación:** `initData` (HMAC) → nonce de un solo uso (`ton_proof`) → `verify_ton_proof` (valida `state_init.hash == address_hash` y luego la firma) → `link_wallet`. Sin fugas: `/api/me` no expone el nonce.
9. **SQLite:** `journal_mode=WAL`, `synchronous=NORMAL`, `busy_timeout=5000`; liquidaciones idempotentes; `chain_txs(tx_hash, lt)` como PK garantiza procesamiento *exactly-once*.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Qualify the exactly-once guarantee

If the indexer process stops after mark_tx_processed commits but before the event's database updates run, a later poll will fetch the transaction and _process_tx will skip it because the marker already exists. The primary key prevents duplicate markers; it does not guarantee exactly-once processing, so this assurance overlooks a data-loss case.

Useful? React with 👍 / 👎.

Comment thread AUDITORIA.md
run 1 -> fetched 3 processed 2 errores 1
cursor tras run 1: (30, ...)
run 2 -> fetched 0 processed 0
¿tx 20 quedó procesada? True ← el cursor ya la dejó atrás

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Clarify the failed transaction's reported status

The report says this transaction failed, and the indexer's exception handler calls unmark_tx_processed before continuing. Therefore, if True means the transaction's processed marker is present, this output contradicts the implementation and does not demonstrate the stated scenario. Clarify what the value measures or correct the probe output.

Useful? React with 👍 / 👎.

Comment thread AUDITORIA.md
**Impacto:** la UI promete ~2 % más de lo que el contrato pagará (con `FEE_BPS=200`). Cuatro implementaciones distintas de la misma fórmula pari-mutuel en cuatro lenguajes.

### F-04 — 🟠 No existe notificación de resolución a los apostadores
`README.md:278` marca **F007 «Recordatorios de cierre y notificación de resolución» ✅**. Hay recordatorio de cierre (`main.py:331`, `job_reminders`), pero al liquidar una predicción **nadie avisa a los usuarios**: `settle_prediction` (`bot/database.py:606`) no envía mensajes y el resumen solo lo ve el administrador (`bot/handlers/admin.py:233`).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Correct the claim that resolved bettors receive no notice

For the point-prediction flow, this is false: after settle_prediction, bot/handlers/admin.py calls _notify_bettors(context, result), which sends each bettor a win, loss, or refund message. The admin-only summary does not mean users receive no notice; narrow F-04 to a different flow if it refers specifically to on-chain resolutions.

Useful? React with 👍 / 👎.

Comment thread AUDITORIA.md

### S-02 — 🔴 `upsert_market` ignora silenciosamente cualquier corrección posterior de los datos del mercado
**Evidencia:** `bot/database.py:943` (`INSERT OR IGNORE INTO markets ...`), usado desde `bot/chain/indexer.py:286` y `:321`.
La fila se crea la primera vez y **nunca se actualiza**. El caso real está documentado en el propio código (`indexer.py:319-330`): si una apuesta llega antes que el evento de creación, se crea un marcador con `title="Mercado #N"`, `closes_at=0` y sin `fee_bps`; cuando luego se indexa el evento de creación, los datos buenos se descartan.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Verify the placeholder sequence before treating it as a defect

The cited indexer comment says the create event was not indexed (for example, because the market predates the indexer), not that it will be indexed later. _fetch sorts transactions by ascending logical time: if the create transaction is fetched, it is applied before later bets; if it was missed behind the cursor, it will not be fetched later. The described production sequence of creating a placeholder and then discarding a later create event is therefore not established by the code.

Useful? React with 👍 / 👎.

Comment thread AUDITORIA.md

### F-05 — 🟠 `prepare_cancel` permite cancelar un mercado todavía abierto
`bot/markets.py:365-373` solo exige `status == "open"`; `prepare_resolve` sí valida `closes_at` (`bot/markets.py:341`).
**Impacto:** asimetría deliberada o descuido (no hay comentario que lo justifique): el admin puede reembolsar un mercado en curso, pero no resolverlo antes de tiempo. Conviene decidirlo explícitamente.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Remove the unsupported early-cancel finding

The contract test explicitly creates a market with a future close time and then successfully cancels it immediately (contracts/tests/escrow.test.js, around lines 415–429). That demonstrates early cancellation is a supported admin path, so the asymmetry with resolution does not establish a defect; F-05 should not present it as a medium finding.

Useful? React with 👍 / 👎.

Fase 0 — red de seguridad
- .github/workflows/ci.yml: lint, tests con umbral, contrato (hash + sandbox
  + npm audit) y pip-audit.
- requirements-dev.txt separado del runtime; .gitignore cubre artefactos.
- pyproject.toml fija las reglas de ruff (14 arreglos aplicados).
- tests/test_architecture.py y tests/test_wiring.py: guardarraíles de capas y
  de conectividad, con baseline en trinquete.
- tests/test_dev_server.py: el sembrado del preview por fin se ejecuta.

Fase 1 — integridad del dinero on-chain
- S-01: el cursor solo avanza sobre tx aplicadas; reintento en el ciclo y
  dead-letter (chain_tx_failures) con backoff para tx envenenadas.
- S-02: insert_market_placeholder / enrich_market_from_event; el marcador ya
  no puede sobrescribir metadatos reales (metadata_source).
- S-07: wallet_links reconstruida con clave subrogada e índices únicos
  parciales; desvincular libera la dirección y conserva el historial.
- F-05: cancelar un mercado vivo con apuestas exige force explícito (solo bot).
- F-06: prepare_resolve/cancel marcan ventana de 15 min y bloquean apuestas.

22 pruebas nuevas; cobertura 55% -> 58%; contrato intacto (22 checks, hash
a29c5c51).

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@Adlgr87 Adlgr87 changed the title docs: auditoría técnica completa del proyecto (solo hallazgos) Auditoría, plan por fases e implementación de las fases 0-1 Oct 23, 2026
…ora)

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b9c078477f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread bot/database.py
("users", "updated_at", "TEXT NOT NULL DEFAULT ''"),
("predictions", "mode", "TEXT NOT NULL DEFAULT 'points'"),
("bets", "payout", "INTEGER NOT NULL DEFAULT 0"),
("markets", "metadata_source", "TEXT NOT NULL DEFAULT 'event'"),

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Classify legacy placeholders before defaulting them to events

When an existing database contains a placeholder created by the old upsert_market path (title='Mercado #N', closes_at=0), this migration assigns it metadata_source='event'. Later, enrich_market_from_event() treats the row as authoritative and returns without filling its real title, close time, or fee. Upgraded installations therefore retain the stale metadata this change is meant to repair; identify legacy placeholders during migration instead of marking every old row as an event.

Useful? React with 👍 / 👎.

Comment thread bot/chain/indexer.py
Comment on lines +190 to +191
delay = RETRY_BACKOFF_SECONDS[min(attempts, len(RETRY_BACKOFF_SECONDS)) - 1]
await database.schedule_chain_tx_retry(tx.tx_hash, tx.lt, delay)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Apply the backoff sequence to parked retries

Once a transaction reaches the five-failure parking threshold, attempts is already 5, so this selects the final 3600-second entry; subsequent parked retries also select 3600 seconds. The configured 60-second, 5-minute, and 15-minute delays are never used, leaving a recoverable transaction unindexed for an hour after it is parked instead of starting the documented backoff sequence.

Useful? React with 👍 / 👎.

Comment thread bot/chain/indexer.py
"Rewinding cursor %s -> %s to retry parked tx %s (next attempt in %ds)",
cursor_lt, target, row["tx_hash"][:12], delay,
)
await database.set_cursor(CURSOR_NAME, target, None)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Fetch the parked transaction directly when rewinding

If more than 20 pages of newer escrow transactions arrive during a parked transaction's retry delay, this rewind starts _fetch at the latest page, and _fetch stops after 20 pages without reaching the parked LT. The poll then advances the cursor back to the head and reschedules the failure, so the transaction remains unprocessed on every retry; fetch through to the target LT or request the parked transaction directly.

Useful? React with 👍 / 👎.

- bot/chain/toncenter.py: run_get_method + normalización del stack.
- bot/chain/escrow_state.py: EscrowState (seis getters + balance) y caché de
  30 s con stale-while-error.
- bot/markets.py: prepare_withdraw_fees / set_fee / set_paused / change_admin,
  con validaciones previas a la firma y aviso si la wallet vinculada no es
  ESCROW_ADMIN_ADDRESS. Los errores de cadena salen como MarketError.
- bot/handlers/admin.py + keyboards: panel «⚙️ Contrato escrow» con estado
  on-chain, retiro de comisiones, comisión, pausa y cambio de administrador
  (confirmación explícita; el valor vive en el estado, no en callback_data).
- bot/api.py + Mini App: GET /api/admin/contract y los cuatro
  .../prepare, tarjeta de estado y acciones firmadas por TON Connect.
- bot/parsing.py: parse_nano / parse_fee_bps como única fuente.
- Pruebas: 376 (antes 308), cobertura 59 %, contrato 24 checks (cambio de
  admin incluido), vulture en CI y cuatro parámetros muertos retirados.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@Adlgr87 Adlgr87 changed the title Auditoría, plan por fases e implementación de las fases 0-1 Auditoría, plan por fases e implementación de las fases 0-2 Oct 23, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 97c3988b7c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread bot/markets.py
expected = _configured_admin()
if not expected or not wallet:
return
if normalize_address(wallet["address"]) != normalize_address(expected):

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Update the expected admin after transferring control

When ESCROW_ADMIN_ADDRESS is configured and change_admin succeeds, this check still compares the linked wallet with the old configured address. The newly appointed wallet is therefore rejected when preparing later admin operations, while the old wallet passes the check only to be rejected on-chain; the deployment configuration must be updated out of band before the bot can manage the contract again.

Useful? React with 👍 / 👎.

Comment thread bot/markets.py
amount = int(amount_nano)
if amount <= 0:
raise MarketError("bad_amount", "El importe debe ser mayor que cero.")
available = state.max_withdrawable_nano

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Refresh fee data before preparing withdrawals

When escrow_state() serves its 30-second cache—or returns a snapshot marked stale after an RPC refresh fails—this compares the withdrawal amount against the old fee total without checking freshness. If an earlier withdrawal has reduced the on-chain fees, the bot can still prepare a withdrawal exceeding the current fees; the contract rejects it at amount <= fees after the wallet spends gas. Force a fresh read and refuse to prepare from a stale snapshot.

Useful? React with 👍 / 👎.

Comment thread bot/markets.py
Comment on lines +569 to +570
if int(target.split(":")[1], 16) == 0:
raise MarketError("bad_address", "No se puede usar la dirección cero.")

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Reject the escrow contract as its own administrator

If an operator enters the escrow contract's own address here, the zero-address check allows it and change_admin permanently sets that contract as admin. Subsequent admin operations require sender == admin, but this contract has no path to send an admin operation to itself, so no external wallet can resolve or cancel markets, withdraw fees, or restore control; reject escrow_address() as a target.

Useful? React with 👍 / 👎.

- S-04: _client_ip solo honra X-Forwarded-For con TRUST_PROXY y un peer de
  TRUSTED_PROXIES; se recorre la lista de derecha a izquierda. RateLimiter con
  evicción LRU real y 429 con Retry-After.
- Backstop global por endpoint (independiente de la identidad) más validación
  de arranque de TRUST_PROXY/TRUSTED_PROXIES.
- S-05: fuera el onclick inline del botón «Reintentar»; data-reload con
  delegación de eventos y test que vigila la CSP publicada.
- D-01: _user_payload / _market_id / _require_admin y un mapeo único de
  MarketError (forbidden→403, chain_unavailable→503); helper único para las dos
  cancelaciones del bot.
- D-02: «Desvincular wallet» y «Cancelar y reembolsar» en la Mini App; el
  baseline de test_wiring queda solo con /api/health.
- Pruebas: 415 (antes 402), cobertura 60 % (umbral en CI), config y activos web
  con suite propia. Verificado en vivo: 40 POST /api/session rotando XFF →
  30×200 y 10×429.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Adlgr87 Adlgr87 changed the title Auditoría, plan por fases e implementación de las fases 0-2 Auditoría, plan por fases e implementación de las fases 0-3 Oct 23, 2026
- bot/economics.py es la única copia de la fórmula pari-mutuel; database,
  markets y los handlers la consumen.
- La Mini App deja de calcular: pide /api/markets/{id}/quote y solo formatea.
- Gas, tope de apuesta, ventanas y TTL pasan a Settings y a /api/config
  (cierra H-*).
- U-05: la confirmación de apuesta de puntos ya no usa formato «x…».
- Vectores compartidos contracts/vectors/economics.json + tests de paridad
  Python/contrato y guardarraíl contra los literales de dinero.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Adlgr87 Adlgr87 changed the title Auditoría, plan por fases e implementación de las fases 0-3 Auditoría, plan por fases e implementación de las fases 0-4 Oct 23, 2026
- Menú resuelto por rol en todas las pantallas: menu_for/back_keyboard.
- parse_points: miles sí, decimales → error explícito; el resumen usa
  economics.preview_payout.
- Modo grupo (opción A): el importe debe responder al prompt del bot y la
  conversación de creación pasa a per_chat=True.
- Outbox de notificaciones con dedupe, backoff y reparto cada 30 s; un fallo
  de Telegram no bloquea el indexador.
- U-01…U-04 y U-06 corregidos; test intermitente de sesión arreglado.

Cobertura 61.24% → 84.30%; bot/handlers 85% y keyboards 86%.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Adlgr87 Adlgr87 changed the title Auditoría, plan por fases e implementación de las fases 0-4 Auditoría, plan por fases e implementación de las fases 0-5 Oct 23, 2026
…08, R-09)

Medido, no estimado: los planes de consulta se verifican con EXPLAIN QUERY
PLAN y la caché con un cliente HTTP real.

- R-01: la página de mercados hace 3 consultas con 1 o con 50 filas
  (antes 1 + 3·N). `get_open_predictions` trae el pozo con LEFT JOIN +
  GROUP BY en lugar de una consulta por fila.
- R-02/R-03: `get_user_stats` agrega con SUM/COUNT y `ranking_position`
  cuenta el puesto real (desempate por user_id), que ahora se muestra.
- R-04/R-05: `idx_onchain_bets_bettor(bettor, id DESC)`,
  `idx_markets_status_close(status, closes_at, market_id DESC)` e
  `idx_onchain_bets_mkt_opt(market_id, option)`; se elimina el índice
  redundante `idx_markets_status`. Ya no hay SCAN ni TEMP B-TREE.
- R-06: icon.png de 921 682 B a 79 408 B (512×512, 64 colores), con
  `scripts/build_icon.py` reproducible y tope de 80 KB.
- R-08: sondeo adaptativo 15/30/60 s con reinicio por actividad y ETag +
  304 en /api/markets.
- R-09: activos versionados con ?v=<huella> y Cache-Control inmutable,
  gzip en memoria (una vez por proceso) y ETag para el resto.

Tests nuevos: tests/test_performance.py (planes, conteo de consultas,
equivalencia de agregados) y tests/test_assets_caching.py (caché, 304,
gzip, rutas rechazadas, presupuesto de activos). 633 tests, 84.8 % de
cobertura; umbral de CI 83 %.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

El advisory GHSA-mrhx-c7xc-m3w5 (zod <4.6.6, arrastrado por @ton/ton, que
solo usa scripts/deploy.js) no tiene parche publicado y dejó el job del
contrato en rojo sin cambios de código.

contracts/scripts/audit.js aplica npm audit con
contracts/audit-allowlist.json: cada excepción lleva motivo y caducidad;
una excepción caducada, sin motivo u obsoleta falla el build, y cualquier
advisory alto/crítico no listado también. contracts/tests/audit.test.js
fija las nueve reglas.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Adlgr87 Adlgr87 changed the title Auditoría, plan por fases e implementación de las fases 0-5 Auditoría, plan por fases e implementación de las fases 0-6 Oct 23, 2026
…plejidad

verify_ton_proof pasa de complejidad 36 a 2 y settle_prediction de 20 a 1,
sin cambios de comportamiento: las suites de ton_proof y de liquidación
siguen verdes sin editarlas. La verificación queda como una lista de pasos
con nombre (dominio, marca de tiempo, payload, firma, dirección, state init,
clave) y la liquidación separa validación, lectura, plan de pagos, escritura
y avisos.

tests/test_complexity.py mide McCabe sobre el AST sin dependencias nuevas:
ninguna función nueva pasa de 12, las 16 que ya estaban por encima tienen un
techo congelado y las dos del núcleo de dinero tienen tope duro de 8.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

admin_confirm_callback enviaba los mensajes de victoria en el acto además
de encolarlos en settle_prediction: cada ganador recibía dos avisos y los
perdedores uno que la política de F-04 decidió no enviar. El panel se queda
con el resumen y el job manda el resto (dedupe, backoff, y un Telegram
caído no bloquea la liquidación).

Los tests de Fase 5 que fijaban el envío directo se ajustan al contrato
nuevo: cero mensajes directos desde el handler y una fila de outbox por
ganador.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@Adlgr87
Adlgr87 force-pushed the arena/de3be963-betpoly-bot branch from 9f1b16c to 2855c9f Compare October 23, 2026 21:12
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

1 similar comment
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

Cierra los 12 hallazgos que quedaban del alcance auditado.

Código muerto (5.1)
- Fuera los 19 símbolos sin referencias; `bot/chain/__init__.py` deja de
  re-exportar 25 nombres y los consumidores importan el submódulo.
- Los cuatro `build_*` que la auditoría daba por muertos se conectan al panel
  del contrato en vez de borrarse: eran la mitad de una función ya escrita.

Persistencia
- D-04: migraciones versionadas con `PRAGMA user_version` (idempotentes,
  forward-only, rechazan una base futura); el saldo inicial se escribe al crear
  el usuario y no con un `UPDATE … WHERE points = 1000`.
- D-05: `upsert_user` nunca anula un `@usuario` conocido.

Telegram
- D-06: `tests/test_keyboards.py` lleva `bot/keyboards.py` al 100 %.
- F-08: panel admin paginado (`ADMIN_PREDICTIONS_PAGE = 6`); texto y botones
  salen de la misma página y el test comprueba que no se pierde ninguna.
- F-07: `parse_message_body` ya no enmascara bugs con `except Exception`.

Web y contrato
- F-12: `@tonconnect/ui` 5.0.1 vendorizado con SRI y CSP sin `unpkg.com`.
- F-13: `deploy.js` aborta si no alcanza `active` o el hash no coincide, y no
  escribe `deploy.json` en ese caso (`contracts/tests/deploy.test.js`).

Tooling
- T-02: python-telegram-bot 21.6 -> 22.8, sin cambios de código.
- R-10: `UP006/UP045` normalizados (465 anotaciones) y `PLR2004`/`ARG`/`PLC0415`
  activados con constantes con nombre y excepciones por fichero justificadas.
- D-01: `_user_payload`, `_require_admin`, `_market_id`, un solo formateador de
  línea de mercado y `create_nonce` delegando en `purge_nonces`.
- F-09: `scripts/dev_server.py` con `--host/--port/--db/--public-base-url/--no-seed`.
- Baseline de complejidad de 15 a 14 entradas (`market_view` 15 -> 4,
  `_show_admin_panel` 14 -> 13).

Gates: 668 tests, cobertura 85,8 % (umbral 83), `ruff check .` y `vulture`
limpios, contrato con el mismo hash `a29c5c51…92db9b` y 25/25 en sandbox,
audit 9/9, deploy 5/5.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Adlgr87 Adlgr87 changed the title Auditoría, plan por fases e implementación de las fases 0-6 Auditoría, plan por fases e implementación de las fases 0-7 Oct 23, 2026
`create_nonce` delega la purga en `purge_nonces` (D-01) y hasta ahora ningún
test cubría la política de caducidad: solo el uso único y el TTL en la
validación. Se añaden dos pruebas sobre `auth_nonces` reales: una comprueba que
la purga conserva los nonces recientes y borra los viejos, y otra que crear un
nonce nuevo arrastra esa misma política.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

…el bot

La lámina de marca se versiona en `web/branding/` (original + tarjeta 512 para
el README) y `scripts/build_icon.py` deja de reescalar un PNG suelto: recorta el
emblema, lo encaja centrado sin deformarlo, difumina el borde del recorte y lo
cuantiza. Icono final: 512x512, 55 535 B (54,2 KB), bajo el presupuesto de 80 KB.

La Mini App usa el logo de verdad: favicon, apple-touch-icon, og:image, el icono
de arranque y la marca de la cabecera dejan de ser el carácter "◎".

Guardarraíles (TestBranding): favicon declarado, cabecera y arranque con el logo,
toda imagen local del README existe y la lámina no se cuela en `web/static`.
El recorte es una constante con test: si la lámina cambia, el script sale con
código 2 en vez de generar un icono descentrado.

README revisado a fondo: abre con la tarjeta de marca, gana una sección "Marca e
icono", y se corrigen tres afirmaciones que ya no eran ciertas (22 -> 25 checks
del contrato, el arranque pesa 249 KB con el bundle vendorizado y no 93 KB, y
"tres suites son guardarraíles" cuando ya son seis).

676 tests, 85,8 % de cobertura, ruff y vulture limpios.

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Adlgr87
Adlgr87 merged commit 3842e7b into main Oct 23, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant