Docs/DX: Clarify on-chain validation and lack of pre-validation for price update payloads

Start with the README or documentation covering SDK price updates, and review the existing Hermes/examples guidance and the updatePriceFeeds flow described in the issue. Add a concise warning that malformed payloads are validated on-chain and may revert, noting the lack of SDK-side validation; the documentation should clearly explain this behavior and possible simulation or sourcing practices.

Description

While integrating Pyth price updates via the SDK and EVM contracts, it is not स्पष्ट in the documentation that payload validation (e.g., VAA integrity and data source checks) occurs strictly on-chain.

As a result, developers may submit invalid price_update payloads that are only rejected at execution time with errors such as InvalidWormholeVaa() or InvalidUpdateDataSource().

Current Behavior

• SDK forwards payloads without explicit validation feedback

• Invalid payloads are accepted client-side

• Transaction reverts on-chain with:

  • InvalidWormholeVaa()
  • InvalidUpdateDataSource()

Minimal Reproduction

1. Fetch a valid price update payload (via Hermes or examples)

2. Modify the payload (e.g., truncate bytes or alter a segment)

3. Submit via updatePriceFeeds (or equivalent)

4. Observe:

   • No SDK-side validation error
   • On-chain revert with InvalidWormholeVaa()

This demonstrates that invalid payloads are only detected at contract level.

Why This Matters

• Developers may assume payload correctness before submission
• Failed transactions increase iteration cost (gas + time)
• Debugging requires decoding revert reasons instead of early feedback

Documentation Gap

It is not clearly stated that:

• Payload validation is exclusively enforced on-chain

• The SDK does not pre-validate:

  • Wormhole VAA structure
  • Data source / emitter correctness

Suggested Improvement (Docs Only)

• Add a short note in README or docs:

  • Clarifying that validation occurs on-chain
  • Warning that malformed payloads will revert

• Optionally reference best practices (e.g., simulation, payload sourcing)

Scope

Documentation and developer experience only.
No claim of contract bug or security issue.

Impact

Improves onboarding clarity and reduces avoidable failed transactions during integration.

Labels Suggested: documentation, developer-experience