as-transformer

MassaLabs as-transformer library.

An AssemblyScript transformer helper module.

The complete documentation of all available functions and objects can be found here:

• as-transformer documentation

Install

To install this module, run the following command at your project root directory :

npm install -D @massalabs/as-transformer
Copy

The protobuf transformer needs protobuf compiler, protoc, to be installed.

Usage

Tell your editor where to find the transformer types in a typing file. For example assembly/types.d.ts.

/// <reference types="@massalabs/as-transformer" />
Copy

You can use this transformer by adding --transform @massalabs/as-transformer to your asc command.

For instance, to compile assembly/my_sc.ts with this transformer you will execute:

npx asc --transform @massalabs/as-transformer assembly/my_sc.ts --target release --exportRuntime -o build/my_sc.wasm
Copy

file2ByteArray

This transformer loads the given file, encodes it to StaticArray<u8> and then replace the call to file2ByteArray by the encoded content.

Example:

export function main(_args: string): i32 {
    const bytes = fileToByteArray('./build/sc.wasm'); // will read `build/sc.wasm`, will encode it in array and then put the result in a string used to initialize `bytes`.
    const sc_addr = createSC(bytes);
    call(sc_addr, "advance", "", 0);
    generateEvent("SC deployed at addr: " + sc_addr);
    return 0;
}
Copy