# BlockForge Portfolio App BlockForge is a portfolio-ready blockchain web app built with pure Python + HTML/CSS/JS. It includes a proof-of-work chain, transaction queue, mining, balances, and save/load persistence. ## What you can show recruiters/clients - Live dashboard with chain stats and latest block preview - Forms to submit transactions, mine blocks, check balances - JSON persistence controls (save/load chain state) - Clean API backend with no external server framework ## Project structure - `blockchain.py` - blockchain engine and CLI utilities - `api_server.py` - API + static web server - `web/index.html` - portfolio UI - `web/styles.css` - visual design and responsive layout - `web/app.js` - frontend API client logic ## Run locally ```powershell python api_server.py --difficulty 2 --port 8000 ``` Open: ```text http://127.0.0.1:8000 ``` ## CLI examples ```powershell python blockchain.py --difficulty 2 --tx alice bob 1.5 --mine miner1 --save data/chain.json python blockchain.py --load data/chain.json --balance miner1 ``` ## API endpoints - `GET /health` - `GET /chain` - `GET /pending` - `GET /balance/{address}` - `POST /transactions` - `POST /mine` - `POST /save` - `POST /load` Example request body for `POST /transactions`: ```json {"sender":"alice","recipient":"bob","amount":2.5} ``` ## Upload now checklist 1. Create a new GitHub repo and push this folder. 2. Add screenshots of the UI to the repo README if you want stronger portfolio presentation. 3. Deploy on a Python host and run: ```text python api_server.py --host 0.0.0.0 --port $PORT ``` ## Note This is an educational blockchain app and not a production cryptocurrency network. # PortfolioBlockchainProject