Merge branch 'docs/feat/browser-sdk'

Author: GuillemGarciaDev

docs/docs/concepts/architecture_custom_backend.md

@@ -1 +1,7 @@
 # Custom backend
+
+:::caution
+
+This page is under construction.
+
+:::

docs/docs/concepts/auth0.md

@@ -1 +1,7 @@
 # Auth0
+
+:::caution
+
+This page is under construction.
+
+:::

docs/docs/concepts/getting-started.md

@@ -2,14 +2,6 @@
 
 FastAuth is a NEAR Protocol authentication system that enables secure transaction signing through Multi-Party Computation (MPC) and JWT-based verification.
 
-## Key Components
-
-**FastAuth Contract** - Main entry point that manages guards and coordinates MPC signing
-
-**JwtGuardRouter** - Routes JWT verification to appropriate guard contracts
-
-**Auth0Guard** - Verifies Auth0-issued JWT tokens using RS256
-
 ## Quick Start
 
 1. Review the [Architecture Overview](./architecture_overview.md)

docs/docs/integrations/auth0.md

@@ -1 +1,7 @@
-# Integrate with Auth0
+# Auth0
+
+:::caution
+
+This page is under construction.
+
+:::

docs/docs/integrations/custom-backend-express.md

@@ -0,0 +1,111 @@
+# Express
+
+# Integrate your custom backend
+
+This guide shows how to build a custom backend that generates JWT tokens for FastAuth transaction signing using Express.js.
+
+## Prerequisites
+
+- Node.js and npm/pnpm installed
+- RSA key pair for JWT signing
+
+## Step 1: Generate RSA Key Pair
+
+```bash
+# Generate private key
+openssl genrsa -out jwtRS256.key 2048
+
+# Generate public key
+openssl rsa -in jwtRS256.key -pubout -out jwtRS256.pub
+```
+
+## Step 2: Install Dependencies
+
+```bash
+npm install express jsonwebtoken
+npm install -D @types/express @types/jsonwebtoken @types/node typescript
+```
+
+## Step 3: Create the Express Server
+
+```typescript
+import { Request, Response } from "express";
+import express from "express";
+import jwt from "jsonwebtoken";
+import * as fs from "node:fs";
+import { createPublicKey } from "crypto";
+
+const app = express();
+const PORT = 3000;
+const JWT_ISSUER = "https://fa-custom-backend.com";
+const JWT_SUBJECT = "user+1@fa-custom-backend.com";
+```
+
+## Step 4: Create JWT Generation Endpoint
+
+```typescript
+app.get("/jwt", (_: Request, response: Response) => {
+    // Your transaction payload (hex-encoded)
+    const SIGNING_PAYLOAD = Buffer.from("Hello world").toString("hex");
+
+    const token = jwt.sign(
+        { fatxn: SIGNING_PAYLOAD }, // FastAuth transaction claim
+        { key: fs.readFileSync("./jwtRS256.key") },
+        {
+            expiresIn: "1h",
+            algorithm: "RS256",
+            issuer: JWT_ISSUER,
+            subject: JWT_SUBJECT,
+        },
+    );
+
+    response.status(200).send(token);
+});
+```
+
+## Step 5: Start Server and Extract Public Key
+
+```typescript
+app.listen(PORT, () => {
+    console.log("Server running at PORT: ", PORT);
+    console.log("Jwt issuer: ", JWT_ISSUER);
+
+    // Extract public key components for contract configuration
+    const publicKey = createPublicKey(fs.readFileSync("./jwtRS256.pub"));
+    const jwk = publicKey.export({ format: "jwk" });
+
+    console.log("Jwt public key [n]: ", jwk.n);
+    console.log("Jwt public key [e]: ", jwk.e);
+}).on("error", (error: Error) => {
+    throw new Error(error.message);
+});
+```
+
+## Step 6: Run the Server
+
+```bash
+# Compile TypeScript
+npx tsc index.ts
+
+# Run the server
+node index.js
+```
+
+## Step 7: Test JWT Generation
+
+```bash
+# Get JWT token
+curl http://localhost:3000/jwt
+```
+
+## Next Steps
+
+1. Customize the `SIGNING_PAYLOAD` with your actual transaction data
+2. Implement user authentication before JWT generation
+3. Deploy your [JwtRS256Guard contract](./jwt-rs256-guard) with your custom jwt verification logic
+4. Register your guard in the JwtGuardRouter contract
+5. Test your integration with the FastAuth contract
+
+## Code
+
+You can find the complete code in the [examples](https://github.com/Peersyst/fast-auth/tree/main/examples/custom-backend) folder.

docs/docs/integrations/custom-backend.md

@@ -1 +1,7 @@
-# Integrate your custom backend
+# Custom Backend
+
+:::caution
+
+This page is under construction.
+
+:::

docs/docs/integrations/dapp.md

@@ -0,0 +1,7 @@
+# JwtRS256Guard contract
+
+:::caution
+
+This page is under construction.
+
+:::

docs/docs/integrations/getting-started.md

@@ -0,0 +1,21 @@
+# Overview
+
+FastAuth provides multiple integration options to suit different application architectures and authentication needs. Choose the integration type that best fits your use case:
+
+## Auth0 Integration
+
+Integrate with Auth0 to leverage their authentication infrastructure for secure JWT-based authentication. This integration provides a seamless login experience and handles JWT token generation and validation for your users.
+
+[Learn more about Auth0 integration →](./auth0.md)
+
+## Custom Backend Integration
+
+Build your own authentication backend with full control over the JWT signing and validation process. This integration gives you the flexibility to implement custom authentication logic while still benefiting from FastAuth's transaction signing capabilities.
+
+[Learn more about Custom Backend integration →](./custom-backend.md)
+
+## Next Steps
+
+1. Choose the integration type that matches your needs
+2. Follow the specific integration guide for detailed implementation steps
+3. Check out the [examples](https://github.com/Peersyst/fast-auth/tree/main/examples) for reference implementations