stable
说明： 项目稳定-一个去中心化的通货膨胀仪表板+加密货币来对冲通货膨胀
(Project stable - A decentralized inflation dashboard + cryptocurrency to hedge against inflation)
(Project stable - A decentralized inflation dashboard + cryptocurrency to hedge against inflation)
文件列表:
LICENSE (1063, 2022-03-10)
aggregator (0, 2022-03-10)
aggregator\.env (185, 2022-03-10)
aggregator\.eslintrc.json (295, 2022-03-10)
aggregator\abis (0, 2022-03-10)
aggregator\abis\CountryTracker.json (8113, 2022-03-10)
aggregator\abis\StabilizerToken.json (6734, 2022-03-10)
aggregator\abis\Stable.json (18339, 2022-03-10)
aggregator\index.js (8769, 2022-03-10)
aggregator\package-lock.json (70364, 2022-03-10)
aggregator\package.json (455, 2022-03-10)
core (0, 2022-03-10)
core\.env.template (51, 2022-03-10)
core\.eslintignore (38, 2022-03-10)
core\.eslintrc.js (525, 2022-03-10)
core\.prettierignore (62, 2022-03-10)
core\.prettierrc (261, 2022-03-10)
core\.solhint.json (204, 2022-03-10)
core\.solhintignore (13, 2022-03-10)
core\contracts (0, 2022-03-10)
core\contracts\CountryTracker.sol (3155, 2022-03-10)
core\contracts\StabilizerToken.sol (501, 2022-03-10)
core\contracts\Stable.sol (15046, 2022-03-10)
core\contracts\StableToken.sol (496, 2022-03-10)
core\hardhat.config.js (1873, 2022-03-10)
core\package-lock.json (790969, 2022-03-10)
core\package.json (1322, 2022-03-10)
core\scripts (0, 2022-03-10)
core\scripts\copy-abis.js (2044, 2022-03-10)
core\scripts\create-supplier.js (1048, 2022-03-10)
core\scripts\deploy.js (3962, 2022-03-10)
core\scripts\deployed.json (61, 2022-03-10)
core\scripts\generate-sample-data.js (10238, 2022-03-10)
core\scripts\products.json (6744, 2022-03-10)
core\scripts\transfer-szr.js (1159, 2022-03-10)
core\test (0, 2022-03-10)
core\test\country-tracker.test.js (4301, 2022-03-10)
... ...
aggregator (0, 2022-03-10)
aggregator\.env (185, 2022-03-10)
aggregator\.eslintrc.json (295, 2022-03-10)
aggregator\abis (0, 2022-03-10)
aggregator\abis\CountryTracker.json (8113, 2022-03-10)
aggregator\abis\StabilizerToken.json (6734, 2022-03-10)
aggregator\abis\Stable.json (18339, 2022-03-10)
aggregator\index.js (8769, 2022-03-10)
aggregator\package-lock.json (70364, 2022-03-10)
aggregator\package.json (455, 2022-03-10)
core (0, 2022-03-10)
core\.env.template (51, 2022-03-10)
core\.eslintignore (38, 2022-03-10)
core\.eslintrc.js (525, 2022-03-10)
core\.prettierignore (62, 2022-03-10)
core\.prettierrc (261, 2022-03-10)
core\.solhint.json (204, 2022-03-10)
core\.solhintignore (13, 2022-03-10)
core\contracts (0, 2022-03-10)
core\contracts\CountryTracker.sol (3155, 2022-03-10)
core\contracts\StabilizerToken.sol (501, 2022-03-10)
core\contracts\Stable.sol (15046, 2022-03-10)
core\contracts\StableToken.sol (496, 2022-03-10)
core\hardhat.config.js (1873, 2022-03-10)
core\package-lock.json (790969, 2022-03-10)
core\package.json (1322, 2022-03-10)
core\scripts (0, 2022-03-10)
core\scripts\copy-abis.js (2044, 2022-03-10)
core\scripts\create-supplier.js (1048, 2022-03-10)
core\scripts\deploy.js (3962, 2022-03-10)
core\scripts\deployed.json (61, 2022-03-10)
core\scripts\generate-sample-data.js (10238, 2022-03-10)
core\scripts\products.json (6744, 2022-03-10)
core\scripts\transfer-szr.js (1159, 2022-03-10)
core\test (0, 2022-03-10)
core\test\country-tracker.test.js (4301, 2022-03-10)
... ...
# Project Stable
Project Stable is a decentralized, on-chain, price-history and inflation dashboard.
It tracks price change of various daily-use products and commodities and allow users to
see true inflation rates.
It also allow users to mint an anti-inflationary asset called `STABLE` token.
Demo: [https://inflation.netlify.app/](https://inflation.netlify.app/)
Subgraph: [https://thegraph.com/hosted-service/subgraph/saleel/stable-price-history](https://thegraph.com/hosted-service/subgraph/saleel/stable-price-history)
[Presentation Slides](https://docs.google.com/presentation/d/1mJleFKS5Iu1r3NbQ3BMaUVnFMGz821PPpLterQprfFA/)
[Presentation Video](https://youtu.be/gRjCPNxg-lM)
Status: Testing/POC phase
## Inspiration Prices of daily-use products and services has been increasing drastically in the last couple of months. Many claims that govt. reported inflation numbers are not accurate. The starting idea for this was inspired by [this tweet](https://twitter.com/balajis/status/1423330960481816582).
## What it does - Track prices of daily-use products and services, in multiple countries, on the chain. - Prices collected from users. - Tracks Price Index (weighted average of all prices) - measure of true inflation. - Products to track and weightage chosen by DAO. - Project token Stabilizer `$SZR` - used for governance and rewards. - Allow users to mint an anti inflationary crypto-currency `$STABLE`, that is pegged to the Global Price Index, and is "stable" in terms of purchasing power.
## How it works
- `Stable` is the main smart contract deployed on Aurora blockchain. A gas efficient chain like Aurora is optimal for a public facing application like this.
- The product details are stored on IPFS and the hash/CID is stored in the contract.
- `Stable` contract create child contracts called `CountryTracker` to track prices within a country.
- Users submit prices to the `CountryTracker` contract (which only emits an event).
- **Aggregators** watch for price submission event and aggregate all submissions made in a day, calculate aggregated price for each product and the Price Index, and submit them back to the contract. The rule (logic name) to be used for aggregation is set in the contract.
- Aggregators need to lockup `SZR` to get claims for aggregation rounds - the more they lock, more rounds they can get. DAO can slash their locked SZR if they don't do aggregations properly.
- The price submission events are indexed by a subgraph in the `TheGraph` protocol, which aggregators can use to query submission data.
- `CountryTracker` contract stores the latest prices of all products and the price index.
- The subgraph also index price and price index history - which powers the web app.
- Aggregators receive rewards in `SZR` (amount set by DAO) for completing each agg. round. Users with winning submissions are also rewarded at the same time. Rules to chose winners is also decided by the DAO.
- There is also a **Global Price Index** in `Stable` which is the weighted average of Price Index of each participating country. The weightage for each country is stored in `Stable` contract and is again, set by the DAO.
### StableToken - StableToken (`STABLE`) is a token pegged to the Global Price Index. - The peg is maintained using the `SZR` token. Users can exchange 1 USD worth of `SZR` for 1 USD worth of `STABLE`. This is similar to how Terra/Luna works. - If a user mint 1000USD worth `STABLE` by exchanging 1000USD worth of `SZR`, and if the inflation increase by 10%, then they can burn their `STABLE` tokens and get 1100USD (10% extra) worth of `SZR`.
### Suppliers
- StableToken is backed by another entity in the ecosystem called by **Suppliers**
- Suppliers (super-market chains for example) stake their reputation, and promise to redeem $STABLE in exchange of the goods in the product basket - and borrow equivalent $SZR.
- Instead of paying an interest, they would pay/redeem the product basket even if the price increase in the future.
- Suppliers are approved and added to the contract by DAO. DAO also set a limit on the percentage of `SZR` they can withdraw with respect to the `STABLE` they promise to redeem. DAO can slow increase these limited based on the behavior of the supplier.
- Suppliers are added to the contract by DAO after verification. Suppliers will have to show their identity publicly in the proposal they create for adding them. If they don't redeem the `STABLES` they promised, it can lead to bad reputation on the brand.
- The incentive for the Supplier is they can borrow money without any interest, which they can use to run their business. Even when a user redeem their Stable token with the supplier, they make profits on the sales. In addition to that they get rewards in `SZR` for each redemption they do.
### Exchange
- Users can only exchange `SZR` for `STABLE` if there are suppliers backing the `STABLE`. However, there is a `over-collateralization ratio` in the contract which can be set by the DAO to allow mining of more `STABLE` than that are in the contract.
- As the ecosystem grows, more `STABLE` than that are backed can be minted because all users wont redeem them at once.
- Also, users can always choose to burn `STABLE` to mint `SZR` instead of redeeming with a supplier. This would increase the supply of `SZR` and reduces its value.
- When users exchange `SZR` for `STABLE`, `SZR` equivalent to over collateralization is burned, as this amount is seignorage. This will also make `SZR` a deflationary asset as the ecosystem grows.
## Tech stack - Contract deployed on Aurora - [`0xaFB36003d119b3976D915D74887F9568ca635854`](https://aurorascan.dev/address/0xaFB36003d119b3976D915D74887F9568ca635854) (deployed to mainnet as TheGraph has trouble indexing testnet). - TheGraph for indexing - to track price submission, price and price index history, etc. - IPFS for storing product meta - CID stored in contract. - React for the UI.
## Repo structure Entire code for this project is in this repo - `/core` : Contains code for smart-contract, hardhat setup, and some scripts for transferring SZR, creating suppliers, generating sample data, etc. - `/subgraph` : Contains the subgraph definition and mappers that index price submissions, price and price index, etc. - `/aggregator` : Contains script for becoming an aggregator - lockup SZR and run aggregations. - `/ui` : React project web-app that renders the UI by connecting to subgraph and the contract.
## Things that can be done - Suppliers backing STABLE token is only one model. **DAO can have a smart contract where users can lock BTC, ETH as collateral and borrow STABLE (i.e equivalent SZR).** - Instead of paying interest, they would be paying the inflation rate as excess when they return. - The contract can also act as an Oracle feed for the Defi apps. And also can bridge the tokens to other chains.
## TODOs: - Allow users to view inflation based on their choice of products and weightage. - Improve overall quality - fix bugs, test for security/errors. - Implement the DAO functionality - proposal and voting features. Currently the `owner` of the contract is one address, but the ownership can be transferred to the DAO. - The contract to derive the price of SZR from an oracle. It is currently simulated (based on supply) in the contract as the token is not traded on any exchange. - `subgraph` to also index the price submissions made through IPFS. - Implement a better logic to select one/few winners from price submissions. Currently all submissions which equal aggregated price is decided as winner. - A lot of these would depend on the direction of this project.
## Testing Please contact me if you would like to test the app. I can transfer `SZR` tokens and also add you as a supplier if you would like to.
### Contracts Deployed to Aurora mainnet during POC/testing phase, as TheGraph has trouble indexing testnet Contract on Aurora: [0xaFB36003d119b3976D915D74887F9568ca635854](https://aurorascan.dev/address/0xaFB36003d119b3976D915D74887F9568ca635854) SZR Token: [0x2f6ee7ee17***7ed9cd0e449d893b5f2a285ef316](https://aurorascan.dev/token/0x2f6ee7ee17***7ed9cd0e449d893b5f2a285ef316) STABLE Token: [0x2***cA4C59e24Dc7424CDf75f57ac14B2cc2eF3F3](https://aurorascan.dev/token/0x2***cA4C59e24Dc7424CDf75f57ac14B2cc2eF3F3)
*Icons and logo from [icons8](https://icons8.com)*
## Inspiration Prices of daily-use products and services has been increasing drastically in the last couple of months. Many claims that govt. reported inflation numbers are not accurate. The starting idea for this was inspired by [this tweet](https://twitter.com/balajis/status/1423330960481816582).
## What it does - Track prices of daily-use products and services, in multiple countries, on the chain. - Prices collected from users. - Tracks Price Index (weighted average of all prices) - measure of true inflation. - Products to track and weightage chosen by DAO. - Project token Stabilizer `$SZR` - used for governance and rewards. - Allow users to mint an anti inflationary crypto-currency `$STABLE`, that is pegged to the Global Price Index, and is "stable" in terms of purchasing power.
## How it works
- `Stable` is the main smart contract deployed on Aurora blockchain. A gas efficient chain like Aurora is optimal for a public facing application like this.
- The product details are stored on IPFS and the hash/CID is stored in the contract.
- `Stable` contract create child contracts called `CountryTracker` to track prices within a country.
- Users submit prices to the `CountryTracker` contract (which only emits an event).
- **Aggregators** watch for price submission event and aggregate all submissions made in a day, calculate aggregated price for each product and the Price Index, and submit them back to the contract. The rule (logic name) to be used for aggregation is set in the contract.
- Aggregators need to lockup `SZR` to get claims for aggregation rounds - the more they lock, more rounds they can get. DAO can slash their locked SZR if they don't do aggregations properly.
- The price submission events are indexed by a subgraph in the `TheGraph` protocol, which aggregators can use to query submission data.
- `CountryTracker` contract stores the latest prices of all products and the price index.
- The subgraph also index price and price index history - which powers the web app.
- Aggregators receive rewards in `SZR` (amount set by DAO) for completing each agg. round. Users with winning submissions are also rewarded at the same time. Rules to chose winners is also decided by the DAO.
- There is also a **Global Price Index** in `Stable` which is the weighted average of Price Index of each participating country. The weightage for each country is stored in `Stable` contract and is again, set by the DAO.
### StableToken - StableToken (`STABLE`) is a token pegged to the Global Price Index. - The peg is maintained using the `SZR` token. Users can exchange 1 USD worth of `SZR` for 1 USD worth of `STABLE`. This is similar to how Terra/Luna works. - If a user mint 1000USD worth `STABLE` by exchanging 1000USD worth of `SZR`, and if the inflation increase by 10%, then they can burn their `STABLE` tokens and get 1100USD (10% extra) worth of `SZR`.
### Suppliers
- StableToken is backed by another entity in the ecosystem called by **Suppliers**
- Suppliers (super-market chains for example) stake their reputation, and promise to redeem $STABLE in exchange of the goods in the product basket - and borrow equivalent $SZR.
- Instead of paying an interest, they would pay/redeem the product basket even if the price increase in the future.
- Suppliers are approved and added to the contract by DAO. DAO also set a limit on the percentage of `SZR` they can withdraw with respect to the `STABLE` they promise to redeem. DAO can slow increase these limited based on the behavior of the supplier.
- Suppliers are added to the contract by DAO after verification. Suppliers will have to show their identity publicly in the proposal they create for adding them. If they don't redeem the `STABLES` they promised, it can lead to bad reputation on the brand.
- The incentive for the Supplier is they can borrow money without any interest, which they can use to run their business. Even when a user redeem their Stable token with the supplier, they make profits on the sales. In addition to that they get rewards in `SZR` for each redemption they do.
### Exchange
- Users can only exchange `SZR` for `STABLE` if there are suppliers backing the `STABLE`. However, there is a `over-collateralization ratio` in the contract which can be set by the DAO to allow mining of more `STABLE` than that are in the contract.
- As the ecosystem grows, more `STABLE` than that are backed can be minted because all users wont redeem them at once.
- Also, users can always choose to burn `STABLE` to mint `SZR` instead of redeeming with a supplier. This would increase the supply of `SZR` and reduces its value.
- When users exchange `SZR` for `STABLE`, `SZR` equivalent to over collateralization is burned, as this amount is seignorage. This will also make `SZR` a deflationary asset as the ecosystem grows.
## Tech stack - Contract deployed on Aurora - [`0xaFB36003d119b3976D915D74887F9568ca635854`](https://aurorascan.dev/address/0xaFB36003d119b3976D915D74887F9568ca635854) (deployed to mainnet as TheGraph has trouble indexing testnet). - TheGraph for indexing - to track price submission, price and price index history, etc. - IPFS for storing product meta - CID stored in contract. - React for the UI.
## Repo structure Entire code for this project is in this repo - `/core` : Contains code for smart-contract, hardhat setup, and some scripts for transferring SZR, creating suppliers, generating sample data, etc. - `/subgraph` : Contains the subgraph definition and mappers that index price submissions, price and price index, etc. - `/aggregator` : Contains script for becoming an aggregator - lockup SZR and run aggregations. - `/ui` : React project web-app that renders the UI by connecting to subgraph and the contract.
## Things that can be done - Suppliers backing STABLE token is only one model. **DAO can have a smart contract where users can lock BTC, ETH as collateral and borrow STABLE (i.e equivalent SZR).** - Instead of paying interest, they would be paying the inflation rate as excess when they return. - The contract can also act as an Oracle feed for the Defi apps. And also can bridge the tokens to other chains.
## TODOs: - Allow users to view inflation based on their choice of products and weightage. - Improve overall quality - fix bugs, test for security/errors. - Implement the DAO functionality - proposal and voting features. Currently the `owner` of the contract is one address, but the ownership can be transferred to the DAO. - The contract to derive the price of SZR from an oracle. It is currently simulated (based on supply) in the contract as the token is not traded on any exchange. - `subgraph` to also index the price submissions made through IPFS. - Implement a better logic to select one/few winners from price submissions. Currently all submissions which equal aggregated price is decided as winner. - A lot of these would depend on the direction of this project.
## Testing Please contact me if you would like to test the app. I can transfer `SZR` tokens and also add you as a supplier if you would like to.
### Contracts Deployed to Aurora mainnet during POC/testing phase, as TheGraph has trouble indexing testnet Contract on Aurora: [0xaFB36003d119b3976D915D74887F9568ca635854](https://aurorascan.dev/address/0xaFB36003d119b3976D915D74887F9568ca635854) SZR Token: [0x2f6ee7ee17***7ed9cd0e449d893b5f2a285ef316](https://aurorascan.dev/token/0x2f6ee7ee17***7ed9cd0e449d893b5f2a285ef316) STABLE Token: [0x2***cA4C59e24Dc7424CDf75f57ac14B2cc2eF3F3](https://aurorascan.dev/token/0x2***cA4C59e24Dc7424CDf75f57ac14B2cc2eF3F3)
*Icons and logo from [icons8](https://icons8.com)*
近期下载者：
相关文件：
收藏者：