Blockchain DApp Development with AWS

Aduraleke faith Akintade

Completed work

DevOps Engineer

Golang

React Native

Terraform

Cryptocurrency & Blockchain

Blockchain-DApp

This is a decentralized application with a complete infrastructure setup on AWS.

Key Technology Choices

The project uses a modern technology stack carefully selected for performance, scalability, and developer productivity:

Frontend: React + React Native for unified web and mobile development

Backend: Golang for high-performance blockchain operations

Database: PostgreSQL for ACID-compliant ledger entries

Infrastructure: EKS (Kubernetes) for container orchestration

Infrastructure as Code: Terraform for reproducible environments

Card Services: Stripe Issuing / Marqeta for card issuing and tokenization

Observability: Prometheus + Grafana + Alertmanager stack

CI/CD: GitHub Actions for automated workflows

See Technology Choices & Rationale for detailed explanations of each technology decision.

AWS Account Setup

The AWS account (ID: 907849381252) has been configured with:

CloudTrail - For logging all AWS API calls across all regions

Config - For tracking configuration changes of AWS resources

IAM Security - With groups, policies, and strong password policies

Secure Root Account - With proper separation of duties

VPC Topology & Network Plan

The infrastructure follows a well-designed VPC topology with:

Public Subnets - For internet-facing resources

Private Subnets - For application resources

Database Subnets - For RDS instances

NAT Gateways - For private subnet internet access

VPC Endpoints - For private access to AWS services

VPC Flow Logs - For network traffic monitoring

See VPC Design Document for detailed network architecture.

Infrastructure Components

Terraform Modules

VPC Module - Creates a complete VPC with public/private subnets, NAT gateways, and routing

EKS Module - Creates EKS clusters with node groups

RDS Module - Creates PostgreSQL database instances

Environments

dev - Development environment

staging - Staging environment

prod - Production environment

Global Resources

CloudTrail for API logging

Config for resource tracking

IAM policies and groups

S3 buckets for Terraform state and application assets

DynamoDB tables for state locking

KMS keys for encryption

ECR repositories for container images

Frontend Applications

Web Interface

The dApp includes a responsive web interface built with React and TypeScript:

Modern UI with dark/light mode support

Wallet creation and import functionality

Responsive design for all screen sizes

Material Symbols icons

Tailwind CSS styling

See Web Interface Documentation for build and deployment instructions.

Mobile Applications

The dApp also includes mobile applications for iOS and Android:

Native mobile experience

Wallet creation and import functionality

Platform-specific UI components

See Mobile App Documentation for build and deployment instructions.

CI/CD Setup

The project uses GitHub Actions for continuous integration and deployment:

Infrastructure Deployment - Automatically deploys infrastructure changes

Application Deployment - Builds and deploys the frontend application

Backend Deployment - Builds and deploys the backend services

See CI/CD Setup Guide for detailed configuration instructions.

Monitoring and Observability

The dev environment includes a complete monitoring stack:

Prometheus - For metrics collection and alerting

Grafana - For visualization and dashboarding

Alertmanager - For handling alerts with Gmail SMTP or webhook notifications

dApp Health Checker - Sample application with Prometheus metrics

See Monitoring Setup Guide for detailed configuration instructions.

Deployment

Use the Makefile commands to deploy:

# Deploy global resources
make deploy-global

# Deploy environment-specific resources
make deploy-dev
make deploy-staging
make deploy-prod

Or use GitHub Actions for automated deployment.

Running the Project Locally

You can run the entire project locally using Docker Compose:

Make sure you have Docker and Docker Compose installed

Run the project:

./run-project.sh

Or manually with Docker Compose:

# For newer versions of Docker (v20.10+)
docker compose up --build

# For older versions of Docker
docker-compose up --build

Access the services:

Frontend: http://localhost:3000

Backend API: http://localhost:8080

Database: postgres://blockchain:blockchain@localhost:5432/blockchain_dev

To stop the services:

# For newer versions of Docker (v20.10+)
docker compose down

# For older versions of Docker
docker-compose down

Running in Development Mode

For development, you can run the frontend and backend separately:

Prerequisites

Go 1.19+

Node.js 16+

PostgreSQL

Setting up the Database

./setup-db.sh

Running the Backend

./run-backend-dev.sh

Running the Frontend

./run-frontend-dev.sh

Security Features

CloudTrail logs are stored in a secure S3 bucket with lifecycle policies (365 days)

Config records all resource configurations with delivery to S3

IAM groups with least-privilege policies (admins, developers, auditors)

Strong password policy enforced (12+ characters, numbers, symbols, uppercase, lowercase)

Separate Terraform state storage per environment with versioning and encryption

Public access blocked on all S3 buckets

VPC Flow Logs for network monitoring

DynamoDB locking for Terraform state consistency

KMS encryption for data at rest

IRSA (IAM Roles for Service Accounts) for secure Kubernetes access

Secrets Manager for sensitive data

Like this project

Completed work

Posted Sep 28, 2025

Developed a decentralized application with AWS infrastructure and modern tech stack.

Likes

Views

Timeline

Sep 8, 2025 - Dec 26, 2025

Clients

Personal Project