Logo
Nuevos usuarios de RPC: 35% de descuento el primer mesVer oferta
OnFinality Learn
Guías de Red y Protocolo11 min de lectura

Ciclo de vida de una transacción en Base: desde el envío hasta la finalidad en L1

Una guía práctica sobre cómo se envían, secuencian, confirman y finalizan las transacciones en Base, con diagnósticos ejecutables para verificar cada etapa.

TL;DR

Una transacción en Base es una transacción con formato Ethereum enviada al secuenciador de Base, que la ordena en un bloque de 200 ms y devuelve un recibo mucho antes de que el lote se publique y finalice en Ethereum L1. La consecuencia práctica es que una transacción puede estar confirmada, segura y finalizada en momentos distintos, y las aplicaciones que tratan el primer recibo como irreversible se exponen al riesgo de reorganización y de fallo del secuenciador. Este artículo explica las etapas, muestra cómo consultar cada una con métodos JSON-RPC estándar y ofrece un procedimiento de diagnóstico para rastrear una transacción desde el envío hasta la finalidad en L1. También cubre los modos de fallo que producen transacciones atascadas o descartadas en Base y las compensaciones entre velocidad y certeza.

Qué es realmente una transacción en Base

Base es un rollup optimista de OP Stack. Una transacción en Base es una transacción estándar de Ethereum —mismos campos, mismo esquema de firma, misma ruta de envío eth_sendRawTransaction— pero la ejecuta el secuenciador de Base en lugar de los validadores de la red principal de Ethereum. La transacción paga gas en ETH en Base, y su calldata y cambios de estado se comprometen finalmente en Ethereum L1 mediante el sistema de envío por lotes y pruebas de fraude del rollup.

Como el formato de transacción es idéntico al de Ethereum, cualquier cadena de herramientas EVM funciona: ethers, viem, web3.py, Foundry, Hardhat. Lo que difiere es el modelo de temporalidad y certeza. En la red principal de Ethereum, la inclusión en un bloque y la finalidad económica están separadas por aproximadamente dos épocas. En Base, la inclusión ocurre en un bloque del secuenciador de 200 ms, pero ese bloque es un compromiso blando hasta que el lote correspondiente se publica en L1 y ha transcurrido la ventana de disputa. Tratar esos dos eventos como el mismo es la fuente más común de errores de integración.

Esta guía asume que puede firmar y difundir una transacción EVM y que dispone de un endpoint RPC para Base. Si aún está eligiendo un endpoint, la guía del RPC Assistant sobre endpoints RPC multicadena fiables cubre los criterios de selección; la mecánica descrita a continuación se aplica independientemente del proveedor.

  • Formato de transacción: Ethereum legacy o EIP-1559, firmada con una clave Ethereum.
  • Token de gas: ETH en Base, no un token separado.
  • Ejecución: secuenciador de Base, con el estado comprometido en L1 por lotes.
  • Disponibilidad del recibo: normalmente dentro de un bloque de 200 ms tras la secuenciación.

Las cuatro etapas de confirmación y qué garantiza cada una

Una transacción en Base pasa por cuatro etapas distinguibles. Cada una tiene una garantía diferente y se corresponde con una señal RPC distinta.

Etapa 1 — Envío. La transacción firmada se difunde a un nodo RPC de Base y entra en el pool de transacciones del secuenciador. En este punto la transacción tiene un hash pero no un bloque. eth_getTransactionByHash devuelve un objeto pendiente o null según si el nodo la ha visto. Todavía no existe garantía de inclusión.

Etapa 2 — Inclusión por el secuenciador (preconfirmación). El secuenciador ordena la transacción en un bloque canónico, que Base construye cada 200 ms. eth_getTransactionReceipt devuelve un recibo con número de bloque, estado, gas usado y logs. Esta es la etapa que la mayoría de las aplicaciones tratan como "confirmada". Es un compromiso blando: el secuenciador ha prometido el orden, pero el bloque aún no está anclado a L1.

Etapa 3 — Publicación del lote en L1 (segura). Los bloques del secuenciador se comprimen en un lote y se publican en Ethereum L1. Una vez que la transacción del lote se incluye en un bloque de L1, los datos de la transacción en Base están disponibles en L1 y pueden ser disputados. Este es el equivalente en el rollup de la cabeza "segura". Es el punto más temprano en el que la inclusión de la transacción está respaldada por la disponibilidad de datos en L1.

Etapa 4 — Finalidad en L1. Tras el propio mecanismo de finalidad de Ethereum (dos épocas bajo prueba de participación) más la ventana de disputa del rollup, el lote queda finalizado. Revertir una transacción en esta etapa requeriría una reorganización de L1 más allá de la finalidad, lo que se considera económicamente inviable. Esta es la única etapa adecuada para decisiones de liquidación irreversibles, como retiros de exchanges o puentes entre cadenas.

  • Pendiente: hash conocido, sin bloque asignado.
  • Preconfirmada: existe recibo, bloque construido por el secuenciador, cadencia de ~200 ms.
  • Segura: lote publicado en L1, datos disponibles, disputable.
  • Finalizada: finalidad de L1 más ventana de disputa transcurrida.

Cómo funcionan el orden de transacciones y las tarifas de prioridad en Base

Dentro de cada bloque de 200 ms, Base ordena las transacciones por tarifa de prioridad, como se documenta en la especificación de ordenación de transacciones de Base. La tarifa base se quema según EIP-1559; la tarifa de prioridad va al secuenciador. Esto significa que una transacción con una tarifa de prioridad competitiva tiene más probabilidades de entrar en el siguiente bloque, pero la cadencia de 200 ms hace que incluso una tarifa modesta suela confirmarse en pocos bloques bajo carga normal.

Base también admite transacciones de validez, que compiten por la inclusión solo después de que se cumplan sus condiciones de predicado. Un predicado coincidente no reserva espacio en el bloque, por lo que una transacción de validez que se vuelve elegible durante un período de congestión sigue compitiendo por la tarifa como cualquier otra transacción. Para el diseño de aplicaciones, esto significa que no puede asumir que una transacción condicional se ejecutará en el momento exacto en que su condición se vuelve verdadera; solo puede asumir que se vuelve elegible.

La implicación práctica para la estimación de tarifas: consulte eth_maxPriorityFeePerGas y eth_gasPrice desde un endpoint RPC de Base, añada un margen y establezca una tarifa máxima que tolere unos pocos bloques de movimiento de la tarifa base. No copie los supuestos de tarifas de la red principal de Ethereum; la tarifa base de Base suele ser órdenes de magnitud menor, y pagar de más no compra una inclusión más rápida más allá del siguiente bloque.

Requisitos previos y supuestos para el procedimiento de diagnóstico

El procedimiento siguiente asume que dispone de una URL RPC de Base (red principal o Sepolia), una cuenta financiada con una clave privada que controla y una cadena de herramientas que pueda firmar transacciones EIP-1559. También asume que puede acceder a un endpoint RPC de Ethereum L1 para verificar la publicación de lotes, ya que el RPC propio de Base no expone directamente el estado de los lotes en L1.

Marcadores de posición utilizados en todo el documento: BASE_RPC_URL, L1_RPC_URL, PRIVATE_KEY y TO_ADDRESS. Nunca confirme una clave privada real en un repositorio ni la pegue en el historial de una terminal compartida. Para sistemas en producción, firme con una billetera de hardware o un servicio de gestión de claves y mantenga las credenciales RPC en un gestor de secretos.

Si necesita un endpoint dedicado para una latencia constante durante el diagnóstico, la página de opciones de nodo dedicado describe la diferencia entre capacidad compartida y dedicada. Los endpoints públicos compartidos son adecuados para una comprobación puntual, pero introducen variación que puede confundirse con el comportamiento de la red.

Envío de una transacción y captura de su hash

El primer paso es construir, firmar y difundir una transacción, y luego persistir el hash inmediatamente. El hash es el único identificador estable que utilizará para cada consulta posterior. El siguiente fragmento de Python usa web3.py y una transacción EIP-1559; imprime el hash y el estado inicial del recibo.

Ejecútelo primero contra una testnet. El script no espera la confirmación; regresa en cuanto el nodo acepta la transacción en bruto, que es el comportamiento correcto para un diagnóstico que consultará por separado.

import os, time
from web3 import Web3

w3 = Web3(Web3.HTTPProvider(os.environ["BASE_RPC_URL"]))
acct = w3.eth.account.from_key(os.environ["PRIVATE_KEY"])

nonce = w3.eth.get_transaction_count(acct.address)
priority = w3.eth.max_priority_fee
base_fee = w3.eth.get_block("latest")["baseFeePerGas"]

 tx = {
    "to": os.environ["TO_ADDRESS"],
    "value": w3.to_wei(0.0001, "ether"),
    "chainId": w3.eth.chain_id,
    "nonce": nonce,
    "maxPriorityFeePerGas": priority,
    "maxFeePerGas": base_fee * 2 + priority,
    "gas": 21000,
    "type": 2,
}

signed = acct.sign_transaction(tx)
hash_ = w3.eth.send_raw_transaction(signed.raw_transaction)
print("tx hash:", hash_.hex())

# Poll for the sequencer receipt
for _ in range(30):
    r = w3.eth.get_transaction_receipt(hash_)
    if r is not None:
        print("block:", r.blockNumber, "status:", r.status, "gasUsed:", r.gasUsed)
        break
    time.sleep(0.5)
else:
    print("no receipt after 15s — inspect pending pool and nonce")

Verificación de cada etapa con llamadas JSON-RPC

Una vez que tenga el hash, puede verificar cada etapa de forma independiente. Las llamadas curl a continuación utilizan métodos JSON-RPC estándar compatibles con los nodos de Base. Reemplace BASE_RPC_URL con su endpoint.

Las etapas 1 y 2 se comprueban con eth_getTransactionByHash y eth_getTransactionReceipt. Un recibo nulo con un objeto de transacción no nulo significa que la transacción está en el pool pero aún no ha sido secuenciada. Un objeto de transacción nulo significa que el nodo no la ha visto en absoluto: verifique el hash, el ID de cadena y si la transacción se difundió a un nodo que tiene pares con el secuenciador.

Las etapas 3 y 4 requieren una consulta a L1. El contrato de bandeja de entrada de lotes de Base emite eventos cuando se publica un lote; puede encontrar el lote que contiene su transacción buscando en los logs de L1 el evento de envío de lote y haciendo coincidir el rango de bloques de L2. Esto es más complejo que una sola llamada RPC, por lo que la mayoría de los equipos utilizan un indexador o el RPC de rollup op-node de OP Stack para optimism_syncStatus, que informa directamente las cabezas segura y finalizada de L2.

# Stage 1/2: transaction and receipt on Base
curl -s -X POST "$BASE_RPC_URL" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionByHash","params":["0xYOUR_TX_HASH"]}'

curl -s -X POST "$BASE_RPC_URL" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"eth_getTransactionReceipt","params":["0xYOUR_TX_HASH"]}'

# Stage 3/4: safe and finalized L2 heads via the rollup RPC
curl -s -X POST "$BASE_RPC_URL" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"optimism_syncStatus","params":[]}'

Resultados esperados de la verificación y cómo interpretarlos

La siguiente tabla describe la forma esperada de cada respuesta y lo que significa. Es una guía de lectura, no un conjunto de valores medidos; los números de bloque y las marcas de tiempo reales dependen de cuándo ejecute el procedimiento.

EtapaMétodoForma esperada de la respuestaInterpretación
Pendienteeth_getTransactionByHashObjeto con blockNumber: nullEn el pool, no secuenciada
Preconfirmadaeth_getTransactionReceiptObjeto con blockNumber, status: 0x1El secuenciador la incluyó
Seguraoptimism_syncStatussafe_l2.number ≥ su bloqueLote publicado en L1
Finalizadaoptimism_syncStatusfinalized_l2.number ≥ su bloqueFinalidad de L1 alcanzada
Si el recibo existe pero status es 0x0, la transacción se incluyó y se revirtió. Eso es un fallo a nivel de contrato, no un fallo de secuenciación; inspeccione el motivo de la reversión con eth_call en el bloque padre. Si el recibo nunca aparece y el objeto de transacción también es nulo, es probable que la transacción se haya descartado del pool, normalmente por un hueco de nonce o una tarifa máxima demasiado baja.

Una comprobación de sentido útil es comparar eth_blockNumber antes y después del envío. Como Base construye bloques cada 200 ms, el número de bloque debería avanzar aproximadamente cinco por segundo. Si no lo hace, es probable que esté utilizando un endpoint con retraso o limitado en tasa, en lugar de un estancamiento de la red.

Solución de problemas de transacciones atascadas, descartadas y reemplazadas

Atascada como pendiente con un hueco de nonce. Si una transacción anterior de la misma cuenta sigue pendiente, el secuenciador no incluirá un nonce posterior. Consulte eth_getTransactionCount(address, "pending") y compárelo con "latest". Una diferencia indica transacciones no confirmadas por delante de la suya. Resuélvalo esperando o reemplazando la transacción anterior con una tarifa más alta en el mismo nonce.

Descartada del pool. El pool de transacciones de Base tiene un tamaño finito y expulsa las transacciones con tarifas más bajas bajo presión. Una transacción que estaba pendiente y luego desaparece de eth_getTransactionByHash fue expulsada. Vuelva a enviarla con una tarifa de prioridad más alta; el nonce no cambia.

Reemplazada. Si volvió a enviar con el mismo nonce y una tarifa más alta, el hash original devolverá null y el hash de reemplazo llevará el recibo. Rastree ambos hashes durante la ventana de reemplazo.

Confirmada pero no segura durante mucho tiempo. Esto suele significar que el secuenciador está produciendo bloques pero la publicación de lotes en L1 está retrasada. Verifique el mercado de gas de L1 y el saldo del remitente de lotes. Durante la congestión de L1, la publicación de lotes puede retrasarse, lo que extiende el tiempo hasta seguro y finalizado sin afectar la velocidad de preconfirmación.

El recibo existe pero faltan logs. Algunos proveedores RPC devuelven recibos sin decodificación completa de logs. Consulte eth_getLogs con el rango de bloques y el filtro de dirección para recuperar los logs en bruto y decodifíquelos en el cliente.

  • Hueco de nonce: compare el conteo de transacciones pendiente vs. último.
  • Expulsión: el hash desaparece del pool, vuelva a enviar con una tarifa más alta.
  • Reemplazo: el hash original es nulo, el hash de reemplazo lleva el recibo.
  • Retraso de lote: preconfirmada pero no segura; verifique el gas de L1 y el saldo del remitente.

Limitaciones y compensaciones de depender de la preconfirmación

La preconfirmación es rápida y barata, pero es una promesa de un secuenciador centralizado, no una garantía criptográfica. Si el secuenciador falla o es censurado, las transacciones preconfirmadas pueden reordenarse o descartarse antes de que el lote llegue a L1. La hoja de ruta de descentralización de Base aborda esto con el tiempo, pero cualquier aplicación que mueva valor basándose en un recibo preconfirmado debe tratar ese recibo como una decisión de crédito, no como una liquidación.

La compensación es latencia frente a certeza. Esperar la finalidad de L1 añade minutos a cada operación y es innecesario para la mayoría de los flujos orientados al usuario, donde un recibo preconfirmado más una heurística de profundidad de confirmación (por ejemplo, esperar N bloques de Base) es adecuado. Para puentes, depósitos en exchanges y cualquier flujo donde la reversión sería catastrófica, espere la cabeza finalizada de L2 que informa optimism_syncStatus.

Una segunda compensación es la dependencia del RPC. El estado de preconfirmación es tan fresco como su endpoint. Un nodo con retraso puede informar una transacción como pendiente después de que ya se haya secuenciado. Utilice un proveedor con garantías de frescura documentadas o verifique con un segundo endpoint antes de concluir que una transacción está atascada. La guía de endpoints RPC explica cómo evaluar la frescura y los límites de tasa, y la descripción general del servicio API describe el modelo operativo detrás de los endpoints gestionados.

Próximos pasos: instrumentar el ciclo de vida en su aplicación

El patrón más robusto es modelar las cuatro etapas explícitamente en la máquina de estados de su aplicación en lugar de colapsarlas en un booleano confirmed. Almacene el hash de la transacción, el número de bloque preconfirmado, la cabeza segura en el momento de la confirmación y la cabeza finalizada cuando llegue. Emita eventos distintos para cada transición para que los consumidores posteriores puedan elegir su propio umbral de certeza.

Para una implementación en producción, combine el diagnóstico anterior con monitoreo de las cabezas segura y finalizada. Una divergencia repentina entre la producción de bloques preconfirmados y el avance de la cabeza segura es una advertencia temprana de problemas de publicación de lotes. Si está seleccionando un endpoint para esta carga de trabajo, la comparación del RPC Assistant de proveedores RPC compatibles con Base cubre los criterios que importan para el seguimiento del ciclo de vida, y la página de precios de RPC explica cómo el volumen de solicitudes se traduce en costo cuando consulta varias etapas por transacción.

Por último, pruebe las rutas de fallo deliberadamente en Base Sepolia: envíe con una tarifa intencionalmente baja, cree un hueco de nonce y observe cómo cada etapa informa la condición. El comportamiento que ve en la testnet es el comportamiento que debe manejar en producción, y la cadencia de bloques de 200 ms hace que estos experimentos sean rápidos de ejecutar.

Nunca te preocupes por la infraestructura nuevamente

OnFinality elimina la carga pesada de DevOps para que puedas construir de forma más inteligente y rápida.

Comenzar