Feat/m3

.gitignore

@@ -8,4 +8,5 @@ aos.json
 .prettierignore
 
 .vscode
-.DS_Store
+.DS_Store
+bun.lock

.npmignore

@@ -3,8 +3,14 @@ node_modules
 wallet.json
 backup
 echo
-potato
+hyper
 modules
 logos
+extensions
+process/test
+process/crypto
+.gitpod
+.husky
+.github
 aos.json
-*.tgz
+*.tgz

README.md

@@ -66,6 +66,7 @@ aos [name/process-id]
 | `--cron [Interval]`                           | The cron flag can only be used when spawning a process, it instructs the Process to generate messages every `Interval`. An Interval can be defined with a [n]-(period) for example: 1-minute, 10-minutes, 5-hours, 10-blocks, etc. | 0-1      |
 | `--get-blueprints [dir]`                      | This command will grab blueprints from the `/blueprints` folder or a folder specified by the user. These blueprints are small lua files that can be applied to your process to automatically give it some functionality.           | 0-1      |
 | `--tag-name [name]` and `--tag-value [value]` | These flags are also only when aos is spawning a Process. You may add many of these combinations as you would like and they will appear on the Process tags object                                                                 | 0-n      |
+| `--authority [authority]` | The authority flag will allow you to set your authority when spawning a Process. Can be a single address or a comma-separated list. | 0-1 |
 | `--load [luaFile]`                            | The load command allows you to load lua source files from your local directory.                                                                                                                                                    | 0-n      |
 | `--gateway-url [url]`                         | The gateway-url flag allows you to specify a custom Gateway to connect to.                                                                                                                                                         | 0-1      |
 | `--cu-url [url]`                              | The cu-url flag allows you to specify a custom Computer Unit to connect to.                                                                                                                                                        | 0-1      |

blueprints/htoken.lua

@@ -0,0 +1,229 @@
+local bint = require('.bint')(256)
+--[[
+  This module implements the ao Standard Token Specification.
+
+  Terms:
+    Sender: the wallet or Process that sent the Message
+
+  It will first initialize the internal state, and then attach handlers,
+    according to the ao Standard Token Spec API:
+
+    - Info(): return the token parameters, like Name, Ticker, Logo, and Denomination
+
+    - Balance(Target?: string): return the token balance of the Target. If Target is not provided, the Sender
+        is assumed to be the Target
+
+    - Balances(): return the token balance of all participants
+
+    - Transfer(Target: string, Quantity: number): if the Sender has a sufficient balance, send the specified Quantity
+        to the Target. It will also issue a Credit-Notice to the Target and a Debit-Notice to the Sender
+
+    - Mint(Quantity: number): if the Sender matches the Process Owner, then mint the desired Quantity of tokens, adding
+        them the Processes' balance
+]]
+--
+local json = require('json')
+
+--[[
+  utils helper functions to remove the bint complexity.
+]]
+--
+
+
+local utils = {
+  add = function(a, b)
+    return tostring(bint(a) + bint(b))
+  end,
+  subtract = function(a, b)
+    return tostring(bint(a) - bint(b))
+  end,
+  toBalanceValue = function(a)
+    return tostring(bint(a))
+  end,
+  toNumber = function(a)
+    return bint.tonumber(a)
+  end
+}
+
+
+--[[
+     Initialize State
+
+     ao.id is equal to the Process.Id
+   ]]
+--
+Variant = "0.0.4"
+
+-- token should be idempotent and not change previous state updates
+Denomination = Denomination or 12
+Balances = Balances or { [id] = utils.toBalanceValue(10000 * 10 ^ Denomination) }
+TotalSupply = TotalSupply or utils.toBalanceValue(10000 * 10 ^ Denomination)
+Name = Name or 'Hyper Test Coin'
+Ticker = Ticker or 'HYPER'
+Logo = Logo or 'eskTHZQzCLOFrpzkr7zeaf4RxmkaNVYvHuPLh4CLpX4'
+
+--[[
+     Add handlers for each incoming Action defined by the ao Standard Token Specification
+   ]]
+--
+
+--[[
+     Info
+   ]]
+--
+Handlers.add('info', function(msg)
+  send({
+    Target = msg.from,
+    Name = Name,
+    Ticker = Ticker,
+    Logo = Logo,
+    Denomination = tostring(Denomination)
+ })
+end)
+
+--[[
+     Balance
+   ]]
+--
+Handlers.add('balance', { action = "balance"}, function(msg)
+  local bal = '0'
+  print('balance called')
+  print('from ' .. msg.from)
+
+  -- If not Recipient is provided, then return the Senders balance
+  if (msg.recipient) then
+    if (Balances[msg.recipient]) then
+      bal = Balances[msg.recipient]
+    end
+  elseif msg.target and Balances[msg.target] then
+    bal = Balances[msg.target]
+  elseif Balances[msg.from] then
+    bal = Balances[msg.from]
+  end
+  send({
+    target = msg.from,
+    balance = bal,
+    ticker = Ticker,
+    account = msg.recipient or msg.from,
+    data = bal
+  })
+end)
+
+--[[
+     Balances
+   ]]
+--
+Handlers.add('balances',
+  function(msg) 
+    send({target = msg.from, data = json.encode(Balances) }) 
+  end)
+
+--[[
+     Transfer
+   ]]
+--
+Handlers.add('transfer', function(msg)
+  assert(type(msg.recipient) == 'string', 'Recipient is required!')
+  assert(type(msg.quantity) == 'string', 'Quantity is required!')
+  assert(bint.__lt(0, bint(msg.quantity)), 'Quantity must be greater than 0')
+
+  if not Balances[msg.from] then Balances[msg.from] = "0" end
+  if not Balances[msg.recipient] then Balances[msg.recipient] = "0" end
+
+  if bint(msg.quantity) <= bint(Balances[msg.from]) then
+    Balances[msg.from] = utils.subtract(Balances[msg.from], msg.quantity)
+    Balances[msg.recipient] = utils.add(Balances[msg.recipient], msg.quantity)
+
+    --[[
+         Only send the notifications to the Sender and Recipient
+         if the Cast tag is not set on the Transfer message
+       ]]
+    --
+    if not msg.cast then
+      -- Debit-Notice message template, that is sent to the Sender of the transfer
+      local debitNotice = {
+        action = 'Debit-Notice',
+        recipient = msg.recipient,
+        quantity = msg.quantity,
+        data = colors.gray ..
+            "You transferred " ..
+            colors.blue .. msg.quantity .. colors.gray .. " to " .. colors.green .. msg.recipient .. colors.reset
+      }
+      -- Credit-Notice message template, that is sent to the Recipient of the transfer
+      local creditNotice = {
+        target = msg.recipient,
+        action = 'Credit-Notice',
+        sender = msg.from,
+        quantity = msg.quantity,
+        data = colors.gray ..
+            "You received " ..
+            colors.blue .. msg.quantity .. colors.gray .. " from " .. colors.green .. msg.from .. colors.reset
+      }
+
+      -- Add forwarded tags to the credit and debit notice messages
+      for tagName, tagValue in pairs(msg) do
+        -- Tags beginning with "X-" are forwarded
+        if string.sub(tagName, 1, 2) == "x-" then
+          debitNotice[tagName] = tagValue
+          creditNotice[tagName] = tagValue
+        end
+      end
+
+      -- Send Debit-Notice and Credit-Notice
+      debitNotice.Target = msg.from
+      send(debitNotice)
+      send(creditNotice)
+    end
+  else
+    send({
+      target = msg.from,
+      action = 'Transfer-Error',
+      ['Message-Id'] = msg.id,
+      error = 'Insufficient Balance!'
+    })
+  end
+end)
+
+--[[
+    Mint
+   ]]
+--
+Handlers.add('mint', function(msg)
+  assert(type(msg.quantity) == 'string', 'Quantity is required!')
+  assert(bint(0) < bint(msg.quantity), 'Quantity must be greater than zero!')
+
+  if not Balances[id] then Balances[id] = "0" end
+
+  if msg.from == id then
+    -- Add tokens to the token pool, according to Quantity
+    Balances[msg.from] = utils.add(Balances[msg.from], msg.quantity)
+    TotalSupply = utils.add(TotalSupply, msg.quantity)
+    send({
+      target = msg.from,
+      data = colors.gray .. "Successfully minted " .. colors.blue .. msg.quantity .. colors.reset
+    })
+  else
+    send({
+      target = msg.from,
+      action = 'Mint-Error',
+      ['Message-Id'] = msg.id,
+      error = 'Only the Process Id can mint new ' .. Ticker .. ' tokens!'
+    })
+  end
+end)
+
+--[[
+     Total Supply
+   ]]
+--
+Handlers.add('totalSupply', function(msg)
+  assert(msg.From ~= id, 'Cannot call Total-Supply from the same process!')
+  send({
+    Target = msg.From,
+    Action = 'Total-Supply',
+    Data = TotalSupply,
+    Ticker = Ticker
+  })
+end)
+
+

hyper/Makefile

@@ -0,0 +1,9 @@
+test:
+	eval $(luarocks path)
+	busted
+
+download:
+	wget https://www.lua.org/ftp/lua-5.3.6.tar.gz
+	tar -xzf lua-5.3.6.tar.gz
+	wget https://luarocks.org/releases/luarocks-3.9.2.tar.gz
+	tar -xzf luarocks-3.9.2.tar.gz

hyper/README.md

@@ -0,0 +1,77 @@
+# hyper AOS
+
+hyper AOS is a hyperBEAM based implementation of AOS, focused to deliver lighting fast performance to the AO network.
+
+
+## Developer Setup
+
+
+* Install lua
+
+```sh
+wget https://www.lua.org/ftp/lua-5.3.6.tar.gz
+tar -xzf lua-5.3.6.tar.gz
+cd lua-5.3.6
+```
+
+For linux
+
+```sh
+make linux
+```
+
+For mac
+
+```sh
+make macosx
+```
+
+```sh
+sudo make install
+```
+
+* Install luarocks
+
+```sh
+wget https://luarocks.org/releases/luarocks-3.9.2.tar.gz
+tar -xzf luarocks-3.9.2.tar.gz
+cd luarocks-3.9.2
+```
+
+```sh
+./configure --lua-version=5.3 --with-lua=/usr/local
+make
+sudo make install
+```
+
+* Init lua env
+
+```sh
+luarocks init
+```
+
+* Install busted testing library 
+
+```sh
+luarocks install busted 
+```
+
+* Setup lua env
+
+```sh
+eval $(luarocks path)
+```
+
+## Tests
+
+* Running Tests
+
+```sh
+busted
+```
+
+* Writing Tests
+
+Add your test in the `spec` folder and name the test ending with `_spec.lua`
+
+