Códigos de builder

Qué es un código de builder

El registro de clave de sesión que firma un trader (RegisterSessionKeyV2) indica una dirección en su campo feeAddress, el código de builder del frontend, y en maxBuilderFee la tasa más alta que el trader acepta pagarle. Mientras esa dirección sea un builder aprobado, cada posición que cierre la clave le paga lo menor entre la tasa propia del builder y ese máximo firmado. Una clave registrada con el tipo original RegisterSessionKey no lleva consentimiento y no le hace ganar nada a ningún builder. La app no indica ningún builder, y cada operación, venga del frontend que venga, la envía el relayer.

Cuánto cuesta

• Ganancias. El trader le paga al builder su tasa, como mucho el 0.5% de la ganancia escalada, además de la comisión por ganancia de 2% y de la comisión de referido.
• Pérdidas. La parte del builder sale de lo que gana el LP, así que la pérdida del trader no cambia. Queda fuera de la base de acuñación de la pérdida.
• Nunca en liquidaciones, y eso incluye un cierre en el precio de quiebra o más allá, que se resuelve como una liquidación.
• Dentro del total. La comisión base, la comisión de referido y la comisión de builder juntas nunca superan el 15% de la base: la tasa de un builder se recorta al margen que dejen las otras dos.

A un builder solo se le acredita la comisión mientras la cola de pagos está vacía y el LP puede cubrirla, la misma regla que para las comisiones propias del protocolo. Cuando no puede, el ganador igual paga la comisión y esta se queda en el LP.

Solo builders aprobados

• El dueño aprueba cada builder a través del timelock de 2 días.
• El multisig de gobernanza puede eliminar un builder de inmediato. La eliminación detiene la comisión en todas las claves que lo indican; las claves siguen funcionando.
• Cada builder fija su propia tasa, hasta el techo del dueño de 0.5%. El dueño puede mover el techo a través del timelock, hasta 15%; bajarlo por debajo de la tasa de un builder recorta lo que ese builder gana.
• Se rechaza un registro que indica una dirección que no es un builder aprobado, tanto en el relayer como en el contrato; lo mismo pasa con uno que indica un builder sin un máximo firmado, que no ganaría nada.

Para builders

• Indica tu dirección de builder en feeAddress cuando tus usuarios firmen RegisterSessionKeyV2, con la tasa máxima que aceptan en maxBuilderFee; fija tu propia tasa en el registro con setFeeRate, por debajo del techo.
• Las comisiones ganadas se acumulan en el Exchange: builderFees(address) muestra las tuyas.
• Cóbralas con claimBuilderFees() en el Exchange, enviado desde tu dirección de builder. El cobro se acredita en tu saldo del exchange; cualquier parte que el LP no pueda cubrir en ese momento entra en la cola de pagos. Las comisiones ganadas antes de una eliminación se pueden seguir cobrando.
• Clave perdida: el dueño puede mover tus comisiones sin cobrar a una dirección nueva a través del timelock (moveBuilderFees).

Hasta que se cobran, las comisiones de builder son una deuda del LP: quedan dentro del efectivo del LP y se descuentan del LP contable (consulta Solvencia y cola). La dirección del BuilderRegistry está en Direcciones de los contratos.