Activos del mundo real

Qué existe

La documentación en lenguaje claro describe tres capas. Exactamente una de ellas tiene código en este repositorio, y esta referencia documenta esa.

Así que: hay precios, y hay contratos que los guardan y los sirven. No hay motor de margen, ni registro de colateral, ni contrato de posición al que llamar. Cuando existan, se documentarán aquí como superficies de llamada, no como intenciones.

Un precio, no el activo

Esto es una afirmación sobre lo que hace la cadena, no una cláusula de descargo atornillada encima. Nada en el registro referencia a un emisor, un custodio o una reserva, porque no hay ninguno: Pickle no emite ningún activo del mundo real y no tiene ninguno. Un feed llamado AAPL/USD es un número que describe a cuánto se negocia esa acción en un mercado de otro lugar, publicado en esta cadena y nada más.

Obtener la lista de activos

Tres vías, y la primera es casi siempre la correcta. No necesita ABI, ni dirección, ni clave.

# 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 es el punto de acceso de los parámetros de red. La respuesta lleva también blockNumber, timestamp, y el publisher y el owner que nombra el registro - léalos si quiere saber quién pudo haber escrito lo que acaba de leer.

Los 33 feeds

19 de los 33 son activos del mundo real. La separación que cuenta en la práctica es otra: 13 feeds se respaldan en mercados spot y 20 vienen solo de Pyth - es decir, todos los feeds del mundo real más XMR/USD, el único par cripto sin pata de mercado.

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

Columna Mercado: siempre abierto - open every day, all day; horario del NYSE - 09:30-16:00 New York, Monday to Friday, with the exchange holiday list; semana de divisas - continuous Monday to Friday afternoon New York, closed Saturday, reopening Sunday evening; sesión con pausa diaria - a nearly-continuous session with a daily break and a closed Saturday. Los calendarios son el asunto de los horarios de mercado, y atenderlos no es opcional.

Cinco políticas de publicación, no treinta y tres

El tope de salto es la fila que más se malinterpreta. Vale 0, y por tanto está desactivado, en todos los feeds cripto, y está activo en todos los feeds del mundo real - así que una actualización del mundo real que se mueva más allá del tope en un solo salto la omite el contrato en lugar de escribirla, salvo que el estado de mercado haya cambiado en esa misma actualización. Esa excepción es lo que deja aterrizar un hueco de fin de semana.

Qué lleva la ficha de un feed

Esos mismos campos son la configuración del feed en cadena, así que lo que lee de pickle_prices o de feeds(offset, limit) es esa ficha más la última ronda. decimals vale 8 en todos los feeds hoy y el campo admite de 0 a 18: léalo en lugar de suponerlo, porque el coste de equivocarse es un precio errado en ocho órdenes de magnitud.

Los identificadores de feed

Un feed se indexa por un hash de su símbolo, no por un índice y no por una dirección:

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 las direcciones

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.