What’s Left (Until You Decide TRON Pipelines & Sweep Methods Review)

Purpose: Single checklist of what’s left so you can decide how to fulfill TRON pipelines and sweep methods review. “Coming Soon” doc links are called out so you can fix them when ready.

Last updated: 2026-02-04

1. “Coming Soon” doc links (to fix when ready)

The docs server shows “Coming Soon” when a nav link points to a file that does not exist under docs/. Current gaps:

Section in nav	Missing file(s)	Fix
API Reference	`api-reference/gateway-rest.md`, `wallet-grpc.md`, `account-grpc.md`, `market-grpc.md`, `transaction-grpc.md`	Add stub or real API docs, or remove from `docs/mkdocs.yml` nav.
Tutorials	`tutorials/first-service.md`, `implement-signer.md`, `setup-watchers.md`, `local-testing.md`	Add stub or real tutorials, or remove from nav.
Migration	`migration/phase-0-foundation.md` … `phase-6-testing.md`	Add these 7 files or point nav to existing migration docs (e.g. `overview.md`, `task-breakdown.md`, `progress.md`).

Note: Overview, Architecture, Portals, Status, Guides (that we added), and Migration overview/task-breakdown/progress/planning-summary exist and work. Only the paths above hit “Coming Soon.”

2. Remaining tasks (from `remaining-tasks.md`)

Tier A (wire / verify)

[ ] Gas safety: Wire gas_safety.go into withdrawal flow (reserve before send, release on fail).
[ ] Risk engine: Ensure called before processing; verify AML triggers and scoring.
[ ] Idempotency: Verify gateway forwards Idempotency-Key to withdrawal and withdrawal checks/saves on create.
[ ] Commit SHA: Add commit SHA to built images and persist in key records.

Core product (B), Blockchain ©, Testing (D)

See docs/production/remaining-tasks.md for the full list (market, auth, deposits, withdrawals, payment, voucher, KYC, WebSocket, BTC UTXO builder, mainnet testing, smoke tests, runbook drill, alerting).

3. TRON pipelines & sweep — what’s left before your review

3.1 TRON cost / energy (from GAS_AND_ENERGY_EFFICIENCY.md)

[ ] Energy rental (must when we have little TRX): Implement tronresource/rental_client.go (or tronenergy package) with EnsureEnergy(ctx, hotWalletAddress, minEnergy); call before every TRON TRC20 withdrawal and TRON TRC20 sweep; add config (API URL, key, min energy).
[ ] Phase 2 tronresource: Freeze/unfreeze, get available energy/bandwidth, estimate cost per tx type (optional when we rely on rental).
[ ] feelimit: Set from estimation + margin in all TRC20 build paths (txbuilder/tron.go, twc/tron_builder.go).
[ ] Dust: Enforce min transfer size for TRC20 in validation/sweep planner.

3.2 TRON sweep pipeline (current vs to review)

Current behavior:

Native TRX sweep: Implemented in services/wallet/.../sweeper/executor.go → executeTRONSweep():
- Uses pure-Go TRON builder (not TWC) to avoid BlockHeader issues.
- Fetches live balance, reserves ~0.002 TRX fee, sweeps the rest to hot wallet.
- Builds and signs native TRX transfer, then broadcasts.
TRC20 (e.g. USDT) sweep: No dedicated TRON TRC20 path in the executor. Sweep jobs are created from balance scanner; if TRON TRC20 balances are planned to be swept, that path needs to be implemented or confirmed (build TRC20 transfer, sign, broadcast) and energy must be ensured (rental or freeze) before sending.

What to decide for “TRON pipelines / sweep methods review”:

TRON TRC20 sweep: Add a dedicated TRON TRC20 sweep path (similar to TRX path) and ensure energy rental (or Phase 2 tronresource) is called before building/broadcasting.
TRON withdrawal (TRC20): Ensure energy rental (or freeze) is called before building/broadcasting TRC20 withdrawals (withdrawal service + hot wallet).
Review: Sweep planner idle thresholds for TRON, fee estimation (TRX vs TRC20), and any TRON-specific limits in coordinator/balance scanner.

3.3 Sweep methods (all chains) — review scope

Component	Location	Review focus
Executor	`services/wallet/.../sweeper/executor.go`	TRON (TRX + TRC20 path), TON, EVM; gas/energy checks before send.
Planner	`services/wallet/.../sweeper/planner.go`	Idle thresholds per chain, min amounts, TRON TRC20 eligibility.
Coordinator	`services/wallet/.../sweeper/coordinator.go`	Which chains are enabled, how often planner/executor run.
Balance scanner	`services/wallet/.../sweeper/balance_scanner.go`	Which assets/chains are scanned (TRX vs TRC20).

4. Summary

Docs: Fix “Coming Soon” by adding (or removing from nav) API Reference, Tutorials, and Migration phase-* pages.
Remaining tasks: Tier A wiring + commit SHA; then B/C/D per remaining-tasks.md.
TRON: Implement energy rental and call it before TRON TRC20 withdrawal/sweep; add or confirm TRON TRC20 sweep path; set feelimit and dust policy; optionally Phase 2 tronresource.
Sweep review: Executor (TRON TRX + TRC20, TON, EVM), planner (thresholds, TRON), coordinator, balance scanner — then decide TRON pipelines and sweep method changes.

Once you decide how you want to fulfill TRON pipelines and the sweep methods review, the next step is to implement the chosen items (energy rental, TRC20 sweep path, and/or code review + adjustments).