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

FileCreate/FileUpdate automatic chunking #835

Open
11 tasks
jbair06 opened this issue Sep 3, 2024 · 5 comments · May be fixed by #861
Open
11 tasks

FileCreate/FileUpdate automatic chunking #835

jbair06 opened this issue Sep 3, 2024 · 5 comments · May be fixed by #861
Assignees
Labels
enhancement New feature or request good first issue Issues which are ideal for a first time or new project contributor. hacktoberfest Issues shown by lists for the Hacktoberfest and made for newcomers to do the first contribution.

Comments

@jbair06
Copy link
Member

jbair06 commented Sep 3, 2024

🆕🐥 First Timers Only

This issue is reserved for people who have never contributed to Hedera or any open source project in general.
We know that creating a pull request (PR) is a major barrier for new contributors.
The goal of this issue and all other issues labeled by 'good first issue' is to help you make your first contribution to Hedera.

👾 Description of the issue

When creating or updating a file using the FileCreateTransaction or FileUpdateTransaction, if the contents are too large for a single transaction, a FileAppendTransaction is required to be created in addition to the FileCreate/FileUpdate.

FileAppendTransaction, on the other hand, can handle a large content because it does chunking of that content internally. It would be good to have FileCreate and FileUpdate to have this same functionality. This would allow for a single transaction to create or update a file with a large content.

Solution

Refactor FileCreateTransaction and FileUpdateTransaction to share the new pub trait FileTransaction which should include an append method to store additional transactions when the content exceeds 1024 kB. Refer to FileAppendTransaction for an example of how to chunk the content.

Implementation

  1. Create a new pub trait FileTransaction with append method (for new transactions).
  2. Create a base struct FileTransactionBase that implements FileTransaction with set_contents method to handle large files by creating multiple transactions.
  3. Update FileCreateTransaction and FileUpdateTransaction to implement FileTransaction
  4. Create tests to verify the new functionality (unit tests and integration tests)

📋 Step by step guide to do a contribution

If you have never contributed to an open source project at GitHub, the following step-by-step guide will introduce you to the workflow. More information and concrete samples for shell commands for each step can be found in our CONTRIBUTING.md file.
A more detailed general documentation of the GitHub PR workflow can be found here.

  • Claim this issue: Comment below that you are interested in working on the issue
  • Wait for assignment: A community member with the given rights will add you as an assignee of the issue
  • Fork the repository: You can do that in GitHub (by simply clicking the 'fork' button).
  • Check out the forked repository
  • Create a feature branch for the issue. We do not have a hard naming definition for branches but it is best practice to prefix the branch name with the issue id.
  • Solve the issue in your branch.
  • Commit your changes: Here, it is needed to add sign-off information to the commit to accept the "Developer Certificate of Origin" (https://developercertificate.org). More details can be found in our CONTRIBUTING.md
  • Start a Pull Request (PR): We have a pattern for naming pull requests that a GitHub Action checks. We use that pattern to support the creation of automatic release notes.
  • Check GitHub Actions: Several GitHub Actions will be triggered automatically for each PR. If a GitHub Action fails and you do not understand the cause of that error do not hesitate to add a comment to the PR and ask the Hedera developer community for support.
  • Wait for reviews: Members of the Hedera developer community will review your PR. If a reviewer finds any missing pieces or a problem, he or she will start a discussion with you and describe the next steps for solving the problem.
  • You did it 🎉: We will merge the fix in the develop branch. Thanks for being part of the Hedera community as an open-source contributor ❤️

🎉 Contribute to Hacktoberfest

Solve this issue as part of the Hacktoberfest event and get a chance to receive cool goodies like a T-Shirt. 🎽

🤔 Additional Information

If you have any questions, just ask us directly in this issue by adding a comment. You can join our community chat at Discord. A general manual about open-source contributions can be found here.

@jbair06 jbair06 added the enhancement New feature or request label Sep 3, 2024
@RickyLB RickyLB added the good first issue candidate Issues that can become a good first issue but need more description/context. label Sep 12, 2024
@hendrikebbers hendrikebbers added good first issue Issues which are ideal for a first time or new project contributor. hacktoberfest Issues shown by lists for the Hacktoberfest and made for newcomers to do the first contribution. and removed good first issue candidate Issues that can become a good first issue but need more description/context. labels Oct 17, 2024
@mrswastik-robot
Copy link

hey @hendrikebbers @RickyLB , can I work on this issue, I have a very little experience with Rust though

@RickyLB
Copy link
Contributor

RickyLB commented Oct 21, 2024

@mrswastik-robot You may! Feel free to ask any questions and i'll answer to the best of my ability.

@mrswastik-robot
Copy link

hii @RickyLB, I have tried to write the logic for the chunking of large content in the file_create_transaction.rs file and also wrote the test case for it, but I have not been able to pass the test case for it and it's giving me the error:

thread 'file::file_create_transaction::tests::serialize_large_contents' panicked at src/file/file_create_transaction.rs:458:20: called Result::unwrap()on anErr value: NoPayerAccountOrTransactionId

should I create a PR so that you can see the modified code and then I can make the requested changes?

@RickyLB
Copy link
Contributor

RickyLB commented Oct 29, 2024

Hey @mrswastik-robot,

Go ahead and create a PR, and i'll take a look at it. Thank you!

@mrswastik-robot mrswastik-robot linked a pull request Oct 29, 2024 that will close this issue
2 tasks
@mrswastik-robot
Copy link

@RickyLB , I have raised the PR, you can have a look into it, I will be more than happy to make the requested changes once you review it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request good first issue Issues which are ideal for a first time or new project contributor. hacktoberfest Issues shown by lists for the Hacktoberfest and made for newcomers to do the first contribution.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants