https://github.com/rechain-network-solutions/bonded-stablecoin
Bonded Stable Coin system, written in OneScript/oscript.
https://github.com/rechain-network-solutions/bonded-stablecoin
bonded onescript oscript oscript-lib oscript-library oscript-package oscript-web ovm rechain rechainapi rechaincontract rechainnetwork stablecoin
Last synced: 3 months ago
JSON representation
Bonded Stable Coin system, written in OneScript/oscript.
- Host: GitHub
- URL: https://github.com/rechain-network-solutions/bonded-stablecoin
- Owner: REChain-Network-Solutions
- License: other
- Created: 2025-04-15T12:10:51.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-06-30T14:41:33.000Z (3 months ago)
- Last Synced: 2025-07-04T16:21:05.432Z (3 months ago)
- Topics: bonded, onescript, oscript, oscript-lib, oscript-library, oscript-package, oscript-web, ovm, rechain, rechainapi, rechaincontract, rechainnetwork, stablecoin
- Language: JavaScript
- Homepage: https://rechain.network
- Size: 174 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
- Governance: governance.oscript
Awesome Lists containing this project
README
# Home
# Welcome to the Bonded-StableCoin Wiki 🪙
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.
## Core Concepts
- Stablecoin with algorithmic backing
- Bonding curve mechanism
- Smart contracts written in Solidity
- Frontend interaction via ethers.js and React
👉 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
- MetaMask / testnet ETH
## Steps
```bash
npm install
npx hardhat compile
npx hardhat run scripts/deploy.js --network
```
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.
--------------------------------------------------------------------------------