From a8d7c9042296532e0f7ffd20b90fd21fa4c733dc Mon Sep 17 00:00:00 2001
From: thomscoder <moyelysian@icloud.com>
Date: Sat, 5 Nov 2022 09:27:26 +0100
Subject: [PATCH 1/2] feat: runtime implementation

---
 example/index.html           |   1 +
 example/js/index.js          |  25 ++--
 package.json                 |   3 +
 pnpm-lock.yaml               | 230 +++++++++++++++++++++++++++++++++
 runtime/README.md            |  49 ++++++--
 runtime/example/example.js   |  13 ++
 runtime/example/main.wat     |   6 +
 runtime/helpers/reader.js    |  27 ++++
 runtime/index.js             |  10 ++
 runtime/package.json         |  13 ++
 runtime/runtime/ast.js       |  28 +++++
 runtime/runtime/invoker.js   |  24 ++++
 runtime/runtime/parser.js    | 238 +++++++++++++++++++++++++++++++++++
 runtime/runtime/processor.js |  40 ++++++
 runtime/runtime/start.js     |  13 ++
 runtime/utils/defaults.js    |  48 +++++++
 runtime/utils/errors.js      |  16 +++
 runtime/utils/types.js       |  17 +++
 18 files changed, 780 insertions(+), 21 deletions(-)
 create mode 100644 runtime/example/example.js
 create mode 100644 runtime/example/main.wat
 create mode 100644 runtime/helpers/reader.js
 create mode 100644 runtime/index.js
 create mode 100644 runtime/package.json
 create mode 100644 runtime/runtime/ast.js
 create mode 100644 runtime/runtime/invoker.js
 create mode 100644 runtime/runtime/parser.js
 create mode 100644 runtime/runtime/processor.js
 create mode 100644 runtime/runtime/start.js
 create mode 100644 runtime/utils/defaults.js
 create mode 100644 runtime/utils/errors.js
 create mode 100644 runtime/utils/types.js

diff --git a/example/index.html b/example/index.html
index 7161a61..df2a62f 100644
--- a/example/index.html
+++ b/example/index.html
@@ -38,6 +38,7 @@ <h1>Luna</h1>
         </div>
         <div id="btn-result-container"><button id="btn">Result</button></div>
         <div id="result"></div>
+        <div id="result-aeon"></div>
       </div>
     </div>
     <!-- 
diff --git a/example/js/index.js b/example/js/index.js
index 1fe5d6e..1125e52 100644
--- a/example/js/index.js
+++ b/example/js/index.js
@@ -1,3 +1,5 @@
+import startAeonRuntime from '../dist/bundle.js';
+
 const go = new Go(); // Defined in wasm_exec.js. Don't forget to add this in your index.html.
 
 
@@ -48,6 +50,7 @@ const runLunaAddition = async () => {
   const btn = document.getElementById('btn')
 
   const res = document.getElementById('result');
+  const aeonRes = document.getElementById('result-aeon');
 
 
   btn.setAttribute('disabled', true)
@@ -60,11 +63,11 @@ const runLunaAddition = async () => {
 `
 
 
-    const editor = CodeMirror(codeContainer, {
-      value: input,
-      mode:  "wast",
-      lineNumbers: true,
-    });
+  const editor = CodeMirror(codeContainer, {
+    value: input,
+    mode:  "wast",
+    lineNumbers: true,
+  });
 
   compile.addEventListener('click', async () => {
     moduleContainer.innerHTML = ""
@@ -88,19 +91,25 @@ const runLunaAddition = async () => {
       btn.addEventListener('click', () => {
         const n1 = Number(input1.value);
         const n2 = Number(input2.value)
-        console.log("n", input1.value)
-        console.log("n", input2.value)
         // Call Luna add function
         res.innerHTML = "Result: " 
         res.innerHTML += wasmer.instance.exports[fn](n1, n2)
 
+      // ---------------------------------------------------------------------------------------
+      // ---------------------------------------------------------------------------------------
+      // ------------------------------RUN IT WITH AEON RUNTIME---------------------------------
+      // ---------------------------------------------------------------------------------------
+      // ---------------------------------------------------------------------------------------
+      const funcName = fn.replace(/"/g, '');
+
+      const result = startAeonRuntime(_wasm, funcName, n1, n2);
+      aeonRes.innerHTML = `Ran with Aeon: ${result}`
       })
     } catch (err) {
       btn.setAttribute('disabled', true)
       moduleContainer.innerHTML = String(err);
     }
 
-    
   })
   
 };
diff --git a/package.json b/package.json
index 57fbda3..3af17d0 100644
--- a/package.json
+++ b/package.json
@@ -6,6 +6,8 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "build": "rimraf ./dist && make compile",
+    "start:runtime": "node ./runtime/index.js",
+    "bundle": "rimraf ./example/dist && esbuild ./runtime/runtime/start.js --bundle --outfile=./example/dist/bundle.js --format=esm",
     "commit": "cz"
   },
   "keywords": [],
@@ -13,6 +15,7 @@
   "license": "ISC",
   "devDependencies": {
     "commitizen": "^4.2.5",
+    "esbuild": "^0.15.13",
     "rimraf": "^3.0.2"
   }
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 6839fcc..5d1cede 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -2,10 +2,12 @@ lockfileVersion: 5.4
 
 specifiers:
   commitizen: ^4.2.5
+  esbuild: ^0.15.13
   rimraf: ^3.0.2
 
 devDependencies:
   commitizen: 4.2.5
+  esbuild: 0.15.13
   rimraf: 3.0.2
 
 packages:
@@ -101,6 +103,24 @@ packages:
     dev: true
     optional: true
 
+  /@esbuild/android-arm/0.15.13:
+    resolution: {integrity: sha512-RY2fVI8O0iFUNvZirXaQ1vMvK0xhCcl0gqRj74Z6yEiO1zAUa7hbsdwZM1kzqbxHK7LFyMizipfXT3JME+12Hw==}
+    engines: {node: '>=12'}
+    cpu: [arm]
+    os: [android]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-loong64/0.15.13:
+    resolution: {integrity: sha512-+BoyIm4I8uJmH/QDIH0fu7MG0AEx9OXEDXnqptXCwKOlOqZiS4iraH1Nr7/ObLMokW3sOCeBNyD68ATcV9b9Ag==}
+    engines: {node: '>=12'}
+    cpu: [loong64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
   /@jridgewell/resolve-uri/3.1.0:
     resolution: {integrity: sha512-F2msla3tad+Mfht5cJq7LSXcdudKTWCVYUgw6pLFOOHSTtZlj6SWNYAp+AhuqLmWdBO2X5hPrLcu8cVP8fy28w==}
     engines: {node: '>=6.0.0'}
@@ -440,6 +460,216 @@ packages:
     dev: true
     optional: true
 
+  /esbuild-android-64/0.15.13:
+    resolution: {integrity: sha512-yRorukXBlokwTip+Sy4MYskLhJsO0Kn0/Fj43s1krVblfwP+hMD37a4Wmg139GEsMLl+vh8WXp2mq/cTA9J97g==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [android]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-android-arm64/0.15.13:
+    resolution: {integrity: sha512-TKzyymLD6PiVeyYa4c5wdPw87BeAiTXNtK6amWUcXZxkV51gOk5u5qzmDaYSwiWeecSNHamFsaFjLoi32QR5/w==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [android]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-darwin-64/0.15.13:
+    resolution: {integrity: sha512-WAx7c2DaOS6CrRcoYCgXgkXDliLnFv3pQLV6GeW1YcGEZq2Gnl8s9Pg7ahValZkpOa0iE/ojRVQ87sbUhF1Cbg==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [darwin]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-darwin-arm64/0.15.13:
+    resolution: {integrity: sha512-U6jFsPfSSxC3V1CLiQqwvDuj3GGrtQNB3P3nNC3+q99EKf94UGpsG9l4CQ83zBs1NHrk1rtCSYT0+KfK5LsD8A==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [darwin]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-freebsd-64/0.15.13:
+    resolution: {integrity: sha512-whItJgDiOXaDG/idy75qqevIpZjnReZkMGCgQaBWZuKHoElDJC1rh7MpoUgupMcdfOd+PgdEwNQW9DAE6i8wyA==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [freebsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-freebsd-arm64/0.15.13:
+    resolution: {integrity: sha512-6pCSWt8mLUbPtygv7cufV0sZLeylaMwS5Fznj6Rsx9G2AJJsAjQ9ifA+0rQEIg7DwJmi9it+WjzNTEAzzdoM3Q==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [freebsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-linux-32/0.15.13:
+    resolution: {integrity: sha512-VbZdWOEdrJiYApm2kkxoTOgsoCO1krBZ3quHdYk3g3ivWaMwNIVPIfEE0f0XQQ0u5pJtBsnk2/7OPiCFIPOe/w==}
+    engines: {node: '>=12'}
+    cpu: [ia32]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-linux-64/0.15.13:
+    resolution: {integrity: sha512-rXmnArVNio6yANSqDQlIO4WiP+Cv7+9EuAHNnag7rByAqFVuRusLbGi2697A5dFPNXoO//IiogVwi3AdcfPC6A==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-linux-arm/0.15.13:
+    resolution: {integrity: sha512-Ac6LpfmJO8WhCMQmO253xX2IU2B3wPDbl4IvR0hnqcPrdfCaUa2j/lLMGTjmQ4W5JsJIdHEdW12dG8lFS0MbxQ==}
+    engines: {node: '>=12'}
+    cpu: [arm]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-linux-arm64/0.15.13:
+    resolution: {integrity: sha512-alEMGU4Z+d17U7KQQw2IV8tQycO6T+rOrgW8OS22Ua25x6kHxoG6Ngry6Aq6uranC+pNWNMB6aHFPh7aTQdORQ==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-linux-mips64le/0.15.13:
+    resolution: {integrity: sha512-47PgmyYEu+yN5rD/MbwS6DxP2FSGPo4Uxg5LwIdxTiyGC2XKwHhHyW7YYEDlSuXLQXEdTO7mYe8zQ74czP7W8A==}
+    engines: {node: '>=12'}
+    cpu: [mips64el]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-linux-ppc64le/0.15.13:
+    resolution: {integrity: sha512-z6n28h2+PC1Ayle9DjKoBRcx/4cxHoOa2e689e2aDJSaKug3jXcQw7mM+GLg+9ydYoNzj8QxNL8ihOv/OnezhA==}
+    engines: {node: '>=12'}
+    cpu: [ppc64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-linux-riscv64/0.15.13:
+    resolution: {integrity: sha512-+Lu4zuuXuQhgLUGyZloWCqTslcCAjMZH1k3Xc9MSEJEpEFdpsSU0sRDXAnk18FKOfEjhu4YMGaykx9xjtpA6ow==}
+    engines: {node: '>=12'}
+    cpu: [riscv64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-linux-s390x/0.15.13:
+    resolution: {integrity: sha512-BMeXRljruf7J0TMxD5CIXS65y7puiZkAh+s4XFV9qy16SxOuMhxhVIXYLnbdfLrsYGFzx7U9mcdpFWkkvy/Uag==}
+    engines: {node: '>=12'}
+    cpu: [s390x]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-netbsd-64/0.15.13:
+    resolution: {integrity: sha512-EHj9QZOTel581JPj7UO3xYbltFTYnHy+SIqJVq6yd3KkCrsHRbapiPb0Lx3EOOtybBEE9EyqbmfW1NlSDsSzvQ==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [netbsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-openbsd-64/0.15.13:
+    resolution: {integrity: sha512-nkuDlIjF/sfUhfx8SKq0+U+Fgx5K9JcPq1mUodnxI0x4kBdCv46rOGWbuJ6eof2n3wdoCLccOoJAbg9ba/bT2w==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [openbsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-sunos-64/0.15.13:
+    resolution: {integrity: sha512-jVeu2GfxZQ++6lRdY43CS0Tm/r4WuQQ0Pdsrxbw+aOrHQPHV0+LNOLnvbN28M7BSUGnJnHkHm2HozGgNGyeIRw==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [sunos]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-windows-32/0.15.13:
+    resolution: {integrity: sha512-XoF2iBf0wnqo16SDq+aDGi/+QbaLFpkiRarPVssMh9KYbFNCqPLlGAWwDvxEVz+ywX6Si37J2AKm+AXq1kC0JA==}
+    engines: {node: '>=12'}
+    cpu: [ia32]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-windows-64/0.15.13:
+    resolution: {integrity: sha512-Et6htEfGycjDrtqb2ng6nT+baesZPYQIW+HUEHK4D1ncggNrDNk3yoboYQ5KtiVrw/JaDMNttz8rrPubV/fvPQ==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild-windows-arm64/0.15.13:
+    resolution: {integrity: sha512-3bv7tqntThQC9SWLRouMDmZnlOukBhOCTlkzNqzGCmrkCJI7io5LLjwJBOVY6kOUlIvdxbooNZwjtBvj+7uuVg==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /esbuild/0.15.13:
+    resolution: {integrity: sha512-Cu3SC84oyzzhrK/YyN4iEVy2jZu5t2fz66HEOShHURcjSkOSAVL8C/gfUT+lDJxkVHpg8GZ10DD0rMHRPqMFaQ==}
+    engines: {node: '>=12'}
+    hasBin: true
+    requiresBuild: true
+    optionalDependencies:
+      '@esbuild/android-arm': 0.15.13
+      '@esbuild/linux-loong64': 0.15.13
+      esbuild-android-64: 0.15.13
+      esbuild-android-arm64: 0.15.13
+      esbuild-darwin-64: 0.15.13
+      esbuild-darwin-arm64: 0.15.13
+      esbuild-freebsd-64: 0.15.13
+      esbuild-freebsd-arm64: 0.15.13
+      esbuild-linux-32: 0.15.13
+      esbuild-linux-64: 0.15.13
+      esbuild-linux-arm: 0.15.13
+      esbuild-linux-arm64: 0.15.13
+      esbuild-linux-mips64le: 0.15.13
+      esbuild-linux-ppc64le: 0.15.13
+      esbuild-linux-riscv64: 0.15.13
+      esbuild-linux-s390x: 0.15.13
+      esbuild-netbsd-64: 0.15.13
+      esbuild-openbsd-64: 0.15.13
+      esbuild-sunos-64: 0.15.13
+      esbuild-windows-32: 0.15.13
+      esbuild-windows-64: 0.15.13
+      esbuild-windows-arm64: 0.15.13
+    dev: true
+
   /escape-string-regexp/1.0.5:
     resolution: {integrity: sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==}
     engines: {node: '>=0.8.0'}
diff --git a/runtime/README.md b/runtime/README.md
index b6e48fe..61d87cf 100644
--- a/runtime/README.md
+++ b/runtime/README.md
@@ -1,24 +1,47 @@
-# Aeon Runtime
+# Aeon - A runtime for Luna ⏳✨
 
-Aeon will be a separate project (repository) and once done it'll get imported in Luna.
+Aeon is an extremely tiny, but easy to use WebAssembly runtime, built for demonstration and educational purposes.
+It is so tiny that supports only additions, subtractions and i32 integers. 
 
-Aeon is a really minimal WASM runtime built for demonstration and educational purposes.
+It is part of the <a href="https://github.com/thomscoder/luna" target="_blank">Luna</a> project, so they integrate very very well.
+Its purpose is to give an high-level overview of how to build a custom WebAssembly runtime.
 
-It is so tiny that can only handle `ì32` functions.
+It is by no means a replacement for runtimes like <a href="https://wasmer.io/">Wasmer</a> or <a href="https://github.com/bytecodealliance/wasmtime">Wasmtime</a>, it is just a tool that aims to serve as a `landmark` for anyone that wants to start learning Wasm.
 
-# How?
+Hence, I tried to document it as much as I could!
 
-The runtime will be divide in three parts:
+# How to use❓
+Aeon was built with Luna in mind and they travel together so whatever Luna can compile, Aeon can run.
+ - Pass the Wasm binary compiled by <a href="https://luna-demo.vercel.app/" target="_blank">Luna</a>, the function name and parameters to the main function.
+ - Done (you should see the result)
 
-- <strong>A parser</strong> for the WASM binary that will output an AST (Abstract Syntax Tree). The parser will run a check against all the sections
+ (Check the `./example/example.js`)
 
-- <strong>An executor</strong> of the code in the WASM binary that will implement a stack 
-> remember WebAssembly's stack machine concept
+ ```js
+const startAeonRuntime = require("./runtime/start");
+ // This binary 
+ // - takes 3 parameters of type `i32` (3, 127, 127, 127) 
+ // - outputs one `i32` result (1, 127)
+ // - exports a function called "addNumbers" (12, 34, 97, 100, 100, 78, 117, 109, 98, 101, 114, 115, 34)
+ // - that adds them all (0, 32, 0, 32, 1, 32, 2, 106, 11)
+const wasmBinary = new Uint8Array([0, 97, 115, 109, 1, 0, 0, 0, 1, 8, 1, 96, 3, 127, 127, 127, 1, 127, 3, 2, 1, 0, 7, 16, 1, 12, 34, 97, 100, 100, 78, 117, 109, 98, 101, 114, 115, 34, 0, 0, 10, 9, 1, 7, 0, 32, 0, 32, 1, 32, 2, 106, 11]);
 
-- <strong>A processor</strong> where the instructions (e.g. `i32.add`) will take place
+const n1 = 8;
+const n2 = 20;
+const n3 = 23;
 
-# Contributing
+const result = startAeonRuntime(wasmBinary, "addNumbers", n1, n2, n3);
+console.log(`${n1} + ${n2} + ${n3} =`, result) // prints 51
+ ```
 
-Aeon is still under development, but if you want to contribute to either one of these two projects, feel free to share your thoughts and code!!!
+# Roadmap
+- `Optimizations` it is not very optimized yet - (as I'm learning too)
+- `Support more wasm feature` currently it supports only additions and i32 integers, but it makes it easy to add more features
 
-Any feedback is greatly appreciated.
+# Contribute
+Both Aeon and Luna are infants.
+There are tons and tons of feature they could implement. I try to keep them as much basic as possible as they should serve as a learning playground rather than making competition to other tools.
+
+If you have any suggestion, feedback or want to add features, feel free to open issues, pull requests or fork the project.
+Turn it into a npm package, embed it in your next project, build beautiful tutorials...
+Aeon will be able (in the near future) to be open to all the possibilities to teach Web Assembly.  
\ No newline at end of file
diff --git a/runtime/example/example.js b/runtime/example/example.js
new file mode 100644
index 0000000..7d146fc
--- /dev/null
+++ b/runtime/example/example.js
@@ -0,0 +1,13 @@
+import startAeonRuntime from "../runtime/start.js";
+
+// Compile the ./main.wat file with https://luna-demo.vercel.app
+// Get the hex dump from either the middle div or the console
+
+// The below example 
+// - exports aeonAddition
+// - takes two parameters (i32)
+// - performs an addition (i32)
+const wasmBinary = new Uint8Array([0, 97, 115, 109, 1, 0, 0, 0, 1, 7, 1, 96, 2, 127, 127, 1, 127, 3, 2, 1, 0, 7, 18, 1, 14, 34, 97, 101, 111, 110, 65, 100, 100, 105, 116, 105, 111, 110, 34, 0, 0, 10, 9, 1, 7, 0, 32, 0, 32, 1, 106, 11]);
+
+const result = startAeonRuntime(wasmBinary, "aeonAddition", 2, 3)
+console.log("Result", result) // prints 5
\ No newline at end of file
diff --git a/runtime/example/main.wat b/runtime/example/main.wat
new file mode 100644
index 0000000..11ef6ba
--- /dev/null
+++ b/runtime/example/main.wat
@@ -0,0 +1,6 @@
+(module
+  (func (export "aeonAddition") (param i32) (param i32) (result i32)
+    local.get 0
+    local.get 1
+    i32.add)
+)
\ No newline at end of file
diff --git a/runtime/helpers/reader.js b/runtime/helpers/reader.js
new file mode 100644
index 0000000..221e274
--- /dev/null
+++ b/runtime/helpers/reader.js
@@ -0,0 +1,27 @@
+
+export default class WasmReader {
+  constructor(wasm) {
+      this.data = wasm;
+      this.pos = 0;
+  }
+
+  dword() {
+      let prev = this.pos;
+      this.pos += 4;
+      const arr = this.data.slice(prev, this.pos);
+      return arr
+  }
+
+  readBytes(num) {
+      let prev = this.pos;
+      this.pos += num;
+
+      return this.data.slice(prev, this.pos);
+  }
+
+  readByte() {
+      let prev = this.pos;
+      this.pos += 1;
+      return this.data[prev];
+  }
+}
diff --git a/runtime/index.js b/runtime/index.js
new file mode 100644
index 0000000..4e9f167
--- /dev/null
+++ b/runtime/index.js
@@ -0,0 +1,10 @@
+import startAeonRuntime from "./runtime/start.js";
+
+const wasmBinary = new Uint8Array([0, 97, 115, 109, 1, 0, 0, 0, 1, 8, 1, 96, 3, 127, 127, 127, 1, 127, 3, 2, 1, 0, 7, 16, 1, 12, 34, 97, 100, 100, 78, 117, 109, 98, 101, 114, 115, 34, 0, 0, 10, 9, 1, 7, 0, 32, 0, 32, 1, 32, 2, 106, 11]);
+
+const n1 = 8;
+const n2 = 20;
+const n3 = 23;
+
+const result = startAeonRuntime(wasmBinary, "addNumbers", n1, n2, n3);
+console.log(`${n1} + ${n2} + ${n3} =`, result)
\ No newline at end of file
diff --git a/runtime/package.json b/runtime/package.json
new file mode 100644
index 0000000..bf2a550
--- /dev/null
+++ b/runtime/package.json
@@ -0,0 +1,13 @@
+{
+  "name": "runtime",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC"
+}
diff --git a/runtime/runtime/ast.js b/runtime/runtime/ast.js
new file mode 100644
index 0000000..d74f8d1
--- /dev/null
+++ b/runtime/runtime/ast.js
@@ -0,0 +1,28 @@
+import WasmReader from "../helpers/reader.js";
+import { parseExportSection, parseTypeSection, parseFunctionSection, parseCodeSection, checkHeader } from "./parser.js";
+
+
+// we create an AST of the parsed module
+export function createAST(wasmBinary) {
+  const wasm = new WasmReader(wasmBinary);
+  checkHeader(wasm);
+  //console.log("headers", headers);
+  const typeSection = parseTypeSection(wasm);
+  //console.log("typeSection", typeSection);
+  const functionTypes = parseFunctionSection(wasm);
+  //console.log(functionTypes)
+  const exportSection = parseExportSection(wasm);
+  //console.log("exportSection", exportSection)
+  const codeSection = parseCodeSection(wasm);
+  //console.log("codeSection", codeSection)
+
+  const moduleAst = {
+      typeSection,
+      functionTypes,
+      exportSection,
+      codeSection,
+  }
+
+  //console.log("Module", moduleAst)
+  return moduleAst;
+}
diff --git a/runtime/runtime/invoker.js b/runtime/runtime/invoker.js
new file mode 100644
index 0000000..c0fbb6f
--- /dev/null
+++ b/runtime/runtime/invoker.js
@@ -0,0 +1,24 @@
+import { RuntimeErrors } from '../utils/errors.js';
+import Processor from './processor.js';
+
+// we need to call the exported function(s)
+export function invokeFunction(ast, funcName, params) {
+  // we search if the export name does exists
+  // if not we throw an error
+  let exportIndex = ast.exportSection.findIndex(exp => exp.name === funcName);
+  if (exportIndex === -1) throw new Error(RuntimeErrors.ExportNotFound);
+
+  // Get the exported function's body
+  let func = ast.codeSection[exportIndex];
+  // Check if the number of parameters of the exported function
+  // corresponds to the number of provided parameters
+  if (ast.typeSection[exportIndex][0].length !== params.length) {
+      throw new Error(RuntimeErrors.InvalidArgumentsNumber);
+  }
+
+  // execute the function
+  const processor = new Processor(func, params);
+  processor.executeFunc();
+
+  return processor.getResult();
+}
\ No newline at end of file
diff --git a/runtime/runtime/parser.js b/runtime/runtime/parser.js
new file mode 100644
index 0000000..8cfa53d
--- /dev/null
+++ b/runtime/runtime/parser.js
@@ -0,0 +1,238 @@
+import { Section, ExportSection, Opcodes } from "../utils/defaults.js";
+import { RuntimeErrors } from "../utils/errors.js";
+import { ValType } from "../utils/types.js";
+
+// I'm creating a very basic AST https://en.wikipedia.org/wiki/Abstract_syntax_tree
+// from the wasm binary
+// If you do not come from Luna https://github.com/thomscoder/luna,
+// our final wasm binary resembles this
+
+// 0000000: 0061 736d                                 ; WASM_BINARY_MAGIC
+// 0000004: 0100 0000                                 ; WASM_BINARY_VERSION
+// ; section "Type" (1)
+// 0000008: 01                                        ; section code
+// 0000009: 00                                        ; section size (guess)
+// 000000a: 01                                        ; num types
+// ; func type 0
+// 000000b: 60                                        ; func
+// 000000c: 02                                        ; num params
+// 000000d: 7f                                        ; i32
+// 000000e: 7f                                        ; i32
+// 000000f: 01                                        ; num results
+// 0000010: 7f                                        ; i32
+// 0000009: 07                                        ; FIXUP section size
+// ; section "Function" (3)
+// 0000011: 03                                        ; section code
+// 0000012: 00                                        ; section size (guess)
+// 0000013: 01                                        ; num functions
+// 0000014: 00                                        ; function 0 signature index
+// 0000012: 02                                        ; FIXUP section size
+// ; section "Export" (7)
+// 0000015: 07                                        ; section code
+// 0000016: 00                                        ; section size (guess)
+// 0000017: 01                                        ; num exports
+// 0000018: 06                                        ; string length
+// 0000019: 6164 6454 776f                           addTwo  ; export name
+// 000001f: 00                                        ; export kind
+// 0000020: 00                                        ; export func index
+// 0000016: 0a                                        ; FIXUP section size
+// ; section "Code" (10)
+// 0000021: 0a                                        ; section code
+// 0000022: 00                                        ; section size (guess)
+// 0000023: 01                                        ; num functions
+// ; function body 0
+// 0000024: 00                                        ; func body size (guess)
+// 0000025: 00                                        ; local decl count
+// 0000026: 20                                        ; local.get
+// 0000027: 00                                        ; local index
+// 0000028: 20                                        ; local.get
+// 0000029: 01                                        ; local index
+// 000002a: 6a                                        ; i32.add
+// 000002b: 0b                                        ; end
+// 0000024: 07                                        ; FIXUP func body size
+// 0000022: 09                                        ; FIXUP section size
+// ; section "name"
+// 000002c: 00                                        ; section code
+// 000002d: 00                                        ; section size (guess)
+// 000002e: 04                                        ; string length
+// 000002f: 6e61 6d65                                name  ; custom section name
+// 0000033: 02                                        ; local name type
+// 0000034: 00                                        ; subsection size (guess)
+// 0000035: 01                                        ; num functions
+// 0000036: 00                                        ; function index
+// 0000037: 00                                        ; num locals
+// 0000034: 03                                        ; FIXUP subsection size
+// 000002d: 0a                                        ; FIXUP section size
+
+
+// if you need a refresher on modules
+// see https://webassembly.github.io/spec/core/binary/modules.html
+
+// IMPORTANT - I created a `wasmParser` helper function to
+// keep track of our position in the binary
+
+
+// We parse and check the headers (MAGIC and VERSION)
+export function checkHeader(wasm) {
+    if (wasm.data.length < 8) {
+        throw new Error(RuntimeErrors.ModuleTooShort);
+    }
+
+    if (wasm.data.length == 8) {
+        throw new Error(RuntimeErrors.ModuleIsEmpty)
+    };
+
+    const magicString = String.fromCharCode(...wasm.readBytes(4));
+    if (magicString !== "\0asm") {
+        throw new Error(RuntimeErrors.InvalidMagicHeader);
+    }
+
+    const version = wasm.dword();
+    if (version.length < 1) {
+        throw new Error(RuntimeErrors.InvalidVersionHeader);
+    }
+
+    return true;
+}
+
+// For every section in the parser we check:
+// - if the section is valid
+// - the section's size 
+// - the number, type or the number of types of the content inside the section
+
+// We parse and check the type section
+// See https://webassembly.github.io/spec/core/binary/modules.html#type-section
+export function parseTypeSection(wasm) {
+    
+    const sectionType = wasm.readByte();
+    if (sectionType !== Section.type) {
+        throw new Error(RuntimeErrors.InvalidSection);
+    }
+
+    // helper function to map the valType (right now accepts only i32)
+    function parseValueType(wasm) {
+        const valType = wasm.readByte();
+
+        switch (valType) {
+            case ValType.i32:
+                return ValType.i32;
+            default:
+                throw new Error(RuntimeErrors.InvalidValueType);
+        }
+    }
+    
+    let sizeOfSection = wasm.readByte();
+    const numTypes = wasm.readByte();
+    let types = [];
+
+    for (let i = 0; i < numTypes; i++) {
+        let func = wasm.readByte();
+
+        let numOfParams = wasm.readByte();
+        let params = [];
+        for (let j = 0; j < numOfParams; j++) {
+            params.push(parseValueType(wasm))
+        }
+
+        let numOfResults = wasm.readByte();
+        let results = [];
+        for (let w = 0; w < numOfResults; w++) {
+            results.push(parseValueType(wasm))
+        }
+        types.push([params, results])
+    }
+
+    return types;
+}
+
+// we parse the function section (3)
+// See https://webassembly.github.io/spec/core/binary/modules.html#function-section
+export function parseFunctionSection(wasm) {
+    const isSectionFunc = wasm.readByte()
+    if (isSectionFunc !== Section.func) {
+        throw new Error(RuntimeErrors.InvalidSection);
+    }
+
+    let sectionSize = wasm.readByte();
+    // number of functions
+    let numberOfFunctions = wasm.readByte();
+    // Index of the function aka the position
+    let functionSigIndex = [];
+
+    for (let i = 0; i < numberOfFunctions; i++) {
+        functionSigIndex.push(wasm.readByte())
+    }
+
+    return functionSigIndex;
+}
+
+// We parse export section
+// See https://webassembly.github.io/spec/core/binary/modules.html#export-section
+export function parseExportSection(wasm) {
+    const isExportSection = wasm.readByte();
+    if (isExportSection !== Section.export) {
+        throw new Error(RuntimeErrors.InvalidSection);
+    }
+
+    let sectionSize = wasm.readByte();
+    // How many exports in the module (we only have one)
+    let numberOfExports = wasm.readByte();
+    let exportsArr = [];
+
+    for (let i = 0; i < numberOfExports; i++) {
+        // we get the exported name
+        const exportNameLength = wasm.readByte();
+        const exportName = String.fromCharCode(...wasm.readBytes(exportNameLength));
+
+        if (!!exportName === false) throw new Error(RuntimeErrors.InvalidExportName);
+        // export kind
+        let zero = wasm.readByte();
+        // Index of the exported function
+        let indexOfExportedFunction = (wasm.readByte() == ExportSection.func) && ExportSection.func;
+        
+        if (typeof indexOfExportedFunction !== 'number' && !!indexOfExportedFunction === false) {
+            throw new Error(RuntimeErrors.InvalidExportType)
+        }
+     
+        exportsArr.push({name: exportName.replace(/"/g, ""), index: indexOfExportedFunction})
+    }
+
+    return exportsArr;
+}
+
+// we parse the code section
+// See https://webassembly.github.io/spec/core/binary/modules.html#code-section
+export function parseCodeSection(wasm) {
+    const isCodeSection = wasm.readByte();
+
+    
+    if (isCodeSection !== Section.code) {
+        throw new Error(RuntimeErrors.InvalidSection);
+    } 
+    
+    let sectionSize = wasm.readByte();
+    let numberOfFunctions = wasm.readByte();
+    let code = [];
+    
+    
+    for (let i = 0; i < numberOfFunctions; i++) {
+        let funcBodySize = wasm.readByte();
+        let numberOfLocals = wasm.readByte();
+
+        let instructions = [];
+        let locals = [];
+        
+        while (wasm.pos < wasm.data.length) {
+            const instruction = wasm.readByte();
+            
+            instructions.push(instruction)
+            
+            if (instruction == Opcodes.get_local) {
+                locals.push(wasm.readByte())
+            }
+        } 
+        code.push([locals, instructions]);
+    }
+
+    return code
+}
diff --git a/runtime/runtime/processor.js b/runtime/runtime/processor.js
new file mode 100644
index 0000000..da4e97e
--- /dev/null
+++ b/runtime/runtime/processor.js
@@ -0,0 +1,40 @@
+import { Opcodes } from "../utils/defaults.js";
+
+// The processor executes the exported function
+export default class Processor {
+  constructor(func, params) {
+    this.func = func;
+    this.params = params;
+    this.stack = [];
+  }
+
+  executeFunc() {
+    for (const instruction of this.func[1]) {
+      if (instruction == Opcodes.get_local) {
+        this.stack.push(this.params[this.func[0].shift()]);
+      }
+      
+      this.#parseInstruction(instruction)
+    }
+  }
+
+  #parseInstruction(instruction) {
+    let result;
+
+    // We Array.prototype.reduce because we do not know in advance
+    // how many parameters are there
+    switch(instruction) {
+      case Opcodes.i32_add:
+        result = this.stack.reduce((prev, current) => prev + current, 0);
+        return this.stack.push(result);
+
+      case Opcodes.i32_sub:
+        result = this.stack.reduce((prev, current) => prev - current);
+        return this.stack.push(result);
+    }
+  } 
+
+  getResult() {
+    return this.stack.pop()
+  }
+}
\ No newline at end of file
diff --git a/runtime/runtime/start.js b/runtime/runtime/start.js
new file mode 100644
index 0000000..d830926
--- /dev/null
+++ b/runtime/runtime/start.js
@@ -0,0 +1,13 @@
+import { createAST } from "./ast.js";
+import { invokeFunction } from "./invoker.js";
+
+const startAeonRuntime = (wasm, ...args) => {
+    const ast = createAST(wasm);
+    const [funcName, ...rest] = args;
+    const params = rest;
+
+    const result = invokeFunction(ast, funcName, params);
+    return result;
+}
+
+export default startAeonRuntime;
\ No newline at end of file
diff --git a/runtime/utils/defaults.js b/runtime/utils/defaults.js
new file mode 100644
index 0000000..ea0a6a3
--- /dev/null
+++ b/runtime/utils/defaults.js
@@ -0,0 +1,48 @@
+export const MAGIC   = [0x00, 0x61, 0x73, 0x6d]
+export const VERSION = [0x01, 0x00, 0x00, 0x00]
+
+export const Opcodes = {
+	// unreachable = 0x00
+	block       : 0x02,
+	loop        : 0x03,
+	br          : 0x0c,
+	br_if       : 0x0d,
+	end         : 0x0b,
+	call        : 0x10,
+	get_local   : 0x20,
+	set_local   : 0x21,
+	i32_store_8 : 0x3a,
+	i32_const   : 0x41,
+	f32_const   : 0x43,
+	i32_eqz     : 0x45,
+	i32_eq      : 0x46,
+	f32_eq      : 0x5b,
+	f32_lt      : 0x5d,
+	f32_gt      : 0x5e,
+	i32_and     : 0x71,
+	i32_add     : 0x6a,
+	i32_sub 		: 0x6b,
+	f32_add     : 0x92,
+	f32_sub     : 0x93,
+	f32_mul     : 0x94,
+	f32_div     : 0x95,
+}
+
+export const Section = {
+	custom: 0x00,
+	type:   0x01,
+	import: 0x02,
+	func:   0x03,
+	table:  0x04,
+	memory: 0x05,
+	global: 0x06,
+	export: 0x07,
+	code:   0xa,
+}
+
+export const ExportSection = {
+	func:   0x00,
+	table:  0x01,
+	mem:    0x02,
+	global: 0x03,
+}
diff --git a/runtime/utils/errors.js b/runtime/utils/errors.js
new file mode 100644
index 0000000..81a1ad2
--- /dev/null
+++ b/runtime/utils/errors.js
@@ -0,0 +1,16 @@
+const RuntimeErrors = {
+  ModuleIsEmpty: "Module is empty",
+  ModuleTooShort: "Module is too short",
+  InvalidMagicHeader: "Invalid magic header",
+  InvalidVersionHeader: "Invalid version header",
+  InvalidSection: "Invalid section",
+  InvalidValueType: "Invalid value type",
+  InvalidExportType: "Invalid export type",
+  InvalidExportName: "Invalid export name",
+  InvalidInstruction: "Invalid instruction",
+  InvalidArgumentsNumber: "Invalid number of arguments",
+  ExportNotFound: "Export not found",
+}
+
+const _RuntimeErrors = RuntimeErrors;
+export { _RuntimeErrors as RuntimeErrors };
\ No newline at end of file
diff --git a/runtime/utils/types.js b/runtime/utils/types.js
new file mode 100644
index 0000000..4f4fb00
--- /dev/null
+++ b/runtime/utils/types.js
@@ -0,0 +1,17 @@
+export const NumTypes = {
+	i32: 0x7f,
+	i64: 0x7e,
+	f32: 0x7d,
+	f64: 0x7c,
+}
+
+export const V128 = 0x7b
+
+export const FuncType = 0x60
+
+export const ValType = {
+	i32: 0x7f,
+	i64: 0x7e,
+	f32: 0x7d,
+	f64: 0x7c,
+}

From cf993d120283b4e3887ed4e5c8da6a50929faab9 Mon Sep 17 00:00:00 2001
From: thomscoder <moyelysian@icloud.com>
Date: Sat, 5 Nov 2022 09:37:28 +0100
Subject: [PATCH 2/2] exclude for stats

---
 .gitattributes | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 .gitattributes

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..30d7884
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+runtime/** linguist-vendored
\ No newline at end of file