wao 0.41.3 → 0.41.5

package/.babelrc-cjs

@@ -0,0 +1,5 @@
+{
+  "presets": [
+    ["@babel/preset-env", { "modules": "commonjs" }]
+  ]
+}

package/.babelrc-esm

@@ -0,0 +1,5 @@
+{
+  "presets": [
+    ["@babel/preset-env", { "modules": false }]
+  ]
+}

package/.gitmodules

@@ -0,0 +1,4 @@
+[submodule "HyperBEAM"]
+	path = HyperBEAM
+	url = https://github.com/weavedb/HyperBEAM.git
+	branch = wao-final

package/.prettierrc

@@ -0,0 +1,6 @@
+{
+    "trailingComma": "es5",
+    "semi": false,
+    "singleQuote": false,
+    "arrowParens": "always"
+  }

package/README.md

@@ -0,0 +1,90 @@
+# Get started
+
+![](./docs/docs/public/images/cover.png)
+
+## What is WizardAO?
+
+WizardAO is the one-stop lab for engineers building on Arweave and AO. It ships tutorials, deep-dive guides, a full HyperBEAM book, and complete HyperBEAM references — everything you need to go from zero to production.
+
+At its core is **WAO**, a lightning-fast testing framework for AOS, [HyperBEAM](https://permaweb.github.io/HyperBEAM/), and AI. Test Lua scripts 1000x faster than mainnet by emulating AO units in memory, launch HyperBEAM nodes from JS test code, build custom devices in Erlang, Rust, C++, Elixir, and Gleam, or spin up standalone local units with a single `npx wao`.
+
+WAO also ships the **WAO SDK** — an extension of Wander (`aoconnect`) with syntactic sugar, seamless message piping, and async message result validation to drastically reduce code size.
+
+This combination — a complete knowledge base plus sub-second testing — makes **WizardAO** the ideal stack for Agent Driven Development on AO and HyperBEAM. AI agents build reliably when they have domain knowledge to avoid hallucinating patterns and a fast feedback loop to iterate autonomously. The [HyperADD Framework](https://docs.wao.eco/add/framework) ties both together.
+
+---
+
+## Start Building
+
+```
+  ┌─────────────────────┬─────────────────────┐
+  │                     │  Lua Scripts (AOS)  │  ← smart contracts
+  │   Custom Modules    ├─────────────────────┤
+  │     (WASM/Lua)      │         AOS         │  ← execution environments
+  ├─────────────────────┴─────────────────────┤
+  │             HyperBEAM Devices             │  ← composable infrastructure
+  ├───────────────────────────────────────────┤
+  │                  Arweave                  │  ← permanent storage
+  └───────────────────────────────────────────┘
+```
+
+WAO provides five environments — from instant in-memory emulation to production networks:
+
+```
+  fast ◀────────────────────────────────────────────▶ realistic
+
+  In-Memory AOS   Local AO   Local HB   WAO Devnet   Remote HB
+    emulation      npx wao   sandboxed   Cloudflare   production
+```
+
+| Environment | Description |
+|-------------|------------|
+| **In-memory AOS** | AOS WASM in Node.js — no server, instant unit tests |
+| **Local AO Units** | Standalone units via `npx wao` — local dev |
+| **Local HyperBEAM** | Sandboxed Erlang node — full stack integration |
+| **WAO Devnet** | Full AO stack on Cloudflare Workers — staging with WAO Scan explorer |
+| **Remote HyperBEAM** | Production nodes — mainnet |
+
+### AOS — Lua Smart Contracts
+Build decentralized processes with Lua handlers running on AO.
+- [Legacynet AOS →](https://docs.wao.eco/tutorials/legacynet)
+- [Legacynet AOS on HyperBEAM →](https://docs.wao.eco/tutorials/legacynet-aos)
+- [Mainnet AOS (WASM Device) →](https://docs.wao.eco/tutorials/mainnet-aos)
+- [HyperAOS (Lua Device) →](https://docs.wao.eco/tutorials/hyperaos)
+
+### Custom Modules — WASM/Lua Execution Modules
+Build custom WASM64 or Lua execution modules that run alongside AOS on HyperBEAM.
+- [Custom WASM64 in Rust →](https://docs.wao.eco/tutorials/rust-wasm64) — Custom WASM64 binary composable with AOS
+- [Custom Lua Modules →](https://docs.wao.eco/tutorials/custom-lua) — Standalone Lua modules on HyperBEAM's lua@5.3a device
+
+### HyperBEAM Devices — Composable Infrastructure
+Build composable devices that extend HyperBEAM's core capabilities — each device is a building block that can be composed with others.
+- [HyperBEAM →](https://docs.wao.eco/tutorials/hb)
+- [Custom Devices in Erlang →](https://docs.wao.eco/tutorials/creating-devices)
+- Custom Devices (Advanced) — [Rust](https://docs.wao.eco/tutorials/devices-rust) · [C++](https://docs.wao.eco/tutorials/devices-cpp) · [Elixir](https://docs.wao.eco/tutorials/devices-elixir) · [Gleam](https://docs.wao.eco/tutorials/devices-gleam)
+- [The HyperBEAM Book →](https://docs.wao.eco/book) — From zero to building custom devices
+- [Decoding HyperBEAM →](https://docs.wao.eco/hyperbeam/decoding-from-scratch) — Deep-dive series into internals
+
+### Agent Driven Development
+Build WAO projects using the HyperADD (Agent Driven Development) Framework.
+- [Overview →](https://docs.wao.eco/add/overview)
+- [Vibe Engineering →](https://docs.wao.eco/add/build)
+- [HyperADD Framework →](https://docs.wao.eco/add/framework)
+
+### WAO Devnet — Edge AO Network for Development
+A lightweight edge implementation of the full AO network (AR, SU, MU, CU, BD) on Cloudflare Workers — horizontally and vertically scalable, with WAO Scan block explorer.
+- [Overview →](https://docs.wao.eco/devnet/overview) — What is WAO Devnet and why you need it
+- [Running a Node →](https://docs.wao.eco/devnet/node) — Run locally or deploy to Cloudflare
+- [API Endpoints →](https://docs.wao.eco/devnet/api) — Full reference for all unit endpoints
+
+### Reference
+- [WAO SDK API →](https://docs.wao.eco/api/overview)
+- [HyperBEAM API →](https://docs.wao.eco/hyperbeam) — core module reference
+
+---
+
+## Experiments
+Active experiments from the lab — usable but still evolving.
+- [AO in the Browser →](https://docs.wao.eco/web) — Full AO units running in your browser at [preview.wao.eco](https://preview.wao.eco)
+- [HyperBEAM on Mobile →](https://docs.wao.eco/mobile) — Run a HyperBEAM node on Android / iOS
+- [Running LLMs on AOS →](https://docs.wao.eco/tutorials/running-llms) — Run AI models on AO processes

package/app/.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "next/core-web-vitals"
+}

package/app/.mocharc.cjs

@@ -0,0 +1,6 @@
+module.exports = {
+  spec: "test/unit/**/*.test.mjs",
+  reporter: "spec",
+  timeout: 30000,
+  parallel: false,
+}

package/app/arweave.mjs

@@ -0,0 +1,87 @@
+import {
+  rmdirSync,
+  unlinkSync,
+  writeFileSync,
+  readFileSync,
+  readdirSync,
+} from "fs"
+
+import { resolve, extname } from "path"
+import * as cheerio from "cheerio"
+
+const out = resolve(import.meta.dirname, "out")
+const dirs = readdirSync(out, { withFileTypes: true, recursive: true })
+
+const prefixWithPath = url => {
+  const cleanedUrl = url.replace(/^\.\//, "").replace(/^\//, "")
+  const txt = "${path}" + cleanedUrl
+  return "`" + txt + "`"
+}
+
+const isRelativeUrl = url => !/^https?:\/\//i.test(url)
+
+let _dirs = []
+
+for (const v of dirs) {
+  const ext = extname(v.name)
+  const htmlPath = resolve(v.path, v.name)
+  if (v.isFile() && ext === ".html") {
+    if (v.name !== "index.html") {
+      unlinkSync(htmlPath)
+    } else {
+      const txt = readFileSync(htmlPath, "utf8")
+      const $ = cheerio.load(txt)
+      let _tags = []
+      $("link[href]").each((i, elem) => {
+        const href = $(elem).attr("href")
+        if (isRelativeUrl(href)) {
+          const props = { ...elem.attribs }
+          props.href = prefixWithPath(href)
+          _tags.push({ elm: "link", props })
+          $(elem).remove()
+        }
+      })
+
+      $("script[src]").each((i, elem) => {
+        const src = $(elem).attr("src")
+        if (isRelativeUrl(src)) {
+          const props = { ...elem.attribs }
+          props.src = prefixWithPath(src)
+          _tags.push({ elm: "script", props })
+          $(elem).remove()
+        }
+      })
+
+      $("script").each((i, elem) => {
+        const scriptContent = $(elem).html()
+        if (scriptContent && scriptContent.includes("let tags = []")) {
+          const tagsString = JSON.stringify(_tags)
+          const updatedScriptContent = scriptContent
+            .replace(/let\s+tags\s*=\s*\[\s*\]/, `let tags = ${tagsString}`)
+            .replace(/"`/g, "`")
+            .replace(/`"/g, "`")
+          $(elem).html(updatedScriptContent)
+        }
+      })
+      const modifiedHtml = $.root().html()
+      writeFileSync(htmlPath, modifiedHtml)
+    }
+  } else if (v.isFile() && ext === ".js" && /^webpack/.test(v.name)) {
+    const txt = readFileSync(htmlPath, "utf8")
+    const x = txt.match(/(.)\.p="\/_next\/"/)[1]
+    const mod = txt.replace(
+      new RegExp(`o=${x}\.p`, "g"),
+      `o=_assetPath()+${x}.p`,
+    )
+    writeFileSync(htmlPath, mod)
+  }
+}
+
+const dirs2 = readdirSync(out, { withFileTypes: true })
+for (const v of dirs2) {
+  const htmlPath = resolve(v.path, v.name)
+  console.log(htmlPath)
+  if (v.isDirectory() && v.name !== "_next") {
+    rmdirSync(htmlPath, { recursive: true, force: true })
+  }
+}

package/app/components/Footer.js

@@ -0,0 +1,76 @@
+import { Box, Flex } from "@chakra-ui/react"
+import { Icon } from "@chakra-ui/react"
+import { FaBookOpen, FaDiscord, FaXTwitter, FaGithub } from "react-icons/fa6"
+import use from "/lib/use"
+
+export default function Footer() {
+  const [wasm64] = use("wasm64")
+  return (
+    <Flex
+      w="100%"
+      h="30px"
+      align="center"
+      px={4}
+      bg="white"
+      fontSize="12px"
+      color="#666"
+      css={{ borderTop: "1px solid #ddd" }}
+    >
+      <Box w="200px">LOCALNET v 1.0.0</Box>
+      {wasm64 ? (
+        <Flex justify="center" flex={1}>
+          Only possible on Arweave and AO
+        </Flex>
+      ) : (
+        <Flex justify="center" flex={1} color="#FF4136">
+          Wasm64 is unsupported with your browser
+        </Flex>
+      )}
+
+      <Flex justify="flex-end" w="200px">
+        <Box
+          mr={3}
+          as="a"
+          target="_blank"
+          href="https://github.com/weavedb/wao"
+        >
+          <Icon
+            size="md"
+            color="#666"
+            css={{ cursor: "pointer", _hover: { opacity: 0.75 } }}
+          >
+            <FaGithub />
+          </Icon>
+        </Box>
+
+        <Box mr={3} as="a" target="_blank" href="https://x.com/waoeco">
+          <Icon
+            size="md"
+            color="#666"
+            css={{ cursor: "pointer", _hover: { opacity: 0.75 } }}
+          >
+            <FaXTwitter />
+          </Icon>
+        </Box>
+        <Box mr={3} as="a" target="_blank" href="https://discord.gg/vCkuVhkugY">
+          <Icon
+            size="md"
+            color="#666"
+            css={{ cursor: "pointer", _hover: { opacity: 0.75 } }}
+          >
+            <FaDiscord />
+          </Icon>
+        </Box>
+        <Box as="a" target="_blank" href="https://docs.wao.eco">
+          <Icon
+            size="md"
+            color="#666"
+            css={{ cursor: "pointer", _hover: { opacity: 0.75 } }}
+          >
+            <FaBookOpen />
+          </Icon>
+        </Box>
+      </Flex>
+    </Flex>
+  )
+}