Contributing guide

❤️ It's great that you are interested! Thank you for investing your time in this project!

ℹ️ The following text is mostly guideline and not rule. Use your best judgment, and feel free to propose changes to this document in a pull request.

• How can i contribute

  • Reporting bugs

  • Enhancements proposal

  • Code contribution

    • How to build smart contract

    • How to run tests

    • Project structure

How can i contrubute

Reporting bugs

We are tracking bugs in GitHub issues. If you found an bug, open new issue with "bug" label.

If you think you found vulnerabilty or security related issue, do not open issue, create vulnerability report.

Enhancements proposal

We are tracking feature suggestions in GitHub issues. if you want to propose new feature, feel free to open issue with "enhancement" label.

Code contribution

To work with application locally you will need Node.js version 22+.

Here is a list of used dependencies in project:

• Tact Lang - programming language for TON Blockchain, we using it for writting smart contract code
• Typescript - programming language we using for testing and scripting smart contracts
• Jest - testing framework
• Prettier - for code formatting
• Blueprint - development environment for TON blockchain for writing, testing, and deploying smart contracts
• TON Sandbox - local TON emulator we are using for testing smart contract

How to build smart contract

npx blueprint build

How to run tests

npx blueprint test

Styleguide

Git Commit Message

• Use Conventional Commits commit format
• Use the present tense ("feat: add feature" not "feat: added feature")

• Use the imperative mood ("fix: move file to..." not "fix: moves files...")

• Use lowercase first letter ("docs: update README.md" not "docs: Update README.md")

• Limit the first line to 72 characters or less