WEB3 OAuth API

API tipo OAuth para autenticar usuarios con wallets de web3, con soporte para validaciones en testnet y mainnet.

Requisitos

• Node.js 18+
• MongoDB
• Redis
• Acceso a nodos RPC de web3 (testnet y mainnet)

Instalación

1. Clona el repositorio:

   git clone <repositorio>
   cd web3-oauth-api
   

2. Instala las dependencias:

   npm install
   

3. Configura las variables de entorno en .env PORT=3000 MONGO_URI=mongodb://mongodb:27017/web3-oauth REDIS_URI=redis://redis:6379 SOLANA_TESTNET_RPC=https://api.testnet.solana.com SOLANA_MAINNET_RPC=https://api.mainnet-beta.solana.com JWT_SECRET=tu-secreto-jwt-aqui

4. Inicia el servidor: npm start

Testing y Desarrollo

Servidor de Testing

El proyecto incluye un servidor de testing que valida balances reales de tokens en Solana (mainnet/testnet):

1. Inicia el servidor de testing:

   npm run test:server

   Esto arrancará el servidor en http://localhost:3001

2. Inicia el cliente de ejemplo:

   cd client-example
   node serve-client.js

   El cliente web estará disponible en http://localhost:8080

3. Conecta tu wallet Phantom para probar la autenticación con balances reales

Nota Importante: El servidor de testing ahora consulta balances reales de tokens desde Solana RPC. Los balances mostrados son los valores reales de tu wallet, con conversión correcta de decimales.

Ejecutar Tests

npm test                # Ejecutar todos los tests
npm run test:watch      # Ejecutar tests en modo watch

Uso con Docker

1. Construye y ejecuta los contenedores:

2. Accede a la API en http://localhost:3000.

Endpoints POST /api/register: Registrar un desarrollador y obtener apiKey y apiSecret. POST /api/authenticate: Autenticar un usuario con su wallet de web3. POST /api/refresh: Refrescar un access token. POST /api/verify: Verificar un access token. POST /api/revoke: Revocar un refresh token.