Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Enhance Developer Documentation: Detailed Code Examples, Improved VAA Explanation, and Structure Refinement #48

Open
wants to merge 11 commits into
base: main
Choose a base branch
from

Conversation

404PJNotFound
Copy link

Description

Enhancement of Developer Documentation:

Added more detailed explanations, examples, and clearer instructions to guide developers through setting up and working with Wormhole’s protocol and tools.

Detailed Code References and Examples:

Added specific references to code snippets and examples in the documentation. These references provide concrete examples for developers to follow, making it easier to implement various functionalities in their applications.
For instance, in the "Specialized Relayer" section, detailed instructions on how to set up, fetch VAAs, and relay them on different environments (EVM and Solana) were provided. This includes precise code snippets that can be directly used by developers.

Improved Explanation of VAAs:

The documentation now includes a more detailed explanation of VAAs (Verified Action Approvals), including how they are created, signed, and relayed across chains.
The sections on "Actions" and "Lifetime of a Message" have been expanded to better explain how messages are emitted, signed by Guardians, and eventually processed on the target chain.

Checklist

  • [X ] Required - I have added a label to this PR 🏷️
  • [X ] Required - I have run my changes through Grammarly
  • [X ] If pages have been moved, I have created redirects in the wormhole-mkdocs repo

Copy link
Collaborator

@eshaben eshaben left a comment

Choose a reason for hiding this comment

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

@404PJNotFound Thanks for opening this PR! 💜

Left some comments about items that need to be addressed. Thanks!

- **[Environment](https://github.com/wormhole-foundation/wormhole){target=\_blank}** - select the folder for the desired network to learn about the recommended native toolset
- **[Mock Guardian](https://github.com/wormhole-foundation/wormhole/blob/main/sdk/js/src/mock/wormhole.ts){target=\_blank}** - it's recommended to set up a mock Guardian or Emitter to provide signed VAAsFor any program methods that require some message be sent or received.
- **[Environment](https://github.com/wormhole-foundation/wormhole){target=\_blank}** - select the folder for the desired network to learn about the recommended native toolset
- **[Mock Guardian](https://github.com/wormhole-foundation/wormhole/blob/main/sdk/js/src/mock/wormhole.ts){target=\_blank}** - it's recommended to set up a mock Guardian or Emitter to provide signed VAAs for any program methods that require some message be sent or received.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Good catch! Thanks!

learn/fundamentals/introduction.md Outdated Show resolved Hide resolved
learn/infrastructure/spy.md Outdated Show resolved Hide resolved
learn/infrastructure/spy.md Outdated Show resolved Hide resolved
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.

2 participants