mirror of
https://github.com/fluencelabs/aqua.git
synced 2024-12-12 17:55:33 +00:00
46 lines
2.1 KiB
Markdown
46 lines
2.1 KiB
Markdown
|
## 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
|
||
|
|
|