Chainlink on Solana
A Chainlink feed publishes its price in rounds. Each round carries an answer and the time Chainlink’s oracle
network observed the price, and a feed starts a new round when the price has moved past its deviation threshold or
when its heartbeat passes without one. On Solana every feed is an account in Chainlink’s store program,
HEvSKofvBgfaexv23kMabbYqxasxU3mQ4ibBMEmJWHny, and the account holds only the feed’s
latest round.
Rounds as readings
Section titled “Rounds as readings”Since a feed keeps no history, each Chainlink market keeps its own: a round log of the last 8 rounds
copied into it. capture_round, which anyone can send, copies the feed’s latest round into the log, with its id, its
observation time and its answer as a tick. Sagitta’s keeper captures every new round on every Chainlink market that has
a ticket waiting.
- Each copied round is a reading, applied once and in order. A rise of 0.5% then a fall of 0.5% pays twice, however late the market is brought up to date.
- Rounds nobody copied merge. Round ids rise by one per round, so a gap shows. Rounds that landed while no ticket waited, and were never copied, fold into the next copied round’s move, paid as one move.
- A full log waits. A log holding 8 rounds the market hasn’t applied takes no more until an execute applies them.
Some rounds are consumed without effect: they pay nothing and fill nothing, and the next valid round pays the whole move since the last one.
| Round | Why it is skipped |
|---|---|
| Invalid | A zero or negative answer, or one too large to price |
| Held | The same answer as the last applied round: a held value carries no new price |
| Older | Observed no later than the last applied round |
A round whose own move is a factor of 1.2214 or more, up or down (about +22.1% or −18.1%), is a step: it counts as a reading and fills the tickets waiting on it, but pays nothing between the pots. The market just carries on from the new level. A move carried by a round after uncopied ones is their merged move, and pays as one move.
Which round fills a ticket
Section titled “Which round fills a ticket”A ticket fills at the first reading after its commit: the first round that landed after the commit and that Chainlink observed more than 60 seconds after it (see Delayed NAV).
- Rounds after the commit. A commit records the feed’s latest round id. A round at or before it was already on the feed when the ticket was placed: it pays its move but fills nothing.
- Observation time. The market goes by when Chainlink observed the price, so a round still on its way when you commit can’t fill your ticket at its older price.
- A minute’s margin. A round observed within 60 seconds of your commit can’t fill it either.
- A skipped round refunds. If a round that landed after the commit, and could have been the ticket’s own, was never copied before a later one was, the ticket is refunded rather than filled at a later round.
A round is published by Chainlink’s oracle network from its own sources, so trading on Sagitta never moves a Chainlink market.
A retiring market
Section titled “A retiring market”When a Chainlink market is retired, its freeze reading is a round after the retirement. Sagitta’s keeper copies every new round of a retiring market, tickets or not, until it freezes, so the market freezes at its own round.
The feeds on Solana
Section titled “The feeds on Solana”- Chainlink publishes 13 push feeds on Solana, and every one lists. See Chainlink markets, which lists every one with its settings.
- There are no Chainlink stock feeds on Solana. Stocks are priced from their own tokens (see Stock tokens).
- Each market reads its feed’s account directly, never through another program, and records which program owned it at listing. A feed account that stops reading as the store’s records no round: the market’s tickets wait, and it freezes for silence once the oldest has had no reading for 7 days, with every exit open.
No uptime feed
Section titled “No uptime feed”On some networks Chainlink also publishes a feed that says whether the network is up, so programs can distrust prices around an outage. Sagitta needs none. A ticket fills by when Chainlink observed a price, never by when the round landed, so a round delayed by an outage fills nothing it couldn’t have filled on time. A feed that stops updating, for any reason, leaves its tickets waiting; if the oldest still has no reading 7 days after its commit, the market freezes at its last price and every holder cashes out there (see Refunds).