Staking avec parrainage et commission partenaire

Les partenaires peuvent amener des stakers sur Powfi et toucher une part du rendement que ces stakers perçoivent. L’attribution se fait on-chain via l’argument referral du stake. La commission est calculée hors chaîne et versée par l’équipe Powfi.

Contactez l’équipe Powfi avant d’utiliser une adresse de parrainage. Le contrat accepte n’importe quelle adresse comme referral, mais la commission n’est versée qu’aux partenaires ayant un accord avec l’équipe. Cet accord fixe votre adresse partenaire, votre taux de commission, la période de règlement et le mode de paiement. Les stakes marqués avec une adresse que l’équipe ne connaît pas peuvent ne pas donner droit à une commission.

Fonctionnement

Enregistrer votre adresse partenaire auprès de l'équipe

Convenez de l’adresse partenaire que vous utiliserez, de votre taux de commission (y %) et du calendrier de règlement.

Staker avec votre adresse comme referral

Votre frontend ou votre intégration appelle stakeAlphWithReferral avec votre adresse partenaire. Utilisez la même adresse pour chaque stake.

Le rendement revient à vos stakers

Le taux de change du xALPH augmente à mesure que les récompenses du protocole sont distribuées. Vos stakers perçoivent ce rendement comme tout détenteur de xALPH.

Règlement et paiement

À chaque période, l’équipe calcule le rendement généré par le xALPH qui vous est attribué et vous en verse y % en ALPH.

Staker avec un parrainage

import { Powfi } from '@alephium/powfi-sdk'
import { ONE_ALPH } from '@alephium/web3'

const powfi = Powfi.load({ networkId: 'mainnet', signer }) // the staker's wallet
const PARTNER_ADDRESS = '<your registered partner address>'

const result = await powfi.staking.stakeAlphWithReferral(100n * ONE_ALPH, PARTNER_ADDRESS)
console.log(result.txId)

Le staker ne paie rien de plus pour le parrainage. La transaction est identique à stakeAlph (elle joint amount + MINIMAL_CONTRACT_DEPOSIT d’ALPH) et le staker reçoit la même quantité de xALPH.

Le frontend officiel de Powfi n’accepte pas encore de paramètre de parrainage. Pour vous attribuer des stakes, créez votre propre page de staking ou intégration qui appelle stakeAlphWithReferral.

Ce que le contrat fait de `referral`

Aucune validation, aucun enregistrement on-chain. XAlphToken.stake(amount, referral) accepte n’importe quelle adresse et se contente de l’enregistrer dans l’événement Staked.
L’adresse de parrainage ne reçoit aucun jeton. Comme rien ne lui est transféré, elle n’apparaît pas dans la vue de transaction de l’explorateur. Elle n’est visible que dans l’événement.
Le stake doit provenir d’un wallet. stake exige que l’appelant soit une adresse d’actifs (wallet) : un contrat ne peut donc pas staker au nom d’un utilisateur.
L’événement est Staked(to, referral, alphAmount, xAlphAmount) : staker, parrain, ALPH déposé, xALPH minté.

Vérifier l’attribution

N’importe qui peut vérifier à quel parrain un stake a été attribué en lisant les événements de la transaction depuis un nœud :

const xAlphAddress = powfi.staking.getConfig().xAlphTokenAddress
const { events } = await powfi.nodeProvider.events.getEventsTxIdTxid(txId)

// Staked is the first event declared by XAlphToken (eventIndex 0)
const staked = events.find((e) => e.contractAddress === xAlphAddress && e.eventIndex === 0)
const [to, referral, alphAmount, xAlphAmount] = staked!.fields.map((f) => f.value)

Les adresses sans groupe peuvent apparaître avec un suffixe :<group> dans l’événement. Il s’agit de la même adresse.

Calcul de la commission

Pour chaque période de règlement :

xALPH attribué : somme des xAlphAmount de tous les événements Staked dont le referral est votre adresse.
Hausse du taux : yieldRateDelta = taux(fin de période) − taux(fin de la période précédente), avec taux = totalDepositedAlph / totalXAlphSupply (voir Staking).
Rendement brut : xALPH attribué × yieldRateDelta, en ALPH.
Votre commission : rendement brut × y %.

Ce qui influe sur les montants :

Seul le xALPH minté au moment du stake compte. Les transferts et unstakes ultérieurs de xALPH ne sont pas suivis.
Staker ne fait pas bouger le taux. Les nouveaux stakes mintent du xALPH au taux courant. Le taux n’augmente que lorsque des récompenses sont déposées.
Le rendement dépend des revenus du protocole. Le taux augmente quand RewardFeeCollector.distributeRewards() s’exécute. Il distribue totalDepositedAlph × rewardRate × temps écoulé / 1 an (un taux annuel), plafonné par l’ALPH que le collecteur détient grâce aux frais de trading. Les parts de la trésorerie et du burn sont prélevées d’abord, et le reste fait monter le taux du xALPH. Si le volume de trading est faible, le rendement à partager l’est aussi.

Paiement

La commission est un montant dû calculé hors chaîne, pas un transfert on-chain déclenché par le stake. L’équipe la verse en ALPH depuis la trésorerie, selon votre accord. Comme toutes les données d’entrée (les événements Staked et le taux du xALPH) sont publiques on-chain, vous pouvez recalculer votre commission de façon indépendante. Demandez à l’équipe la page de vérification qui liste vos règlements.

Commission de parrainage et frais d’intégrateur

Ce sont deux mécanismes distincts :

	Commission de parrainage (cette page)	Frais d’intégrateur
S’applique à	Staking (`stakeAlphWithReferral`)	Swaps (`cpmm.swap`, `clmm.swap`)
Qui paie	Powfi, sur le rendement du protocole	L’utilisateur, en plus du swap
Calcul	Hors chaîne, par période de règlement	On-chain, montant fixé par l’intégrateur
Versement	Par l’équipe, selon l’accord	Immédiat, dans la même transaction
Accord avec l’équipe requis	Oui	Non

SDK et API

Concepts clés

Modules

Utilitaires

Guides

Référence

Staking avec parrainage et commission partenaire

Fonctionnement

Staker avec un parrainage

Ce que le contrat fait de `referral`

Vérifier l’attribution

Calcul de la commission

Paiement

Commission de parrainage et frais d’intégrateur

​Fonctionnement

​Staker avec un parrainage

​Ce que le contrat fait de referral

​Vérifier l’attribution

​Calcul de la commission

​Paiement

​Commission de parrainage et frais d’intégrateur

Fonctionnement

Staker avec un parrainage

Ce que le contrat fait de `referral`

Vérifier l’attribution

Calcul de la commission

Paiement

Commission de parrainage et frais d’intégrateur