Why a 0.5 threshold and not 42 for the USDREG oracle?

EzSwim

Is the DAO happy with the current limits on the USDREG conversion oracle ?
minAnswer = 0.5 USDREG (lower limit of the bracket in the smart contract/ also refered to as "the threshold")
maxAnswer = 100 USDREG (upper limit of the bracket in the smart contract)

Theses values were initialized by RealT as they released the USDREG conversion vault on march 19. (it was discussed with experts over at Chainlink and based on the REG price at the time)

Theses limits can be modified and Michael encouraged the DAO on Telegram to discuss the relevance of the initial values.

This suggestion serves as a means for anyone to follow the debat on:

How should the DAO manage the USDREG conversion Threshold ?

Context :

To put things into context, it's important to understand the impact of this threshold (currently at 0.5) for the USDREG oracle and why it was put in place.

On March 19 2025, a tool appeared to claim your REG. This tool allows you to convert your USDREG (the right to mint REG based on their value).

RealT has implemented a conversion threshold. Currently, it's therefore not possible to convert USDREG below 0.5 per 1 REG.

This threshold is not intended to control the price of REG, but rather to limit high inflation in case of a hack on the oracle.

For instance, if a hacker found a way to manipulate the oracle to return 1 REG = 0.0001 USDREG, it would then be very easy to create a lot of REG and thus have uncontrolled inflation. This threshold is therefore an essential protection mechanism for the security of REG and its supply. This mechanism could potentially be adjusted over time depending on the liquidity of REG and the level of risk we are willing to take.

~~We must maintain a balance between a conversion that reflects market reality and a conversion that does not endanger REG and its supply.~~ (do we really have to? Some DAO members have argued against)

Where does this threshold of 0.5 come from? This value, implemented by RealT, is based on Chainlink's recommendations. Chainlink, which is used to managing this type of oracle, recommended 0.5 to protect the REG supply as a minimum (at the time 1 REG was worth between $1.5 and $2). REG markets have especially very low liquidity. If liquidity were sufficient, this threshold would not necessarily be required

How the oracle algorithm works :

You can find the oracle smart-contract here.

Every 24h, the fulfillRegPrice(bytes32,uint256) function updates the price the oracle (🔴) returns to the USDREGConversionVault with an off-chain price (🔵). This price (🔵) is calculated from Chainlink's server (more insights on how this price is calculated in the wiki).

Below you can find the conditions (written in english) that acts as the protective measure against hackers:
If the price (🔵) is within the range [minAnswer; maxAnswer] and [regTwapPrice * (1 - diffFactor); regTwapPrice * (1 + diffFactor)] then update the oracle price (🔴).

On march 19:
minAnswer = 50000000 (= 0.5 since 8 decimals) => the lower limit of the bracket
maxAnswer = 10000000000 (= 100 since 8 decimals) => the upper limit of the bracket
regTwapPrice => The on-chain TWAPOracleREGUSD calculated price
diffFactor = 500 (= 5% since 10000 = 100%) => probably to check if the off-chain price (🔵) returned by chainlink's server is not widely off the regTwapPrice

The full fulfillRegPrice(bytes32,uint256 ) function:

function fulfillRegPrice(
        bytes32 requestId,
        uint256 price
    ) public recordChainlinkFulfillment(requestId) {
        uint256 regTwapPrice = getRegTwapPriceInUsd();
        uint256 diffFactorCache = _priceRangeDiffFactor; // cache to save gas
        uint256 minAnswerCache = _minAnswer; // cache to save gas
        uint256 maxAnswerCache = _maxAnswer; // cache to save gas

        // If the price is within the range (minAnswer, maxAnswer) and (regTwapPrice * (1 - diffFactor), regTwapPrice * (1 + diffFactor)) then update the price
        if (
            price >
            ((regTwapPrice * (PRICE_RANGE_FACTOR - diffFactorCache)) /
                PRICE_RANGE_FACTOR) &&
            price <
            ((regTwapPrice * (PRICE_RANGE_FACTOR + diffFactorCache)) /
                PRICE_RANGE_FACTOR) &&
            price > minAnswerCache &&
            price < maxAnswerCache
        ) {
            // Emit the callback function event
            emit RequestRegPriceFulfilled(requestId, price);

            _latestAnswer = int256(price);
            _latestRound += 1;
            _latestTimestamp = block.timestamp;
            _answers[_latestRound] = _latestAnswer;
            _timestamps[_latestRound] = block.timestamp;
            emit AnswerUpdated(int256(price), _latestRound, block.timestamp);
            emit NewRound(_latestRound, msg.sender, block.timestamp);
        } else {
            // Emit the off-chain price out of range event
            // Do not revert the transaction to prevent Chainlink automation from stopping
            emit OffChainPriceOutOfRange(
                price,
                regTwapPrice,
                diffFactorCache,
                minAnswerCache,
                maxAnswerCache,
                requestId
            );
        }
    }

Michael-RealT

EzSwim Theses values were imposed by RealT as they developed the USDREG conversion vault.

Avec se genre de remarque, il pourrais que RealT ne développe plus rien, REALT n'as pas imposer, et c'est meme Realt qui as demander a la DAO de décider de la politique lier a ses valeurs, RealT n'as que mis ds paramétré par rapporta un moment de déploiement, Valeur qui ne sont pas en dure et donc modifiable se qui as été demander a la DAO de décidé

se commentaire est d'une total mauvaise fois

Michael-RealT

EzSwim Indeed, with a price manipulation where a REG would be worth 0.01, it would then be very easy to create a lot of REG and thus have uncontrolled inflation. This threshold is therefore an essential protection mechanism for the security of REG and its supply. This mechanism could potentially be adjusted over time depending on the liquidity of REG and the level of risk we are willing to take.

il y as une erreur ici c'est pas contre une manipulation du prix sur le marché, la protection contre cela c'est la logique de fonctionnement de l'oracle qui le calcule, baser sur les conseilles de la team Chainlink.
le prix si c'est le prix que la communauté décide en vendant sans racheter sera le prix.

le Seuil dans le contrat a pour objectif de protéger les failles dans la valeur de l'oracle, si un hacker trouve une solution pour forcé une valeur comme 0.0001 alors que le REG n'a pas cette valeur sur le marché.
Le seuil a donc pour objectif de limité la casse en cas de hack de l'oracle.

Michael-RealT

EzSwim Where does this threshold of 0.5 come from? This value, implemented by RealT, is based on Chainlink's recommendations. Chainlink, which is used to managing this type of oracle, recommended 0.5 to protect the REG supply as a minimum, especially in a very low liquidity market. If liquidity were sufficient, this threshold would not necessarily be necessary

oui ce'st baser sur les discussion dans un contexte donné, un REG qui étais entre 1.5 et 2$
Le contexte a changer et RealT a demander de prendre ses responsabilité en fixant une politique de mise a jours de ses valeurs.
au lieu de réfléchir efficacement sur le sujet, la communauté fais des affirmation hors de propos et totalement incorrect, des proposition absurde, espérons que la réflexion sera meilleur ici

Benoist-Not-for-sale

Totally agree although it is currently the opposite:
min REG price is 0.5 USD / REG, minimum thresold is 1 USDREG = 2 REG.
So it makes sense to set min answer to 24 instead of 42

EzSwim

Benoist-Not-for-sale

What are you agreeing with and how is 24 any better than 42 I don't understand the logic behind.

For the record, 42 was @DRKTT 's absurd answer to my absurd suggestion on Telegram where I said something along the lines of "Let's ramp up the lower limit to 10" (meaning way above the REG market price) because people kept telling me the lower limit is JUST a preventive measure against hyperinflation.
If that were TRUE, everyone should be ok with 42.

I now have explained in great details how the oracle works and what was the intended purpose of theses limits.
If readers still have troubles understanding the topic please tell me what is keeping you from participating and I will update the suggestion accordingly as well as try my best to provide you with answers.

PhilP

Je trouve surprenant que la question soit posée ainsi, surtout par quelqu'un qui fait de supers videos de vulgarisation !
Seuls les personnes qui ont lu les dizaines de messages sur le TG DAO d'hier, peuvent comprendre de quoi il en retourne.
Le sujet à traiter par la DAO https://t.me/realtokendao_official/3/9649 me semble mériter mieux, pour que chacun s'approprie la problématique et puisse avoir un avis.

EzSwim

PhilP
This is to move the debate to the forum. I don't think the topic is easy to follow for non-french speakers on Telegram. I deliberately phrased it in a provocative way so that interested people would take part in the discussion and explain their point of view and their understanding of the threshold mechanism.

Why is 0.5 better than 42?

If the oracle's price really aims to prevent hyperinflation, why not choose a stupidly high number as the threshold?

If people instinctively reject a minAnswer (lower limit) above the market price, why?

Why a bracket and not a fixed random number?

Maybe we should keep the default 0.5-100 forever ? Maybe not, if so, why and how should we decide on the next limits?

Yohann76

To clarify and put things into context, it's important to understand the impact of this threshold (currently at 0.5) for the USDREG oracle and why it was put in place.

A few days ago, a tool appeared to claim your REG. This tool allows you to convert your USDREG (the right to mint REG based on their value).

RealT has implemented a conversion threshold. Currently, it's therefore not possible to convert USDREG below 0.5 per 1 REG.

This threshold is not intended to control the price of REG, but rather to limit high inflation in case of REG price manipulation.

Indeed, with a price manipulation where a REG would be worth 0.01, it would then be very easy to create a lot of REG and thus have uncontrolled inflation. This threshold is therefore an essential protection mechanism for the security of REG and its supply. This mechanism could potentially be adjusted over time depending on the liquidity of REG and the level of risk we are willing to take.

We must maintain a balance between a conversion that reflects market reality and a conversion that does not endanger REG and its supply.

Where does this threshold of 0.5 come from? This value, implemented by RealT, is based on Chainlink's recommendations. Chainlink, which is used to managing this type of oracle, recommended 0.5 to protect the REG supply as a minimum, especially in a very low liquidity market. If liquidity were sufficient, this threshold would not necessarily be necessary.

EzSwim

Michael-RealT

As I clearly suggested to change the threshold, It seemed obvious to me that there was no need to specify that the limits CAN be changed if needed. I have now added a sentence mentioning that just in case.

I also added that it was RealT that invited the DAO to discuss the limits as I agree that It was missing from the context.

After some digging, it seems that the word “impose” doesn't mean what I thought it meant. I thought it meant more "without taking someone's opinion into account" / “regardless of what someone thinks” than “against someone's will”.
Anyway, I was trying to get across that the DAO had no say in the values (0,5 and 100) during the development of the safe. So it must have something to say now that the safe has been delivered. Whether it agrees with the initial values or want to change it. Therefore I switched "impose" to "initialized".

EzSwim

Michael-RealT le Seuil dans le contrat a pour objectif de protéger les failles dans la valeur de l'oracle, si un hacker trouve une solution pour forcé une valeur

Good point, I've applied the changes accordingly.

PhilP

A l'aide des contributions de chacun, cette proposition prend une meilleur tournure : moins provocatrice et plus constructive.
Reste encore :

le titre, qui pourrait par exemple être du type : "Evolution du seuil de protection de l'Oracle",
et la question principale, qui n'a pas trop de sens ..
La valeur minimal de l'oracle ne peut être significativement au dessus des cours, sous peine de pénaliser toutes les personnes qui claimeraient (exemple : avec un cours du REG à 1$, un utilisateur avec 100 USDREG aurait : 100 REG si le seuil était inférieur à 1 et 2,4 REG si le seuil était à 42 !).
Par contre, la question pourrait être : comment ajuster la valeur de cette protection, en fonction de l'évolution du cours du REG...

Cogatos

PhilP La valeur minimal de l'oracle ne peut être significativement au dessus des cours, sous peine de pénaliser toutes les personnes qui claimeraient (exemple : avec un cours du REG à 1$, un utilisateur avec 100 USDREG aurait : 100 REG si le seuil était inférieur à 1 et 2,4 REG si le seuil était à 42 !).

Je te remercie pour ce complément d'information qui donne un argument technique et clair du pourquoi la valeur du minAnswer ne peut être complètement arbitraire. Si je comprends bien, cela signifie qu'en cas de présence de cours du REG en dessous de la limite basse du seuil, c'est bien la valeur basse du seuil qui restera pertinente à considérer afin d'éviter un mint trop important de REG, et ce faisant, n'aura plus aucun sens à une telle valeur.

Idéalement, il faudrait après discussion, ajouter un sondage pour jauger les avis.

Cela dit, les vraies questions pour cette proposition selon moi, seraient :

1) L'intérêt de conserver les niveaux de seuils actuels ou non et pourquoi, en fonction d'intérêts clairement identifiés pour la DAO.

--> D'un côté, si l'on envisage le paramétrage des seuils uniquement d'un point de vue de sécurité en limitant le minting de nouveaux REG en cas de hack, les conserver en l'état aurait du sens, au moins pour une période fixe donné.

--> De l'autre, au travers des diverses discussions sur TG, il avait été question d'éventuellement pouvoir modifier le minAnswer, afin de "gérer" différemment certains événements courts/moyens termes ayant un impact pour la DAO, comme l'arrivée prochaine de nombreuses réévaluations en retard, impliquant une grande quantité de REG susceptibles d'être mintés et vendus, il faudrait que les explicitations en faveur de ces modifications soient claires.

2) Réfléchir aux modalités de modification ultérieures de ces seuils : Doivent-ils être fixés pour une durée déterminé ? Quelles sont les types d'imprévus éventuels à considérer et pouvant nécessiter des modifications d'urgence ? Quels impacts potentiels pour quels seuils bas donnés ?

--> À ce propos, il y avait il me semble des enjeux d'apport de liquidité, qui en fonction du volume apporté, pourrait permettre de motiver un abaissement du seuil vers le bas, afin de permettre l'acquisition davantage de REG max pour ceux croyant au projet et à ses usages futurs, sauf erreur de ma part.

Personnellement, concernant la gestion des seuils, je suis en faveur d'un maintien des seuils actuels pour une durée à déterminée, en ne considérant que l'aspect sécurité de la fonctionnalité pour le moment.

Il m'apparaît important dans un premier temps, de commencer par une phase de pédagogie et d'éducation des utilisateurs autour de l'intérêt de ces mécanismes de seuil, avant de chercher à les manipuler immédiatement sans raison pertinente.

DRKTT

42 était un joke sur telegram et les jokes sur telegram ne devraient être repris ici sur ce forum, ce n'est clairement pas le lieu.

Pour en revenir au débat, il y a eu deux aspects sur ce seuil minimum qui n'est là que dans le cas où l'Oracle serait compromis.

La nécessité d'abaisser le seuil de par exemple de 10%, 25 % ou 50% régulièrement par rapport au prix actuel. Pour cela il semble qu'un vote doit être organisé pour que ce travail (qui doit être manuel) soit fait périodiquement. Je suis pour aller qu'on puisse voter rapidement sur le sujet afin que les personnes qui ont choisi la conversion automatique des USD REG en REG ne soient pas lesés dans les prochaines semaines.
Un certain nombre de personnes souhaitent détourner le but de ce seuil afin de "protéger" le prix du REG. Il faudrait pour cela un autre vote. Je suis contre car cela amènerait plus de problèmes que cela en résoudrait et ceux qui ont choisi la conversion automatique se retrouveraient vraiment comme les dindons de la farce.

PhilP

Pour établir un mode de calcul du seuil de protection, prenons d'abord un exemple pour comprendre quelles sont les variables à prendre en compte :
Soit :

500 millions, le nombre de REG déjà mintés,
1 million, le nombre total d'USDREG disponibles (attribués et non encore convertis),
faisons l'hypothèse extrême, que tous les USSDREG disponibles sont convertis lors du hack.

Donc, si nous souhaitons qu'un hack ne produise pas plus de 1% d'augmentation des REG mintés, la valeur minimum de l'oracle devrait être de 0,2$ par REG.
Explications : 1% x 500 millions = 5 millions REG. 1 millions d'USDREG / 5 millions de REG = 0,2$.

Pour mémoire, le seuil est actuellement à 0,5$
(ce qui, dans l'exemple ci-dessus, générerait lors d'un hack : 2 millions de REG, soit 0,4% d'augmentation des 500 millions mintés)

On voit donc que les variables à prendre en comptes, pour fixer le seuil, sont :

le % max d'inflation accepté lors d'un hack (paramètre qui serait fixé par la DAO)
le nombre de REG déjà mintés (paramètre mesurable lors de l'actualisation du seuil),
le nombre d'USDREG disponible (paramètre mesurable lors de l'actualisation du seuil)
(en gardant l'hypothèse extrême, que tous les USDREG disponibles pourraient être mintés lors du hack).

La DAO devrait en plus décider : la fréquence d'actualisation du seuil.

soit périodiquement (par ex 1 fois par trimestre),
soit conjoncturellement (si le nombre d'USDREG disponible augmentait brutalement, par ex à l'occasion d'un changement de règle de d'attribution des USDREG...)
ou les deux ..

En espérant avoir contribué à l'éclaircissement du débat (dont il serait souhaitable que le titre change ;-) )

EzSwim

PhilP le nombre de REG déjà mintés (paramètre mesurable lors de l'actualisation du seuil),

So the threshold would follow the total "circulating supply" of USDREG (USDREG can be considered "burnt" after the REG conversion) in relation to how much inflation we are comfortable with in case of a hack ? Or did you mean ALL the USDREG that has ever been "distributed" to RealToken holders since the beginning. In which case the threshold can only decrease and never increase (I might come back to that later, I don't know yet if that can cause an issue).

EzSwim

PhilP dont il serait souhaitable que le titre change ;-)

BTW I can't change the title (or haven't found how). I can only edit the first message

PhilP

Je vous propose de regarder ce seuil sous un autre angle, qui va vous montrer qu'il peut avoir une autre fonction que celle de la protection contre un hack de l'oracle.

= > RealT dispose d'un droit de création de REG (via les USDREG), que ce seuil va aussi permettre de limiter.

Revenons déjà sur une confusion, comme quoi "les REG données par RealT, servent à compenser les frais de sourcing (10% en général)".
Cette confusion vient du fait que le montant en REG (USDREG) donnée par RealT, correspond aux frais sourcing, mais ce n'est pas pour autant en compensation !
Par cette distribution, l'objectif de RealT est en fait de permettre aux investisseurs en Realtoken, d'avoir gratuitement des REG pour s'intéresser à ce qu'est la DAO.

Prenons maintenant un cas de figure : Le REG tombe de façon durable à 0,01$ .. 😱
Si il n'y avait pas de seuil sur l'oracle, les attributions d'USDREG générerait des quantités astronomiques de REG (1 million d'USDREG génèreraient 100 millions de REG, soit 20 % du supply).
Dans ce cas, RealT irait à l'encontre de son objectif : il détruirait le DAO en voulant la faire connaitre !

On voit donc qu'avec ce seuil, par ex à 0,5$, l'effet de l'attribution d'USDREG par RealT sera limité à la création de 0,4% du supply (cf mon msg précédent).

Le seuil limite donc l'effet d'un hack sur l'oracle ainsi que l'effet des attributions (gratuites) faite par RealT.

Rappelons que dans cas, il n'y a pas "manipulation de marché" mais juste une limitation des cadeaux faits par RealT

Michael-RealT

A small addition for medium- to long-term consideration.

RealT has already planned how we could technically transfer control of the REG mint from USDREG, once the DAO is more established with roader processes, and probably with Governance v2, which will allow more flexibility in voting.
We will be able to activate this transition; the main difficulty currently would be the 10-day delay if we were to use Governance v1.

The imagined process would be as follows:

Anyone could propose an update to the rights in USDREG
The data generated in Merkle Tree is verified by the DAO
A vote is held to change the root in the contract to validate that the DAO agrees with the data linked to this root
Once the vote is accepted, the rights are active

PhilP

Michael-RealT
Il faudra alors rajouter dans les clauses de ventes des RealTokens, que les USDREG attribués ne le seront vraiment qu’à la suite d’un vote de la DAO…

PhilP

EzSwim
Il s’agit du nombre d’USDREG « disponibles », c’est à dire : tout ceux attribués et moins ceux qui ont déjà donné lieux à conversion.
Ils ne sont pas vraiment brûlés, car l’USDREG n’est pas un token mais un droit à conversion, historisé dans un Merkel tree.

PhilP

EzSwim
Donnes moi le titre que tu souhaites mettre et je vais faire la modification.