hotfix: per_chain_explainer for perp-fees + wallet-labels-coverage

benchmarks/perp-fees.yml

@@ -51,6 +51,20 @@ methodology:
   - "All-in formula: `all_in_bps = taker_fee_bps + spread_bps`. Both components emitted as separate metrics for transparency."
   - "Failures (5xx, timeouts, rate limits) leave the previous gauge in place and increment a per-venue `fetch_errors_total` counter. The page falls back to the last successful sample."
 
+per_chain_explainer:
+  - slug: ETH
+    h2: "Cheapest perp DEX for ETH"
+    body: |
+      The cheapest perp DEX for ETH on this benchmark sits at {{best_p50:chain:ETH}} all-in (p50, 24h) for a $1000 ETH long 10x. ETH-PERP is the deepest pair on every venue measured (Hyperliquid, Lighter, dYdX v4, GMX v2, gains.trade), which means the rack-rate taker fee dominates the all-in number rather than the spread. Lighter quotes 0 bps taker, Hyperliquid 4.5 bps, dYdX 5 bps tier-0, GMX 4 or 6 bps on the impact branch, gains.trade reads the openFeeP slot live from the on-chain Gains v8 fees contract. Spread plus impact at $1000 notional is added on top via an orderbook walk.
+  - slug: BTC
+    h2: "Cheapest perp DEX for BTC"
+    body: |
+      The cheapest perp DEX for BTC on this benchmark sits at {{best_p50:chain:BTC}} all-in (p50, 24h) for a $1000 BTC long 10x. BTC-PERP carries the highest open interest across every venue in the cohort, so books are typically tighter than ETH on the same notional and the spread component compresses toward the rack rate. GMX v2 BTC uses the same positionFeeFactor schedule as ETH (4 bps positive impact, 6 bps negative); the bench reports the conservative negative branch. The leaderboard reorders intra-day with funding skew and orderbook depth.
+  - slug: SOL
+    h2: "Cheapest perp DEX for SOL"
+    body: |
+      The cheapest perp DEX for SOL on this benchmark sits at {{best_p50:chain:SOL}} all-in (p50, 24h) for a $1000 SOL long 10x. SOL-PERP books are thinner than ETH or BTC on every venue, so the spread plus impact component carries more weight in the all-in figure and a 5 bps taker venue can land above a 0 bps taker venue once the orderbook is walked. Lighter, Hyperliquid and dYdX v4 quote SOL-PERP natively; GMX v2 trades SOL as a synthetic on its Arbitrum deployment.
+
 findings:
   - "{{best_name}} currently leads the leaderboard at {{best_p50}} all-in (24 h average) across {{count}} measured perp venues. The number includes taker fee plus the spread crossed at $1000 notional, not the rack-rate taker fee alone."
   - "Lighter charges zero taker fees on ETH-PERP, confirmed live via their public API. {{name:lighter}} clocks {{p50:lighter}} all-in (24 h average), so the headline figure is essentially the half-spread plus orderbook impact crossed at $1000."

benchmarks/wallet-labels-coverage.yml

@@ -81,6 +81,32 @@ methodology:
   - "Failures (timeouts, 5xx, auth errors) are counted as 'no label' and surfaced separately as `wallet_labels_fetch_errors_total`."
   - "Region: `eu-west` (single point)."
 
+per_chain_explainer:
+  - slug: solana
+    h2: "Best wallet labeling API on Solana"
+    body: |
+      The Solana wallet labeling leaderboard is driven by chain-specialist curation rather than universal coverage. Helius wins by default on this chain because its label graph is built directly against native Solana programs (Jito stake pools, Jupiter routers, Pump.fun creators, Magic Eden marketplace IDs) rather than translated from an EVM-shaped schema. Mobula audits Solana as part of its universal coverage and clocks {{p50:mobula}} on the active Kind tab. Blockscout does not index Solana, so the per-chain leaderboard here is between Solana-native APIs.
+  - slug: ton
+    h2: "Best wallet labeling API on TON"
+    body: |
+      TON wallet labeling is essentially a two-API conversation. TonAPI ships a curated entity directory covering core TON contracts (jettons, Telegram bot wallets, DEX routers like STON.fi and DeDust). Mobula audits TON as part of its universal coverage. Most EVM-centric providers (Moralis, Blockscout) do not index TON at all, so the per-chain leaderboard here surfaces the genuine specialist gap. Per the bench's coverage definition, generic categorical fillers like `EOA` or `Wallet` do not count toward a hit; only entity-grade names do.
+  - slug: stellar
+    h2: "Best wallet labeling API on Stellar"
+    body: |
+      Stellar wallet labeling is dominated by StellarExpert, whose `/explorer/directory/{addr}` endpoint is the curated entity graph the rest of the Stellar ecosystem cites. The directory covers anchor issuers (Circle USDC issuer, AnchorUSD), SDF accounts, DEX market makers and SDF grant recipients. Mobula audits Stellar as part of its universal coverage. EVM-centric providers (Moralis, Blockscout) do not index Stellar, so the per-chain leaderboard reflects a specialist-heavy field rather than a universal one.
+  - slug: bitcoin
+    h2: "Best wallet labeling API on Bitcoin"
+    body: |
+      Bitcoin wallet labeling is the hardest case in the benchmark because the chain has no smart contract layer to derive names from, every entity has to come from a curated graph. WalletExplorer maintains the canonical public clustering of Bitcoin addresses (exchanges, mixers, pools, OFAC SDN), and most downstream Bitcoin labeling products cite it directly. Mobula audits Bitcoin as part of its universal coverage. The Kind = Contract tab is essentially empty on Bitcoin (no verified-source contracts), so the EOA tab is the only honest comparison.
+  - slug: ethereum
+    h2: "Best wallet labeling API on Ethereum"
+    body: |
+      Ethereum is the chain where the EOA vs Contract split matters most. On the Contract tab Blockscout saturates near 100% because every Uniswap V3 router, WETH9 and Aave V3 pool ships a verified-source constructor name that the explorer reads for free. On the EOA tab the comparison flips to curated entity graphs: Mobula, Moralis and OLI on Base EAS each maintain their own directory of Binance hot wallets, Safe multisigs, OFAC SDN addresses and public figures. Switch the Kind tab at the top of the page to read the side you actually need.
+  - slug: base
+    h2: "Best wallet labeling API on Base"
+    body: |
+      Base wallet labeling is shaped by Coinbase's OP Stack rollup pattern. Most EVM-centric providers (Mobula, Moralis, Blockscout, OLI via Base EAS) advertise Base coverage and audit cleanly on contracts (Uniswap V4, Aerodrome, the Coinbase Wallet Smart Wallet factory). The EOA tab is the harder job here because Base wallets are dominated by retail Smart Wallets created through the Coinbase Wallet factory, which collapses to a single contract type that providers must distinguish from one another via deployment-time call data.
+
 findings:
   - "{{best_name}} currently leads coverage at {{best_p50}} (24 h) on the active tab, across {{count}} measured providers. The number is the share of curated anchor addresses for which the provider returns a non-generic entity name, audited every 30 minutes against ~180 publicly-known addresses split by kind (contract vs EOA)."
   - "The Kind toggle separates two distinct jobs. On the Contract tab any explorer that reads verified source code (Blockscout in particular) saturates near 100% because the contract's name is already in the bytecode metadata. On the EOA tab the score reflects how well the provider's curated entity graph covers plain wallets, the actually-hard job."