Cómo los agentes de IA y scripts compran gas EVM mediante API
Guía para pedir microgas programáticamente para bots, agentes autónomos y pipelines de CI sin claves de API, cuentas ni verificaciones KYC.
Los agentes de software autónomos y los scripts de backend a menudo se topan con el problema del arranque en frío. Cuando un agente genera una cuenta externa ordinaria (EOA) para reclamar un airdrop, barrer tokens o interactuar con contratos inteligentes, esa dirección tiene saldo cero para pagar a los validadores.
Para resolverlo, los desarrolladores buscan una solución de api recarga gas evm. Mientras los exchanges exigen verificación KYC y credenciales, 1gwei.dev ofrece una gasolinera HTTP abierta donde un script comprar gas eth funciona con una recarga de gas sin api key.
Los agentes necesitan saldo de gas nativo, no solo protocolos de pago
Protocolos como x402 permiten a las máquinas pagar peticiones de API con stablecoins. Sin embargo, las transacciones EVM en cadena siguen consumiendo activos nativos para ejecutar código. Un agente con créditos no puede mover tokens hasta que su billetera tenga un saldo de gas nativo eoa.
Ya sea operando en Ethereum (ETH), Arbitrum (ETH), Base (ETH), Robinhood (ETH), Polygon (POL), HyperEVM (HYPE), BNB Chain (BNB) o la red de pruebas Sepolia (ETH), los validadores exigen tokens nativos auténticos entregados directamente en la dirección de destino.
API de gasolinera frente a paymasters y relayers de patrocinio
Los paymasters patrocinan UserOperations en cuentas inteligentes
Los paymasters ERC-4337 permiten transacciones sin gas o pagos con tokens ERC-20, pero solo funcionan en cuentas inteligentes configuradas para interactuar con un relayer activo.
Una gasolinera entrega gas nativo a cualquier EOA estándar
Los scripts de desarrollo estándar no pueden depender de paymasters. Una gasolinera cripto openapi vende pequeños saldos de gas nativo a cualquier dirección tras pagar una factura, sin necesidad de contratos especiales.
El ciclo de pedido automatizado: Cotización, Pedido, Pago y Sondeo
El flujo está documentado en texto plano en llms.txt gas para agentes y llms-full.txt. Consta de cuatro pasos HTTP muy sencillos.
1. Solicitar una cotización en vivo
Llama a GET /api/quote?chain={chain}ðAmount={amount} para obtener el importe en USD y la tarifa base actual antes de crear el pedido.
2. Crear el pedido de gas
Envía un POST a /api/orders con destAddress, chain, ethAmount y method (LN, XMR o x402). Puedes incluir ref para atribución o sendAt para envíos programados.
3. Liquidar la factura de pago
Para Lightning, liquida la factura bolt11 con tu factura lightning api gas habitual. Para Monero, envía fondos a payment.address para pagar gas con monero programaticamente. Para x402, transfiere USDC en Base.
4. Sondear hasta confirmar el envío
Consulta GET /api/orders/{id} cada 3 a 8 segundos. Al confirmarse el pago el estado pasa a paid y luego a sent, lo que permite consultar txhash del pedido y verificar la transacción en el explorador.
Parámetros multired y cantidades de tokens
Aunque el parámetro se llama ethAmount, representa el token nativo de la red seleccionada: en Polygon representa POL, en HyperEVM representa HYPE y en BNB Chain representa BNB.
Consulta GET /api/meta para conocer los mínimos, máximos y preajustes en vivo. Como el servicio está pensado para microrrecargas operativas y no para swaps financieros grandes, los límites son deliberadamente prudentes.
Automatización de pipelines de CI y recargas en Sepolia
Las suites de pruebas automatizadas y los ejecutores de CI fallan frecuentemente cuando los faucets públicos se secan o exigen cuentas de GitHub y resolución de captchas.
Con nuestra api de gas sepolia para ci, los entornos de pruebas pueden solicitar sETH bajo demanda antes de desplegar contratos efímeros, evitando esperas e intervención humana.
Gestión de errores, seguridad y límites de privacidad
Las transacciones en cadena son finales e irreversibles: los scripts deben validar siempre el checksum de la dirección de destino antes de enviar un pedido.
En cuanto a privacidad y custodia: los envíos salen de nuestra billetera caliente y no proceden de un contrato descentralizado. 1gwei.dev no hace que tu dirección sea irrastreable y nada oculta la transacción pública en los exploradores de bloques. Lo que se garantiza es que ningún registro de identidad ni cuenta de exchange vincula tu origen de fondos con la dirección receptora.
Preguntas frecuentes
¿Cómo puede un agente de IA recargar gas en una billetera EVM sin KYC?
Un agente puede llamar a la API REST de 1gwei.dev para crear un pedido con la dirección de destino y la cadena, liquidar la factura de Lightning o Monero de forma programática y sondear hasta que se emita la transacción de gas nativo.
¿Qué diferencia hay entre una API de paymaster y una API de gasolinera?
Una API de paymaster patrocina UserOperations para cuentas inteligentes. Una API de gasolinera entrega tokens de gas nativo (ETH, POL, HYPE, BNB) directamente a billeteras EOA estándar para que ejecuten cualquier transacción ordinaria.
¿Cuál es el intervalo de sondeo recomendado para el estado del pedido?
Recomendamos sondear GET /api/orders/{id} cada 3 a 8 segundos. Sondear más rápido de 2 segundos puede activar límites de tasa, mientras que esperar más de 10 segundos añade latencia innecesaria.
¿Qué parámetros son obligatorios al llamar a POST /api/orders?
Las solicitudes deben enviar destAddress (la dirección 0x receptora), chain (la clave de la red, como base o hyperevm), ethAmount (la cantidad deseada de gas nativo) y method ('LN', 'XMR' o 'x402').
¿Pueden los pipelines de CI/CD usar esta API para financiar billeteras en Sepolia?
Sí. Los ejecutores de CI pueden crear pedidos programáticos de ETH en Sepolia y liquidar la factura, sin captchas, sin requisitos de cuenta de GitHub y sin colas de faucets públicos.
¿Cómo funciona la privacidad de pago para scripts automatizados?
Al pagar con Monero o Lightning, no se registra ninguna identidad de remitente ni cuenta de exchange en la cadena. El envío desde nuestra billetera caliente es público, pero ningún enlace lo asocia con la fuente de fondos del agente.