Blockchain Cert

Certificador de documentos on-chain sobre Polygon Amoy Testnet. El proyecto actual funciona como un MVP funcional para certificar documentos (texto o archivos), calcular su hash SHA-256, registrarlo en un smart contract Solidity y conservar el historial en PostgreSQL.

Estado actual del proyecto

El repositorio ya incluye una implementación end-to-end con las siguientes capacidades:

• Certificación de texto y archivos desde el frontend.
• Cálculo del hash SHA-256 en el navegador antes de enviarlo al backend.
• Registro on-chain a través de un contrato desplegado en Polygon Amoy.
• Verificación pública por hash desde la interfaz y por URL directa.
• Consulta pública de documentos por identificador único desde /consultar/:codigo.
• Generación de identificadores únicos por tipo de documento (CBC-TIPO-00001-2026).
• Párrafo predefinido de autenticidad generado automáticamente para incluir en el documento.
• Vinculación entre identificador y certificación en blockchain.
• Historial de certificaciones persistido en PostgreSQL con acciones rápidas.
• Generación de stickers PDF con QR para compartir la verificación.
• Documentación de la API con Swagger.

Este estado lo posiciona como un MVP funcional, aunque aún quedan mejoras de producto y seguridad para una versión más robusta.

¿Por qué blockchain?

El valor del proyecto no es solo técnico, sino también filosófico: una vez que el hash de un documento queda registrado en una blockchain pública, nadie puede alterarlo ni antedatarlo, ni siquiera el administrador del sistema. Cualquier persona puede verificar la autenticidad de un documento sin depender de una autoridad central.

Arquitectura

Frontend (Angular) → Backend (Node.js/Express) → Smart Contract (Solidity/Polygon Amoy)
↓
PostgreSQL (historial + identificadores)

Capa	Tecnología
Frontend	Angular 21, SCSS
Backend	Node.js, Express, TypeScript
Base de datos	PostgreSQL 15
Blockchain	Solidity 0.8.28, Hardhat, ethers.js v6
Red	Polygon Amoy Testnet (Chain ID: 80002)
Contenedores	Docker, Docker Compose

Funcionalidades implementadas

• Certificación de documentos desde una interfaz web moderna.
• Soporte para texto y archivos (PDF, DOCX, imágenes, etc.).
• Previsualización del hash SHA-256 calculado antes de certificar.
• Verificación de un documento por hash desde la app o por URL directa.
• Generación de identificadores únicos por tipo de documento (CBC-TIPO-00001-2026).
• Párrafo predefinido de autenticidad con instrucciones para incluir en el documento antes de certificar.
• Consulta pública de documentos certificados por identificador.
• Historial con acciones rápidas: verificar, ver en Polygonscan y descargar sticker.
• Descarga de un sticker PDF con QR y datos resumidos del certificado.
• API REST documentada con Swagger.

Smart Contract

Campo	Valor
Contrato	CertificadorDocumentos.sol
Red	Polygon Amoy Testnet
Address	0xA73F1BB8668e30558CC77F9d937104a58Cc64CA0
Verificado	Sourcify
Explorador	Polygonscan Amoy

Funciones del contrato

• certificar(hashDoc, descripcion): registra el hash on-chain y rechaza documentos ya certificados.
• verificar(hashDoc): consulta si un hash existe y devuelve metadatos como quién lo registró y cuándo.

Estructura del proyecto

├── backend # API REST Node.js/Express
│ └── src
│ │ ├── config # PostgreSQL, ethers.js, Swagger
│ │ ├── controllers
│ │ ├── database
│ │ │ └── migrations
│ │ ├── models
│ │ └── routes
│ ├── Dockerfile # Imagen Docker del backend
│ └── docker-compose.yml # Orquestación de servicios: backend y PostgreSQL
├── contracts # Smart contracts Solidity + Hardhat
│ ├── contracts # CertificadorDocumentos.sol
│ ├── ignition # Módulos de despliegue
│ │ ├── deployments
│ │ └── modules
│ ├── scripts
│ └── test # Tests unitarios con Mocha
└── frontend # Angular 21
├── public
└── src
└── app
├── components # certificar, historial, identificador, verificar
│ ├── certificar
│ ├── historial
│ ├── identificador
│ └── verificar
└── services

Requisitos

• Node.js v22 LTS
• npm
• Docker y Docker Compose
• Una wallet con fondos en Polygon Amoy para emitir transacciones reales
• nvm (recomendado)

Correr localmente

1. Clonar el repositorio

git clone https://github.com/git-devtest/blockchain-cert.git
cd blockchain-cert

2. Configurar variables de entorno del backend

cd backend
cp .env.example .env

Editar el archivo .env con tus credenciales:

PORT=3000DB_PASSWORD=tu_passwordDATABASE_URL=postgresql://admin:tu_password@localhost:5434/blockchain_certAMOY_RPC_URL=https://polygon-amoy.drpc.orgAMOY_PRIVATE_KEY=tu_private_key_de_metamaskCONTRACT_ADDRESS=0xA73F1BB8668e30558CC77F9d937104a58Cc64CA0

3. Levantar todo el proyecto

Desde la raíz del repositorio:

npm install
npm run dev

Esto levanta backend + PostgreSQL en Docker y el frontend Angular simultáneamente con logs diferenciados por color.

• Frontend: http://localhost:4200
• API docs: http://localhost:3000/api-docs
• Health check: http://localhost:3000/health

El endpoint /health valida conectividad con la base de datos y con la red Polygon Amoy:

{
"status": "ok",
"timestamp": "2026-06-26T04:24:12.878Z",
"servicios": {
"api": "ok",
"database": "ok",
"blockchain": "ok"
}
}

Aplicar cambios en el backend

El backend corre dentro de un contenedor Docker. El código se copia a la imagen en el momento del build, por lo tanto los cambios en backend/src no se reflejan automáticamente.

Si modificas el backend, reconstruye la imagen antes de levantar de nuevo:

cd backend
docker compose build
cd ..
npm run dev

Los cambios en el frontend (Angular) sí se reflejan en caliente sin pasos adicionales.

Endpoints principales

Certificaciones

• POST /api/certificar
• GET /api/verificar/:hash
• GET /api/certificaciones

Identificadores

• GET /api/identificadores/tipos
• POST /api/identificadores/generar
• GET /api/identificadores/consultar/:codigo

Flujos de uso

Flujo directo (sin identificador)

1. El usuario escribe texto o sube un archivo.
2. El frontend calcula el SHA-256 en el navegador.
3. El hash se envía al backend.
4. El backend llama al smart contract certificar() en Polygon Amoy.
5. La transacción queda confirmada on-chain.
6. El hash y la metadata se guardan en PostgreSQL para consultas rápidas.
7. El usuario recibe el hash de la transacción y puede descargar un sticker PDF.

Flujo con identificador

1. El usuario genera un identificador desde la sección Identificador seleccionando el tipo de documento.
2. Copia el código (CBC-TIPO-00001-2026) y lo agrega en la esquina superior derecha del documento.
3. Copia el párrafo predefinido de autenticidad y lo agrega al pie de página del documento.
4. Guarda el documento como PDF.
5. Va a Certificar, sube el PDF, llena la descripción e ingresa el identificador en el campo opcional.
6. Cualquier persona puede consultar el documento en /consultar/:codigo sin necesidad del hash.

Verificación de documentos

Por hash

Cualquier persona puede verificar un documento sin usar esta aplicación:

1. Calcular el SHA-256 del documento.
2. Consultar directamente el contrato en Polygonscan: https://amoy.polygonscan.com/address/0xA73F1BB8668e30558CC77F9d937104a58Cc64CA0
3. Llamar a la función verificar con el hash.

Por identificador

Si el documento fue certificado con un identificador, cualquier persona puede consultarlo en: http://localhost:4200/consultar/CBC-TIPO-00001-2026

La página muestra la información en lenguaje simple para usuarios no técnicos, con enlace directo a Polygonscan para verificación independiente.

Próximos pasos sugeridos

• Mejorar la experiencia de wallet y manejo de errores en la red.
• Añadir autenticación de usuarios y roles.
• Ampliar la cobertura de tests en frontend, backend y contratos.
• Añadir soporte para más redes y despliegues productivos.
• Mejorar el proceso de verificación pública con enlaces más legibles y compartibles.

Tests

cd contracts
npx hardhat test

Licencia

MIT