Skip to content

Enhance account documentation with utility functions and examples #1403

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

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

Conversation

markv44
Copy link

@markv44 markv44 commented Apr 5, 2025

  • Updated the accounts.adoc file to correct minor formatting issues in usage examples.
  • Added a new section on Account Utilities in the account.adoc file, detailing utility functions for executing calls, validating signatures, and verifying transaction versions.
  • Included comprehensive descriptions of utility functions and constants related to account management.

Fixes #1016

PR Checklist

  • Tests
  • Documentation
  • Added entry to CHANGELOG.md
  • Tried the feature on a public network

- Updated the accounts.adoc file to correct minor formatting issues in usage examples.
- Added a new section on Account Utilities in the account.adoc file, detailing utility functions for executing calls, validating signatures, and verifying transaction versions.
- Included comprehensive descriptions of utility functions and constants related to account management.
@markv44
Copy link
Author

markv44 commented Apr 5, 2025

hello @ericnordelo , the pull request is ready for review please review it when you have time.

@ericnordelo
Copy link
Member

Hey @markv44. Thanks for taking the time to contribute! We will go through the PR and give some feedback later this week.

@markv44
Copy link
Author

markv44 commented Apr 11, 2025

Hey @ericnordelo soft reminder to review the pr. Thanks again. Cheers

@ericnordelo
Copy link
Member

Hey @markv44. You can check how the docs would look by going to the Deploy Preview action executed in the PR for the latest commit. If you go there, you can see there's a few broken sections that we need to handle. After that, I will leave feedback about the structure and the content. Thanks for the patience!

@markv44
Copy link
Author

markv44 commented Apr 14, 2025

Hi @ericnordelo , I checked the Deploy Preview for accounts.adoc. The "Account Utilities" section has rendering issues, specifically with ++ and [.item-kind] showing up raw for function/constant types.

Could you point me to the correct AsciiDoc syntax or an example in the docs for formatting these definitions? Thanks!

@ericnordelo
Copy link
Member

Hey @markv44, on the same page where you added the Account Utilities there are examples on how to use the attributes in the right way.

… descriptions

- Merged updates to the Account Utilities section in accounts.adoc, adding comprehensive descriptions for utility functions such as `execute_call`, `is_valid_transaction_version`, `hash_transaction`, and `verify_signature`.
- Introduced constants `VALIDATION_SUCCESS` and `VALIDATION_FAILED` with explanations for their usage in validation functions.
@markv44
Copy link
Author

markv44 commented Apr 29, 2025

Hello @ericnordelo , would you please take a look at the CI failures, I dont think they are related to my code changes, if I missed something please advice how should I fix them.

@@ -527,6 +527,7 @@ await provider.waitForTransaction(tx.transaction_hash);

== Account Utilities

<<<<<<< Updated upstream
Copy link
Member

Choose a reason for hiding this comment

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

This is probably an issue with merging that needs to be addressed.

…amline documentation to focus on the `AccountComponent` utility functions. This update enhances clarity and relevance in the documentation.
@markv44
Copy link
Author

markv44 commented May 1, 2025

Hey @ericnordelo I have changed the merging issues but now the tests are failing, can you please check why the test are failing?

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.

Document account component utils in docsite
2 participants