#utilities #collection #gas #counter #contract #twasm

no-std bin+lib twasm-utils

Collection of command-line utilities and corresponding Rust api for producing twasm-compatible executables

Show the crate…

3 releases (breaking)

0.17.0 Feb 11, 2021
0.16.0 Mar 14, 2021
0.6.1 Feb 21, 2021

#33 in #gas

Download history 2/week @ 2024-11-13 9/week @ 2024-11-20 19/week @ 2024-11-27 42/week @ 2024-12-04 66/week @ 2024-12-11 10/week @ 2024-12-18 6/week @ 2025-01-01 10/week @ 2025-01-08 13/week @ 2025-01-15 11/week @ 2025-01-22 24/week @ 2025-02-05 34/week @ 2025-02-12 10/week @ 2025-02-19 9/week @ 2025-02-26

77 downloads per month
Used in 43 crates (4 directly)

MIT/Apache

200KB
5K SLoC

twasm-utils

Build Status

A collection of WASM utilities used in twasm-vapory and tetcore contract development.

This repository contains the package twasm-utils which consists of a library crate and a collection of cli binaries that make use of this library.

Installation of cli tools

cargo install twasm-utils --features cli

This will install the following binaries:

  • wasm-build
  • wasm-check
  • wasm-ext
  • wasm-gas
  • wasm-pack
  • wasm-prune
  • wasm-stack-height

Symbols pruning (wasm-prune)

wasm-prune <input_wasm_binary.wasm> <output_wasm_binary.wasm>

This will optimize WASM symbols tree to leave only those elements that are used by contract call function entry.

Gas counter (wasm-gas)

For development puposes, raw WASM contract can be injected with gas counters (the same way as it done by twasm-vapory/tetcore runtime when running contracts)

wasm-gas <input_wasm_binary.wasm> <output_wasm_binary.wasm>

License

wasm-utils is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0), at your choice.

See LICENSE-APACHE, and LICENSE-MIT for details.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in wasm-utils by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.4–7.5MB
~57K SLoC