Skip to content

Conversation

aditya520
Copy link
Member

Description

  • Add Mermaid/Process Flow Diagram
  • Explain DL sequencer

Type of Change

  • New Page
  • Page update/improvement
  • Fix typo/grammar
  • Restructure/reorganize content
  • Update links/references
  • Other (please describe):

Areas Affected

Checklist

  • I ran pre-commit run --all-files to check for linting errors
  • I have reviewed my changes for clarity and accuracy
  • All links are valid and working
  • Images (if any) are properly formatted and include alt text
  • Code examples (if any) are complete and functional
  • Content follows the established style guide
  • Changes are properly formatted in Markdown
  • Preview renders correctly in development environment

Related Issues

Closes #

Additional Notes

Contributor Information

  • Name:
  • Email:

Screenshots

Copy link

vercel bot commented Oct 13, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Oct 16, 2025 5:31pm
documentation Error Error Oct 16, 2025 5:31pm

@aditya520
Copy link
Member Author

We call relayers and routers in our pyth-lazer code, but sequencers and observers in our internal docs. Are we going to rename stuff in future? I went with what was written in the code for brevity.


<Callout type="info">
The Douro Labs-operated relayer follows a strict, deterministic processing model:
- **No price dropping**: All validated updates are forwarded to the message queue without dropping any prices.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not entirely true right now. We don't drop updates entirely, but relayer can mark any update as rejected. Its logic is not fully deterministic because we still have a circuit breaker. (We plan to remove it.)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

let's describe the policy that is implemented here -- "no price dropping outside of circuit breakers"

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was trying not to mention circuit breakers at all as we are planning to remove it.

@Riateche
Copy link
Contributor

We call relayers and routers in our pyth-lazer code, but sequencers and observers in our internal docs. Are we going to rename stuff in future? I went with what was written in the code for brevity.

Sequencers and observers are the names used in early docs that predate the code I think. Let's stick with relayers and routers.

@aditya520 aditya520 self-assigned this Oct 15, 2025
@aditya520 aditya520 marked this pull request as ready for review October 16, 2025 07:33
Copy link
Contributor

@ali-behjati ali-behjati left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall looks good, i'd approve once you apply my comments.

- **Channel types**: Supports real-time and fixed-rate channels (1ms, 50ms, 200ms)
- **Multi-chain support**: Generates on-chain payloads for Solana, EVM, and other chains

#### Aggregation logic
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is where deterministic behaviour is important, all the aggregators produce the exact same aggregate solely relying on the consistent stream of price updates.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

here if you are not mentioning Douro running the service and think about the future that this part gets more decentralized, the publishers signature should be checked too (otherwise Douro can forge them). You can add that the aggregator validates the signatures of publisher update transactions.

p.s: we don't do it now, but will do in the future.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So should we mention that right now?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants