# Requirement of Product
## USX
### DEX Volume
24H交易量、24H新增用户数、24H交易笔数
累计交易量、累计用户数、累计交易笔数

| 网络 | DEX | Pair | Address |
| -------- | ---------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Ethereum | Pulsar | DF-USX | [0xa5f715cd7555b6b940ebe961e96b9e9be71755fe](https://etherscan.io/address/0xa5f715cd7555b6b940ebe961e96b9e9be71755fe) |
| Ethereum | Curve | USX-3CRV | [0x76264772707c8bc24261516b560cbf3cbe6f7819](https://etherscan.io/address/0x76264772707c8bc24261516b560cbf3cbe6f7819) |
| Ethereum | Uniswap V3 | DF-USX | [0xc7c5f1bC531883158a7DD26659a72E360d234e5E](https://etherscan.io/address/0xc7c5f1bC531883158a7DD26659a72E360d234e5E) |
| Arbitrum | DODO | USDC-USX | [0x3fb983c686c2df5368092da08f8f56062adf47a6](https://arbiscan.io/address/0x3fb983c686c2df5368092da08f8f56062adf47a6) |
| Arbitrum | DODO | DF-USX | [0x19e5910f61882ff6605b576922507f1e1a0302fe](https://arbiscan.io/address/0x19e5910f61882ff6605b576922507f1e1a0302fe) |
| Arbitrum | Uniswap V3 | DF-USX | [0x19e5910f61882ff6605b576922507f1e1a0302fe](https://arbiscan.io/address/0x19e5910f61882ff6605b576922507f1e1a0302fe) |
| Arbitrum | Curve | USX-2CRV | [0x2ce5fd6f6f4a159987eac99ff5158b7b62189acf](https://arbiscan.io/address/0x2ce5fd6f6f4a159987eac99ff5158b7b62189acf) |
| Arbitrum | Swapfish | USDC-USX | [0x53001d6faa0b6be4f1f27e0272eab3a35090e6d0](https://arbiscan.io//address/0x53001d6faa0b6be4f1f27e0272eab3a35090e6d0) |
| Arbitrum | Pulsar | DF-USX | [0x4761d4892d413416f002ffef58e844d9bbed5e9c](https://arbiscan.io/address/0x4761d4892d413416f002ffef58e844d9bbed5e9c) |
| BSC | DODO | BUSD-USX | [0xb19265426ce5bc1e015c0c503dfe6ef7c407a406](https://bscscan.com/address/0xb19265426ce5bc1e015c0c503dfe6ef7c407a406) |
| BSC | Pancake | DF-USX | [0x780517aae4bb8375ca97d2ef471ef2abe23bc904](https://bscscan.com/address/0x780517aae4bb8375ca97d2ef471ef2abe23bc904) |
| BSC | Swapfish | BUSD-USX | [0x24896e397D648D38ec4a5dB90FD06CaD77e1B7Ee](https://bscscan.com/address/0x24896e397D648D38ec4a5dB90FD06CaD77e1B7Ee) |
| Optimism | Velodrome | USDC-USX | [0x5edac6b8ea08d535c01981d75b3361481c0ee999](https://optimistic.etherscan.io/address/0x5edac6b8ea08d535c01981d75b3361481c0ee999) |
| Optimism | Velodrome | DF-USX | [0xf8edf2da8fcf610cf77235d3f90cc110723159aa](https://optimistic.etherscan.io/address/0xf8edf2da8fcf610cf77235d3f90cc110723159aa) |

## dForce Swap

Coingecko数据服务需求：

* Liquidity：
全网所有Pair每天流动性加总，按天展示
* Volume
全网所有Pair每天交易量加总，按天展示
* Top Token
USDC、DAI、USX
（1）Price：$1.00
（2）Volume 24H:全网当前Token最近24小时交易量
（3）Liquidity：全网当前Token资产流动性
* Top Pairs
(1)Pair：币对，比如USDC-USX
(2)Network：币对所在网络，Ethereum、BSC、Arbitrum、Optimism、Polygon
(3)Price：交易价格，当前是$1.00
(4)Volume(24H):该币对24内的交易量。单边统计
(5)Liquidity：该币对当前TVl，已知抵押资产价值，乘以2就是该pair的Liquidity
参考链接：https://pancakeswap.finance/info
* Note：计算规则
（1）USDC-USX-DAI，1000。交易量是2000。USDC-1000，DAI-1000，USX-2000
结果应该是：usx的volume等于dai+usdc
（2）USX-USDC，1000。交易量1000。USX-1000，USDC-1000
结果应该是：usx的volume等于USDC
（3）DAI-USX，1000。交易量1000。USX-1000，DAI-1000
结果应该是：usx的volume等于DAI

### Volume
* total trading volume by month by blockchain
* total accumulated trading volume since launch by blockchain

## 后端需求
### LSR数据
#### Collatral Value
* Total Collatrals
抵押物总价值=所有网络稳定币总价值之和(Collatrals Amount)
Contract: https://hackmd.io/@Triumph/S10kFAJpq

| Netwrok | Collatral Assets | Collatral Amount |
| -------- | ---------------- | ---------------- |
| Ethereum | USDC | |
| Ethereum | DAI | |
| Arbitrum | USDC | |
| Arbitrum | DAI | |
| Optimism | USDC | |
| Optimism | DAI | |
| Polygon | USDC | |
| Polygon | DAI | |
| BSC | USDC | |
| BSC | DAI | |
| BSC | BUSD | |

#### dForce Swap API
按照不同网络展示不同Pair的数据
Contract: https://hackmd.io/@Triumph/S10kFAJpq
| Netwrok | Pair（Token-USX） |
| -------- | ----------------- |
| Ethereum | USDC |
| Ethereum | DAI |
| Arbitrum | USDC |
| Arbitrum | DAI |
| Optimism | USDC |
| Optimism | DAI |
| Polygon | USDC |
| Polygon | DAI |
| BSC | USDC |
| BSC | DAI |
| BSC | BUSD |

* 示例结构: Uniswap Sample

{
"0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599_0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2": {
"base_id": "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
"base_name": "Wrapped BTC",
"base_symbol": "WBTC",
"quote_id": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"quote_name": "Wrapped Ether",
"quote_symbol": "WETH",
"last_price": "30.45692523596447546478",
"base_volume": "1725.0451867",
"quote_volume": "52450.878529932577252127"
},
"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2_0xdAC17F958D2ee523a2206206994597C13D831ec7": {
"base_id": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"base_name": "Wrapped Ether",
"base_symbol": "WETH",
"quote_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"quote_name": "Tether USD",
"quote_symbol": "USDT",
"last_price": "345.2244580923542612263",
"base_volume": "195644.931427163765765227",
"quote_volume": "67443916.533922"
}
}

#### Mint USX Cap
LSR界面所需数据
1. Token-USX的铸币上线（Mint Cap）
2. Token-USX的铸币数量 (Total Mint)
3. Token-USX的剩余可铸数量（Left to Mint）
4. Token-USX的使用率（Usage）

### 服务报警
#### POO-stETH报警

| Network | Contract |
| -------- | --------------------------------------------------------------------------------------------------------------------- |
| BSC | [ 0xe6b4A72D5D2CeD78aa8a4f7453D41EbDd0C4C05d](https://bscscan.com/address/0xe6b4A72D5D2CeD78aa8a4f7453D41EbDd0C4C05d) |
| Arbitrum | [0x3e5De9F2BA58bA036E84d93c81e8DFb0f002DAF6](https://arbiscan.io/address/0x3e5De9F2BA58bA036E84d93c81e8DFb0f002DAF6) |

#### 矿山合约报警
Notes：低于1万DF报警

| Network | Address |
| -------- | --------------------------------------------------------------------------------------------------------------------- |
| Ethereum | [0x1D22AFC7dc4Bf336532dd6248d453C647CecA1B3](https://etherscan.io/address/0x1D22AFC7dc4Bf336532dd6248d453C647CecA1B3) |
| BSC | [0x959715da68DC2D1329F4bb34e13Da03FE10c374b](https://bscscan.com/address/0x959715da68DC2D1329F4bb34e13Da03FE10c374b) |
| Arbitrum | [0xc0Dc7C5057141C9065bd9bedf79fd4E9EA69a739](https://arbiscan.io/address/0xc0Dc7C5057141C9065bd9bedf79fd4E9EA69a739) |
| Optimism | [0x7B598182875Df02236eEa8a3e264f9376511D5ad](https://optimistic.etherscan.io/address/0x7B598182875Df02236eEa8a3e264f9376511D5ad) |
| Polygon | [0x958b0166B9De547a1998cc06A55c4fa5B4304d0d](https://polygonscan.com/address/0x958b0166B9De547a1998cc06A55c4fa5B4304d0d) |
| | |

### Dashboard
#### Total Assets：1+2+3
1. dForce Lending所有网络总存款价值+Liqee Lending所有网络总存款价值-（USX存款总额和EUX存款总额）
备注：减掉USX和EUX是因为#2已经包含。[dForce Lending](https://docs.google.com/spreadsheets/d/1Mxh1lashjSv_Gy4Z1nCj0lbZ2qeC91G9/edit#gid=1790215788)和[Liqee Lending](https://hackmd.io/haBUYZyNR4yPlEO0Z7h22A)
2. 各网络USX total supply和EUX total supply之和
备注：以太网络需要减掉该合约的数量：
[0x9e8b68e17441413b26c2f18e741eaba69894767c](https://etherscan.io/address/0x9e8b68e17441413b26c2f18e741eaba69894767c)
[0x40be37096ce3b8a2e9ec002468ab91071501c499](https://etherscan.io/address/0x40be37096ce3b8a2e9ec002468ab91071501c499)

| 网络 | Address |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Ethereum | [0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8](https://etherscan.io/token/0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8) |
| BSC | [0xb5102cee1528ce2c760893034a4603663495fd72](https://bscscan.com/token/0xb5102cee1528ce2c760893034a4603663495fd72) |
| Arbitrum | [0x641441c631e2f909700d2f41fd87f0aa6a6b4edb](https://arbiscan.io/token/0x641441c631e2f909700d2f41fd87f0aa6a6b4edb) |
| Optimism | [0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9](https://optimistic.etherscan.io/token/0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9) |
| Polygon | [0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752](https://polygonscan.com/token/0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752) |
| Avalanche | [0x853ea32391AaA14c112C645FD20BA389aB25C5e0](https://snowtrace.io/token/0x853ea32391AaA14c112C645FD20BA389aB25C5e0) |
| Kava | [0xdb0e1e86b01c4ad25241b1843e407efc4d615248](https://explorer.kava.io/token/0xDb0E1e86B01c4ad25241b1843E407Efc4D615248/token-transfers) |
| Evmos | |

3. 其它：dToken+Goldx+其他
备注：量太小，暂时可不加
#### Total Accumulated Borrow
dForce借贷所有网络每个用户每执行一笔资产的借款都会计算其中，是一个累计量，只会越来越大，不会变小。用户当时操作资产的数量乘以当时的价格
#### Total USX
各网络USX Total Supply总和-该地址USX数量：[0x9e8b68e17441413b26c2f18e741eaba69894767c](https://etherscan.io/address/0x9e8b68e17441413b26c2f18e741eaba69894767c)
[0x40be37096ce3b8a2e9ec002468ab91071501c499](https://etherscan.io/address/0x40be37096ce3b8a2e9ec002468ab91071501c499)

| 网络 | Address |
| -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Ethereum | [0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8](https://etherscan.io/token/0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8) |
| BSC | [0xb5102cee1528ce2c760893034a4603663495fd72](https://bscscan.com/token/0xb5102cee1528ce2c760893034a4603663495fd72) |
| Arbitrum | [0x641441c631e2f909700d2f41fd87f0aa6a6b4edb](https://arbiscan.io/token/0x641441c631e2f909700d2f41fd87f0aa6a6b4edb) |
| Optimism | [0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9](https://optimistic.etherscan.io/token/0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9) |
| Polygon | [0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752](https://polygonscan.com/token/0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752) |
| Avalanche | [0x853ea32391AaA14c112C645FD20BA389aB25C5e0](https://snowtrace.io/token/0x853ea32391AaA14c112C645FD20BA389aB25C5e0) |
| Kava | [0xdb0e1e86b01c4ad25241b1843e407efc4d615248](https://explorer.kava.io/token/0xDb0E1e86B01c4ad25241b1843E407Efc4D615248/token-transfers) |
| Evmos | |

#### DF Markets
* Total Supply
DF以太合约直接可以获得：[DF总量](https://etherscan.io/token/0x431ad2ff6a9c365805ebad47ee021148d6f7dbe0)
* Circulating Supply
通过API可直接获得：[DF流通量](https://api.dforce.network/baseinfo/df/circulating/)
* DF Price
* DF Multi-chain Distribution
DF在已部署5个网络的数量和占比，BSC计算方法需要减掉冷钱包的数量。
BSC需用1亿减掉这2个地址的数量：
[0xf977814e90da44bfa03b6295a0616a897441acec](https://bscscan.com/address/0xf977814e90da44bfa03b6295a0616a897441acec)
[0x5a52e96bacdabb82fd05763e25335261b270efcb](https://bscscan.com/address/0x5a52e96bacdabb82fd05763e25335261b270efcb)

| 网络 | Address |
| -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Ethereum | [0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8](https://etherscan.io/token/0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8) |
| BSC | [0xb5102cee1528ce2c760893034a4603663495fd72](https://bscscan.com/token/0xb5102cee1528ce2c760893034a4603663495fd72) |
| Arbitrum | [0x641441c631e2f909700d2f41fd87f0aa6a6b4edb](https://arbiscan.io/token/0x641441c631e2f909700d2f41fd87f0aa6a6b4edb) |
| Optimism | [0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9](https://optimistic.etherscan.io/token/0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9) |
| Polygon | [0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752](https://polygonscan.com/token/0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752) |
| Avalanche | [0x853ea32391AaA14c112C645FD20BA389aB25C5e0](https://snowtrace.io/token/0x853ea32391AaA14c112C645FD20BA389aB25C5e0) |
| Kava | [0xdb0e1e86b01c4ad25241b1843e407efc4d615248](https://explorer.kava.io/token/0xDb0E1e86B01c4ad25241b1843E407Efc4D615248/token-transfers) |
| Evmos | |

#### USX Markets
* USX Total Value
各网络USX Total Supply总和-该地址USX数量：[0x9e8b68e17441413b26c2f18e741eaba69894767c](https://etherscan.io/address/0x9e8b68e17441413b26c2f18e741eaba69894767c)
[0x40be37096ce3b8a2e9ec002468ab91071501c499](https://etherscan.io/address/0x40be37096ce3b8a2e9ec002468ab91071501c499)

| 网络 | Address |
| -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Ethereum | [0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8](https://etherscan.io/token/0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8) |
| BSC | [0xb5102cee1528ce2c760893034a4603663495fd72](https://bscscan.com/token/0xb5102cee1528ce2c760893034a4603663495fd72) |
| Arbitrum | [0x641441c631e2f909700d2f41fd87f0aa6a6b4edb](https://arbiscan.io/token/0x641441c631e2f909700d2f41fd87f0aa6a6b4edb) |
| Optimism | [0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9](https://optimistic.etherscan.io/token/0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9) |
| Polygon | [0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752](https://polygonscan.com/token/0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752) |
| Avalanche | [0x853ea32391AaA14c112C645FD20BA389aB25C5e0](https://snowtrace.io/token/0x853ea32391AaA14c112C645FD20BA389aB25C5e0) |
| Kava | [0xdb0e1e86b01c4ad25241b1843e407efc4d615248](https://explorer.kava.io/token/0xDb0E1e86B01c4ad25241b1843E407Efc4D615248/token-transfers) |
| Evmos | |

1. Lending
dForce Lending和Liqee Lending各网络USX存款总额，相关地址如下：

| 网络 | dForce | Liqee |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| Ethereum-General | [0x1AdC34Af68e970a93062b67344269fD341979eb0](https://etherscan.io/address/0x1AdC34Af68e970a93062b67344269fD341979eb0) | [0xA5d65E3bD7411D409EC2CCFa30C6511bA8a99D2B](https://etherscan.io/address/0xA5d65E3bD7411D409EC2CCFa30C6511bA8a99D2B) |
| Ethereum-Stocks | [0xF54954BA7e3cdFDA23941753b48039aB5192AEa0](https://etherscan.io/address/0xF54954BA7e3cdFDA23941753b48039aB5192AEa0) | |
| BSC-General | [0x7B933e1c1F44bE9Fb111d87501bAADA7C8518aBe]([0x7B933e1c1F44bE9Fb111d87501bAADA7C8518aBe](https://bscscan.com/address/0x7B933e1c1F44bE9Fb111d87501bAADA7C8518aBe)) | [0x450E09a303AA4bcc518b5F74Dd00433bd9555A77](https://bscscan.com/address/0x450E09a303AA4bcc518b5F74Dd00433bd9555A77) |
| BSC-Stocks | [0x911F90e98D5c5C3a3B0c6c37Bf6ea46D15eA6466](https://bscscan.com/address/0x911F90e98D5c5C3a3B0c6c37Bf6ea46D15eA6466) | |
| Arbitrum | [0x0385F851060c09A552F1A28Ea3f612660256cBAA](https://arbiscan.io/address/0x0385F851060c09A552F1A28Ea3f612660256cBAA) | |
| Optimism | [ 0x7e7e1d8757b241Aa6791c089314604027544Ce43](https://optimistic.etherscan.io/address/0x7e7e1d8757b241Aa6791c089314604027544Ce43) | |
| Polygon | [ 0xc171EBE1A2873F042F1dDdd9327D00527CA29882](https://polygonscan.com/address/0xc171EBE1A2873F042F1dDdd9327D00527CA29882) | |
| Avalanche | [ 0x73C01B355F2147E5FF315680E068354D6344Eb0b](https://snowtrace.io/address/0x73C01B355F2147E5FF315680E068354D6344Eb0b) | |
| Kava | [ 0x9787aF345E765a3fBf0F881c49f8A6830D94A514](https://explorer.kava.io/address/0x9787aF345E765a3fBf0F881c49f8A6830D94A514) | |
| Evmos | | |

2. DEX

备注：随时会添加其他网络或其他DEX流动性
| 网络 | DEX | Address |
| -------- | ---- | -------------------------------------------------------------------------------------------------------------------- |
| BSC | DODO | [0xb19265426ce5bc1e015c0c503dfe6ef7c407a406](https://bscscan.com/address/0xb19265426ce5bc1e015c0c503dfe6ef7c407a406) |
| BSC | Pancake | [0x780517aae4bb8375ca97d2ef471ef2abe23bc904](https://bscscan.com/address/0x780517aae4bb8375ca97d2ef471ef2abe23bc904) |
| Arbitrum | DODO | [0x3fb983c686c2df5368092da08f8f56062adf47a6](https://arbiscan.io/address/0x3fb983c686c2df5368092da08f8f56062adf47a6) |

3. cBridge

| 网络 | Address |
| --------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Ethereum | [0x5427fefa711eff984124bfbb1ab6fbf5e3da1820](https://etherscan.io/address/0x5427fefa711eff984124bfbb1ab6fbf5e3da1820) |
| BSC | [0xdd90e5e87a2081dcf0391920868ebc2ffb81a1af](https://bscscan.com/address/0xdd90e5e87a2081dcf0391920868ebc2ffb81a1af) |
| Arbitrum | [0x1619de6b6b20ed217a58d00f37b9d47c7663feca](https://arbiscan.io/address/0x1619de6b6b20ed217a58d00f37b9d47c7663feca) |
| Optimism | [0x9d39fc627a6d9d9f8c831c16995b209548cc3401](https://optimistic.etherscan.io/address/0x9d39fc627a6d9d9f8c831c16995b209548cc3401) |
| Polygon | [0x88dcdc47d2f83a99cf0000fdf667a468bb958a78](https://polygonscan.com/address/0x88dcdc47d2f83a99cf0000fdf667a468bb958a78) |
| Avalanche | [0xef3c714c9425a8f3697a9c969dc1af30ba82e5d4](https://snowtrace.io/address/0xef3c714c9425a8f3697a9c969dc1af30ba82e5d4) |
| Kava | [0xb51541df05DE07be38dcfc4a80c05389A54502BB](https://explorer.kava.io/address/0xb51541df05DE07be38dcfc4a80c05389A54502BB) |
| Evmos | |

4. Arb/BSC/OP Bridges

| 网络 | Address |
| -------- | -------------------------------------------------------------------------------------------------------------------- |
| Ethereum | |
| BSC | |
| Arbitrum | [0x9e8b68e17441413b26c2f18e741eaba69894767c](https://arbiscan.io/address/0x9e8b68e17441413b26c2f18e741eaba69894767c) |
| Optimism | |
| Polygon | |
| Evmos | |

5. Others
USX Total Value-(1+2+3+4)

* USX Multi-chain Distribution
以太网络需要减掉该地址USX数量：
[0x9e8b68e17441413b26c2f18e741eaba69894767c](https://etherscan.io/address/0x9e8b68e17441413b26c2f18e741eaba69894767c)
[0x40be37096ce3b8a2e9ec002468ab91071501c499](https://etherscan.io/address/0x40be37096ce3b8a2e9ec002468ab91071501c499)

| 网络 | Address |
| -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Ethereum | [0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8](https://etherscan.io/token/0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8) |
| BSC | [0xb5102cee1528ce2c760893034a4603663495fd72](https://bscscan.com/token/0xb5102cee1528ce2c760893034a4603663495fd72) |
| Arbitrum | [0x641441c631e2f909700d2f41fd87f0aa6a6b4edb](https://arbiscan.io/token/0x641441c631e2f909700d2f41fd87f0aa6a6b4edb) |
| Optimism | [0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9](https://optimistic.etherscan.io/token/0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9) |
| Polygon | [0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752](https://polygonscan.com/token/0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752) |
| Avalanche | [0x853ea32391AaA14c112C645FD20BA389aB25C5e0](https://snowtrace.io/token/0x853ea32391AaA14c112C645FD20BA389aB25C5e0) |
| Kava | [0xdb0e1e86b01c4ad25241b1843e407efc4d615248](https://explorer.kava.io/token/0xDb0E1e86B01c4ad25241b1843E407Efc4D615248/token-transfers) |
| Evmos | |

| 网络 | Lending | DEX | cBridge | Bridges | Others |
| --------- | ------------ | --- | ------- | ------- | ------ |
| Ethereum | dForce+Liqee | | √ | | 总- |
| BSC | dForce+Liqee | √ | √ | | 总- |
| Arbitrum | dForce | √ | √ | √ | 总- |
| Optimism | dForce | | √ | | 总- |
| Polygon | dForce | | √ | | 总- |
| Avalanche | dForce | | √ | | 总- |
| Kava | dForce | | √ | | 总- |
| Evmos | | | | | |

#### POO-Treasury

| 网络 | Borrow ETH | Entrofi | Protocol Liquidity | Others |
| -------- | ---------- | ------- | ------------------ | ------ |
| Ethereum | | | | |
| BSC | √ | | | |
| Arbitrum | √ | | | |
| Optimism | | | | |
| Polygon | | | | |
| Evmos | | | | |

* Borrow ETH

| 网络 | USX Suppied | ETH Borrowed | Adequacy Ratio | Supply APY | Borrow APY |
| -------- | ----------- | ------------ | -------------- | ---------- | --- |
| Ethereum | | | | | |
| BSC | | | | | |
| Arbitrum | | | | | |
| Optimism | | | | | |
| Polygon | | | | | |
| Evmos | | | | | |

* Entrofi

| 网络 | Debt Ceiling |
| -------- | ------------ |
| Ethereum | |
| BSC | |
| Arbitrum | |
| Optimism | |
| Polygon | |
| Evmos | |

* Protocol Liquidity
备注：执行动作要包括：AddLiquidity、RemoveLiquidity、Swap、Borrow、Repay、Transfer等

| 网络 | Protocol | Stake DF | Stake USX |
| -------- | ---------- | -------- | --------- |
| Ethereum | Uniswap V3 | | |
| Arbitrum | Uniswap V3 | | |
| Arbitrum | DODO | | |
| BSC | Pancake | | |
| BSC | DODO | | |
| Optimism | | | |
| Polygon | | | |
| Evmos | | | |

* Others

#### Protocol Income
* Total revenue 30d
最近30天平台总收入总额
* Total Income 30d
最近30天平台净收入总额
* 图表
每个月的平台总收入和平台净收入，展示最近6个月的数据

### Markets API
#### dForce Lending Total Assets
后续也可能添加生态项目的数据，方便扩展.
#### Total Supply：
以太general Total Supply+以太Stocks Total Supply+BSC General Total Supply+BSC Stocks Total Supply

#### Total Borrow：
以太general Total Borrow+以太Stocks Total Borrow+BSC General Total Borrow+BSC Stocks Total Borrow

#### Total Mint：
以太general Total Mint+以太Stocks Total Mint+BSC General Total Mint+BSC Stocks Total Mint
### dForce Website Data
#### Total Assets：
USDx+GOLDx+dToken+dForce Lending Total Supply (BSC/Ethereum/Arbitrum)+Lending Total Mint (BSC/Ethereum/Arbitrum)+Liqee Lending Total Supply (BSC/Ethereum)+Liqee Lending Total Mint (BSC/Ethereum)
#### Total Accumulated Borrow：
（dForce协议所有网络所有池子的每一笔Borrow+Mint累计值）+（Liqee协议所有网络所有池子的每一笔Borrow+Mint累计值）
#### Total Accumulated Borrow：
Trade协议所有网络每一笔交易的累计值

### dForce TVL
* Legacy TVL

arbi_locked = total_supply
op_locked = total_supply
Polygon_locked = total_supply
Avalanche_locked = total_supply
total TVL = total.usx + total_cash_in_lending - usx_in_lending

Ethereum Circulating Supply：0x0a5e677a6a24b2f1a2bf4f3bffc443231d2fdec8-0x9e8b68e17441413b26c2f18e741eaba69894767c
BSC Circulating Supply：0xb5102cee1528ce2c760893034a4603663495fd72
Arbitrum Circulating Supply：0x641441c631e2f909700d2f41fd87f0aa6a6b4edb
Optimism Circulating Supply：0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9
Polygon Circulating Supply：0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752
Avalanche Circulating Supply：0x853ea32391AaA14c112C645FD20BA389aB25C5e0
Kava Circulating Supply：0xDb0E1e86B01c4ad25241b1843E407Efc4D615248

### USX Circulating Supply
ethereum: {
issued: ["0x0a5E677a6A24b2F1A2Bf4F3bFfC443231d2fDEc8"],
unreleased: [
"0x9e8b68e17441413b26c2f18e741eaba69894767c", // MSD
"0x40be37096ce3b8a2e9ec002468ab91071501c499", // L1 escrow
"0x5427fefa711eff984124bfbb1ab6fbf5e3da1820", // cbridge
//"0x1adc34af68e970a93062b67344269fd341979eb0", // iUSX
],
},
arbitrum: {
issued: ["0x641441c631e2f909700d2f41fd87f0aa6a6b4edb"],
unreleased: [
"0x9e8b68e17441413b26c2f18e741eaba69894767c", // Layer2 Bridge
"0x1619de6b6b20ed217a58d00f37b9d47c7663feca", // cbridge
//"0x0385f851060c09a552f1a28ea3f612660256cbaa", // iUSX
],
},
optimism: {
issued: ["0xbfD291DA8A403DAAF7e5E9DC1ec0aCEaCd4848B9"],
unreleased: [
"0x40a33fb67b8dafe88a5b1930be03c82157f47c65", // PDLP-Velodrome
"0x9D39Fc627A6d9d9F8C831c16995b209548cc3401", // cbridge
//"0x7e7e1d8757b241aa6791c089314604027544ce43", // iUSX
],
},
polygon: {
issued: ["0xCf66EB3D546F0415b368d98A95EAF56DeD7aA752"],
unreleased: [
"0x88dcdc47d2f83a99cf0000fdf667a468bb958a78", // cbridge
//"0xc171ebe1a2873f042f1dddd9327d00527ca29882", // iUSX
],
},
bsc: {
issued: ["0xb5102cee1528ce2c760893034a4603663495fd72"],
unreleased: [
"0xdd90e5e87a2081dcf0391920868ebc2ffb81a1af", // cbridge
//"0x7b933e1c1f44be9fb111d87501baada7c8518abe", // iUSX
],
},
avax: {
issued: ["0x853ea32391AaA14c112C645FD20BA389aB25C5e0"],
unreleased: [
"0xef3c714c9425a8F3697A9C969Dc1af30ba82e5d4", // cbridge
"0x73c01b355f2147e5ff315680e068354d6344eb0b", // iUSX, none is borrowed
],
},
kava: {
issued: ["0xDb0E1e86B01c4ad25241b1843E407Efc4D615248"],
unreleased: [
"0xb51541df05DE07be38dcfc4a80c05389A54502BB", // cbridge
"0x9787aF345E765a3fBf0F881c49f8A6830D94A514", // iUSX, none is borrowed
],
},

## ERC20 AMM
### Backend
1.Pools API(All、Type、Tag、Pool Contract，Token Contract、Token Name、Pool Name)
2.My Pools
3.APR
4.aggregator API
### Contract
1.Test Case（Finished）
2.Router（Test Case）
3.Aggregator
4.Faucet、USX Token（Finished）
5.Saddle vision（Review）

### Frontend
1.Token List
2.Create Pool（Volatile）、Add Liquidity（Volatile、Stable）、Withdraw（Volatile、Stable）
3.Faucet
4.Swap（APi）
6.钱包只保留Goerli即可
7.Create Pool（Stable）
### Others
1.Contract Verify
2.Bounty
3.Docs（Product）
4.中英文
5.PC、手机端、浏览器
### Name
dForce AMM Volatile - USDT-USDC
vAMM-USDT-USDC
dForce AMM Stable - USDT-USDC
sAMM-USDT-USDC

### 列表页
* 筛选
1.默认展示所有Pools（All Pools）
2.搜索框可以通过Pools Name、Pool Address、Token Name、Token Address搜索
3.All Pools、右侧标签（USD、ETH、BTC、Others、My Pools）、搜索框，这三项属于关联筛选。例如选择All Pools、标签USD、搜索框DF，那么结果就应该筛选所有池子USD标签的DF池子，这种情况会搜索到DF-USX这样的池子，不会搜索到DF-ETH池子。
4.如果搜索结果没有，展示No Data
* 标签定义
1.USD-Ethereum

| USD | Address | Column 3 |
| ---- | ------- | -------- |
| USDT | | |
| USDC | | |
| DAI | | |
| TUSD | | |
| FRAX | | |
| USDP | | |
| USDD | | |
| GUSD | | |
| LUSD | | |
| sUSD | | |
| USX | | |

2.ETH-Ethereum
| ETH | Address | Column 3 |
| ------- | ------- | -------- |
| ETH | | |
| stETH | | |
| cbETH | | |
| rETH | | |
| ankrETH | | |

3.BTC-Ethereum
| BTC | Address | Column 3 |
| ------ | ------- | -------- |
| WBTC | | |
| sBTC | | |
| renBTC | | |
| tBTC | | |
| hBTC | | |

### Testnet Token List
* Swap Default Pair
DF-USX
Token 1:USX
Token 2:DF
* Create Volatile Pool
Default Pair:
Token 1:USX
Token 2:Empty（Select Token）
* Volatile Pools
DF-USX(Contract)
DF-WETH
USDT-USX(Contract)
USDT-USDC
USX-WETH
WBTC-WETH
WBTC-USX
WBTC-USDT
* Stable Pools
USDT-USX(Contract)
USDT-USDC-USX(Contract)
USDC-DAI-USDT-USX(Contract)
WBTC-HBTC(Contract)

* Router Token
USX
USDT
USDC
ETH

* Faucet all tokens

| Assets | Amount | Contract Address | Link | |
| ------ | ------ | ------------------------------------------ |:-------------------------------------------------------------------------------------- |:--- |
| USX | 10,000 | 0x708f9e98eaAACcF9b540B6B56D79e63d304FD468 | [link](https://sepolia.etherscan.io/address/0x708f9e98eaAACcF9b540B6B56D79e63d304FD468) | |
| DAI | 10,000 | 0x64Ea4B0B4363Fc053B073Be3ec83448Aa4035aFc | [link](https://sepolia.etherscan.io/address/0x64Ea4B0B4363Fc053B073Be3ec83448Aa4035aFc) | |
| DF | 100,000 | 0x4ed818eDd4a0c36A3F43826A60630879b8164401 | [link](https://sepolia.etherscan.io/address/0x4ed818eDd4a0c36A3F43826A60630879b8164401) | |
| HBTC | 1 | 0x799b4e45321C9BF484B660B166221AE62C64672C | [link](https://sepolia.etherscan.io/address/0x799b4e45321C9BF484B660B166221AE62C64672C) | |
| USDC | 10,000 | 0xEB50F151484A64b972747f31E6483C6463e32cc1 | [link](https://sepolia.etherscan.io/address/0xEB50F151484A64b972747f31E6483C6463e32cc1) | |
| USDT | 10,000 | 0x778d20CE2f51B3b882b76b8268F32F6211E69834 | [link](https://sepolia.etherscan.io/address/0x778d20CE2f51B3b882b76b8268F32F6211E69834) | |
| WBTC | 1 | 0x25503b21b631C85E88Dd4b6b55eac52f9672399C | [link](https://sepolia.etherscan.io/address/0x25503b21b631C85E88Dd4b6b55eac52f9672399C) | |
| UNI | 1,000 | 0x7e7e6f65F32C6b39d2dD135F4b62646d9e2DAf17 | [link](https://sepolia.etherscan.io/address/0x7e7e6f65F32C6b39d2dD135F4b62646d9e2DAf17) | |

Test-Decimal
| Assets | Decimal | Contract Address | Link | |
| ------ | ------ | ------------------------------------------ |:-------------------------------------------------------------------------------------- |:--- |
| SBTC | 0 | 0xF3d29e9D5A4208284C187A008376A1D7f0058ABb | [link](https://sepolia.etherscan.io/address/0xF3d29e9D5A4208284C187A008376A1D7f0058ABb) | |
|ZD | 0 | 0x4aD3821892FaFa5258aBDF4A5636eCCA676E7728 | [link](https://sepolia.etherscan.io/address/0x4aD3821892FaFa5258aBDF4A5636eCCA676E7728) | |
| TD | 2 | 0x64fDaef7316E1E38fA85910D544F91680CaeFefa | [link](https://sepolia.etherscan.io/address/0x64fDaef7316E1E38fA85910D544F91680CaeFefa) | |
|TTD | 22 | 0x780fF13Ee385fcab78e10259Ca26E3d449Af1b19 | [link](https://sepolia.etherscan.io/address/0x780fF13Ee385fcab78e10259Ca26E3d449Af1b19) | |
| TSD | 36 | 0x577fF076Fa10B29e46B35F4Bba6ed58a22919B44 | [link](https://sepolia.etherscan.io/address/0x577fF076Fa10B29e46B35F4Bba6ed58a22919B44) | |
| FZD | 40 | 0x0f47cA9e1f692E535829835FfDC086C45585DF1c | [link](https://sepolia.etherscan.io/address/0x0f47cA9e1f692E535829835FfDC086C45585DF1c) | |

* Stable pool
SBTC-ZD
SBTC-TD
SBTC-USDT
SBTC-USX
TD-WBTC
TD-USX
SBTC-ZD-TD
SBTC-ZD-USX
SBTC-TD-USX
SBTC-USDT-WBTC-USX

### Issue Update
* Approve
1.正常处理逻辑：输入值大于授权额度，按钮变成Approve（借贷ENABLE），授权额度-1
2.特殊token（以太主网DF）：维护一套特殊token的列表，输入值大于授权额度，按钮变成Approve（借贷ENABLE），授权额度0并执行，执行完成后继续调起Metamask授权额度-1
* Price Impact
针对Swap Token A和Token B，Send Token A和Receive Token B输入框分别有一个数量，从第三方（coingecko: https://www.coingecko.com/zh-tw/api/documentation ） 获取Token A和Token B的价格进行计算对比就会得到Impact Price
例如：
DF Price：$0.0677
USX Price：$0.9998
Send DF Amount：10000
Receive USX Amount：670
Price Impact：(0.9998 * 670-0.0677 * 10000)/(0.9998 * 670)=-1.0649%


表达方式：详见原型或设计稿:https://axhub.im/ax9/3f16266bd285df81/#g=1&id=ranxcd&p=price_impact__5
0<Price Impact<3% 正常颜色
3<=Price Impact<5% 橙色
Price Impact>=5% 红色 （还需要出现提示信息：Price impact warning）

* Stable Pool-Receive LP Amount

## AMM Test Requirement
20230418
优先级设定：H(High)、M(Medium)、L(Low)
### Home
1.Home Search
2.Home Data
M(1)默认按照TVl排序，也可以手动触发TVL排序
M(2)按照APR手动排序
M(3)Pool Address新窗口跳转查看
H(4)Token Symbol一样，但是Address不一样，Logo不能一样
### Create Pools-Volatile
1.Data
L(1)Share of Pool字段，需跟随输入数量进行变化
H(2)创建池子完成后，Info信息只有单个token数据更新，另一个没有更新
H(3)操作池子完成后，数据需要进行一次更新
2.Create
M(1)Approve额度检查（需要一起沟通token的逻辑）
M(2)将MAX按钮去掉，设置每个token的balance字段整体可点击为MAX。
M(3)所有数据按照千分位显示：Info Token信息、Balance、交易历史
L(4)token或LP余额规范，小于0.0001，展示全部Balance
M(5)create按钮仅在下方的token输入0后会置灰，应该初始状态置灰直到两个token额度都有效才变蓝色
### Add Liquidity
H1.Stable Pool：缺少以余额最小的token为基础，按照池子里各token比例填入对应额度（去掉All Balance）
H2.Stable Pool：缺少添加流动性滑点显示和接收LP数量（待规划）
L3.＜Back 一整行都是可点击区域，需要调小范围至点击back按钮周围才有返回列表效果
### Withdraw
L1.LP的token list窗口，缺少search框、跳转浏览器icon和添加到钱包的icon
M2.LP余额较小时，如0.0000003，删除最后一位3，下方tokne的额度没有变为0
H3.withdraw页面，重复点击max，withdraw按钮会置灰持续loading
### History
M1.交易窗口内，给文案添加链接，点击可新窗口跳转到浏览器（文案见翻译文档）
### Swap
M1.Token List（包括create、deposit）支持搜索、token和合约查询（当前测试环境不支持的原因是没有Tokenlist吗？）
H2.添加Impact Price功能（待规划）
### Others
L1.UI优化
L2.中英文
L3.多端设备、浏览器适配
M4.数据加载较慢
(1)my pool更新较慢
(2)Add Liquidity数据加载较慢
(3)添加流动性完成后，reserve info模块数据更新较慢，主要是volatile池子的deposit操作
(4)LP 列表更新较慢，deposit新的池子需要等待较长时间才会在lp list出现
### 沟通
L1.deposit页面，切换token是否需要记住切换后的pair，刷新页面是否恢复为之前的pair

20230410
一.Home data：
1、TVL需要添加美刀$符号；DF-UNI的TVL应该有值，现在是0
2、my pools加载不出来，持续loading

二.Create：
1、创建成功后，reserve info模块的数据没有自动更新
2、手动输入数值时，输入超过6位小数，另一个值会变成0。例如：创建usx-uni，输入100 usx，在uni输入框输入100.1234567（小数位第7下），usx值会变成0

三.Deposit：
1、deposit交易完成，reserve info模块token的数量、汇率没有自动更新
2、手动输入数值时，输入超过6位小数，另一个值会变成0（跟上面create输入超过6位小输一样的情况）
3.approve token后，deposit无法调起metamask

四.Withdraw：
1、LP token列表加载不出来，都是“...”
2、withdraw交易成功后，share of pool字段数据没有自动更新
3、one coin取出，出现流动性不足的提示之后，再切到custom或者清空数值，流动性不足的提示都没有消失，且withdraw都是置灰的无法点击
4、stable池子-withdraw max，①成功后还剩了些库存，无法全部取出；②virtual price变成了0；③再次deposit，无法只选择个别token，还是需要所有token都填值才能deposit

五.Swap：
1、无返回值

### 池子切换模式
* 按照网络（Ethereum、BSC、ArbitrumOne）分类，网络类型下方展示池子（general、Stocks）。涉及到页面包括：Markets、Farm-Lending、Liquidation、Price
* 如果当前网络没有该池子，则不显示该池子，跳转到默认Lend池子。涉及到页面包括：Markets、Farm-Lending、Liquidation、Price
* #### Markets页面，如果当前在BSC-Stocks界面，切换到Arbitrum网络上，应该展示Arbitrum-General，不跳转出去
### Trade
* 在新版本模式下支持旧合约
* 在新版本模式下添加Arbitrum网络，需要配置token list
* 旧合约支持Arbitrum，接入dodo
* 默认pair：DF-USX
* 上方从上到下：DF USX USDC USDT EUX ETH WBTC DAI
* 下方从上到下：DF USX USDC USDT EUX ETH WBTC DAI
### 流动性挖矿多挖
* 支持一挖、双挖和三挖模式的流动性挖矿，不同模板可配置
* 多挖token展示
* 多挖总APY和单个APY展示
* 一键取出多挖奖励
详细查看：https://axhub.im/ax9/8b2f9d403cf2dab5/#g=1&id=7jq568&p=stake-double

### Lending和trade更换gas price
* Ethereum
https://api.zapper.fi/v1/gas-price?api_key=96e0cc51-a62e-42ca-acee-910ea7d2a241&network=ethereum&eip1559=false
* BSC
https://api.zapper.fi/v1/gas-price?api_key=96e0cc51-a62e-42ca-acee-910ea7d2a241&network=binance-smart-chain&eip1559=false
* arbitrum
https://api.zapper.fi/v1/gas-price?api_key=96e0cc51-a62e-42ca-acee-910ea7d2a241&network=arbitrum&eip1559=false
### Lending各池子展示当前Block
Lending左下角展示当前Block数，点击当前Block可以跳转到对应的浏览器查看，API中获取“blockNumber”。ArbitrumOne跳转到etherscan即可。设计稿已上传到蓝湖，可参考原型：https://axhub.im/ax9/8b2f9d403cf2dab5/#g=1&id=7jq568&p=stake-double
* bsc API
https://app.dforce.network/general/blockStatus?network=bsc
* Ethereum API
https://app.dforce.network/general/blockStatus?network=mainnet
* ArbitrumOne API
https://app.dforce.network/general/blockStatus?network=ArbitrumOne

### Lock DF逻辑梳理
* Create Lock-0
1.默认没有选择时长和填入数量，锁仓时间、返回APY值和用户可接收vDF数量：…
2.只有输入框填入数量没有选择锁仓时长，锁仓时间、返回APY值和用户可接收vDF数量：…
3.只有选择锁仓时长没有输入框输入数量，锁仓时间有值，返回APY值和用户可接收vDF数量：…
4.输入框输入数量有值和选择了锁仓时长，那么锁仓时长、APY和vDF数量会有返回值
* Add Amount-1
1.输入框没有输入数量，可接收vDF数量：…
2.输入框输入数量，可接收vDF数量有值
* Extend Time-1
1.默认没有选择时长，锁仓时间、返回APY值和用户可接收vDF数量：…
2.选择时长，那么锁仓时长、APY和vDF数量会有返回值
* Recreate Lock-2
1.默认输入框无值、0或有值，默认没有选择时长，锁仓时间、返回APY值和用户可接收vDF数量：…
2.默认输入框无值、0或有值，已选择时长，那么锁仓时长、APY和vDF数量会有返回值

### 授信模式
* 授信额度
合约授信10,000*1.01 USX,前端返回授信额度10000/1.01，用户可借额度=10000/1.01-total Borrow

### 连接钱包逻辑
* Create Lock-0

## 备忘录
* 各链当前Block数显示