A collection of independent MVP projects showcasing skills in Web3/Blockchain development. Each subfolder is standalone; detailed docs live in each project’s own README.
- evm — EVM Launchkit (Foundry): token factory, tax-enabled ERC20, tests, CI & evidence
- audit_docker_mvp — Smart-contract automated auditing MVP
- defi-audit — Security analysis tools for DeFi protocols
- nft-query — NFT metadata & transaction query tools
- token_api — Token data query & management API
This collection demonstrates backend engineering, on-chain interaction, security auditing, and DevEx.
- Compile → Deploy (cast) → Constructor args → Etherscan Exact Match → Read checks
- Watch: https://youtu.be/bUFz8v6JHiw
- Build & start with Docker Compose → Check DB & logs → Generate JWT → Call API with Postman → Verify latency (~1s; cached requests instant) → Confirm logs & DB updates
- Watch: https://youtu.be/bJQyXpvDhhg
What it is A practical Foundry template focused on delivery and evidence: token factory + tax-enabled ERC20 (OZ v5), scripts, tests, CI, and reproducible artifacts.
CI & Gas Evidence
- Workflow: GitHub Actions runs
forge test -vvv
and publishes a gas report (--gas-report
). - Artifacts: Each run uploads
gas-ci.txt
(downloadable). - Scope: CI runs in the
evm/
subfolder viadefaults.run.working-directory: evm
.
Quickstart (Sepolia)
# inside ./evm
set -a && source .env && set +a
forge build --build-info
# deploy with cast (robust path)
OWNER_ENV="${TOKEN_OWNER:-$INITIAL_OWNER}"
BYTECODE=$(forge inspect contracts/TaxedERC20.sol:TaxedERC20 bytecode)
TX=$(cast send --rpc-url "$SEPOLIA_RPC_URL" --private-key "$PRIVATE_KEY" \
--create "$BYTECODE" \
"constructor(string,string,uint8,uint256,address,uint16,address)" \
"$NAME" "$SYMBOL" $DECIMALS $INITIAL_SUPPLY "$OWNER_ENV" $TAX_BPS "$TAX_COLLECTOR")
NEW_TOKEN=$(echo "$TX" | awk '/^contractAddress/ {print $2}')
# verify
ARGS=$(cast abi-encode "constructor(string,string,uint8,uint256,address,uint16,address)" \
"$NAME" "$SYMBOL" $DECIMALS $INITIAL_SUPPLY "$OWNER_ENV" $TAX_BPS "$TAX_COLLECTOR")
forge verify-contract --chain sepolia --constructor-args "$ARGS" \
--etherscan-api-key "$ETHERSCAN_API_KEY" "$NEW_TOKEN" \
contracts/TaxedERC20.sol:TaxedERC20 --watch
See the consolidated index: evm/docs/evidence/.
-
#1 – Token Factory (simple ERC20) Delivery: factory contract, scripts, tests, gas report, usage notes.
-
#2 – TaxedERC20 (OZ v5) — tax / whitelist / blacklist / pause Delivery: ERC20 with tax via
_update
hook, owner controls, tests, gas report, evidence pack. Evidence: see Day6 pack above.
For service details or custom extensions, please open an issue or contact me.
- Testnet keys are for demo only. Do not reuse on mainnet.
- Some screenshots/links reference the
evm/
submodule and CI artifacts.