Add files via upload

Author: sorydima

README.md

@@ -1,31 +1,153 @@
-# Bonded StableCoin 🪙
+# Home
 
-A decentralized stablecoin powered by bonding curves and smart contracts.
+# Welcome to the Bonded-StableCoin Wiki 🪙
 
-## Features
+Bonded-StableCoin is a decentralized stablecoin system leveraging bonding curves for dynamic pricing and minting. It is designed to be fully autonomous, transparent, and backed by reserve logic.
 
-- Dynamic minting/burning using bonding curves
-- Backed by collateral and bonding logic
-- Secure smart contracts
-- Basic frontend for interaction
+## Core Concepts
 
-## Tech Stack
+- Stablecoin with algorithmic backing
+- Bonding curve mechanism
+- Smart contracts written in Solidity
+- Frontend interaction via ethers.js and React
 
-- Solidity
+👉 Explore the sections on the left to learn more.
+
+
+--------------------------------------------------------------------------------
+
+# Architecture
+
+# System Architecture
+
+## Overview
+
+The Bonded-StableCoin system consists of:
+
+- **Smart Contract** (`BondedStableCoin.sol`) — Handles minting, burning, and bonding logic
+- **Frontend** — Connects users via wallet (e.g., MetaMask)
+- **Hardhat Backend** — Development & deployment environment
+
+## Components
+
+- ERC-20 token standard
+- ETH reserve tracking
+- Mint/Burn entry points
+- UI hooks (optional integration with DApps)
+
+
+--------------------------------------------------------------------------------
+
+# Bonding Curves
+
+# Bonding Curve Mechanism
+
+Bonding curves determine token price based on supply.
+
+## Pricing Formula
+
+Currently:
+```
+Price = 1 ETH per token (flat, can evolve)
+```
+
+Future iterations may use:
+```
+Price = k * (Supply ^ exponent)
+```
+
+## Benefits
+
+- Algorithmic control of supply
+- Dynamic pricing
+- Built-in incentive mechanics
+
+
+--------------------------------------------------------------------------------
+
+# Smart Contracts
+
+# Smart Contracts
+
+## `BondedStableCoin.sol`
+
+Implements:
+
+- ERC-20 standard
+- Mint function (receives ETH)
+- Burn function (returns ETH)
+- Basic bonding curve logic
+
+## Key Functions
+
+```solidity
+function mint() public payable
+function burn(uint256 amount) public
+```
+
+## Security Considerations
+
+- Reentrancy protection
+- Overflow/underflow checks (via Solidity 0.8.x)
+
+
+--------------------------------------------------------------------------------
+
+# Deployment
+
+# Deployment Guide
+
+## Requirements
+
+- Node.js
 - Hardhat
-- JavaScript (React)
-- Ethers.js
+- MetaMask / testnet ETH
 
-## Getting Started
+## Steps
 
 ```bash
-git clone https://github.com/REChain-Network-Solutions/Bonded-StableCoin.git
-cd Bonded-StableCoin
 npm install
 npx hardhat compile
-npx hardhat test
+npx hardhat run scripts/deploy.js --network <your-network>
 ```
 
-## License
+Use a `.env` file for private keys and API keys.
+
+
+--------------------------------------------------------------------------------
+
+# FAQ
+
+# Frequently Asked Questions
+
+### Q: Is this stablecoin collateral-backed?
+A: Yes. ETH reserves back the token supply directly.
+
+### Q: How is price stability ensured?
+A: Via bonding curve logic that determines mint/burn pricing algorithmically.
+
+### Q: Can I contribute?
+A: Absolutely! Open issues, submit PRs, or suggest improvements.
+
+
+--------------------------------------------------------------------------------
+
+# Glossary
+
+# Glossary
+
+**Stablecoin** — A token designed to maintain a stable value.
+
+**Bonding Curve** — A mathematical function defining the price of a token based on its supply.
+
+**Minting** — Creating new tokens in exchange for ETH.
+
+**Burning** — Destroying tokens to redeem ETH.
+
+**Reserve** — The ETH pool backing the stablecoin.
+
+**ERC-20** — A widely-used Ethereum token standard.
+
+
+--------------------------------------------------------------------------------
 
-MIT