Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Transaction lanes: reserved blockspace with custom lane support

Abierto
  • ¿Algo no está bien?
#128 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
25/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Estancado
Stack tecnológico
rust
Área
backend

Línea de trabajo

Comienza con EvolvePayloadBuilder en crates/node/src/builder.rs y, después, inspecciona las ubicaciones propuestas de Lane, LaneMatcher y LanePolicy en crates/common/ o crates/evolve/. Sigue las cadenas existentes de EvolveConfig chainspec extras y las rutas de receipt/RPC antes de definir los puntos de integración. Se considera terminado cuando se haya cubierto la lista de comprobación, incluidas las garantías de Lane, el overflow, las métricas, los metadatos de RPC y receipt, las pruebas de integración y la documentación.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Summary

Implement a lane-based block construction system in the payload builder that reserves blockspace for different transaction categories, with built-in payment lanes and a pluggable interface for custom lanes.

Motivation

At 100ms block times with sequencer-controlled ordering, the scarce resource isn't confirmation speed -- it's guaranteed throughput under congestion. When block gas is fully utilized, high-value payment transactions compete with arbitrary EVM workloads (DeFi, NFT mints, contract deployments). Payment lanes guarantee that stablecoin transfers and payment-critical transactions always have access to blockspace, regardless of what else is happening on-chain.

Custom lanes extend this to any transaction category a chain operator cares about: system transactions, oracle updates, bridge operations, or domain-specific workloads.

Design

Lane model

A lane defines:

  • Name / ID: identifier for the lane (e.g., payment, system, general)
  • Gas reservation: minimum gas guaranteed for this lane per block
  • Gas cap: maximum gas this lane can consume (optional -- lanes can overflow into general capacity)
  • Matcher: predicate that routes a transaction to a lane (by tx type, destination address, calldata selector, or custom logic)
  • Priority: ordering within the lane (FIFO, fee-based, or custom)
Block structure
Block gas_limit: 30M
├── system lane:   2M reserved  (system txs, L1 info, oracle updates)
├── payment lane:  15M reserved (stablecoin transfers, 0x76 payment calls)
├── general lane:  13M remainder (everything else)
└── overflow: unused lane capacity redistributed to general
Chainspec configuration
{
  "evolve": {
    "lanes": [
      {
        "id": "system",
        "gas_reserved": 2000000,
        "matcher": { "type": "tx_type", "values": ["system"] },
        "priority": "fifo"
      },
      {
        "id": "payment",
        "gas_reserved": 15000000,
        "gas_cap": 20000000,
        "matcher": {
          "type": "any_of",
          "rules": [
            { "type": "to_address", "addresses": ["0x...USDC", "0x...USDT"] },
            { "type": "selector", "selectors": ["0xa9059cbb", "0x23b872dd"] }
          ]
        },
        "priority": "fee"
      }
    ],
    "lanes_activation_height": 0
  }
}
Custom lane interface

Chain operators can define lanes via chainspec (static) or register them programmatically via a trait:

pub trait LaneMatcher: Send + Sync {
    /// Returns the lane ID this transaction belongs to, or None for general lane.
    fn match_tx(&self, tx: &EvTxEnvelope, state: &dyn StateProvider) -> Option<LaneId>;
}

pub trait LanePolicy: Send + Sync {
    /// Orders transactions within a lane. Returns sorted transaction list.
    fn order(&self, txs: Vec<&EvTxEnvelope>) -> Vec<&EvTxEnvelope>;
}

This allows customers to:

  • Define lanes by contract address, function selector, tx type, sender allowlist, or arbitrary state-dependent logic
  • Implement custom ordering within lanes (auction-based, priority fee, FIFO, round-robin)
  • Compose matchers (any_of, all_of, not)
Payload builder integration

EvolvePayloadBuilder in crates/node/src/builder.rs changes:

  1. Classify: Route each incoming transaction to a lane via matchers
  2. Reserve: Allocate gas budget per lane from block gas limit
  3. Fill: Execute transactions lane-by-lane, respecting per-lane gas reservations
  4. Overflow: Redistribute unused lane capacity to general lane
  5. Metrics: Emit per-lane utilization metrics (gas used, tx count, overflow)
Receipt / RPC extensions
  • eth_getTransactionReceipt includes lane field indicating which lane the tx was routed to
  • New RPC: evolve_getLaneStatus returns current lane utilization and available capacity
  • Useful for clients to estimate inclusion probability and fee dynamics per lane

Scope

  • Define Lane, LaneMatcher, LanePolicy traits in crates/common/ or crates/evolve/
  • Implement built-in matchers: tx_type, to_address, selector, sender, any_of, all_of
  • Add lane configuration to EvolveConfig chainspec extras
  • Modify EvolvePayloadBuilder to classify, reserve, fill, and overflow
  • Add per-lane metrics (gas used, tx count, overflow events)
  • Extend RPC with lane status endpoint
  • Extend receipts with lane metadata
  • Integration tests: congested blocks with lane guarantees, overflow behavior, custom matcher registration
  • Documentation: how to define custom lanes for a chain deployment

Prior art

Lenguaje dominante
Rust
Estrellas
8
Forks
9
Merge medio
7 h 25 min
PR fusionados (30 d)
2

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de evstack/ev-reth

Todos los issues de evstack/ev-reth

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.