Protocolo
Referencia de contratos y estados
Definiciones detalladas de estados, reglas de firma y funciones públicas de la API.
Comprar una acción y mantener un índice son productos distintos
Difieren en lo que posees, quién lo custodia y cómo sales. La interfaz nunca confunde ambos.
| Diferencia | Comprar directamentetoken en tu billetera | Mantener un índiceparticipaciones de bóveda |
|---|---|---|
| Qué posees | El propio token bStock, en su dirección de contrato. | Participaciones ERC-20 de una bóveda que posee la cesta. |
| Custodia | Tu billetera. Tras el intercambio, nuestro sistema no toca el activo. | Un contrato sin custodia de terceros. Ninguna billetera de la plataforma guarda activos de usuarios. |
| Cómo sales | Lo vendes mediante la misma ruta cuando haya una disponible. | Canjeas proporcionalmente en especie: recibes los tokens subyacentes, no efectivo. |
| Restricciones del emisor | Te afectan directamente. Una congelación impide la transferencia. | Se aplican a cada componente. Uno restringido revierte todo el canje. |
| Precio de referencia para operar | Una cotización ejecutable con plazo y salida mínima. | Una vista previa en bloque fijo. No promete ejecución. |
| Rebalanceo | Lo realizas tú. No mantenemos una posición ni enviamos instrucciones. | Solo mediante una configuración revisada, bajo gobernanza y dentro de límites fijos. |
| Cuándo elegirlo | Quieres un solo activo y tener el token directamente. | Quieres exposición a un tema en una posición, con los pesos comprobados por el contrato. |
Qué comparten ambas opciones
El activo se identifica por cadena y dirección, nunca por símbolo. Lo admite la misma cadena de pruebas. El emisor puede congelar o restringir cualquiera de las vías y ninguna promete poder salir.
Qué está disponible hoy
La ejecución depende de la vía: las participaciones de índice necesitan las funciones actuales y específicas de cadena de una bóveda registrada; la compra directa necesita una ruta ejecutable y profundidad medida. Direcciones configuradas, pruebas técnicas y permiso de producción son cosas separadas.
Estado de verificación
Procedencia de la fuente y del código. No indica si el activo se puede utilizar.
| Estado técnico de prueba · DISCOVERED | Importado como candidato desde una fuente archivada. Aún no se ha confirmado nada. |
| Estado técnico de prueba · SOURCE_REVIEW | El documento del emisor está en revisión. |
| Estado técnico de prueba · ONCHAIN_VERIFIED | Se registraron pruebas de funciones onchain en un bloque fijo. |
| Estado técnico de prueba · VERIFIED | La fuente y las pruebas onchain fueron revisadas y aprobadas de forma independiente. |
| Estado técnico de prueba · REVOKED | Se retiró una aprobación anterior. Trata este activo como no verificado. |
Permiso de operación
Indica si se puede usar un activo y en qué dirección. Se decide de forma independiente de la verificación.
| Solo consulta | Solo puede mostrarse. No permite nueva exposición ni uso en fondos. |
| Activo | Se permite operar según las reglas actuales del registro. |
| Solo salida | No permite nueva exposición. Se puede salir de la existente. |
| Pausado | También se prohíben las salidas afectadas. Las operaciones pueden fallar. |
| Revocado | Estado terminal. No permite nueva exposición; solo se puede salir si el propio token todavía permite transferencias. |
Por qué se separan ambos estados
Un activo con la fuente completamente verificada puede ser solo de consulta, y un activo antes habilitado puede pausarse sin que cambien sus pruebas. Unificarlos en una etiqueta ocultaría la diferencia entre «hemos comprobado el documento del emisor» y «puedes usarlo para crear un fondo».
Estado de las funciones
La API responde 503 CAPABILITY_UNAVAILABLE cuando una función no está implementada. La interfaz la muestra como no disponible; nunca la sustituye por una lista vacía, un saldo cero o una transacción completada.
| Función | Estado |
|---|---|
| Directorio del registro de activos | Implementada |
| Procedencia de la verificación del activo | Implementada |
| Fuentes oficiales archivadas | Implementada |
| Funciones del token en un bloque fijo | Implementada |
| Publicación de precios de referencia | ImplementadaRequiere una fuente de precios con licencia; responde 503 hasta disponer de ella |
| Comprobación pública de direcciones | Implementada |
| Inicio de sesión con billetera | Implementada |
| Sesión y roles | Implementada |
| Reto de escritura de negocio | Implementada |
| Búsqueda de estrategias publicadas | Implementada |
| Borradores de estrategias | Implementada |
| Publicación de estrategias | Implementada |
| Enlace compartido de solo lectura | Implementada |
| Comprobación determinista de datos | ImplementadaRequiere una fuente de precios con licencia; responde 503 hasta disponer de ella |
| Prueba retrospectiva | ImplementadaRequiere una fuente de precios con licencia; responde 503 hasta disponer de ella |
| Lista personal de seguimiento | Implementada |
| Funciones de cadena y despliegue del entorno | Implementada |
| Vista previa canónica en especie de la red de pruebas | ImplementadaRequiere una dirección de contrato desplegado |
| Directorio de fondos registrados | Implementada |
| Activos del fondo en un bloque fijo | ImplementadaRequiere una instantánea canónica en bloque fijo; responde 503 hasta disponer de ella |
| NAV de referencia | ImplementadaRequiere una fuente de precios con licencia; responde 503 hasta disponer de ella |
| Historial disperso de NAV | ImplementadaRequiere una fuente de precios con licencia; responde 503 hasta disponer de ella |
| Actividad del fondo | ImplementadaRequiere una instantánea canónica en bloque fijo; responde 503 hasta disponer de ella |
| Posiciones de la billetera | ImplementadaRequiere una instantánea canónica en bloque fijo; responde 503 hasta disponer de ella |
| Actividad de la billetera | ImplementadaRequiere una instantánea canónica en bloque fijo; responde 503 hasta disponer de ella |
| Intenciones de transacción | Implementada |
| Cola de revisión de activos | Implementada |
| Revisión de la fuente del activo | Implementada |
| Activación del activo | Implementada |
| Solicitudes restringidas de fondos | Implementada |
| Registro de gobernanza del fondo | Implementada |
| Cotización de cesta heredada | No incluida en el contrato de APINo declarada en el contrato de API; responde 503 |
| Cotización de compra de cesta | ImplementadaRequiere un proveedor de rutas aprobado; responde 503 por defecto y un resultado satisfactorio es solo una simulación |
| Cotización de venta de cesta | ImplementadaRequiere un proveedor de rutas aprobado; responde 503 por defecto y un resultado satisfactorio es solo una simulación |
| Cotización de depósito en bóveda | ImplementadaRequiere un proveedor de rutas aprobado; responde 503 por defecto y un resultado satisfactorio es solo una simulación |
| Cotización de canje de bóveda | ImplementadaRequiere un proveedor de rutas aprobado; responde 503 por defecto y un resultado satisfactorio es solo una simulación |
Cómo se autoriza una escritura de negocio
La sesión de inicio identifica quién eres, pero no autoriza cambios. Cada escritura serializa el cuerpo una sola vez, calcula SHA-256 sobre esos bytes exactos, solicita al servidor un reto de un solo uso vinculado al método, la ruta y el hash, pide a la billetera que firme el mensaje exacto del servidor y envía los mismos bytes con el nonce y la firma. Cambiar un byte, la ruta o el método invalida la firma.
Un nonce que ya tuvo éxito no puede reutilizarse, y la interfaz nunca vuelve a crear el mismo registro de forma silenciosa. Si se pierde una respuesta, se consulta el resultado por nonce antes de reintentar.
Qué significa iniciar sesión con la billetera
El inicio de sesión prueba que controlas una dirección mediante un mensaje generado por el servidor. Autoriza llamadas a la API durante ocho horas. Nunca autoriza transferencias de tokens, asignaciones de gasto ni operaciones de fondos, ni concede roles de revisor o gobernador.
Cómo se tratan las cantidades
Las cantidades de token sin ajustar son enteros, transmitidos como BigInt o cadenas decimales exactas. La interfaz no realiza operaciones de coma flotante sobre cantidades ni aplica multiplicadores hasta que el contrato publique su escala.
Riesgos y límites
- La producción en la red principal sigue desactivada. Los despliegues de prueba y los activos sintéticos no satisfacen las condiciones de lanzamiento de producción.
- No se publican una fuente de precios, NAV de referencia ni cotización ejecutable. Una vista previa nunca promete una cotización.
- Los registros importados desde los datos iniciales son candidatos. Un candidato no está verificado ni se puede negociar.
- Los emisores de acciones tokenizadas pueden restringir transferencias. Esta interfaz no garantiza poder salir de un token restringido.