Aqua

Aqua is an open-source language for distributed workflow coordination in p2p networks. Aqua programs are executed on many peers, sequentially or in parallel, forming a single-use coordination network. Applications are turned into hostless workflows over distributed function calls, which enables various levels of decentralization: from handling by a limited set of servers to complete peer-to-peer architecture by connecting user devices directly. Aqua is the core of the Fluence protocol and a framework for internet or private cloud applications.

Installation and Usage

The easiest way to use Aqua is to download the latest build from npm: @fluencelabs/aqua.

npm i -g @fluencelabs/aqua
aqua --input src/aqua --output src/generated

Input directory should contain files with .aqua scripts.

Other ways of installing Aqua can be found in INSTALL.md.

Documentation

Comprehensive documentation and usage examples as well as a number of videos can be found in Aqua Book. Aqua Playground demonstrates how to start writing Aqua and integrate it into a TypeScript application. Numerous videos are available at our YouTube channel.

Repository Structure

• api - Aqua API for JS
  • api - Scala sources
  • api-npm - JS project
  • api-example - usage example
• aqua-run - Aqua API to run functions
• backend - compilation backend interface
  • backend/air - generates AIR code from the middle-end model
  • backend/ts - generates AIR code and TypeScript wrappers for use with Fluence JS SDK
• cli - CLI interface
  • cli - Scala sources
  • cli-npm - JS project
• compiler - compiler as a pure function made from linker, semantics and backend
• model - middle-end, internal representation of the code, optimizations and transformations
  • transform - optimizations and transformations, converting model to the result, ready to be rendered
  • test-kit - tests and test helpers for the model and transformations
• linker - checks dependencies between modules, builds and combines an abstract dependencies tree
• parser - parser, takes source text and produces a source AST
• semantics - rules to convert source AST into the model
• types - data types, arrows, stream types definitions and variance

Support

Please, file an issue if you find a bug. You can also contact us at Discord or Telegram. We will do our best to resolve the issue ASAP.

Contributing

Any interested person is welcome to contribute to the project. Please, make sure you read and follow some basic rules.

License

All software code is copyright (c) Fluence Labs, Inc. under the Apache-2.0 license.