API Emily

Emilyarrow-up-right es una API que ayuda a facilitar y supervisar el puente sBTC, sirviendo como enlace programático entre los usuarios de sBTC y los firmantes.

Resumen

La API Emily está diseñada para rastrear depósitos y retiros, proporcionando información sobre el estado de las operaciones sBTC en curso. Atiende a dos grupos principales de usuarios: los usuarios de sBTC y los desarrolladores de aplicaciones sBTC.

¿Por qué llamarla Emily?

La API Emily recibe un nombre indirecto porque maneja más que solo depósitos y retiros; puede detectar la salud del sistema y probablemente se ampliará para manejar más funciones a medida que maduren los requisitos de los usuarios. Antes se llamaba “Revealer API”, nombre que dejó de tener sentido tras varios cambios de diseño, y luego “Deposit API”, que también dejó de tener sentido tras algunos cambios. La opción más obvia “sBTC API” da una impresión equivocada sobre lo que la API es responsable, ya que la propia API no gestiona la totalidad del protocolo.

Las grandes empresas nombran sus APIs por algo vagamente relacionado pero lo suficientemente ambiguo como para que las extensiones de la API no hagan que el nombre original resulte engañoso. Siguiendo esto, elegimos “Emily” en honor a Emily Warren Roebling, quien fue el enlace entre los constructores y el ingeniero jefe, su esposo, del puente de Brooklyn. Ella fue, en efecto, la supervisora de la construcción del puente; de manera similar, la API Emily supervisa el puente sBTC y actúa como enlace entre los usuarios del protocolo y los firmantes de sBTC.

Características clave

  • Rastrear depósitos: Supervisar el proceso de conversión de BTC a sBTC.

  • Rastrear retiros: Supervisar el proceso de conversión de sBTC de vuelta a BTC.

  • Proporcionar estado de las operaciones: Ofrecer actualizaciones de estado en tiempo real para las operaciones sBTC en curso.

  • Recuperar datos históricos: Permitir consultar operaciones sBTC pasadas.

Conceptos centrales

Operaciones sBTC

Las operaciones sBTC son los procesos fundamentales que Emily rastrea:

  • Depósitos: Convertir BTC a sBTC

  • Retiros: Convertir sBTC de vuelta a BTC

Estados de la operación

Cada operación sBTC pasa por varios estados:

  • PENDING: La operación ha sido iniciada.

  • ACCEPTED: La operación ha sido aprobada por los firmantes.

  • CONFIRMED: La operación ha sido completada y confirmada en la blockchain.

  • FAILED: La operación no pudo completarse.

Dónde está involucrada Emily en los flujos de sBTC

En cada uno de los flujos de depósito y retiro de sBTC, Emily desempeña un papel vital. Aquí se muestra dónde se sitúa Emily tanto en los flujos de depósito como de retiro.

Durante el flujo de depósito

  1. El usuario crea una transacción de depósito en Bitcoin

  2. El usuario envía la prueba de depósito a la API de depósito

  3. Emily registra el depósito como PENDING

  4. Los firmantes validan y votan sobre el depósito

  5. Si se acepta, Emily actualiza el estado a ACCEPTED

  6. Los firmantes procesan la transacción de Bitcoin

  7. Los firmantes acuñan sBTC en Stacks

  8. Emily actualiza el estado del depósito a CONFIRMED

Durante el flujo de retiro

  1. El usuario inicia el retiro a través del contrato Clarity de sBTC

  2. Emily registra el retiro como PENDING

  3. Los firmantes deciden aceptar o rechazar el retiro

  4. Si se acepta, Emily actualiza el estado a ACCEPTED

  5. Los firmantes procesan la transacción de Bitcoin

  6. Los firmantes queman sBTC en Stacks

  7. Emily actualiza el estado del retiro a CONFIRMED

Última actualización

¿Te fue útil?