Running app in nodejs
It is easy to use Fluence JS in NodeJS applications. You can take full advantage of the javascript ecosystem and at the save time expose service to the Fluence Network. That makes is an excellent choice for quick prototyping of applications for Fluence Stack.

@fluencelabs/fluence delivers AquaVM wasm file through the npm package. No additional configuration is needed.

Lets implement a very simple app which simulates a desk calculator. The calculator has internal memory and implements the following set of operations:
  • Add a number
  • Subtract a number
  • Multiply by a number
  • Divide by a number
  • Get the current memory state
  • Reset the memory state to 0.0
First, let's write the service definition in aqua:
-- service definition
service Calc("calc"):
add(n: f32)
subtract(n: f32)
multiply(n: f32)
divide(n: f32)
getResult() -> f32
Now write the implementation for this service in typescript:
import { Fluence } from "@fluencelabs/fluence";
import { krasnodar } from "@fluencelabs/fluence-network-environment";
import { registerCalc, CalcDef } from "./_aqua/calc";
class Calc implements CalcDef {
private _state: number = 0;
add(n: number) {
this._state += n;
subtract(n: number) {
this._state -= n;
multiply(n: number) {
this._state *= n;
divide(n: number) {
this._state /= n;
reset() {
this._state = 0;
getResult() {
return this._state;
const keypress = async () => {
return new Promise<void>((resolve) =>
process.stdin.once("data", () => {
async function main() {
await Fluence.start({
connectTo: krasnodar[0],
registerCalc(new Calc());
console.log("application started");
console.log("peer id is: ", Fluence.getStatus().peerId);
console.log("relay is: ", Fluence.getStatus().relayPeerId);
console.log("press any key to continue");
await keypress();
await Fluence.stop();
As you can see all the service logic has been implemented in typescript. You have full power of npm at your disposal.
Now try running the application:
> node -r ts-node/register src/index.ts
application started
peer id is: 12D3KooWLBkw4Tz8bRoSriy5WEpHyWfU11jEK3b5yCa7FBRDRWH3
relay is: 12D3KooWSD5PToNiLQwKDXsu8JSysCwUt8BVUJEqCHcDe7P5h45e
press any key to continue
And the service can be called from aqua. For example:
const peer ?= "12D3KooWLBkw4Tz8bRoSriy5WEpHyWfU11jEK3b5yCa7FBRDRWH3"
const relay ?= "12D3KooWSD5PToNiLQwKDXsu8JSysCwUt8BVUJEqCHcDe7P5h45e"
func demoCalculation() -> f32:
on peer via relay
res <- Calc.getResult()
<- res
Copy link
On this page
Configuring application to run in nodejs
Calc app example