Repository navigation
Auditoría, plan por fases e implementación de las fases 0-7 - #4
Conversation
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>
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars. ⚙️ Run configuration
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. Comment |
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
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>
There was a problem hiding this comment.
💡 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".
| 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*. |
There was a problem hiding this comment.
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 👍 / 👎.
| 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 |
There was a problem hiding this comment.
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 👍 / 👎.
| **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`). |
There was a problem hiding this comment.
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 👍 / 👎.
|
|
||
| ### 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. |
There was a problem hiding this comment.
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 👍 / 👎.
|
|
||
| ### 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. |
There was a problem hiding this comment.
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>
…ora) Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
There was a problem hiding this comment.
💡 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".
| ("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'"), |
There was a problem hiding this comment.
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 👍 / 👎.
| delay = RETRY_BACKOFF_SECONDS[min(attempts, len(RETRY_BACKOFF_SECONDS)) - 1] | ||
| await database.schedule_chain_tx_retry(tx.tx_hash, tx.lt, delay) |
There was a problem hiding this comment.
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 👍 / 👎.
| "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) |
There was a problem hiding this comment.
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>
There was a problem hiding this comment.
💡 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".
| expected = _configured_admin() | ||
| if not expected or not wallet: | ||
| return | ||
| if normalize_address(wallet["address"]) != normalize_address(expected): |
There was a problem hiding this comment.
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 👍 / 👎.
| amount = int(amount_nano) | ||
| if amount <= 0: | ||
| raise MarketError("bad_amount", "El importe debe ser mayor que cero.") | ||
| available = state.max_withdrawable_nano |
There was a problem hiding this comment.
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 👍 / 👎.
| if int(target.split(":")[1], 16) == 0: | ||
| raise MarketError("bad_address", "No se puede usar la dirección cero.") |
There was a problem hiding this comment.
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>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
- 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>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
- 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>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
…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>
|
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>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
…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>
|
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>
|
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>
9f1b16c to
2855c9f
Compare
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
1 similar comment
|
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>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
`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>
|
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>
|
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>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
Qué contiene
Diez commits sobre
main, en orden:c50224b— Auditoría (AUDITORIA.md). 7 hallazgos críticos/altos, 15 medios y 25 menores, cada uno conarchivo:líneay prueba reproducible.f7c156c— Plan (PLAN_IMPLEMENTACION.md). 8 fases con dependencias, criterios de aceptación y 11 ADRs con la alternativa descartada.f479839— Fases 0 y 1 implementadas.97c3988— Fase 2 implementada (administración del contrato escrow).6183291— Fase 3 implementada (endurecimiento de la API).6bc6619— Fase 4 implementada (economía única, importes configurables, U-05).03798e0— Fase 5 implementada (capa Telegram: navegación, importes, grupo, notificaciones).9b05bc1— Fase 6 implementada (rendimiento y activos: R-01…R-06, R-08, R-09), más3c684f5que arregla el gate denpm auditcon una lista de excepciones caducables.596794b— R-07:verify_ton_proofysettle_predictionen pasos con nombre, con un trinquete de complejidad sobre el AST.0644ec4— Fase 7 implementada (mantenibilidad, dependencias y tooling del contrato).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.ymlcon 4 jobs: lint (ruff + vulture), tests + cobertura, contrato (hash reproducible + sandbox TVM +npm audit) y pip-audit. Los 4 en verde.requirements-dev.txtseparado del runtime;.gitignorecubre artefactos de test.pyproject.tomlfija las reglas de ruff → 0 hallazgos.tests/test_architecture.py(dirección de dependencias entre capas) ytests/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
chain_tx_failures) con backoff 60 s → 1 h para que una tx envenenada no detenga el streaminsert_market_placeholdervsenrich_market_from_event;metadata_sourceimpide sobrescribir metadatos realeswallet_linksreconstruida con clave subrogada e índices únicos parciales; migración automática sin pérdida de historialforceexplícito solo desde el bot, con confirmación; la API HTTP nunca lo envíapending_resolve_at: 15 min de bloqueo de apuestas y aviso en la Mini AppFase 2 — Administración del contrato (S-03, D-03)
bot/chain/toncenter.pyrun_get_method(address, method, stack)con el stack normalizado (hex/decimal →int) y error si el exit code no es 0bot/chain/escrow_state.pyEscrowStatecon los seis getters + balance yEscrowStateCache(TTL 30 s, stale-while-error)bot/markets.pyprepare_withdraw_fees,prepare_set_fee,prepare_set_paused,prepare_change_admin: validan antes de firmar y devuelvenPreparedTxsin firmar/admin→ ⚙️ Contrato escrow: estado on-chain, retirar comisiones, cambiar comisión, pausar/reanudar y cambiar administrador, con confirmación explícitaGET /api/admin/contractyPOST /api/admin/contract/{withdraw,set-fee,set-paused,change-admin}/prepareInvariantes respetados: el backend nunca firma ni custodia;
withdraw_feesse valida contrafeesleí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)
X-Forwarded-ForTRUST_PROXY=truey un peer deTRUSTED_PROXIES; se recorre de derecha a izquierda.RateLimitercon evicción LRU real y429conRetry-After/api/session,/api/wallet/*y/api/markets/prepareonclickinline que la propia CSP bloquea: pasa adata-reloadcon delegación y un test vigila la CSP publicada_user_payload,_market_id,_require_adminy un mapeo único deMarketError(403/503); un solo renderer para las dos cancelaciones del bottest_wiringqueda solo con/api/health, justificadoLa configuración incoherente falla al arrancar (
TRUST_PROXYsin lista, o lista sinTRUST_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)
bot/economics.pydistributable,fee_of,payout,multiplier(neto),preview_payoutbot/database.py(liquidación de puntos),bot/markets.py(estimate_payout,market_view,quote_payout),bot/handlers/{markets,admin}.pyGET /api/markets/{id}/quote?option=&stake_ton=ymultiplier/fee_bps/fee_percentnetos en/api/markets/{id}MAX_STAKE_NANO,BET/CREATE/ADMIN/CLAIM_GAS_NANO,MIN_MARKET_DURATION_MIN,MAX_MARKET_DURATION_DAYS,TX_TTL_SECONDSenSettingsy en/api/configcontracts/vectors/economics.jsonejecutado por pytest y por el sandbox TVMTestNoMoneyLiterals(literales de dinero) yTestNoLocalEconomics(app.jsno 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.307xy el pago que anuncia el quote es exactamente el que liquidaeconomics.payout. U-05: la confirmación de apuestas de puntos ya no mezclapuntos 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)
menu_for(update)yback_keyboard(update)resuelven el rol en las 13 pantallas;back_to_menu_keyboard(is_admin)ya no ignora el parámetro10.5se convertía en105parse_points(miles sí, decimales → error explícito) y resumen coneconomics.preview_payoutper_chat=Truey el importe solo cuenta si responde al mensaje del botnotifications+bot/notifications.py+ job cada 30 s con backoff y dedupe; un fallo de Telegram no bloquea el indexador/helpsegún rolLa capa que estaba al 0 % de cobertura pasa al 85 % (
bot/keyboards.py, 86 %)gracias a
tests/telegram_fakes.pyy dos suites nuevas de handlers. CI gana unumbral 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 conMcCabe sobre el AST.
LEFT JOIN+GROUP BY)SUM/COUNT(get_user_stats) con equivalencia exacta bajo testranking_position()con desempate poruser_id; el mensaje dice el puestoSCANenonchain_betsSCAN onchain_betsidx_onchain_bets_bettor(bettor, id DESC)→SEARCH … USING INDEXTEMP B-TREEGROUP BYen memoriaidx_markets_status_closeeidx_onchain_bets_mkt_opt; cero B-TREE temporalesscripts/build_icon.pysetIntervalsobre/api/marketsETag/304en/api/marketsCache-Controlni gzip?v=<huella>+immutableun año, gzip memoizado por proceso yETagpara el restoverify_ton_proof36,settle_prediction20tests/test_complexity.pycongela el techoPresupuesto 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), noconvenciones: un PNG de 900 KB o un
SCANvuelven a romper el CI.Arreglo de CI incluido
npm auditse puso en rojo con un advisory nuevo contrazod(<4.6.6)arrastrado por
@ton/ton, sin parche publicado y sin cambios en el código. Enlugar de bajar el nivel de exigencia,
contracts/scripts/audit.jsaplicanpm auditconcontracts/audit-allowlist.json: cada excepción lleva motivo ycaducidad, 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)
bot/chain/__init__.pysin los 25 re-exportsvulture --min-confidence 80en CI, lista blanca vacíaUPDATE … points = 1000PRAGMA user_version, idempotentes y forward-only; rechaza una base futuratests/test_migrations.py(11)upsert_userborraba el@usuarioCOALESCE(excluded.username, users.username)bot/keyboards.pyal 100 %except (AddressError, Exception)ADMIN_PREDICTIONS_PAGE = 6, navegaciónadmin_preds:<p>, texto y botones de la misma páginadev_server.pycon el manifest fijo enhttp://--host/--port/--db/--public-base-url/--no-seed; aviso si el manifest no es HTTPStests/test_dev_server.py+--help@tonconnect/ui5.0.1 vendorizado (159 KB gzip) con SRI recalculado por un test; CSPscript-src 'self' https://telegram.orgtests/test_web_assets.pydeploy.jscantaba despliegues inexistentesdeploy.jsonsi no llega aactive; aborta si el hash no coincidecontracts/tests/deploy.test.js(5)_user_payload,_require_admin,_market_id, un formateador de línea ycreate_nonce→purge_noncesUP006/UP045normalizados (465 anotaciones) yPLR2004/ARG/PLC0415activados con constantes con nombreruff check .El baseline de complejidad baja de 15 a 14 entradas:
market_view(15 → 4) separte en
_option_viewsy_open_now, y_show_admin_panel(14 → 13) delega lapaginación en su propio callback. Las excepciones del linter viven en
pyproject.tomlpor fichero y con motivo escrito, no en# noqadispersos.Identidad visual — logo
web/branding/logo-source.pngweb/branding/logo-card.pngweb/static/icon.pngscripts/build_icon.pyapple-touch-icon+og:image+ icono de arranque + marca de la cabeceraEl 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 sindeformar (
MARGIN) y el difuminado del borde (FEATHER) son constantes contest; si la lámina cambia, el script falla en vez de generar un icono
descentrado.
TestBrandingademás comprueba que toda imagen local del READMEexiste y que la lámina no se cuela en
web/static(donde contaría contra elpresupuesto 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 % parabot.handlers+bot.keyboards, hoy al 89 %;bot/keyboards.py, 100 %).a29c5c51…92db9bidéntico al pineado; 9/9 checks de la política de auditoría.ruff: limpio.vulture --min-confidence 80: limpio y obligatorio en CI.POST /api/sessionrotandoX-Forwarded-For→ 30×200 y 10×429 (antes, 40×200).ruff check .: limpio sobrebot,config.py,main.py,scriptsytests.vulture --min-confidence 80: limpio.eb8a036(Fase 7 + logo): 4/4 jobs en verde (lint, tests + cobertura, contrato + sandbox + audit, pip-audit).