Skip to content

Conversation

@2dpetkov
Copy link
Contributor

This content is taken from the subsections under the Validators section from https://docs.skip.build/connect/validators/.

Summary

  • Replaces “Connect Sidecar / Skip” references with “Slinky” across validator/oracle docs, and updates the primary external reference to the Slinky repo (https://github.com/dydxprotocol/slinky).
  • Updates the oracle.json example from the original Validators documentation with the latest set of provider endpoints that validators need to configure.
  • Adds tighter cross-linking between node runbooks and config docs:
    • running-a-validator.mdx now points to required-node-configs.mdx#oracle-configuration and required-node-configs.mdx#slinky-configs.
  • Updates sidecar upgrade guidance:
    • upgrading-sidecar.mdx removes the Skip/Connect upgrade link and adds native upgrade steps, while still linking to ../running-node/optimize.mdx#slinky-sidecar.
  • Updates the Oracle onboarding FAQs:
    • onboarding-faqs/index.mdx switches the oracle breakdown to “Slinky” and adds additional Oracle FAQ entries in the existing sequence.

@2dpetkov 2dpetkov requested review from a team as code owners January 14, 2026 20:26
@vercel
Copy link

vercel bot commented Jan 14, 2026

@2dpetkov is attempting to deploy a commit to the dYdX Trading Team on Vercel.

A member of the Team first needs to authorize it.

# Interval is the time between each price update request. The recommended interval
# is the block time of the chain. Otherwise, 1.5 seconds (1500ms) is a good default. If this
# is greater than 1 minute (1m), the app will not start.
interval = "1500ms"
Copy link
Contributor

Choose a reason for hiding this comment

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

The default should reflect our recommendation of $blocktime

Copy link
Contributor Author

Choose a reason for hiding this comment

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

true, I'll recommend 600ms since block times are slightly higher than that number nowadays.


| Key | Default | Description |
|---------------------------------------|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
| `CONNECT_CONFIG_HOST` | `"0.0.0.0"` | The address Slinky will serve requests from. WARNING: changing this value requires updating the oracle_address in the app.toml configuration. |
Copy link
Contributor

Choose a reason for hiding this comment

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

We should add a note on security concerns, e.g. using 0.0.0.0 vs 127.0.0.1 permits external queries. That might be desired for convenience but I think our recommendations should lean towards security.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

true, adding such a note

## Slinky

Starting in `v5.0.0`, running a validating full node requires a Skip Protocol's Connect Sidecar to be run in order to fetch Oracle prices. The sidecar should be started before upgrading from `v4` to `v5`. Instructions to start Connect Sidecar can be found [here](https://docs.skip.build/connect/validators/quickstart).
Starting in `v5.0.0`, running a validating full node requires the Slinky sidecar to be running in order to fetch Oracle prices. Slinky is a sidecar that pulls price data from external sources and caches them for the validator to use.
Copy link
Contributor

Choose a reason for hiding this comment

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

We don't a note on v5.0.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is the dYdX Chain Protocol version v5.0.0 - the dydxprotocold version when prices were moved from price daemon to Skip's sidecar

I can of course remove it, or reword it so that it's clearly referencing the corresponding dYdX Chain hard fork.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Or better yet - link the dYdX Protocol upgrade proposal that introduced Skip's sidecar

Copy link
Contributor Author

Choose a reason for hiding this comment

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

My thinking is: the wording Starting in v5.0.0 was there in docs.dydx.xyz before this change, why not build on top of it.
I can remove though, if there's something I'm missing

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

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants