doc: web3 auth

docs/.vitepress/config.js

@@ -124,6 +124,13 @@ const migrationMenu = [{
   ]
 }]
 
+const web3Menu = [{
+  text: 'Web3',
+  collapsed: false,
+  items: [
+    { text: "Authentification with wallet", link: "/web3/auth" }
+  ]
+}]
 
 const guideMenu = [{
   text: 'Quick Start',
@@ -203,6 +210,7 @@ const guideMenu = [{
     { text: "Create Unit Tests", link: "/guide/unit-test" },
   ]
 },
+...web3Menu,
 ...migrationMenu
 ]
 
@@ -276,6 +284,7 @@ module.exports = {
       '/advanced/': guideMenu,
       '/plugins/': pluginMenu,
       '/migration/': guideMenu,
+      '/web3/': guideMenu,
     },
     plugins: ['@vuepress/active-header-links'],
     head: [

docs/web3/auth.md

@@ -0,0 +1,79 @@
+# Authentification Integrating Web3 into RPGJS
+
+::: warning
+The module is not complete. Further developments are in progress
+:::
+
+## Overview
+
+By following this guide, you'll be able to connect to a digital wallet like MetaMask and implement Web3 capabilities both on the client and server sides.
+
+### Prerequisites
+- Basic knowledge of RPGJS
+- Familiarity with Web3 concepts
+- MetaMask or similar digital wallet installed
+
+## Frontend Integration
+
+### Customization
+You are free to customize the frontend as per your needs. However, an example is provided here for guidance.
+
+### Example:
+
+https://github.com/RSamaium/RPG-JS/tree/v4/packages/sample3
+
+## Server-Side Integration
+
+### Installation
+
+Install the `@rpgjs/web3` plugin:
+
+```bash
+npx rpgjs add @rpgjs/web3
+```
+
+Ensure that the `@rpgjs/web3` module is the first in the list:
+
+Example:
+```toml
+modules = [
+    '@rpgjs/web3',
+    './main',
+    '@rpgjs/default-gui',
+]
+```
+
+### Setting up Configuration
+
+Add the following configurations:
+
+```toml
+[auth]
+    jwtSecret = 'mysecret'
+
+[express.cors]
+    origin = '$ENV:VITE_GAME_URL'
+    credentials = true
+
+[express.socketIo.cors]
+    origin = '$ENV:VITE_GAME_URL'
+    credentials = true
+
+[socketIoClient]
+    withCredentials = true
+```
+
+## Usage
+
+### Endpoints
+The integration introduces two endpoints:
+
+- `SERVER_URL + '/nonce'`
+- `SERVER_URL + '/verify'`
+
+These endpoints help in creating an HTTP-only cookie containing a JWT (JSON Web Token).
+
+### API Utilization
+This integration extends the `RpgPlayer` type with Web3 functionalities:
+
+- `player.web3.walletAddress`: Allows access to the player's wallet address.