Beginner-to-Intermediate Solidity Smart Contracts 🚀

Welcome to my personal Solidity mastery repository! This is a project-based learning journey that documents my transition from a Solidity beginner to intermediate (and beyond) using Foundry and professional smart contract development practices.

---

📖 About This Repository

This repository contains a growing collection of hands-on Solidity smart contract projects built to solidify my understanding of:

• Solidity syntax and best practices

• Foundry testing and deployment workflows

• Custom errors, events, and advanced access control patterns

• Secure ETH handling (receive, fallback, withdrawals)

• Writing clean, gas-optimized, and professional-grade smart contracts

---

Each project is organized in its own folder with:

• A dedicated README explaining the project scope and goals.

• Full Foundry test suites with high coverage.

• Proper ETH flow management and access control.

---

📚 Learning Goals

Milestone Goal

• Step 1 Master basic Solidity (Structs, Mappings, Functions, Modifiers).
• Step 2 Implement gas-optimized custom errors and modifiers.
• Step 3 Build secure ETH handling with receive and fallback.
• Step 4 Practice Owner-only access control and event logging.
• Step 5 Master Foundry testing, coverage, and deployment scripts.
• Ongoing Learn advanced patterns, design upgrades, and modular contracts.

---

📂 Repository Structure

├── Day01-UserStorage/            # Advanced user data storage smart contract
│   ├── src/                      # Contract code
│   ├── test/                     # Foundry tests with high coverage
│   └── README.md                 # Detailed project description
├── Day02-ComingSoon/             # Placeholder for next project
└── README.md                     # Main repository overview (this file)

---

🛠 Tools Used

• Language: Solidity ^0.8.18
• IDE: Remix + Visual Studio Code
• Version Control: Git + GitHub (SSH)
• Foundry

---

🛠 Getting Started

Clone the Repository

git clone [email protected]:BuildsWithKing/beginner-to-intermediate-upgraded-version.git
cd beginner-to-intermediate-upgraded-version

Install Foundry

curl -L https://foundry.paradigm.xyz | bash
foundryup

Run Tests on Any Project

cd Day01-UserStorage
forge test
forge coverage

Deploy Using Foundry Script

forge script script/DeployUserStorage.s.sol --rpc-url $SEPOLIA_RPC_URL --private-key $PRIVATE_KEY --broadcast --verify

---

✅ Completed Projects.

✅ Advanced UserStorage

---

🤝 Contributing

This repository is my personal learning tracker. You’re welcome to star ⭐, fork 🍴, or follow for inspiration.

Pull requests are open for constructive improvements or helpful resources.

---

📄 License

MIT License – free to learn, remix, and build upon it.

---

✍ Author

Built with 💡 by @BuildsWithKing

---

💬 Want to Follow My Journey?

📡 Twitter/X – @BuildsWithKing
🌍 Website – https://buildswithking.vercel.app
🧠 GitHub Profile – https://github.com/BuildsWithKing

Let’s connect and grow in public!

---

“I believe mastery comes through consistency — and I’m here to prove it.” — Michealking 👑

---

⭐ Give Credit If It Helps You

If this inspires your learning journey, kindly give the repo a ⭐ or mention in your posts!

---