Skip to content

[VEN-3254] Add Token Converters #300

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: docs/VEN-3271
Choose a base branch
from
Draft

[VEN-3254] Add Token Converters #300

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c0291ad
fix: updated token convertors for bnb
web3rover Jun 19, 2025
0e003f2
fix: specify bnb chain
web3rover Jun 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions deployed-contracts/token-converters.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@
* SingleTokenConverterBeacon: [`0x4c9D57b05B245c40235D720A5f3A592f3DfF11ca`](https://bscscan.com/address/0x4c9D57b05B245c40235D720A5f3A592f3DfF11ca)
* USDTPrimeConverter: [`0xD9f101AA67F3D72662609a2703387242452078C3`](https://bscscan.com/address/0xD9f101AA67F3D72662609a2703387242452078C3)
* USDCPrimeConverter: [`0xa758c9C215B6c4198F0a0e3FA46395Fa15Db691b`](https://bscscan.com/address/0xa758c9C215B6c4198F0a0e3FA46395Fa15Db691b)
* BTCBPrimeConverter: [`0xE8CeAa79f082768f99266dFd208d665d2Dd18f53`](https://bscscan.com/address/0xE8CeAa79f082768f99266dFd208d665d2Dd18f53)
* ETHPrimeConverter: [`0xca430B8A97Ea918fF634162acb0b731445B8195E`](https://bscscan.com/address/0xca430B8A97Ea918fF634162acb0b731445B8195E)
* WBNBPrimeConverter: [`0x55a4b16A6d133085Fc15E32972af7AE518b2FC4d`](https://bscscan.com/address/0x55a4b16A6d133085Fc15E32972af7AE518b2FC4d)
* FDUSDPrimeConverter: [`0xF4Ff8Bf521113667eF9BC3a58E576AF3A5A4f8C5`](https://bscscan.com/address/0xF4Ff8Bf521113667eF9BC3a58E576AF3A5A4f8C5)
* XVSVaultConverter: [`0xd5b9AE835F4C59272032B3B954417179573331E0`](https://bscscan.com/address/0xd5b9AE835F4C59272032B3B954417179573331E0)
* WBNBBurnConverter: [`0x9eF79830e626C8ccA7e46DCEd1F90e51E7cFCeBE`](https://bscscan.com/address/0x9eF79830e626C8ccA7e46DCEd1F90e51E7cFCeBE)
* ConverterNetwork: [`0xF7Caad5CeB0209165f2dFE71c92aDe14d0F15995`](https://bscscan.com/address/0xF7Caad5CeB0209165f2dFE71c92aDe14d0F15995)
Expand Down Expand Up @@ -42,8 +42,8 @@
* SingleTokenConverterBeacon: [`0xD2410D8B581D37c5B474CD9Ee0C15F02138AC028`](https://testnet.bscscan.com/address/0xD2410D8B581D37c5B474CD9Ee0C15F02138AC028)
* USDTPrimeConverter: [`0xf1FA230D25fC5D6CAfe87C5A6F9e1B17Bc6F194E`](https://testnet.bscscan.com/address/0xf1FA230D25fC5D6CAfe87C5A6F9e1B17Bc6F194E)
* USDCPrimeConverter: [`0x2ecEdE6989d8646c992344fF6C97c72a3f811A13`](https://testnet.bscscan.com/address/0x2ecEdE6989d8646c992344fF6C97c72a3f811A13)
* BTCBPrimeConverter: [`0x989A1993C023a45DA141928921C0dE8fD123b7d1`](https://testnet.bscscan.com/address/0x989A1993C023a45DA141928921C0dE8fD123b7d1)
* ETHPrimeConverter: [`0xf358650A007aa12ecC8dac08CF8929Be7f72A4D9`](https://testnet.bscscan.com/address/0xf358650A007aa12ecC8dac08CF8929Be7f72A4D9)
* WBNBPrimeConverter: [`0xad721D647C83B05DCdce996E99034cd3A8a7e8Fa`](https://testnet.bscscan.com/address/0xad721D647C83B05DCdce996E99034cd3A8a7e8Fa)
* FDUSDPrimeConverter: [`0x8F2925af604D2CA33a1cBE0E92d191cA03Ec3dDB`](https://testnet.bscscan.com/address/0x8F2925af604D2CA33a1cBE0E92d191cA03Ec3dDB)
* XVSVaultConverter: [`0x258f49254C758a0E37DAb148ADDAEA851F4b02a2`](https://testnet.bscscan.com/address/0x258f49254C758a0E37DAb148ADDAEA851F4b02a2)
* WBNBBurnConverter: [`0x42DBA48e7cCeB030eC73AaAe29d4A3F0cD4facba`](https://testnet.bscscan.com/address/0x42DBA48e7cCeB030eC73AaAe29d4A3F0cD4facba)
* ConverterNetwork: [`0xC8f2B705d5A2474B390f735A5aFb570e1ce0b2cf`](https://testnet.bscscan.com/address/0xC8f2B705d5A2474B390f735A5aFb570e1ce0b2cf)
Expand Down
14 changes: 7 additions & 7 deletions technical-reference/reference-technical-articles/prime.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Venus Prime

{% hint style="info" %}
Only available on BNB chain
Only available on BNB and Ethereum chain
{% endhint %}

## Overview
Expand Down Expand Up @@ -92,25 +92,25 @@ Every market in Venus (including Isolated Lending markets) contributes to the re

<figure><img src="../../.gitbook/assets/prime_funds.svg" alt="Flow of funds related to Prime"><figcaption></figcaption></figure>

Rewards will be distributed to Prime users only in USDT, USDC, BTC and ETH tokens. Other tokens will have to be converted to the tokens used for rewarding users in Prime. This conversion should follow a configurable (via VIP) distribution table, that initially will be:
Rewards will be distributed to Prime users only in configured list of tokens. For example, in BNB chain rewards will be distirbuted in USDT, USDC, WBNB and FDUSD tokens. Other tokens will have to be converted to the tokens used for rewarding users in Prime. This conversion should follow a configurable (via VIP) distribution. In BNB chain initially will be the below:

| Prime market | Distribution |
| --- | --- |
| USDT | 40% |
| USDC | 30% |
| ETH | 25% |
| BTC | 5% |
| WBNB | 25% |
| FDUSD | 5% |

For example:

- The CAKE market generates 1,000 CAKE of total income
- 10% of the CAKE total income should be allocated to Prime → 100 CAKE (following the protocol tokenomics)
- We should convert 100 CAKE to USDC, USDT, BTC and ETH, because in Prime the rewards are defined in these tokens
- We should convert 100 CAKE to USDC, USDT, WBNB and FDUSD, because in Prime the rewards are defined in these tokens
- The conversion should follow the previous table:
- 40 CAKE should be converted to USDT
- 30 CAKE should be converted to USDC
- 25 CAKE should be converted to ETH
- 5 CAKE should be converted to BTC
- 25 CAKE should be converted to WBNB
- 5 CAKE should be converted to FDUSD

Interest reserves (part of the protocol income) from Isolated Pools and the Core Pool markets are sent to the PSR ([Protocol Share Reserve](https://github.com/VenusProtocol/protocol-reserve/blob/main/contracts/ProtocolReserve/ProtocolShareReserve.sol)) contract. Based on the configuration, a percentage of income from all markers is reserved for Prime token holders. The interest reserves will be sent to the PSR periodically (currently every 24 hours, but this can be changed by the community via [VIP](https://app.venus.io/governance)).

Expand Down
4 changes: 2 additions & 2 deletions technical-reference/reference-technical-articles/token-converters.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,8 @@ The **Venus Protocol** generates income in various underlying tokens from intere
| XVSVaultConverter | XVS | 20% | 20% |
| USDTPrimeConverter | USDT | 11% | 0% |
| USDCPrimeConverter | USDC | 6% | 0% |
| BTCBPrimeConverter | BTCB | 1% | 0% |
| ETHPrimeConverter | ETH | 2% | 0% |
| WBNBPrimeConverter | WBNB | 1% | 0% |
| FDUSDPrimeConverter | FDUSD | 2% | 0% |
| WBNBBurnConverter | WBNB | 25% | 25% |

### Ethereum Chain
Expand Down