Actifs réels

Ce qui existe

La documentation en langage clair décrit trois couches. Exactement une d'entre elles a du code dans ce dépôt, et cette référence documente celle-là.

Donc : il y a des prix, et il y a des contrats qui les détiennent et les servent. Il n'y a pas de moteur de marge, pas de registre de collatéral et pas de contrat de position à appeler. Quand ceux-ci existeront, ils seront documentés ici comme des surfaces d'appel, pas comme des intentions.

Un prix, pas l'actif

C'est un énoncé sur ce que fait la chaîne, pas une clause de non-responsabilité vissée dessus. Rien dans le registre ne référence un émetteur, un dépositaire ou une réserve, parce qu'il n'y en a pas : Pickle n'émet aucun actif réel et n'en détient aucun. Un flux nommé AAPL/USD est un nombre décrivant ce à quoi cette action s'échange sur un marché ailleurs, publié sur cette chaîne et rien de plus.

Obtenir la liste des actifs

Trois façons, et la première est presque toujours la bonne. Elle ne demande ni ABI, ni adresse, ni clé.

# 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 est le point d'accès des paramètres réseau. La réponse porte aussi blockNumber, timestamp, ainsi que le publisher et l'owner que nomme le registre - lisez-les si vous voulez savoir qui aurait pu écrire ce que vous venez de lire.

Les 33 flux

19 des 33 sont des actifs réels. La séparation qui compte à l'usage en est une autre : 13 flux sont adossés à des places au comptant et 20 viennent de Pyth seul - c'est-à-dire tous les flux d'actifs réels plus XMR/USD, la seule paire crypto sans jambe de place.

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

Colonne Marché : toujours ouvert - open every day, all day ; heures du NYSE - 09:30-16:00 New York, Monday to Friday, with the exchange holiday list ; semaine des changes - continuous Monday to Friday afternoon New York, closed Saturday, reopening Sunday evening ; séance avec pause quotidienne - a nearly-continuous session with a daily break and a closed Saturday. Les calendriers font l'objet des heures de marché, et les gérer n'est pas optionnel.

Cinq politiques de publication, pas trente-trois

Le plafond de pas est la ligne la plus souvent mal lue. Il vaut 0, et est donc désactivé, sur chaque flux crypto, et il est actif sur chaque flux d'actif réel - une mise à jour d'actif réel qui bouge plus loin que le plafond en un pas est donc sautée par le contrat plutôt qu'écrite, sauf si le statut de marché a changé dans la même mise à jour. C'est cette exception qui laisse atterrir un écart de week-end.

Ce que porte l'enregistrement d'un flux

Ces mêmes champs sont la configuration du flux on-chain, donc ce que vous lisez de pickle_prices ou de feeds(offset, limit) est cet enregistrement plus le dernier tour. decimals vaut 8 sur chaque flux aujourd'hui et le champ autorise 0 à 18 : lisez-le plutôt que de le supposer, parce que le coût d'une erreur est un prix faux de huit ordres de grandeur.

Les identifiants de flux

Un flux est indexé par un hash de son symbole, pas par un index et pas par une adresse :

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.

Résoudre les adresses

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.