Import initial sunodo project from cpp template

Generated by @sunodo/cli v0.10.4

.github/workflows/clang-format-check.yml

@@ -0,0 +1,35 @@
+################################################################################
+#
+#  Copyright (C) 2024 retro.ai
+#  This file is part of retro3 - https://github.com/retroai/retro3
+#
+#  SPDX-License-Identifier: AGPL-3.0-or-later
+#  See the file LICENSE.txt for more information.
+#
+################################################################################
+
+name: Clang Format Check
+
+on: [push, pull_request]
+
+jobs:
+  format:
+    # The type of runner that the job will run on
+    runs-on: ubuntu-22.04
+
+    defaults:
+      run:
+        # Set the working directory to src folder
+        working-directory: src
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Install Clang Format
+      run: sudo apt-get install -y clang-format-15
+
+    - name: Run Clang Format
+      run: |
+        find . -regex '.*\.\(cpp\|hpp\)' -exec clang-format-15 -style=file -i {} \;
+        git diff --exit-code --color

.gitignore

@@ -0,0 +1 @@
+/.sunodo

Dockerfile

@@ -0,0 +1,64 @@
+# syntax=docker.io/docker/dockerfile:1.4
+################################################################################
+#
+#  Copyright (C) 2024 retro.ai
+#  This file is part of retro3 - https://github.com/retroai/retro3
+#
+#  This file is derived from Sunodo under the Apache 2.0 License
+#  Copyright (C) 2023-2024 Sunodo (https://docs.sunodo.io)
+#
+#  SPDX-License-Identifier: AGPL-3.0-or-later AND Apache-2.0
+#  See the file LICENSE.txt for more information.
+#
+################################################################################
+
+#
+# builder
+#
+
+FROM --platform=linux/riscv64 riscv64/ubuntu:22.04 as builder
+
+RUN <<EOF
+set -e
+apt-get update
+apt-get install -y --no-install-recommends \
+  autoconf \
+  automake \
+  build-essential \
+  ca-certificates \
+  curl \
+  libtool \
+  wget
+rm -rf /var/lib/apt/lists/*
+EOF
+
+COPY --from=sunodo/sdk:0.2.0 /opt/riscv /opt/riscv
+WORKDIR /opt/cartesi/dapp
+COPY src/backend .
+RUN make
+
+#
+# host
+#
+
+FROM --platform=linux/riscv64 riscv64/ubuntu:22.04 as host
+
+LABEL io.sunodo.sdk_version=0.2.0
+LABEL io.cartesi.rollups.ram_size=128Mi
+
+ARG MACHINE_EMULATOR_TOOLS_VERSION=0.12.0
+RUN <<EOF
+set -e
+apt-get update
+apt-get install -y --no-install-recommends busybox-static=1:1.30.1-7ubuntu3 ca-certificates=20230311ubuntu0.22.04.1 curl=7.81.0-1ubuntu1.15
+curl -fsSL https://github.com/cartesi/machine-emulator-tools/releases/download/v${MACHINE_EMULATOR_TOOLS_VERSION}/machine-emulator-tools-v${MACHINE_EMULATOR_TOOLS_VERSION}.tar.gz \
+  | tar -C / --overwrite -xvzf -
+rm -rf /var/lib/apt/lists/*
+EOF
+
+ENV PATH="/opt/cartesi/bin:${PATH}"
+
+WORKDIR /opt/cartesi/dapp
+COPY --from=builder /opt/cartesi/dapp/dapp .
+
+ENTRYPOINT ["/opt/cartesi/dapp/dapp"]

README.md

@@ -8,10 +8,20 @@ Please note that ROMs are not included and you must obtain them yourself. Most R
 
 ## Dependencies
 
+Nodejs, Docker, Sunodo ([Sunodo Docs](https://docs.sunodo.io/guide/introduction/installing)).
+
+Sunodo is a build tool that simplifies the process of building and running Cartesi Machines. It is used to build the Cartesi Machine that runs the game emulator and the learning agent. It is also used to build the website frontend.
+
 For frontend development, the pnpm tool is also used (`npm i -g pnpm`).
 
 ## Quick Start
 
+To build the backend, run the command:
+
+```bash
+sunodo build
+```
+
 To build and run the website frontend, enter the `src/frontend/` directory and use standard pnpm commands:
 
 ```bash

src/.clang-format

@@ -0,0 +1,92 @@
+---
+# BasedOnStyle:  LLVM
+AccessModifierOffset: -2
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+AlignEscapedNewlines: DontAlign
+AlignOperands:   true
+AlignTrailingComments: false
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: InlineOnly
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: true
+BinPackArguments: true
+BinPackParameters: false
+BreakBeforeBinaryOperators: None
+BreakBeforeBraces: Allman
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: false
+BreakConstructorInitializers: BeforeColon
+BreakAfterJavaFieldAnnotations: false
+BreakStringLiterals: true
+ColumnLimit:     100
+CommentPragmas:  '^ IWYU pragma:'
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+ConstructorInitializerIndentWidth: 2
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DerivePointerAlignment: false
+DisableFormat:   false
+ExperimentalAutoDetectBinPacking: false
+ForEachMacros:   [ foreach, Q_FOREACH, BOOST_FOREACH ]
+IncludeBlocks: Regroup
+IncludeCategories:
+  - Regex:           '<EGL/.*\.h>'
+    Priority:        6
+  - Regex:           '(["/]PlatformDefs|"(system|system_gl|system_egl))\.h"'
+    Priority:        5
+  - Regex:           '"platform/[^/]+/'
+    Priority:        2
+  - Regex:           '^<[a-z0-9_]+>$'
+    Priority:        3
+  - Regex:           '^<(assert|complex|ctype|errno|fenv|float|inttypes|iso646|limits|locale|math|setjmp|signal|stdalign|stdarg|stdatomic|stdbool|stddef|stdint|stdio|stdlib|stdnoreturn|string|tgmath|threads|time|uchar|wchar|wctype)\.h>$'
+    Priority:        3
+  - Regex:           '^<'
+    Priority:        4
+  - Regex:           '.*'
+    Priority:        1
+IncludeIsMainRegex: '$'
+IndentCaseLabels: true
+IndentWidth:     2
+IndentWrappedFunctionNames: false
+JavaScriptQuotes: Leave
+JavaScriptWrapImports: true
+KeepEmptyLinesAtTheStartOfBlocks: true
+MacroBlockBegin: ''
+MacroBlockEnd:   ''
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+ObjCBlockIndentWidth: 2
+ObjCSpaceAfterProperty: false
+ObjCSpaceBeforeProtocolList: true
+PenaltyBreakBeforeFirstCallParameter: 19
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 60000
+PointerAlignment: Left
+ReflowComments:  false
+SortIncludes:    true
+SpaceAfterCStyleCast: false
+SpaceAfterTemplateKeyword: false
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeParens: ControlStatements
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles:  false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+Standard:        Cpp11
+TabWidth:        8
+UseTab:          Never
+...

src/backend/.gitignore

@@ -0,0 +1,2 @@
+# Build files
+/dapp

src/backend/Makefile

@@ -0,0 +1,22 @@
+################################################################################
+#
+#  Copyright (C) 2024 retro.ai
+#  This file is part of retro3 - https://github.com/retroai/retro3
+#
+#  This file is derived from Sunodo under the Apache 2.0 License
+#  Copyright (C) 2023-2024 Sunodo (https://docs.sunodo.io)
+#
+#  SPDX-License-Identifier: AGPL-3.0-or-later AND Apache-2.0
+#  See the file LICENSE.txt for more information.
+#
+################################################################################
+
+CXX  := g++
+
+.PHONY: clean
+
+dapp: dapp.cpp
+	$(CXX) -pthread -std=c++17 -I /opt/riscv/kernel/work/linux-headers/include -o $@ $^
+
+clean:
+	@rm -rf dapp