Слой RWA

Что существует

Документация на простом языке описывает три слоя. Ровно у одного из них есть код в этом репозитории, и эта справка описывает именно его.

Итак: есть цены, и есть контракты, которые их держат и отдают. Нет ни маржинального движка, ни реестра обеспечения, ни контракта позиции, который можно было бы вызвать. Когда они появятся, они будут описаны здесь как поверхности вызова, а не как намерения.

Цена, а не актив

Это утверждение о том, что делает сеть, а не оговорка, привинченная к нему сверху. Ничто в реестре не ссылается ни на эмитента, ни на хранителя, ни на резерв, потому что их нет: Pickle не выпускает ни одного реального актива и ни одного не держит. Фид с именем AAPL/USD - это число, описывающее, по какой цене эта акция торгуется на рынке в другом месте, опубликованное в этой сети, и ничего больше.

Получение списка активов

Три способа, и первый почти всегда правильный. Ему не нужны ни ABI, ни адрес, ни ключ.

# Every feed the chain carries, with its adapter, decimals, answer and age.
curl -s $RPC_URL \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"pickle_prices","params":[]}' \
  | jq '.result.feeds[] | {symbol, feedId, adapter, decimals, price, statusName, staleOnchain}'

# The count alone, when you only want to know whether the catalog changed.
curl -s $RPC_URL \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"pickle_prices","params":[]}' \
  | jq '.result.feeds | length'

$RPC_URL - это адрес из параметров сети. Ответ несёт также blockNumber, timestamp, а ещё publisher и owner, которых называет реестр - читайте их, если хотите знать, кто мог написать то, что вы только что прочитали.

33 фида

19 из 33 - реальные активы. Разделение, которое имеет значение на практике, другое: 13 фидов опираются на спотовые площадки, а 20 приходят от одного только Pyth - и это все фиды реальных активов плюс XMR/USD, единственная крипто-пара без ноги площадки.

• 5 площадок + Pyth. five spot venues, with a Pyth feed alongside as a cross-check and a stand-in
• Только Pyth. Pyth only - no venue is listed for this feed, so an absent Pyth credential leaves it unpublished

Колонка Рынок: всегда открыт - open every day, all day; часы NYSE - 09:30-16:00 New York, Monday to Friday, with the exchange holiday list; валютная неделя - continuous Monday to Friday afternoon New York, closed Saturday, reopening Sunday evening; сессия с ежедневным перерывом - a nearly-continuous session with a daily break and a closed Saturday. Расписания - предмет часов работы рынков, и обрабатывать их не опционально.

Пять политик публикации, а не тридцать три

Потолок шага - строка, которую читают неверно чаще всего. Он равен 0, а значит отключён, на каждом крипто-фиде, и работает на каждом фиде реального актива - поэтому обновление реального актива, которое за один шаг уходит дальше потолка, контракт пропускает, а не записывает, если только в том же обновлении не изменился статус рынка. Именно это исключение и позволяет приземлиться разрыву выходных.

Что несёт запись фида

Те же поля составляют конфигурацию фида на цепочке, поэтому то, что вы читаете из pickle_prices или из feeds(offset, limit), - это данная запись плюс последний раунд. decimals сегодня равен 8 на каждом фиде, а поле допускает от 0 до 18: читайте его, а не предполагайте, потому что цена ошибки - цена, промахнувшаяся на восемь порядков величины.

Идентификаторы фидов

Фид индексируется хешем своего символа, а не индексом и не адресом:

bytes32 feedId = keccak256(bytes("ETH/USD"));

The canonical symbol, upper case, with a single slash - keccak256("ETH/USD"), not "ETH-USD" and not "eth/usd". The same 32 bytes key the contract's mappings, name the feed on the RPC, and appear as the indexed topic of every FeedUpdated log. You can compute it offline with any keccak-256 implementation; nothing has to be fetched to know it.

The node and the service both accept ETH/USD, ETH-USD, eth-usd or 0x<64 hex feed id and normalise before looking up, so a URL-safe spelling costs nothing.

Разрешение адресов

The price registry and one adapter per feed are predeploys: their addresses are fixed at genesis and canonical for the life of the chain. That is precisely why this reference resolves them instead of printing them.

• pickle_prices answers with the registry's address in core and each feed's adapter in feeds[].adapter, checksummed. That is the shortest path and it needs no ABI.
• pickle_price(feed) carries that feed's adapter; pickle_ethUsdPrice carries the adapter, the registry and, under contract, the adapter again, which is what a Chainlink reader should be pointed at.
• On chain, adapterOf(feedId) returns the deployed adapter and adapterAddress(feedId) recomputes it: the adapter is CREATE2 from the registry with salt = feedId, so its address is a pure function of the registry address and the symbol.
• The first-party applications resolve every address they use at runtime rather than compiling one in - shared-ui/config.js merges the deployment's address files into config.addresses at load.
• The explorer shows that address as an account, with its code and its activity, which is the human-readable cross-check that something is deployed there. It publishes no source and no ABI: the repository is not public yet, and the explorer verifies no contract.

# The registry and one feed's adapter, resolved from the chain itself.
curl -s $RPC_URL \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"pickle_price","params":["ETH-USD"]}' \
  | jq '{adapter: .result.adapter, feedId: .result.feedId}'

# Then prove the address has code before you call it.
curl -s $RPC_URL \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getCode","params":["<adapter>","latest"]}'

Verify a resolved address with an eth_getCode before your first call. A CALL to an account with no code succeeds and returns nothing, so a wrong address does not revert - it reads as a price of zero.