Ativos do mundo real

O que existe

A documentação em linguagem clara descreve três camadas. Exatamente uma delas tem código neste repositório, e esta referência documenta essa.

Então: há preços, e há contratos que os guardam e os servem. Não há motor de margem, não há registro de garantias e não há contrato de posição a chamar. Quando esses existirem, serão documentados aqui como superfícies de chamada, não como intenções.

Um preço, não o ativo

Isto é uma afirmação sobre o que a cadeia faz, não uma cláusula de isenção aparafusada nela. Nada no registro referencia um emissor, um custodiante ou uma reserva, porque não há nenhum: a Pickle não emite nenhum ativo do mundo real e não detém nenhum. Um feed chamado AAPL/USD é um número que descreve a que preço essa ação é negociada num mercado em outro lugar, publicado nesta cadeia e nada mais.

Obter a lista de ativos

Três maneiras, e a primeira é quase sempre a certa. Ela não pede ABI, nem endereço, nem chave.

# 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 é o endpoint dos parâmetros de rede. A resposta também carrega blockNumber, timestamp, e o publisher e o owner que o registro nomeia - leia-os se quiser saber quem poderia ter escrito o que você acabou de ler.

Os 33 feeds

19 dos 33 são ativos do mundo real. A separação que conta na prática é outra: 13 feeds são lastreados por mercados à vista e 20 vêm somente da Pyth - ou seja, todos os feeds do mundo real mais XMR/USD, o único par cripto sem perna de mercado.

• 5 mercados + Pyth. five spot venues, with a Pyth feed alongside as a cross-check and a stand-in
• Somente Pyth. Pyth only - no venue is listed for this feed, so an absent Pyth credential leaves it unpublished

Coluna Mercado: sempre aberto - open every day, all day; horário da NYSE - 09:30-16:00 New York, Monday to Friday, with the exchange holiday list; semana do câmbio - continuous Monday to Friday afternoon New York, closed Saturday, reopening Sunday evening; sessão com pausa diária - a nearly-continuous session with a daily break and a closed Saturday. Os calendários são o assunto de Horários de mercado, e tratá-los não é opcional.

Cinco políticas de publicação, não trinta e três

O teto de passo é a linha mais frequentemente mal lida. Ele vale 0, e portanto está desativado, em todo feed cripto, e está ativo em todo feed do mundo real - então uma atualização do mundo real que se move além do teto num só passo é pulada pelo contrato em vez de escrita, a menos que o status de mercado tenha mudado na mesma atualização. É essa exceção que deixa aterrissar um salto de fim de semana.

O que o registro de um feed carrega

Esses mesmos campos são a configuração do feed on-chain, então o que você lê de pickle_prices ou de feeds(offset, limit) é esse registro mais a última rodada. decimals vale 8 em todo feed hoje e o campo permite de 0 a 18: leia-o em vez de supô-lo, porque o custo de errar é um preço errado por oito ordens de grandeza.

Identificadores de feed

Um feed é indexado por um hash do seu símbolo, não por um índice e não por um endereço:

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.

Resolver os endereços

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.