aqua/npm/aqua-run.md

Installation

• run sbt "cliJS/fullLinkJS" in a root dir of a project after any code update (better to keep sbt running for faster compilation)
• npm installed required
• run npm i in npm directory
• feel free to change @fluencelabs/fluence version in package.json file, run npm i after changes

Run script

Generally, use this script to run compiled aqua compiler from a repo:

npm run from:scalajs -- run -f "someFunction(arg1, arg2)" -i path/to/aqua --data-path path/to/args -m path/to/exports --addr /multiaddr/to/node  

• -f or --func is a function to call with arguments
• -i or --input aqua file where function located
• -m or --import imports location, could be used multiple times
• -a or --addr multiaddress to a Fluence node
• -p or --data-path path to a file with JSON where arguments are located

As example, use test/sample.aqua with args from test/data.json running on /dns4/kras-04.fluence.dev/tcp/19001/wss/p2p/12D3KooWFEwNWcHqi9rtsmDhsYcDbRUCDXH84RC4FW6UfsFWaoHi node:

npm run from:scalajs -- run -f "identityArgsAndReturn(structField, stringField, numberField)" -i test/sample.aqua --data-path test/data.json --addr /dns4/kras-04.fluence.dev/tcp/19001/wss/p2p/12D3KooWFEwNWcHqi9rtsmDhsYcDbRUCDXH84RC4FW6UfsFWaoHi

To simplify experience you can use ./aqua-run.sh command and change all arguments straight in this file.

Node addresses

Different Fluence network addresses could be found here: https://github.com/fluencelabs/fluence-network-environment/blob/main/src/index.ts

Useful flags

• --print-air to print resulted air
• --no-xor to disable xor wrapping aroung service calls
• --sk secret_key send request signed with specific secret key. Secret key could be created with npm run from:scalajs -- create_keypair or aqua create_keypair if you want to use installed aqua
• --data "json"" use instead of --data-path to pass arguments through command line
• --timeout 10000 to change timeout
• --log-level debug/info/.. to change log level

Builtins for aqua run

You can find all builtins in aqua/run-builtins/run-builtins.aqua