Токени акцій Robinhood Chain: читання мультиплікатора, власників та щоденної активності з одним API key

Robinhood Chain підтримує токенізовані реальні активи (RWA), включно з токенізованими акціями компаній США та біржовими інвестиційними фондами (ETF). Хоча стандартні токени ERC-20 відображають баланси 1:1, токенізовані акції впроваджують мультиплікатор корпоративних дій, щоб враховувати спліти акцій та коригування дивідендів без зміни балансів у гаманцях.

Цей посібник пояснює, як працює мультиплікатор токенів акцій, як конвертувати необроблені баланси токенів у кількість базових акцій, як запитувати uiMultiplier ончейн за допомогою JSON-RPC eth_call, а також як отримувати дані про щоденних власників та активність переказів через BlockVectra Data API.

Загальні параметри мережі, політики методів та налаштування RPC дивіться у посібнику з Robinhood Chain. Вичерпний опис полів та моделі використання Compute Unit (CU) для цього набору даних наведено в посібнику з токенізованих акцій.

Що являє собою мультиплікатор токенів акцій

Токени акцій Robinhood — це стандартні токени ERC-20 (із 18 десятковими знаками), випущені Robinhood Assets (Jersey) Limited (RHJ). Для обробки корпоративних дій, таких як спліти акцій та реінвестовані дивіденди, ці контракти реалізують ERC-8056 (Scaled UI Amount Extension).

Мультиплікатор (uiMultiplier) визначає співвідношення shares-per-token:

• Точність: uiMultiplier() представлений як число з фіксованою комою з 18 десятковими знаками, де 1e18 дорівнює 1.0.
• Початкове значення: під час випуску токена мультиплікатор ініціалізується значенням 1e18 (один токен представляє одну базову акцію).
• Корпоративні дії: коли відбувається корпоративна подія (наприклад, прямий спліт акцій або реінвестування дивідендів), контракт токена оновлює uiMultiplier і генерує подію UIMultiplierUpdated(uint256 oldMultiplier, uint256 newMultiplier, uint256 effectiveAtTimestamp).

Фіксовані баланси токенів під час сплітів

Токени акцій не є токенами з ребейсингом (rebasing tokens). Під час корпоративних дій:

• Баланси гаманців (balanceOf(account)) та загальна емісія токенів (totalSupply()) залишаються незмінними.
• Змінюється лише мультиплікатор масштабування.

Наприклад, якщо для базової акції проводиться прямий спліт 2-до-1:

• Власник, який володіє 10 токенами, продовжує мати 10 токенів у balanceOf.
• Контракт оновлює uiMultiplier з 1.0 (1e18) до 2.0 (2e18).
• Тепер кожен токен представляє 2 базові акції, забезпечуючи власнику фактичну експозицію у 20 акцій.

Конвертація балансів у кількість акцій

Щоб обчислити кількість базових акцій, представлених балансом токенів, використовуйте формулу ERC-8056:

underlying shares = raw token amount × uiMultiplier ÷ 1e18

Контракти токенів ERC-8056 також надають допоміжні функції ончейн лише для читання:

• balanceOfUI(address account): безпосередньо повертає баланс акаунта, виражений у базових акціях (масштабований на uiMultiplier, 18 десяткових знаків).
• totalSupplyUI(): безпосередньо повертає загальну пропозицію токенів, виражену в базових акціях.

Крім того, перекази токенів генерують подію TransferWithScaledUI(address indexed from, address indexed to, uint256 value, uint256 uiValue), фіксуючи як необроблену суму токенів, так і масштабовану кількість базових акцій.

Мультиплікатор та оракульні цінові потоки

Robinhood Chain розгортає виділений ціновий потік Chainlink (AggregatorV3Interface) для кожного токена акцій:

• Ціновий потік Chainlink (latestRoundData()) вже враховує мультиплікатор. Він відображає повну ринкову ціну одного токена (ціна базової акції, помножена на мультиплікатор).
• Застосунки, що читають ончейн-оракул Chainlink, отримують ціну, скориговану на мультиплікатор, безпосередньо і не повинні застосовувати мультиплікатор повторно.
• Офчейн-метадані також можна перевірити через REST-ендпоінт Robinhood GET https://api.robinhood.com/rhj/assets, який надає currentMultiplier та pendingMultiplier.

Читання мультиплікатора за допомогою JSON-RPC eth_call

Ви можете перевірити мультиплікатор будь-якої токенізованої акції безпосередньо через JSON-RPC ендпоінт BlockVectra для Robinhood Chain за допомогою eth_call.

• Функція: uiMultiplier()
• 4-байтний селектор функції: 0xa60bf13d (bytes4(keccak256("uiMultiplier()")))
• Формат повернення: 32-байтне шістнадцяткове значення uint256 (число з фіксованою комою з 18 десятковими знаками)

BlockVectra обслуговує JSON-RPC запити до Robinhood Chain за адресою https://api.blockvectra.com/v1/robinhood_mainnet. Передавайте ваш API key через заголовок x-api-key або додайте його до шляху (https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}).

Приклади коду

У наведених нижче прикладах виконується запит uiMultiplier() до контракту токена акцій 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"
    ]
  }'

Запит власників та щоденної активності через Data API

BlockVectra Data API надає попередньо індексовані щоденні зведення для токенізованих акцій. Використовуйте GET /v1/data/robinhood_mainnet/stocks для таблиці лідерів щоденної активності та GET /v1/data/robinhood_mainnet/stocks/{token} для метаданих одного токена та до 30 днів щоденних показників. Параметри запитів, поля відповідей та приклади дивіться у посібнику з токенізованих акцій.

Нормативні примітки

Токени акцій є токенізованими борговими цінними паперами, випущеними Robinhood Assets (Jersey) Limited (RHJ). Дивіться документацію Robinhood RHJ для ознайомлення з проспектами емісії, остаточними умовами та юрисдикційними повідомленнями.

Наступні кроки

• Перегляньте каталог наборів даних, щоб ознайомитися з усіма наборами даних, які індексує BlockVectra.
• Перегляньте безкоштовний план і ціни, щоб дізнатися, що включено у ваш акаунт.
• Увійдіть до консолі, щоб створити API key.