Stable coin example (#113)

* Stablecoin tutorial

Author: rgottleber

stablecoin-project/README.md

@@ -0,0 +1,70 @@
+# Reserve-Backed Stablecoin Project
+
+This repository contains a practical implementation of a reserve-backed stablecoin built with Foundry, designed to accompany a YouTube tutorial video.
+
+🎬 **[Watch the full tutorial on YouTube](https://youtube.com/chainlink)**
+
+## Project Overview
+
+This stablecoin demonstrates key concepts of a reserve-backed cryptocurrency:
+
+- **ERC20 Token**: Implements a standard ERC20 token with additional functionality
+- **Reserve Backing**: The stablecoin is fully backed by reserves verified through a DataFeed (mocked in this example)
+- **Minting Controls**: Only mint tokens when sufficient reserves exist
+- **Access Control**: Role-based permissions for administrative actions
+- **Safety Features**: Includes pause/unpause functionality and other safety measures
+
+## Prerequisites
+
+- [Foundry](https://getfoundry.sh/) installed on your machine
+- Basic understanding of Solidity and ERC20 tokens
+- Familiarity with smart contract development
+
+## Project Structure
+
+- `src/StableCoin.sol`: The main stablecoin implementation
+- `src/SmartDataMock.sol`: Mock price feed for testing
+- `test/StableCoin.t.sol`: Comprehensive test suite
+- `script/StableCoinInteraction.s.sol`: Deployment and interaction script
+
+## Getting Started
+
+### Installation
+
+```shell
+# Clone the repository
+git clone https://github.com/yourusername/stablecoin-project.git
+cd stablecoin-project
+
+# Install dependencies
+forge install
+```
+
+### Build
+
+```shell
+forge build
+```
+
+### Test
+
+```shell
+forge test
+```
+
+### Run Scripts
+
+```shell
+# In a seperate window
+anvil
+# Run the interaction script on local network
+forge script script/StableCoinInteraction.s.sol --rpc-url http://127.0.0.1:8545 --broadcast
+```
+
+## Disclaimer
+
+This code is for educational purposes only and has not been audited. Do not use in production without proper security reviews and audits.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

stablecoin-project/foundry.toml

@@ -0,0 +1,7 @@
+[profile.default]
+src = "src"
+out = "out"
+libs = ["lib"]
+remappings = ["@openzeppelin/=lib/openzeppelin-contracts/"]
+
+# See more config options https://github.com/foundry-rs/foundry/blob/master/crates/config/README.md#all-options