Saltar al contenido principal
Borrador: especificación en curso. Los endpoints y campos pueden cambiar.
Rebalancear significa ajustar la proporción entre USDY y BUIDL en el saldo que está rindiendo. La empresa decide cuándo ocurre: las reglas viven en la política de asignación, y todo rebalanceo ocurre solo con la aprobación y la firma de la empresa. TESA no recomienda asignaciones ni define disparadores.

De dónde vienen las propuestas

  • Generadas por una regla de su política (origem: regra): usted define el disparador, por ejemplo un diferencial de tasas por encima de un umbral que usted elija. Cuando se cumple su regla, el software prepara la transacción y el evento alocacao.proposta avisa a la integración. El campo regra_id indica qué regla se cumplió.
  • Creadas manualmente por la integración (origem: manual): con POST /propostas, indicando la asignación objetivo elegida por la empresa.
El monitoreo de reglas funciona como un informe sobre el cumplimiento de la política propia de la empresa por parte de la cartera, no como una sugerencia.

Flujo

1

Reciba o cree la propuesta

2

Revise los movimientos

GET /propostas/{id} muestra movimentos y alocacao_resultante. Revíselos antes de aprobar.
3

Apruebe o rechace

Con una clave admin, llame a POST /propostas/{id}/aprovar o POST /propostas/{id}/rejeitar. La aprobación exige una Idempotency-Key y, en la propuesta actual, puede firmarse con HMAC.
4

Firme con el custodio

La propuesta aprobada incluye transacoes[].payload_nao_assinado. El custodio firma y transmite.
5

Siga la ejecución

Tras la confirmación on-chain, la propuesta pasa a executada y aparecen registros de tipo rebalanceamento en GET /registros.

Cambiar la política

Para cambiar la proporción o las reglas de forma permanente, y no solo una vez, use PUT /politica-de-alocacao. La nueva versión se aplica a los depósitos futuros y sus regras generan las próximas propuestas. Los porcentajes deben sumar 100; de lo contrario, la API devuelve 422 con politica_invalida. Cada regla tiene un gatilho (spread_acima o desvio_da_alocacao) y un limite elegido por la empresa. TESA no sugiere umbrales.
Aprobar no mueve fondos. Los fondos se mueven únicamente después de la firma del custodio de la empresa.