How manvendra8511/stellar-cert-project works
This repository implements a certificate registry API backed by a Soroban smart contract. A client submits certificate details or requests a lookup/verification; the API validates the request, the controller delegates to the Soroban service, and the response reflects the contract operation. The contract stores certificates persistently by student address. Health and readiness checks are separate API capabilities. The source excerpts show the backend and contract, but no README or frontend workflow; links to the external network are based on the service’s RPC calls.
Main entry points: app.js Express application · certificates.controller.js Certificate controller · health.routes.js Health routes · soroban.service.js Soroban service
Components 16
API and routing
- Express application
cert-registry-backend/src/app.js - Certificate routes
cert-registry-backend/src/routes/certificates.routes.js
Certificate operations
- Certificate controller
cert-registry-backend/src/controllers/certificates.controller.js - Issue certificate
cert-registry-backend/src/controllers/certificates.controller.js - Get certificate
cert-registry-backend/src/controllers/certificates.controller.js - Verify certificate
cert-registry-backend/src/controllers/certificates.controller.js
Stellar integration
- Soroban service
cert-registry-backend/src/services/soroban.service.js - Stellar configuration
cert-registry-backend/src/config/stellar.js - Soroban RPC
- Certificate contract
stellar-cert/src/lib.rs - Persistent storage
stellar-cert/src/lib.rs
Health and operations
- Health routes
cert-registry-backend/src/routes/health.routes.js - Error handlers
cert-registry-backend/src/middleware/errorHandler.js - Logger
cert-registry-backend/src/config/logger.js - Backend entry
cert-registry-backend/src/index.js
Other components
- API client
Connections 20
- API client → Express application: sends requests
cert-registry-backend/src/app.js - Express application → Certificate routes: routes requests
cert-registry-backend/src/app.js - Express application → Health routes: routes requests
cert-registry-backend/src/app.js - Express application → Error handlers: installs handlers
cert-registry-backend/src/app.js - Express application → Logger: logs requests
cert-registry-backend/src/app.js - Certificate routes → Certificate controller: dispatches endpoints
cert-registry-backend/src/routes/certificates.routes.js - Certificate controller → Issue certificate: implements issue
cert-registry-backend/src/controllers/certificates.controller.js - Certificate controller → Get certificate: implements lookup
cert-registry-backend/src/controllers/certificates.controller.js - Certificate controller → Verify certificate: implements verification
cert-registry-backend/src/controllers/certificates.controller.js - Certificate controller → Soroban service: calls operations
cert-registry-backend/src/controllers/certificates.controller.js - Soroban service → Stellar configuration: uses connection config
cert-registry-backend/src/services/soroban.service.js - Soroban service → Soroban RPC: simulates and submits
cert-registry-backend/src/services/soroban.service.js - Soroban RPC → Certificate contract: executes contract calls
- Certificate contract → Persistent storage: reads and writes
stellar-cert/src/lib.rs - Health routes → Stellar configuration: uses RPC client
cert-registry-backend/src/routes/health.routes.js - Health routes → Soroban RPC: checks readiness
cert-registry-backend/src/routes/health.routes.js - Health routes → Logger: logs failures
cert-registry-backend/src/routes/health.routes.js - Error handlers → Logger: logs errors
cert-registry-backend/src/middleware/errorHandler.js - Backend entry → Express application: starts server
cert-registry-backend/src/index.js - Backend entry → Stellar configuration: loads configuration
cert-registry-backend/src/index.js