現実世界資産

何が存在するか

平易な言葉のドキュメントは三つのレイヤーを説明します。このリポジトリにコードがあるのは そのうちちょうど一つで、このリファレンスが記述するのはそれです。

つまり、価格があり、それを保持して提供するコントラクトがあります。証拠金エンジンも、担保の レジストリも、呼べるポジションのコントラクトもありません。それらが存在するようになったら、 意図としてではなく呼び出し可能な面としてここに記述されます。

資産ではなく価格

これはチェーンが何をするかについての記述であり、後から取り付けた免責文ではありません。 レジストリの中に発行体も、保管者も、準備も参照するものはありません。存在しないからです。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 のフィード

33 のうち 19 が現実世界資産です。運用上 効いてくる区分は別のものです。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 です。 スケジュールは市場の取引時間の主題であり、それを 扱うことは任意ではありません。

公開ポリシーは 33 ではなく五つ

最も誤読されやすいのが、値動きの上限の行です。暗号資産のフィードではすべて 0、すなわち無効であり、現実世界のフィードではすべて有効です。したがって 一歩で上限を超えて動く現実世界の更新は、書き込まれるのではなくコントラクトによって飛ばされます。同じ更新で市場の状態が変わった場合を 除いてのことです。その例外が、週末の窓開けを着地させています。

フィードのレコードが運ぶもの

同じフィールドがオンチェーンでのフィードの設定でもあるので、pickle_prices や feeds(offset, limit) から読めるのは、このレコードに最新のラウンドを加えた ものです。decimals は今日どのフィードでも 8 で、フィールド自体は 0 から 18 を 許します。仮定せずに読んでください。間違いの代償は、8 桁ずれた価格だからです。

フィード ID

フィードは、インデックスでもアドレスでもなく、シンボルのハッシュでキーが付きます。

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.