1 ¿Qué es microwd.online?

microwd.online es un servicio de certificación documental que utiliza la blockchain de Stellar para registrar la existencia de un documento en un momento concreto del tiempo, sin revelar su contenido.

La plataforma:

• Recibe un fichero (texto, PDF, imagen, cualquiera).
• Calcula su hash SHA-256 (una huella digital única de 64 caracteres hexadecimales).
• Escribe ese hash en la blockchain de Stellar mediante una operación manage_data.
• Devuelve un comprobante con el hash de la transacción, el ledger donde quedó grabado y enlaces de verificación pública.

2 Conceptos básicos de Stellar

2.1 Hash SHA-256

Un hash es el resultado de pasar cualquier cantidad de datos por una función matemática que produce una cadena de 64 caracteres hexadecimales. Dos documentos idénticos producen el mismo hash; dos documentos distintos producen hashes distintos. El hash no revela el contenido original ni permite reconstruirlo.

# Ejemplo: generar un hash en Linux / macOS / WSL
$ echo -n "microwd online stellar" | sha256sum
3c2e8f5a...

2.2 Operación manage_data

En Stellar, una cuenta puede almacenar pares clave-valor en su ledger. La clave es el hash SHA-256 del documento; el valor es la fecha/hora UTC del registro. Estas entradas son inmutables: una vez escritas, no se pueden modificar.

2.3 Cuentas Stellar

La plataforma mantiene 3 cuentas Stellar en pubnet (red principal). Por cada documento nuevo, se selecciona una cuenta en round-robin con failover automático si una cuenta no tiene fondos suficientes (mínimo 5 XLM de reserva).

3 Registrar un documento

3.1 Desde la web

3.2 Desde la línea de comandos

curl -X POST https://www.microwd.online/api/register.php \
  -H "X-API-Key: TU_CLAVE_API" \
  -F "file=@documento.txt"

O usando HTTP Basic Auth con credenciales de usuario:

curl -X POST https://www.microwd.online/api/register.php \
  -u "usuario@email.com:contraseña" \
  --data-binary @documento.txt

3.3 Idempotencia

Registrar el mismo documento dos veces no crea una segunda transacción. El sistema detecta el hash duplicado (primero en base de datos, luego en la blockchain) y devuelve la información de la transacción original con el campo "already_registered": true.

4 Verificar un documento

La verificación puede hacerse de tres formas distintas:

4.1 Por fichero (POST /api/verify.php)

Se envía el fichero completo. El servidor calcula el hash, lo busca en la blockchain y responde si está registrado o no.

curl -X POST https://www.microwd.online/api/verify.php \
  -H "X-API-Key: TU_CLAVE_API" \
  -F "file=@documento_sospechoso.pdf"

4.2 Por hash (GET /api/verify.php?hash=...)

Si ya conoces el hash SHA-256 del documento, puedes consultarlo directamente:

curl https://www.microwd.online/api/verify.php?hash=3c2e8f5a... \
  -H "X-API-Key: TU_CLAVE_API"

4.3 Desde la web

En verificar.php tienes tres pestañas: Archivo (subir fichero), Texto (pegar contenido) y Hash (escribir el hash directamente).

4.4 Verificación pública (sin API)

Cualquier persona puede verificar un registro sin necesidad de credenciales, directamente en la blockchain:

https://horizon.stellar.org/accounts/GATEKT3J.../data/3c2e8f5a...

El enlace verify_data_url que devuelve la API apunta exactamente a esta consulta Horizon. Si el hash está registrado, Horizon devuelve la fecha/hora del registro.

5 Autenticación en la API

La API acepta dos métodos de autenticación simultáneamente:

5.1 Rate limiting

Cada autenticación tiene su propio límite de peticiones por minuto: Admin: 30 req/min. Usuario: 30 req/min por usuario. Alta de usuarios: 5 req/min por IP. Si se excede, la API responde 429 Too Many Requests con un header Retry-After.

6 Gestión de usuarios

6.1 Alta de usuario (auto-servicio)

Cualquier persona puede solicitar un usuario en alta-usuarios.php. Necesita:

• Un email válido.
• Una contraseña de al menos 8 caracteres.
• El código de autorización que proporciona el administrador del sistema.

Los usuarios se crean inactivos por defecto. Un administrador debe activarlos manualmente antes de que puedan usar la API.

6.2 Activación / desactivación / borrado

El administrador gestiona los usuarios desde:

• Web: admin.php → pestaña Usuarios → botones Activar / Desactivar / Borrar.
• API: POST /api/admin/users.php?mode=toggle_active&user_id=X&activo=1

6.3 Seguridad de contraseñas

• Las contraseñas se almacenan con bcrypt (coste 10, algoritmo estándar).
• La comparación en login usa hash_equals() para prevenir timing attacks.
• El hash de la contraseña nunca sale de la función de autenticación; no se devuelve en respuestas JSON.

7 Panel de administración

Accede en admin.php con la X-API-Key de administrador. El panel tiene dos pestañas:

7.1 Operaciones

Lista filtrable de todas las acciones registradas en tblAccion. Puedes filtrar por:

• Acción: register_submitted, verify_hash, register_error, admin_user_created, etc.
• Aceptado: sí/no (operaciones exitosas vs denegadas).
• Hash SHA-256 o Transaction Hash de Stellar.
• Cuenta origen (G…), Rango de fechas, Orden (ASC/DESC).

7.2 Usuarios

Lista de usuarios con filtro por email y estado (activo/inactivo). Acciones disponibles: Activar, Desactivar y Borrar.

8 Uso programático de la API

8.1 Endpoints disponibles

8.2 Ejemplo: integración en JavaScript

const API_KEY = 'tu-clave-admin';

async function registrar(file) {
  const form = new FormData();
  form.append('file', file);

  const res = await fetch(
    'https://www.microwd.online/api/register.php',
    { method: 'POST', headers: { 'X-API-Key': API_KEY }, body: form }
  );
  return res.json();
}

8.3 Ejemplo: verificar en Python

import requests, hashlib

def verificar_archivo(path, api_key):
    with open(path, 'rb') as f:
        content = f.read()
    h = hashlib.sha256(content).hexdigest()

    resp = requests.get(
        'https://www.microwd.online/api/verify.php',
        params={'hash': h},
        headers={'X-API-Key': api_key},
    )
    return resp.json()

8.4 Formato de respuesta

Todas las respuestas incluyen al menos:

{
  "success": true | false,
  "error":   "mensaje si success=false",
  "code":    "código de error"
}

En caso de registro exitoso, se añaden hash, tx_hash, ledger, source_account, created_at y las URLs de verificación.

9 Monitorización y estado

9.1 Panel de estado

La página estado.php muestra (sin necesidad de autenticación):

• Salud: si Horizon (la API de Stellar) está accesible.
• Cuentas: balance XLM, número de secuencia, entradas de datos registradas, enlace al explorer.
• Actividad: conteo total y últimas 24h de registros, verificaciones y errores.

9.2 Monitor de saldos

Un script programado (balance_monitor.ps1) se ejecuta cada día a las 08:00. Si alguna cuenta Stellar baja de 10 XLM, escribe una alerta en ACTIONS/MONITOR/. Revisa ese directorio periódicamente o configura una alerta por correo.

9.3 Health check para uptime

curl https://www.microwd.online/api/health.php
# Respuesta: {"ok":true,"service":"microwd.online","ts":"2026-06-20T08:00:00Z"}

Ideal para servicios como UptimeRobot, Better Uptime o Healthchecks.io.

10 Preguntas frecuentes

11 Documentación

La documentación completa de la plataforma está disponible en formato Markdown (.md) para su consulta sin conexión.

11.1 Descargar documentación

11.2 Guia rapida (Agil)

La pagina Agil muestra una guia paso a paso para registrar y verificar documentos, con enlaces directos a las paginas y URLs de la blockchain. Es la version HTML del fichero MicroWD_Steps.txt.

11.3 Visor de Markdown gratuito

Para visualizar el documento con formato, se recomienda la aplicación gratuita: