@permaweb/aos-cli
v1.2.7
Published
> NOTE: This is very experimental, use for research and development purposes only.
Downloads
46
Readme
AOS REPL
NOTE: This is very experimental, use for research and development purposes only.
The repl is a thin client to access and execute ao contracts on the permaweb.
Getting Started
# create new project add arweave
yarn init -y
yarn add arweave
# Generate Wallet
node -e "require('arweave').init({}).wallets.generate().then(JSON.stringify).then(console.log.bind(console))" > wallet.json
# Boot up AOS
npx @permaweb/aos-cli@latest wallet.json
The wallet creates a personal process that allows you to use as a repl, you can send it commands and it will evaluate and return output.
About
AOS-CLI is a simple REPL that connects to a Personal AOS Process in the AO network. The AO network is a messaging passing process architecture. A Personal AOS Process is like a CPU on the Arweave Network. This repl will allow you to pass LUA expressions to your process, and those expressions get evaluated and return output to your screen.
Examples
When you boot up the OS, you can use https://lua.org to run expressions on your AOS Process.
First try "Hello AOS" - the return keyword sets the output variable that is passed to the output on the screen.
"Hello AOS"
You should get Hello AOS
What is happening here? You input, is getting wrapped in an signed AO message and submitted to a
mu
or messenger unit, which then forwards it to asu
or Sequencer Unit, then the REPL app, calls thecu
compute unit to evaluate the AO Message with your Personal Process. This generates output to be returned for display.
Lets try another expression:
1 + 41
You should get 42
the answer to the universe :P
So, thats cool, you can send expressions to the AO network and get them evaluated and get a response.
You can also set variables:
a = "Hello AOS"
Then type return a
and you should get Hello AOS
, neat
You can also create functions:
sayHi = function (name) return "Hello " .. name end
return sayHi("Sam")
You should get Hello Sam
Woohoo!
We can also pass messages to other AOS Processes!
return send("9ps7pnC7hpdCYJGJujAg_QY-cyKbQ1GoaE5h-4elI9c", { body = "Hi Tom!" })
Or you can check your messages ( by creating a message check function)
function checkInbox() local o = ""; for i,v in ipairs(inbox) do o = o .. v.body .. '\n' end; return o; end
checkInbox()
[{"from":"9ps7pnC7hpdCYJGJujAg_QY-cyKbQ1GoaE5h-4elI9c","body":"Hi"}]