¿Qué son los Paymasters? (ERC-4337)

En la abstracción de cuentas, los paymasters son contratos inteligentes que permiten políticas de gas flexibles, como que las aplicaciones descentralizadas patrocinen operaciones para sus usuarios (es decir, paguen las tarifas de gas en la moneda nativa de la blockchain), o acepten el pago de tarifas de gas en un token ERC-20 (por ejemplo, USDC) en lugar de la moneda nativa de la blockchain.

El contrato inteligente paymaster se introdujo en la Ethereum Improvement Proposal (EIP) 4337 y se integra con otra infraestructura de Account Abstraction, como los bundlers y el contrato inteligente entry point, para compensarlos por adelantar el gas necesario para ejecutar user operations.

Explicación de paymasters de Alchemy University

¿Cuándo se deben usar los paymasters?

Hay dos razones principales para usar un paymaster: patrocinar las tarifas de gas de la transacción de otra cuenta, o pagar las tarifas de gas en un token ERC-20 en lugar de la moneda nativa de la red blockchain. Este paymaster ERC-20 puede ser el token de una aplicación, o una stablecoin como USDC.

1. Paymasters para patrocinar transacciones

Entre las razones por las que los desarrolladores de aplicaciones y billeteras Web3 pueden optar por usar un paymaster patrocinador están facilitar la participación de nuevos usuarios en Web3, incentivar comportamientos específicos de usuarios en la plataforma, permitir acuñar un NFT sin pagar gas, desplegar una billetera sin gastar gas, y muchos otros casos de uso.

Para patrocinar transacciones con un paymaster, los desarrolladores Web3 crean políticas definiendo las reglas que determinan qué user operations pueden patrocinarse; el contrato paymaster que utilicen tendrá cierta cantidad de criptomoneda depositada en el contrato entry point, de la cual se deducirán las tarifas de gas de las transacciones subsidiadas, y luego activan la política.

¿Cuáles son las reglas que definen las políticas de patrocinio de un paymaster?

Para controlar quién puede acceder a transacciones patrocinadas con un paymaster, los desarrolladores pueden definir reglas para administrar el gasto y la cantidad de user operations por aplicación y por remitente (por ejemplo, un usuario que solicita una user op patrocinada), admitir o denegar el acceso a user ops patrocinadas, y establecer controles sobre cuándo comienzan, terminan y expiran las políticas.

• Gasto máximo: el monto máximo de dinero (en USD) que la política puede gastar
• Gasto máximo por remitente: el monto máximo de dinero (en USD) que la política puede gastar
• Gasto máximo por user operation: el monto máximo de dinero (en USD) que cada user operation puede gastar
• Conteo máximo de transacciones: la cantidad máxima global de transacciones que la política puede patrocinar
• Conteo máximo de transacciones por remitente: la cantidad máxima individual de transacciones por remitente
• Listas de permitidos de remitentes: reglas que definen las cuentas que tienen acceso al paymaster
• Listas de bloqueados de remitentes: reglas que definen las cuentas que no tienen acceso al paymaster
• Hora de inicio de la política: la hora en que comienza la política
• Hora de finalización de la política: la hora en que termina la política
• Expiración de la política: el monto máximo de dinero (en USD) que la política puede gastar

Nota: Estas son las reglas de política de gas que se pueden configurar usando el Gas Manager Coverage API de Alchemy. Otros paymasters compatibles con ERC-4337 pueden admitir más o menos reglas.

Usando paymaster access keys, los desarrolladores pueden crear, activar y administrar políticas de patrocinio de gas flexibles de forma programática. Para administrar políticas manualmente, los desarrolladores pueden crearlas en el Gas Manager dashboard.

¿Cómo administra el Gas Manager Coverage API de Alchemy los depósitos para patrocinar user ops?

El contrato del Gas Manager Coverage API de Alchemy ya ha depositado moneda nativa en el contrato entrypoint global de cada blockchain compatible. Cuando los desarrolladores crean políticas de gas a través de nuestro Gas Manager, registramos cuánta moneda nativa usaron para cubrir las tarifas de gas.

Al final del mes, los equipos que construyen sobre Alchemy reciben una factura con el monto total de tarifas de gas que su política cubrió, más un 8% del total de tarifas de gas cubiertas. Esta tarifa se paga luego a través del método de pago en su cuenta de Alchemy.

¿Cuáles son las tarifas asociadas al Gas Manager Coverage API de Alchemy?

Las tarifas por cubrir gas para transacciones patrocinadas son personalizadas para clientes Enterprise, 8% para clientes del nivel Growth, y gratuitas para usuarios del plan gratuito, ya que las transacciones patrocinadas solo están disponibles en testnets.

¿En qué redes están desplegados los contratos paymaster patrocinadores de Alchemy?

Alchemy tiene contratos paymaster patrocinadores desplegados en Ethereum, Arbitrum, Optimism y Polygon. Aquí están las direcciones de despliegue en mainnet y sus enlaces a Etherscan:

• Ethereum - 0x4Fd9098af9ddcB41DA48A1d78F91F1398965addc
• Polygon - 0x4Fd9098af9ddcB41DA48A1d78F91F1398965addc
• Arbitrum - 0x4Fd9098af9ddcB41DA48A1d78F91F1398965addc
• Optimism - 0x4Fd9098af9ddcB41DA48A1d78F91F1398965addc

¿En qué testnets están desplegados los contratos paymaster patrocinadores de Alchemy?

Alchemy tiene contratos paymaster patrocinadores desplegados en Sepolia, Goerli, Mumbai, Arbitrum-Goerli y Optimism-Goerli. Aquí están las direcciones de despliegue en testnet y sus direcciones de contrato en un explorador de bloques:

• ETH Sepolia - 0xC03Aac639Bb21233e0139381970328dB8bcEeB67
• ETH Goerli - 0xC03Aac639Bb21233e0139381970328dB8bcEeB67
• Polygon Mumbai - 0xC03Aac639Bb21233e0139381970328dB8bcEeB67
• Arbitrum Goerli - 0xC03Aac639Bb21233e0139381970328dB8bcEeB67
• Optimism Goerli - 0xC03Aac639Bb21233e0139381970328dB8bcEeB67

2. Paymasters para pagar el gas con tokens ERC-20

Entre las razones por las que los desarrolladores de dapps y billeteras pueden elegir usar un paymaster ERC-20 están agregar utilidad al token ERC-20 de su aplicación, ofrecer más flexibilidad a usuarios que poseen una variedad de activos digitales dentro del ecosistema de una red blockchain, pagar con una stablecoin cuyo valor no cambia, a diferencia de monedas nativas como ETH, MATIC, OP y ARB, y muchos otros casos de uso específicos de cada aplicación.

¿Cuáles son los tipos de paymasters según la interfaz IPaymaster?

Los paymasters cumplen múltiples propósitos, como patrocinar transacciones y permitir que los usuarios paguen el gas con tokens ERC-20; los paymasters que cumplen estas dos funciones se describen como verifying paymasters y token (deposit) paymasters, según la interfaz IPaymaster.

1. Verifying paymasters

El tipo verifying paymaster se usa cuando un servicio fuera de la cadena decide si la tarifa de la transacción debe patrocinarse. Por ejemplo, si un usuario quiere pagar con moneda fiat y una tarjeta de crédito, el remitente de la user operation primero enviará su pago al firmante externo, y si este paso es exitoso, el paymaster validará la operación y confirmará que cubrirá la tarifa de la transacción.

2. Paymasters ERC-20

El tipo deposit paymaster se usa cuando las tarifas de gas deben pagarse con un token ERC-20. El desarrollador especifica el token ERC-20 y las direcciones de las billeteras de contrato inteligente elegibles para user operations patrocinadas. Un ejemplo es cuando una dapp Web3 quiere usar su propio token ERC-20 para pagar las transacciones de los primeros 1000 usuarios.

Aunque un deposit paymaster permite el patrocinio de tarifas con tokens ERC-20, el costo real de la transacción se paga en ETH y se deduce del monto de reserva depositado por el paymaster en el contrato entry point. La función postOp() contiene la lógica que toma tokens ERC-20 del remitente según el precio cotizado por un oráculo, para igualar el ETH necesario para cubrir las tarifas.

¿Cómo funcionan los paymasters?

Los paymasters funcionan interactuando con el contrato entry point para cubrir las tarifas de las user operations patrocinadas y reembolsar a los bundlers que ejecutan user operations en nombre de los remitentes.

Para cada user operation:

1. Llamar a validateOp en la billetera del remitente
2. Si la user op tiene una dirección de paymaster, llamar a validatePaymasterOp
3. Descartar las user ops que fallen la llamada a validatePaymasterOp
4. Para cada user op, llamar a executeOp en la billetera del remitente
5. Registrar cuánto gas se usó para ejecutar la user op en nombre del remitente
6. Transferir ETH al bundler para pagar el gas que usó al ejecutar la user op en nombre del remitente
7. Si la user op tiene un campo de paymaster, el paymaster usa el ETH depositado en su contrato para pagar al bundler
8. Si la user op no tiene un campo de paymaster, el ETH es reembolsado por la billetera del remitente

Aquí hay un diagrama que ilustra cómo funcionan los paymasters:

¿Qué funciones incluye la interfaz IPaymaster?

La interfaz IPaymaster es el modelo que cada contrato paymaster debe seguir para cumplir con las especificaciones de la propuesta. Introduce dos funciones: validatePaymasterOp() y postOp().

1. validatePaymasterUserOp()

La función validatePaymasterUserOp() es utilizada por los nodos del mempool, los bundlers y el contrato entry point para asegurarse de que el contrato paymaster acepta patrocinar las tarifas de la transacción. La validatePaymasterUserOp() se menciona en el campo paymasterAndData de una user operation.

La función validatePaymasterUserOp() acepta la representación en bytes de la user operation que se va a verificar, junto con su ID y el costo máximo. Devuelve una variable bytes32 llamada 'context', que luego se pasa a la función postOp().

2. postOp()

La función postOp() define qué debe hacerse si la user op se valida correctamente. Por ejemplo, si el remitente de la user op quiere pagar con un token ERC-20, el entry point llamará a postOp() después de completada la operación y comunicará cuánto gas se usó.

La función postOp() solo puede llamarse si el 'context' generado por validatePaymasterUserOp() no es nulo.

¿Cómo evitan los bundlers los ataques DoS de paymasters maliciosos?

La especificación ERC-4337 describe un sistema de puntuación de reputación y throttling para paymasters que permite a los bundlers ERC-4337 evitar ejecutar user operations de paymasters maliciosos.

Debido a que el almacenamiento de un paymaster se comparte entre todas las operaciones de un bundle que usan ese paymaster, las acciones de un solo validatePaymasterOp podrían hacer que la validación falle para numerosas otras user ops del bundle que usan ese mismo paymaster, en un ataque de denegación de servicio (DoS).

Para evitar que paymasters maliciosos creen múltiples instancias de sí mismos (es decir, un ataque Sybil), se les exige a los paymasters depositar ETH en garantía (stake). Los stakes de los paymasters nunca se penalizan (slashing) y pueden retirarse en cualquier momento; los stakes existen para exigir que un posible atacante bloquee una cantidad no trivial de capital y así desincentivar el comportamiento malicioso.

¿Cuáles son los beneficios para los desarrolladores de usar un paymaster?

Los beneficios de los paymasters incluyen aumentar la flexibilidad de las políticas de gas, simplificar la experiencia de onboarding a Web3 para nuevos usuarios, y agregar mayor programabilidad a las transacciones.

1. Atraer nuevos usuarios

Un beneficio para los desarrolladores que aprovechan los paymasters es facilitar la participación de nuevos usuarios en Web3. El proceso actual de crear una billetera de Externally Owned Account (EOA), fondearla con el token nativo de una blockchain, y acuñar un NFT es un proceso complicado con muchas oportunidades para que los usuarios lo abandonen.

Los paymasters ayudan a reducir la fricción de fondear una billetera con moneda nativa para completar transacciones onchain, como acuñar un NFT, reclamar un nombre de usuario, o registrarse en un evento usando su billetera.

2. Mejorar la experiencia de usuario

Los desarrolladores que construyen productos Web3 pueden mejorar la experiencia de usuario de su aplicación con paymasters, agregando funciones que permitan pagar el gas en la moneda nativa de la plataforma.

3. Incentivar el comportamiento del usuario

Las startups Web3 que buscan crecer pueden beneficiarse de los paymasters cubriendo las tarifas de la plataforma para usuarios avanzados, incentivando a los usuarios a probar nuevos productos, y logrando participación en promociones de marketing.

Al igual que las ventajas de las billeteras de contrato inteligente, los paymasters pueden beneficiar a los desarrolladores Web3 de muchas maneras distintas. Las empresas Web3 más innovadoras de hoy están encontrando nuevas formas de implementar paymasters para mejorar sus productos y la experiencia de usuario en Web3.

Cómo empezar a usar una paymaster API

El paymaster de Alchemy está disponible en las mainnets de Ethereum, Polygon, Optimism y Arbitrum. Para empezar a patrocinar transacciones y construir políticas de gas flexibles con un paymaster compatible con ERC-4337, explora nuestra Gas Manager API y nuestra guía de inicio rápido para crear una política de paymaster.

Preguntas frecuentes

¿Qué es un paymaster en ERC-4337?

Un paymaster es un contrato inteligente introducido en EIP-4337 que permite políticas de gas flexibles, permitiendo que las aplicaciones patrocinen las tarifas de gas de los usuarios o acepten pagos en tokens ERC-20 en lugar de la moneda nativa de la blockchain.

¿Cuándo deben los desarrolladores usar paymasters?

Los paymasters son ideales para patrocinar tarifas de gas y mejorar el onboarding de usuarios, permitir el pago en tokens ERC-20 o stablecoins como USDC, e incentivar comportamientos específicos de usuarios en plataformas Web3.

¿Cuáles son los dos tipos principales de paymasters?

Los dos tipos son los verifying paymasters, que usan servicios fuera de la cadena para decidir el patrocinio de la transacción, y los paymasters ERC-20, que permiten a los usuarios pagar las tarifas de gas con tokens ERC-20 mientras el paymaster cubre el costo real en ETH.

¿Cómo interactúan los paymasters con el contrato EntryPoint?

El EntryPoint llama a validatePaymasterUserOp() durante la validación para confirmar el patrocinio, y luego llama a postOp() después de la ejecución para manejar la contabilidad y las transferencias de tokens desde la reserva de ETH depositada por el paymaster.

¿Qué funciones debe implementar un paymaster?

Los paymasters deben implementar validatePaymasterUserOp() para verificar los acuerdos de patrocinio y postOp() para manejar la lógica posterior a la ejecución, como transferir tokens ERC-20 de los usuarios para cubrir los costos en ETH.

¿Cómo maneja el Gas Manager de Alchemy la facturación de las transacciones patrocinadas?

Alchemy predeposita moneda nativa en los contratos EntryPoint y factura mensualmente a los clientes por el total de tarifas de gas cubiertas, más una tarifa del 8% para clientes del nivel Growth, con precios personalizados para clientes Enterprise.

¿Qué políticas pueden configurar los desarrolladores para el patrocinio de gas?

Los desarrolladores pueden configurar límites de gasto máximo, tanto globales como por remitente, límites en la cantidad de transacciones, listas de permitidos y bloqueados de remitentes, y horas de inicio/fin de la política, para controlar el uso del paymaster.