feat: add fuelnaut game

.gitignore

@@ -26,6 +26,7 @@
 # misc
 .DS_Store
 *.pem
+.fuels/
 
 # debug
 npm-debug.log*

.vscode/settings.json

@@ -1,6 +1,5 @@
 {
   "editor.defaultFormatter": "biomejs.biome",
-  "editor.formatOnSave": true,
   "editor.codeActionsOnSave": {
     "source.organizeImports.biome": "explicit"
   },

biome.json

@@ -74,7 +74,8 @@
       "dist",
       "**/node_modules",
       "pnpm-lock.yaml",
-      "./next.config.js"
+      "./next.config.js",
+      "src/fuelnaut-api"
     ]
   }
 }

docs/guides/docs/fuelnaut/coin-flip.mdx

@@ -0,0 +1,21 @@
+---
+title: Coin Flip
+category: Fuelnaut
+parent:
+  label: All Guides
+  link: /guides
+---
+
+# Coin Flip
+
+<FuelnautLevel
+description="To beat this level, you'll need to guess the coin flip correctly 10 times"
+level={props.level}
+bytecode={props.bytecode}
+abiJSON={props.abiJSON}
+/>
+
+<CodeImport
+  file="../../examples/fuelnaut/coin-flip/src/main.sw"
+  lang="sway"
+/>

docs/guides/docs/fuelnaut/hello-world.mdx

@@ -0,0 +1,31 @@
+---
+title: Hello World
+category: Fuelnaut
+parent:
+  label: All Guides
+  link: /guides
+---
+
+# Hello World
+
+<FuelnautLevel
+description="This level will guide you through how to play the Fuelnaut game."
+level={props.level}
+bytecode={props.bytecode}
+abiJSON={props.abiJSON}
+>
+<List type="ordered" css={{mb: '$4'}}>
+    <List.Item>Download the [Fuel Wallet](https://chromewebstore.google.com/detail/fuel-wallet/dldjpboieedgcmpkchcjcbijingjcgok) extension, setup an account, and use the "Faucet" button to get some testnet funds.</List.Item>
+    <List.Item>Press the "Connect Your Wallet" button below to connect your wallet if you haven't already.</List.Item>
+    <List.Item>Open up the developer console in your browser window. You can play the game from here! Try typing in `help()` in the console to see a full list of helper variables and functions.</List.Item>
+    <List.Item>Click the "Deploy New Instance" button to deploy a new instance of the level contract. Note: you will have to approve 2 transactions for this to work!</List.Item>
+    <List.Item>Take a look at the level contract. To beat a level in the game, you'll need to make sure the `attack_success` function returns `true`. For this level, you'll have to call the `hello_world` function to set the `value` variable in the storage block to `true`.</List.Item>
+    <List.Item>In the developer console, use the `instance` variable to call the `hello_world` function. (Hint: take a look at the `fuels` TypeScript [docs](/docs/fuels-ts/contracts/)). </List.Item>
+    <List.Item>Once you think you've beat the level, click the "Check If Completed" button to confirm.</List.Item>
+</List>
+</FuelnautLevel>
+
+<CodeImport
+  file="../../examples/fuelnaut/hello-world/src/main.sw"
+  lang="sway"
+/>

docs/guides/docs/fuelnaut/index.mdx

@@ -0,0 +1,15 @@
+---
+title: Fuelnaut
+category: Fuelnaut
+parent:
+  label: All Guides
+  link: /guides
+---
+
+# The Fuelnaut
+
+The Fuelnaut is security-focused smart contract game inspired by [The Ethernaut](https://ethernaut.openzeppelin.com/).
+
+The game is designed to teach players about potential security vulnerabilities while building in the Sway language.
+
+<FuelnautCards />

docs/guides/docs/fuelnaut/payback.mdx

@@ -0,0 +1,21 @@
+---
+title: Payback
+category: Fuelnaut
+parent:
+  label: All Guides
+  link: /guides
+---
+
+# Payback
+
+<FuelnautLevel
+description="To beat this level, you'll need to trick the contract into sending you all its funds."
+level={props.level}
+bytecode={props.bytecode}
+abiJSON={props.abiJSON}
+/>
+
+<CodeImport
+  file="../../examples/fuelnaut/payback/src/main.sw"
+  lang="sway"
+/>

docs/guides/docs/fuelnaut/vault.mdx

@@ -0,0 +1,23 @@
+---
+title: Vault
+category: Fuelnaut
+parent:
+  label: All Guides
+  link: /guides
+---
+
+# Vault
+
+🚧 Under Construction 🚧
+
+<FuelnautLevel
+description="To beat this level, you'll need to correctly guess the vault password."
+level={props.level}
+bytecode={props.bytecode}
+abiJSON={props.abiJSON}
+/>
+
+<CodeImport
+  file="../../examples/fuelnaut/vault/src/main.sw"
+  lang="sway"
+/>

docs/guides/docs/guides.json

@@ -35,6 +35,12 @@
     "featured": false,
     "tags": ["fuel-core"]
   },
+  "fuelnaut": {
+    "title": "Fuelnaut",
+    "description": "Play The Fuelnaut: a security-focused smart contract game",
+    "featured": false,
+    "tags": []
+  },
   "installation": {
     "title": "Toolchain Installation",
     "description": "Install the Fuel toolchain and binaries.",

docs/guides/docs/nav.json

@@ -7,5 +7,6 @@
   "running_a_node": ["Running a Local Node", "Running a Testnet Node"],
   "migration_guide": ["Breaking Changes Log"],
   "intro_to_sway": ["Introduction to Sway", "Prerequisites", "Imports", "Structs", "ABI", "Storage", "Errors", "Functions", "Checkpoint", "Rust Testing", "Typescript Frontend", "Explore Fuel"],
-  "intro_to_predicates": ["Introduction to Sway", "Prerequisites", "Predicate Root", "Predicate Limitations", "Imports", "Configurables", "Signature Verification", "Main", "Checkpoint", "Debugging with Scripts", "Logging in Rust tests", "Rust Testing"]
+  "intro_to_predicates": ["Introduction to Sway", "Prerequisites", "Predicate Root", "Predicate Limitations", "Imports", "Configurables", "Signature Verification", "Main", "Checkpoint", "Debugging with Scripts", "Logging in Rust tests", "Rust Testing"],
+  "fuelnaut": ["Hello World", "Payback", "Coin Flip", "Vault"]
 }

docs/guides/examples/fuelnaut/.gitignore

@@ -0,0 +1,2 @@
+*/out/deployments
+target

docs/guides/examples/fuelnaut/Forc.lock

@@ -0,0 +1,45 @@
+[[package]]
+name = "coin-flip"
+source = "member"
+dependencies = ["std"]
+
+[[package]]
+name = "core"
+source = "path+from-root-E19CE48B3E858B72"
+
+[[package]]
+name = "fuelnaut"
+source = "member"
+dependencies = [
+    "standards",
+    "std",
+    "sway_libs",
+]
+
+[[package]]
+name = "payback"
+source = "member"
+dependencies = ["std"]
+
+[[package]]
+name = "standards"
+source = "git+https://github.com/FuelLabs/sway-standards?tag=v0.5.0#348f7175df4c012b23c86cdb18aab79025ca1f18"
+dependencies = ["std"]
+
+[[package]]
+name = "std"
+source = "git+https://github.com/fuellabs/sway?tag=v0.60.0#2f0392ee35a1e4dd80bd8034962d5b4083dfb8b6"
+dependencies = ["core"]
+
+[[package]]
+name = "sway_libs"
+source = "git+https://github.com/FuelLabs/sway-libs?tag=v0.22.0#172adbbcc36e561a56c5820209445f86f0856bfc"
+dependencies = [
+    "standards",
+    "std",
+]
+
+[[package]]
+name = "vault"
+source = "member"
+dependencies = ["std"]

docs/guides/examples/fuelnaut/Forc.toml

@@ -0,0 +1,2 @@
+[workspace]
+members = ["fuelnaut-contract", "coin-flip", "payback", "vault"]