Gas Sponsorship

Sequence Builder ofrece una función de patrocinio de gas que permite a los propietarios de proyectos cubrir el gas para sus usuarios en aplicaciones web3. Al cubrir las tarifas de transacción, los usuarios disfrutan de una experiencia de juego fluida sin preocuparse por obtener cripto para pagar comisiones.

Cuando un usuario utiliza una wallet de Sequence, ofrecemos la compatibilidad de patrocinar gas en cualquier cadena para sus usuarios, ya sea a nivel de contrato o de dirección. Esto significa mayores tasas de conversión y una experiencia de onboarding más fluida para sus usuarios. Por defecto, Sequence patrocina todo el gas en testnets para una experiencia de desarrollo sin fricciones, pero recomendamos que, al pasar a Mainnet, usted patrocine el gas para sus usuarios.

Comportamiento actual de Builder:

Considere los despliegues de contratos desde Builder en redes de producción como transacciones autofinanciadas. Incluso si agrega una wallet o contrato bajo Gas Sponsorship, desplegar un nuevo contrato desde Builder, incluyendo la mayoría de los despliegues basados en factory, puede requerir que la wallet que despliega pague el gas de la red.

El patrocinio de gas es más confiable para interacciones retransmitidas con contratos que ya están desplegados.

Patrocinar una dirección de wallet es más amplio que patrocinar una dirección de contrato. Una wallet patrocinada puede cubrir transacciones retransmitidas desde esa wallet en la red patrocinada más allá de un solo contrato, mientras que patrocinar una dirección de contrato es una opción más limitada.

¿Por qué querría patrocinar el gas de mi aplicación?

Obtener la cripto necesaria para cubrir las tarifas de gas es un reto para el onboarding de sus usuarios. Patrocinar el gas en su nombre resuelve este problema, lo que se traduce en mayores tasas de conversión y retención.

Patrocinar gas es sencillo y funciona en todas las redes que soportamos con un solo balance.

​

Cómo habilitar el patrocinio de gas

1. Cree o seleccione un proyecto

   Para crear un proyecto, siga esta guía

   Si ya tiene un proyecto, inicie sesión y seleccione uno de los proyectos listados.

2. Patrocinar Wallet o Contrato

   Primero, vaya a la página de resumen del patrocinio de gas.

   Luego, haga clic en + Add Address para patrocinar el gas de una dirección de wallet específica.

   

   O bien, haga clic en Add Contract para seleccionar un smart contract al que desee patrocinar.

   

   El patrocinio de wallet y el patrocinio de contrato tienen alcances diferentes. Patrocinar una wallet puede cubrir las transacciones retransmitidas de esa wallet en muchos contratos dentro de la red seleccionada. Patrocinar un contrato puede beneficiar a muchos usuarios, pero solo cuando interactúan con ese contrato específico.

3. Agregar método de pago y configurar

   Ahora, vamos a agregar un método de pago con tarjeta de crédito para financiar el patrocinio. Vaya a la configuración de patrocinio de gas y seleccione Configurar método de pago.

   Agregue un método de pago, lo que actualizará la configuración de su patrocinio de gas.

   Puede hacer una recarga única o configurar recargas automáticas según los rangos que prefiera, para definir con precisión cuánto desea subsidiar a sus usuarios cada mes. Una vez que haya elegido los montos de recarga, guarde su configuración.

   Le notificaremos automáticamente si su saldo cae por debajo de $5 y tiene contratos patrocinados.

4. Pruebe su patrocinio

   Recomendamos probar sus patrocinios antes de lanzar. Una vez que el contrato esté desplegado, llame al contrato o use su wallet patrocinada para una transacción en mainnet. Debería ver pronto la lista de transacciones patrocinadas llenándose con estas transacciones.

   No use el despliegue de un contrato desde Builder como prueba de patrocinio, ya que las transacciones de despliegue pueden requerir que la wallet que despliega pague el gas.

​

Patrocinio de gas para ecosistemas

También ofrecemos la posibilidad de patrocinar todas las transacciones de su ecosistema, donde orquestamos varios signers a través de nuestro relayer a nivel de cadena. Esto significa que cualquier desarrollador que construya en su ecosistema, así como cualquier usuario de wallets Sequence, tendrá la mejor experiencia de incorporación y UX posible. No dude en contactarnos para configurar esto en su ecosistema.

​

Patrocinio condicional mediante Webhook

Si necesita tomar decisiones de patrocinio por transacción — por ejemplo, para aplicar límites de gasto por wallet, filtros KYC o reglas según el nivel de usuario — puede adjuntar un webhook a cualquier patrocinador de gas. Cuando llega una transacción patrocinada, el Relayer envía los detalles de la transacción a su endpoint mediante POST y solo la patrocina si usted la aprueba.

​

Configuración

Al crear o actualizar un patrocinador de gas, configure:

• webhookUrl — su endpoint HTTPS. Se requiere HTTPS.
• webhookAuthToken (opcional, recomendado) — un secreto compartido de al menos 32 caracteres. El Relayer lo envía como Authorization: Bearer <token> en cada llamada. Sin un token, cualquiera que conozca la URL puede invocarla.

​

Solicitud

El Relayer envía un cuerpo JSON mediante POST a su webhookUrl:

{
  "chainId": 137,
  "projectId": 12345,
  "gasSponsorId": 678,
  "walletAddress": "0x70236ffbAd7b70c2C65928c7Ca413AEa639FA0dE",
  "transactions": [
    { "to": "0xA0b8...", "value": "0x0", "data": "0xa9059cbb..." }
  ]
}

Encabezados enviados en cada llamada:

• Content-Type: application/json
• Authorization: Bearer <token> — solo si configuró un webhookAuthToken
• X-Sequence-Request-Id: <uuid> — identificador estable por llamada; úselo para registros o deduplicación

transactions[].value y data están codificados en hexadecimal. Una sola decisión puede cubrir varias llamadas agrupadas — aplique sus reglas al arreglo completo.

​

Respuesta

Devuelva HTTP 200 con exactamente este cuerpo JSON:

{ "sponsor": true }

o

{ "sponsor": false }

El código de estado HTTP es importante. El Relayer solo considera 200 OK como una decisión válida — cualquier otro estado (incluyendo 201, 202, 400, 500) se trata como un fallo de transporte y la transacción se patrocina (ver “Fail-open” abajo).

No codifique una denegación como 400 ni una aprobación como 201. Siempre devuelva 200 y coloque la decisión en el campo sponsor.

​

Tiempo de espera y comportamiento fail-open

El Relayer espera hasta 2 segundos por su respuesta. Si su endpoint es lento, inalcanzable, devuelve un estado distinto de 200, devuelve un JSON mal formado u omite el campo sponsor, el Relayer patrocina la transacción por defecto.

Este comportamiento fail-open es intencional: un webhook defectuoso no debe interrumpir silenciosamente el patrocinio para sus usuarios. Para denegar una transacción, debe enviar explícitamente {"sponsor": false} con HTTP 200.

​

Seguridad

• Se requiere HTTPS. El Relayer no sigue redirecciones, por lo que un endpoint HTTPS que redirige a http:// será rechazado.
• Configure un webhookAuthToken a menos que su endpoint aplique autenticación en otra capa (lista de IP permitidas, proxy perimetral).
• El token se envía tal cual en el encabezado Authorization — no registre este encabezado.
• Para rotar el token, llame a UpdateGasSponsor con un nuevo valor. Para eliminar el control completamente, borre webhookUrl.