Status: Preview rc2 Version: 2.0.0-rc2 Module: PSPMkkFrJzYI2bQbkmeEQ5ONmeR-FJZu0fNQoSCU1-I

Sqlite-Module: C4bxMlK8d_wQ-QpXIIZLU8UWXu6Sd8PDJw7HN3nNE2I

Requirements

• NodeJS version 20+

Getting Started

npm i -g https://get_ao.g8way.io && aos

NOTE: after the first time you run aos it installs it to your local machine, so the next time you want to run aos, just type aos + [enter]

User Documentation

Go to ao Cookbook

Design Principals

• aos the module is designed to be an operating system on the ao network, it provides developers the ability to build ao processes that are fast to iterate with and highly flexible. The design goal of the aos process is to not have too many opinions and implement the core functionality extremely well. The design should quickly reach a complete status. Currently it is in the Preview stage and should be progressing to an Early stage, then finally a Complete stage.

• aos console is an interactive shell to the aos module, the purpose of this shell is to provide developers with a fun and engaging experience with the aos operating system module, as well as users. Users should enjoy to run their personal processes and engage on the network, from trading, to chats, to games. So the console should be easy to install on all major os platforms.

Preview Implementation

The current implementation of aos is using the ao wasm module and building with the ao cli that uses a emscripten c compiler and embeds Lua v5.3 in the wasm binary. This gives the developers and users with a built in operating system with a first class interactive language to engage with the Process business logic. The aos module also provides features like json, base64,

For Developers

The aos console is a command-line application that provides a easy to use DX experience to create Processes (aka Smart Contracts) on the ao Computer.

Setup

Use yarn to build the project and run.

yarn
yarn build
yarn start

Command-line options

You can provide a name for a specific Process, if the Process does not exist aos will spawn the process, then every time you run aos [name] it will locate that process and interact with it.

aos [name]

Flags

Commands

When running the console, you can type dot commands to instruct the console to perform special instructions.

License

The ao and aos codebases are offered under the BSL 1.1 license for the duration of the testnet period. After the testnet phase is over, the code will be made available under either a new evolutionary forking license, or a traditional OSS license (GPLv3/v2, MIT, etc).

Advanced AOS Development Guide

Requirements

• Docker
• Nodejs

Setup

curl -L https://install_ao.g8way.io | bash

Follow install instructions

change console directory to process

cd process

Build WASM Module

ao build

Develop using os loader

Making changes and debugging can be a challege with aos modules.

node ../src/index.js
aos> .update

Will load the current changes into a process. This workflow will allow you to make changes and update the os verify changes. Rinse Repeat.

Run AOS Tests

yarn
yarn test

Deploy WASM Module

NOTE: you will need a keyfile with turbo credits from ardrive.io Add keyfile to $HOME/.wallet.json file

yarn deploy

Copy the new module id

Create a new aos with module id

$MODULE={moduleId}
aos new1 --module=$MODULE

Deploy a new version of AOS Console

in the project directory Update package.json with new Module ID and new Version. Use semantic versioning. Update README.md with new Module ID and new Version

Update aos-sqlite with latest

cd process
docker run -v .:/src p3rmaw3b/aos-sqlite:0.0.0 emcc-lua
yarn 
yarn test
yarn deploy-sqlite

copy module id to package.json and readme