Tokens de acciones de Robinhood Chain: consulta el multiplicador, los titulares y la actividad diaria con una API key

Robinhood Chain admite activos del mundo real tokenizados (RWAs), incluidas acciones estadounidenses y fondos cotizados (ETFs) tokenizados. Mientras que los tokens ERC-20 estándar corresponden a los saldos en una proporción 1:1, las acciones tokenizadas incorporan un multiplicador de operaciones corporativas para reflejar desdoblamientos de acciones y ajustes por dividendos sin cambiar los saldos de las billeteras.

Esta guía explica cómo funciona el multiplicador de los tokens de acciones, cómo convertir los saldos brutos de tokens en cantidades de acciones subyacentes, cómo consultar uiMultiplier en la cadena mediante JSON-RPC eth_call y cómo obtener los titulares diarios y la actividad de transferencias mediante la Data API de BlockVectra.

Consulta los parámetros generales de la red, las políticas de métodos y la configuración de RPC en la guía de Robinhood Chain. Consulta la referencia completa de campos y los modelos de consumo en Compute Units (CU) del conjunto de datos en la guía de acciones tokenizadas.

Qué es el multiplicador de los tokens de acciones

Los tokens de acciones de Robinhood son tokens ERC-20 estándar (con 18 decimales) emitidos por Robinhood Assets (Jersey) Limited (RHJ). Para gestionar operaciones corporativas como desdoblamientos de acciones y dividendos reinvertidos, estos contratos implementan ERC-8056 (Scaled UI Amount Extension).

El multiplicador (uiMultiplier) define la proporción shares-per-token:

• Precisión: uiMultiplier() se representa como un número de punto fijo con 18 decimales, donde 1e18 equivale a 1.0.
• Valor inicial: Al emitir el token, el multiplicador se inicializa en 1e18 (un token representa una acción subyacente).
• Operaciones corporativas: Cuando se produce una operación corporativa (como un desdoblamiento de acciones o un dividendo reinvertido), el contrato del token actualiza uiMultiplier y emite el evento UIMultiplierUpdated(uint256 oldMultiplier, uint256 newMultiplier, uint256 effectiveAtTimestamp).

Saldos de tokens fijos durante los desdoblamientos

Los tokens de acciones no son tokens con reajuste de saldo (rebasing). Durante las operaciones corporativas:

• Los saldos de las billeteras (balanceOf(account)) y la emisión total de tokens (totalSupply()) se mantienen sin cambios.
• Solo cambia el multiplicador de escala.

Por ejemplo, si una acción subyacente realiza un desdoblamiento de 2 por 1:

• Un titular que posee 10 tokens sigue teniendo 10 tokens en balanceOf.
• El contrato actualiza uiMultiplier de 1.0 (1e18) a 2.0 (2e18).
• Cada token representa ahora 2 acciones subyacentes, lo que da al titular una exposición efectiva de 20 acciones.

Conversión de saldos a cantidad de acciones

Para calcular la cantidad de acciones subyacentes representadas por un saldo de tokens, usa la fórmula ERC-8056:

underlying shares = raw token amount × uiMultiplier ÷ 1e18

Los contratos de tokens ERC-8056 también ofrecen funciones auxiliares de solo lectura en la cadena:

• balanceOfUI(address account): Devuelve directamente el saldo de la cuenta expresado en acciones subyacentes (escalado por uiMultiplier, con 18 decimales).
• totalSupplyUI(): Devuelve directamente el suministro total de tokens expresado en acciones subyacentes.

Además, las transferencias de tokens emiten el evento TransferWithScaledUI(address indexed from, address indexed to, uint256 value, uint256 uiValue), que registra tanto la cantidad bruta de tokens como la cantidad escalada de acciones subyacentes.

Multiplicador y fuentes de precios del oráculo

Robinhood Chain despliega una fuente de precios Chainlink dedicada (AggregatorV3Interface) para cada token de acciones:

• La fuente de precios Chainlink (latestRoundData()) ya incorpora el multiplicador. Refleja el precio de mercado completo de un token (precio de la acción subyacente multiplicado por el multiplicador).
• Las aplicaciones que leen el oráculo Chainlink en la cadena reciben directamente el precio ajustado por el multiplicador y no deben aplicarlo una segunda vez.
• También puedes consultar los metadatos fuera de la cadena mediante el endpoint REST de Robinhood GET https://api.robinhood.com/rhj/assets, que proporciona currentMultiplier y pendingMultiplier.

Consulta del multiplicador con JSON-RPC eth_call

Puedes inspeccionar el multiplicador de cualquier acción tokenizada directamente mediante el endpoint JSON-RPC de BlockVectra para Robinhood Chain usando eth_call.

• Función: uiMultiplier()
• Selector de función de 4 bytes: 0xa60bf13d (bytes4(keccak256("uiMultiplier()")))
• Formato de respuesta: uint256 con codificación hexadecimal de 32 bytes (valor de punto fijo con 18 decimales)

BlockVectra sirve las solicitudes JSON-RPC de Robinhood Chain en https://api.blockvectra.com/v1/robinhood_mainnet. Envía tu API key mediante la cabecera x-api-key o añádela a la ruta (https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}).

Ejemplos de código

Los siguientes ejemplos consultan uiMultiplier() en el contrato del token de acciones de Everpure (0x1Cdad396DB64BDa184d5182A97Dd9B3C62100b7D):

curl -s "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_call",
    "params": [
      {
        "to": "0x1Cdad396DB64BDa184d5182A97Dd9B3C62100b7D",
        "data": "0xa60bf13d"
      },
      "latest"
    ]
  }'

Consulta de titulares y actividad diaria con la Data API

La Data API de BlockVectra ofrece resúmenes diarios preindexados de acciones tokenizadas. Usa GET /v1/data/robinhood_mainnet/stocks para la clasificación de actividad diaria y GET /v1/data/robinhood_mainnet/stocks/{token} para los metadatos de un token y hasta 30 días de métricas diarias. Consulta los parámetros de solicitud, los campos de respuesta y los ejemplos en la guía de acciones tokenizadas.

Notas regulatorias

Los tokens de acciones son títulos de deuda tokenizados emitidos por Robinhood Assets (Jersey) Limited (RHJ). Consulta los folletos, las condiciones finales y los avisos jurisdiccionales en la documentación de Robinhood RHJ.

Próximos pasos

• Explora el directorio de conjuntos de datos para ver todos los conjuntos de datos que indexa BlockVectra.
• Consulta el Plan gratuito y los precios para comprobar qué incluye tu cuenta.
• Inicia sesión en la consola para crear una API key.