Skip to content

Commit 326db32

Browse files
committed
move guidance out of ondo page, generic for any asset issuer
1 parent 4bf3b8e commit 326db32

3 files changed

Lines changed: 40 additions & 36 deletions

File tree

src/content/data-feeds/llms-full.txt

Lines changed: 20 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -6838,6 +6838,24 @@ These actions are usually announced outside regular trading hours. The feed will
68386838
- Consider pausing markets during corporate action windows
68396839
- Implement maximum price change limits with manual review for extreme moves
68406840

6841+
#### Pause confirmation for corporate actions
6842+
6843+
*This section contains information for asset issuers that provide Chainlink with pause state for tokenized equity feeds.*
6844+
6845+
Some asset issuers use pause-based workflows for large corporate actions such as stock splits or reverse splits. In these workflows, **the feed freezes at the last known good token value during the pause window**. Before signaling that the feed can be unpaused, the asset issuer should verify that the post-corporate-action equity price and the new issuer multiplier are aligned so the next published token value remains continuous.
6846+
6847+
The underlying equity leg for this check should be the same Data Streams 24/5 US equity input that the feed uses for tokenized equity feed calculation. See the official list of the [24/5 equity streams](/data-streams/rwa-streams?show24x5=true\&page=1), and [learn more about how market data is sourced for tokenized equity feed calculation](/data-feeds/tokenized-equity-feeds#how-is-market-data-sourced-for-tokenized-equity-feed-calculation).
6848+
6849+
For each tokenized equity feed, use the stream and time segment configured for that product (the value the feed pipeline would read as the stock leg for the current window), *not* an ad hoc quote from a different venue.
6850+
6851+
1. Take the new multiplier that is staged for go-live after the corporate action.
6852+
2. Read the current equity market price from that same Data Streams 24/5 input, for the appropriate session (regular, pre-market, post-market, or overnight), the same way the feed prices that window.
6853+
3. Multiply: `new multiplier` × that current equity price. That product is the implied token value the feed would publish if it unpaused *now*.
6854+
4. Compare that implied value to the token price at freeze: the last good, frozen feed value from when the pause took effect. They should match, or be treated as aligned only within the asset issuer's defined tolerance, because correct coordination means the post-corporate-action stock price and the new multiplier should combine to the same onchain token price as at the freeze, preserving continuity.
6855+
6856+
- **If that equality holds** within the asset issuer's tolerance, the issuer can signal that the feed is ready to unpause according to the applicable release process and any other release gates.
6857+
- **If it does not hold**, the equity input and the new multiplier are not yet consistent with each other after the corporate action, so unpausing the feed would jump or misstate the level for integrators. The feed should remain paused until the stock leg, multiplier, or both are reconciled and the check passes.
6858+
68416859
### Market closures and halts not explicitly flagged
68426860

68436861
Tokenized equity feeds do not explicitly flag:
@@ -6966,30 +6984,14 @@ This pause mechanism ensures price continuity during corporate actions. For exam
69666984
The token price remains continuous at $200 throughout the event, even though the underlying equity market price dropped from $200 to $20.
69676985

69686986
<Aside type="note">
6969-
When the `SyntheticSharesOracle` contract returns `paused = true`, the Ondo Finance Global Markets (GM) feed freezes at the last known good
6987+
When the `SyntheticSharesOracle` contract returns `paused = true`, the Chainlink feed freezes at the last known good
69706988
price. Integrators should be aware that during pause windows:
69716989

69726990
- The feed will not update until manually unpaused
69736991
- The pause duration depends on when Ondo confirms the corporate action has been correctly applied
69746992
- A minimum pause duration (at least 10 minutes) is enforced to prevent premature unpausing
69756993
</Aside>
69766994

6977-
### Verification before unpausing
6978-
6979-
Before an Ondo Finance Global Markets (GM) feed is unpaused after a large corporate action, Ondo verifies that the post-corporate-action equity price and staged `sValue` are aligned so the next published value remains continuous.
6980-
6981-
**Where the equity price comes from:** the underlying equity leg is the same Data Streams 24/5 US equity input the DON already uses in the [Total Return Value](#total-return-value-calculation) formula. See the official list of the [24/5 equity streams](/data-streams/rwa-streams?show24x5=true\&page=1), and [learn more about how market data is sourced for tokenized equity feed calculation](/data-feeds/tokenized-equity-feeds#how-is-market-data-sourced-for-tokenized-equity-feed-calculation).
6982-
6983-
For each Ondo Finance Global Markets (GM) tokenized equity feed, this check uses the stream and time segment configured for that product (the value the feed pipeline would read as the stock leg for the current window), *not* an ad hoc quote from a different venue.
6984-
6985-
1. Take the new `sValue` that is staged for go-live (the post–corporate-action multiplier).
6986-
2. Read the current equity market price from that same Data Streams 24/5 input, for the appropriate session (regular, pre-market, post-market, or overnight), the same way the feed prices that window.
6987-
3. Multiply: `new sValue` × that current equity price. That product is the implied token (total return) value the feed would publish if it unpaused *now*.
6988-
4. Compare that implied value to the **token price at freeze** (the last good, frozen feed value from when the pause took effect). They should match, or be treated as aligned only within whatever tolerance Ondo defines, because correct coordination means the post–corporate-action stock price and the new `sValue` should combine to the same onchain token price as at the freeze, preserving continuity.
6989-
6990-
- **If that equality holds** (within Ondo's tolerance), the feed can be unpaused according to the applicable release process and any other release gates.
6991-
- **If it does not hold**, the equity input and the new `sValue` are not yet consistent with each other after the corporate action, so unpausing the feed would jump or misstate the level for integrators. The feed remains paused until the stock leg, `sValue`, or both are reconciled and the check passes.
6992-
69936995
## Example scenarios
69946996

69956997
**Normal operation**
@@ -7032,7 +7034,7 @@ This fail-safe behavior prevents incorrect token prices from being published whe
70327034

70337035
Primary mint and redeem for Ondo Finance Global Markets (GM) tokenized equities can be permissioned, but once the tokens are onchain, anyone can hold them and anyone can liquidate positions that use the feed.
70347036

7035-
Ondo Finance Global Markets (GM) feeds have [SVR](/data-feeds/svr-feeds) enabled even when the primary market is not public to all participants. The liquidator set includes teams that can also access primary mint and redeem when they need to. Permissioned mint and redeem concerns the primary market; tokens can still circulate onchain and positions that use the feed can still be liquidated outside that path.
7037+
Most Ondo Finance Global Markets (GM) feeds have [SVR](/data-feeds/svr-feeds) enabled even when the primary market is not public to all participants. The liquidator set includes teams that can also access primary mint and redeem when they need to. Permissioned mint and redeem concerns the primary market; tokens can still circulate onchain and positions that use the feed can still be liquidated outside that path.
70367038

70377039
For Oracle Extractable Value (OEV) and how SVR relates to standard feeds, use [SVR Feeds](/data-feeds/svr-feeds)—especially [Understanding MEV and OEV](/data-feeds/svr-feeds#understanding-mev-and-oev). To read answers from contracts, follow [Using Data Feeds](/data-feeds/using-data-feeds) and point at the SVR-enabled proxy address for your feed.
70387040

src/content/data-feeds/tokenized-equity-feeds/index.mdx

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -241,6 +241,24 @@ These actions are usually announced outside regular trading hours. The feed will
241241
- Consider pausing markets during corporate action windows
242242
- Implement maximum price change limits with manual review for extreme moves
243243

244+
#### Pause confirmation for corporate actions
245+
246+
_This section contains information for asset issuers that provide Chainlink with pause state for tokenized equity feeds._
247+
248+
Some asset issuers use pause-based workflows for large corporate actions such as stock splits or reverse splits. In these workflows, **the feed freezes at the last known good token value during the pause window**. Before signaling that the feed can be unpaused, the asset issuer should verify that the post-corporate-action equity price and the new issuer multiplier are aligned so the next published token value remains continuous.
249+
250+
The underlying equity leg for this check should be the same Data Streams 24/5 US equity input that the feed uses for tokenized equity feed calculation. See the official list of the [24/5 equity streams](/data-streams/rwa-streams?show24x5=true&page=1), and [learn more about how market data is sourced for tokenized equity feed calculation](/data-feeds/tokenized-equity-feeds#how-is-market-data-sourced-for-tokenized-equity-feed-calculation).
251+
252+
For each tokenized equity feed, use the stream and time segment configured for that product (the value the feed pipeline would read as the stock leg for the current window), _not_ an ad hoc quote from a different venue.
253+
254+
1. Take the new multiplier that is staged for go-live after the corporate action.
255+
1. Read the current equity market price from that same Data Streams 24/5 input, for the appropriate session (regular, pre-market, post-market, or overnight), the same way the feed prices that window.
256+
1. Multiply: `new multiplier` × that current equity price. That product is the implied token value the feed would publish if it unpaused _now_.
257+
1. Compare that implied value to the token price at freeze: the last good, frozen feed value from when the pause took effect. They should match, or be treated as aligned only within the asset issuer's defined tolerance, because correct coordination means the post-corporate-action stock price and the new multiplier should combine to the same onchain token price as at the freeze, preserving continuity.
258+
259+
- **If that equality holds** within the asset issuer's tolerance, the issuer can signal that the feed is ready to unpause according to the applicable release process and any other release gates.
260+
- **If it does not hold**, the equity input and the new multiplier are not yet consistent with each other after the corporate action, so unpausing the feed would jump or misstate the level for integrators. The feed should remain paused until the stock leg, multiplier, or both are reconciled and the check passes.
261+
244262
### Market closures and halts not explicitly flagged
245263

246264
Tokenized equity feeds do not explicitly flag:

src/content/data-feeds/tokenized-equity-feeds/ondo.mdx

Lines changed: 2 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ This pause mechanism ensures price continuity during corporate actions. For exam
101101
The token price remains continuous at $200 throughout the event, even though the underlying equity market price dropped from $200 to $20.
102102

103103
<Aside type="note">
104-
When the `SyntheticSharesOracle` contract returns `paused = true`, the Ondo Finance Global Markets (GM) feed freezes at the last known good
104+
When the `SyntheticSharesOracle` contract returns `paused = true`, the Chainlink feed freezes at the last known good
105105
price. Integrators should be aware that during pause windows:
106106

107107
- The feed will not update until manually unpaused
@@ -110,22 +110,6 @@ The token price remains continuous at $200 throughout the event, even though the
110110

111111
</Aside>
112112

113-
### Verification before unpausing
114-
115-
Before an Ondo Finance Global Markets (GM) feed is unpaused after a large corporate action, Ondo verifies that the post-corporate-action equity price and staged `sValue` are aligned so the next published value remains continuous.
116-
117-
**Where the equity price comes from:** the underlying equity leg is the same Data Streams 24/5 US equity input the DON already uses in the [Total Return Value](#total-return-value-calculation) formula. See the official list of the [24/5 equity streams](/data-streams/rwa-streams?show24x5=true&page=1), and [learn more about how market data is sourced for tokenized equity feed calculation](/data-feeds/tokenized-equity-feeds#how-is-market-data-sourced-for-tokenized-equity-feed-calculation).
118-
119-
For each Ondo Finance Global Markets (GM) tokenized equity feed, this check uses the stream and time segment configured for that product (the value the feed pipeline would read as the stock leg for the current window), _not_ an ad hoc quote from a different venue.
120-
121-
1. Take the new `sValue` that is staged for go-live (the post–corporate-action multiplier).
122-
1. Read the current equity market price from that same Data Streams 24/5 input, for the appropriate session (regular, pre-market, post-market, or overnight), the same way the feed prices that window.
123-
1. Multiply: `new sValue` × that current equity price. That product is the implied token (total return) value the feed would publish if it unpaused _now_.
124-
1. Compare that implied value to the **token price at freeze** (the last good, frozen feed value from when the pause took effect). They should match, or be treated as aligned only within whatever tolerance Ondo defines, because correct coordination means the post–corporate-action stock price and the new `sValue` should combine to the same onchain token price as at the freeze, preserving continuity.
125-
126-
- **If that equality holds** (within Ondo's tolerance), the feed can be unpaused according to the applicable release process and any other release gates.
127-
- **If it does not hold**, the equity input and the new `sValue` are not yet consistent with each other after the corporate action, so unpausing the feed would jump or misstate the level for integrators. The feed remains paused until the stock leg, `sValue`, or both are reconciled and the check passes.
128-
129113
## Example scenarios
130114

131115
**Normal operation**
@@ -168,6 +152,6 @@ This fail-safe behavior prevents incorrect token prices from being published whe
168152

169153
Primary mint and redeem for Ondo Finance Global Markets (GM) tokenized equities can be permissioned, but once the tokens are onchain, anyone can hold them and anyone can liquidate positions that use the feed.
170154

171-
Ondo Finance Global Markets (GM) feeds have [SVR](/data-feeds/svr-feeds) enabled even when the primary market is not public to all participants. The liquidator set includes teams that can also access primary mint and redeem when they need to. Permissioned mint and redeem concerns the primary market; tokens can still circulate onchain and positions that use the feed can still be liquidated outside that path.
155+
Most Ondo Finance Global Markets (GM) feeds have [SVR](/data-feeds/svr-feeds) enabled even when the primary market is not public to all participants. The liquidator set includes teams that can also access primary mint and redeem when they need to. Permissioned mint and redeem concerns the primary market; tokens can still circulate onchain and positions that use the feed can still be liquidated outside that path.
172156

173157
For Oracle Extractable Value (OEV) and how SVR relates to standard feeds, use [SVR Feeds](/data-feeds/svr-feeds)—especially [Understanding MEV and OEV](/data-feeds/svr-feeds#understanding-mev-and-oev). To read answers from contracts, follow [Using Data Feeds](/data-feeds/using-data-feeds) and point at the SVR-enabled proxy address for your feed.

0 commit comments

Comments
 (0)