Wallet V5

This is an extensible wallet specification aimed at replacing V4 and allowing arbitrary extensions.

Wallet V5 has 93% lower storage fees, can delegate payments for gas to third parties and supports flexible extension mechanism.

Warning! Contest note!

Because of the extreme amount of optimizations, developer's discretion is advised! Evil laugh

Also, there are some radical optimizations not for the faint-hearted. Proceed with care.

The build system is the same as in the original Wallet V5, no security features have been sacrificed for performance improvements, that is - there are practically no tradeoffs or compromises.

Message and storage layouts were not changed, although some rearragement might squeeze a little more gas, but that may break existing optimizations due to stack reordering.

Also, tests were improved - a Global Gas Counter mechanism was added that accounts for gas in all transactions of all test suites and cases (except for negative and getter ones). This allows to keep an eye on other non-contest cases to track how bad is tradeoff when performing optimizations here and there.

Another utility that was developed for contest is scalpel script, that allows for a detailed, really detailed optimizations of the code by comparing lines of code function by function, printing out diffs, and providing detailed TVM files with stack comments and rewrites. This utility allowed to make some latter optimizations, since with each optimization next one becomes exponentionally harder to make. While result is not entirely precise and is needed to be verified by tests, this allows to instantly estimate whether there is some progress or not, since scalpel is executed immediately, while tests take approximately 10 seconds to execute.

The print script is specialized on anyzing the code on a very low level - it compiles the code using system func and fift binaries, decompiles it, and prints the result as a decompilation, cell tree and compiled hex. Also, amount of free bits and bytes in root cell are printed (that is VERY important for gas usage).

Radical optimizations: compiler improvements

In this branch, there are so-called "radical" (by the contest creators!) optimizations that allow to save even more gas, but they require modification of Asm.fif in the compiler. In order to preserve existing compilation methods and pipelines, a fiftfunclib is patched with a modified version incorporating changes from fift/Asm.fif file. You can find more information about the changes here.

Details of optimizations, their rationale and explanations, comparison of consumed gas both in test cases and not in test cases (global gas counter) are provided on a dedicated page: Gas improvements.

Project structure

• Specification
• contracts - source code of all the smart contracts of the project and their dependencies.
• wrappers - wrapper classes (implementing Contract from ton-core) for the contracts, including any [de]serialization primitives and compilation functions.
• tests - tests for the contracts.
• scripts - scripts used by the project, mainly the deployment scripts.
• Gas improvements (detailed by contest paths, global gas counters per commit)

How to use

Build

npm run build:v5

Test

npm run test

Deployment

1. Deploy library: npm run deploy-library
2. Deploy wallet: npm run deploy-wallet

Get wallet compiled code

npm run print-wallet-code