Whitelist ERC-3643 : comment un wallet est-il validé ?
Un agent inscrit le wallet de Bruno dans la whitelist d’un token, puis l’en retire. Que deviennent les 50 parts qu’il détient déjà ?
EN 30 SECONDES
Un registre d’identité ERC-3643 est une whitelist de wallets avec des habilitations : une clé agent inscrit un wallet, puis chaque transfert vérifie le destinataire. Retirer un wallet bloque les transferts vers lui, mais ses tokens restent.
À RETENIR · 3
- ERC-3643 peut implémenter le schéma de whitelist : une clé agent inscrit un wallet, et chaque transfert vérifie le destinataire.
- Retirer un wallet bloque les nouveaux transferts vers lui, mais ses tokens restent où ils sont.
- La clé propriétaire peut remplacer le registre d’identité. Qui détient quelle clé ? L’émetteur, son agent de transfert et leurs conseils en décident.
Sur cette page
Comment un registre d’identité ERC-3643 inscrit un wallet, étape par étape
EN BREF Les propriétaires des registres fixent les règles. Une clé agent ajoute le wallet. Puis chaque transfert revérifie le destinataire selon ces règles.
LES MOTS À CONNAÎTRE
- Registre d’identité
- Le contrat ERC-3643 qui liste les wallets inscrits et relie chacun à une fiche d’identité.
- Claim
- Une attestation signée sur l’ONCHAINID d’un investisseur, du type « identité vérifiée », venant d’un tiers de confiance du token.
- Clé agent
- Une adresse nommée par le propriétaire pour les opérations courantes, comme inscrire ou geler un wallet. La clé propriétaire, elle, fixe les règles.
EN CLAIR
Le contrôle se fait dans le token. Son Registre d’identité Le contrat ERC-3643 qui liste les wallets inscrits et relie chacun à une fiche d’identité. Voir le glossaire relie chaque wallet inscrit à la fiche d’identité de l’investisseur (ONCHAINID) et à un code pays. Une Clé agent Une adresse nommée par le propriétaire pour les opérations courantes, comme inscrire ou geler un wallet. La clé propriétaire, elle, fixe les règles. Voir le glossaire écrit chaque inscription.
ÉTAPE PAR ÉTAPE
Étape 1. Fixer les règles. Les propriétaires des registres choisissent les claims requis et les émetteurs de confiance. Un déploiement peut confier les deux au propriétaire du token.
- Fixer les règles Les propriétaires des registres choisissent les claims requis et les émetteurs de confiance. Un déploiement peut confier les deux au propriétaire du token.
- Signer un claim Un émetteur de confiance signe un claim, par exemple une identité vérifiée, sur l’ONCHAINID de Bruno.
- Inscrire le wallet Une clé agent inscrit le wallet de Bruno, son ONCHAINID et un code pays. C’est ça, le whitelisting.
- Demander À chaque transfert, émission (mint) ou transfert forcé (sans la signature du porteur), le token interroge le registre sur le destinataire.
- Répondre Oui seulement si chaque sujet requis a un claim valide d’un émetteur de confiance.
- Refusé Le wallet de Carole n’a jamais été inscrit : la réponse est non, et rien ne bouge.
La spec (statut Final) parle d’une « whitelist dynamique d’identités ». Le droit de détenir le token ne s’acquiert pas une fois pour toutes. On le recalcule à chaque transfert, à partir des Claim Une attestation signée sur l’ONCHAINID d’un investisseur, du type « identité vérifiée », venant d’un tiers de confiance du token. Voir le glossaire de celui qui reçoit.
ADAM explique : Prenez l’accueil d’un immeuble : l’agent ajoute votre badge, un lecteur le contrôle à chaque porte. La limite : ce lecteur tient aussi les soldes, et le projet ne dit pas si l’agent d’accueil fait office d’agent de transfert.
ATTENTION
Deux pièges dans T-REX
Sans sujet de claim configuré, tout wallet inscrit passe. Et un transfert ordinaire ne vérifie que l’identité du destinataire ; l’expéditeur, lui, est contrôlé sur ses gels et son solde libre.
Coming up next: Et un wallet retiré alors qu’il détient encore des tokens, que devient-il ?
Un exemple concret : un wallet ajouté, puis retiré
EN BREF Retirer un wallet de la whitelist bloque les nouveaux transferts vers lui, mais ses tokens restent où ils sont.
UN EXEMPLE CONCRET
Chiffres illustratifs
VALIDÉBruno entre dans la whitelist et reçoit 50 parts
ENTRÉE
- Destinataire
- Bruno, inscrit par un agent
- Transfert
- Alice envoie 50 parts
CE QUI SE PASSE
- Les claims de Bruno sont valides, et les contrôles de pause, gel, solde et conformité passent.
- Le transfert aboutit, et le registre off-chain affiche Bruno avec 50 parts.
SORTIE
- Solde de Bruno
- 50
- Rapprochement
- aucun écart
SIGNALÉPlus tard, un agent supprime l’identité de Bruno
ENTRÉE
- Action
- retirer le wallet de Bruno du registre
CE QUI SE PASSE
- Le contrôle d’identité dit désormais non : les nouveaux transferts vers Bruno échouent.
- Ses 50 parts ne bougent pas : supprimer une identité ne détruit (burn) ni ne déplace de tokens.
SORTIE
- Solde de Bruno
- 50 (toujours là)
- Rapprochement
- solde sans identité
OBJET OBTENU
Retiré ne veut pas dire vidé
Coming up next: Mais qui détient les clés qui inscrivent et retirent les wallets ?
Quelle clé de rôle fait quoi
EN BREF La clé propriétaire fixe les règles et peut remplacer le registre. Les clés agent gèrent les wallets, chaque contrat avec sa liste d’agents.
Définit les exigences
Modifie la whitelist
Vers un wallet vérifié, sans le contrôle avant transfert
Bascule un porteur sur un nouveau wallet
Les remplace purement et simplement
ATTENTION
La récupération a une faille
Le code vérifie que le nouveau wallet est une clé de gestion de l’ONCHAINID fourni par l’agent. Il ne vérifie pas que c’est celui du wallet perdu : ce contrôle revient donc à l’agent, dans sa procédure.
Selon le projet, l’agent de transfert garderait le contrôle exclusif de la liste officielle. Mais s’il a les clés agent et l’émetteur la clé propriétaire ? L’émetteur peut alors remplacer le registre.
Est-ce encore un contrôle exclusif ? Je ne trancherai pas ce point de droit.
Je mettrais par écrit qui tient quelle clé. La clé propriétaire irait sur un multisig (un wallet à plusieurs signatures), avec des signataires nommés. Et je verrais avec un avocat avant de déployer.
FAQ
Les propriétaires fixent les règles, une clé agent inscrit chaque wallet et chaque transfert vérifie qui reçoit : cela peut implémenter le schéma de whitelist. Qui devrait tenir la clé agent ? C’est à l’émetteur, à son agent de transfert et à leurs conseils d’en décider.
NIVEAU TERMINÉ
Ce que vous savez maintenant
- Qui fixe les règles, qui inscrit un wallet et pourquoi chaque transfert revérifie le destinataire.
- Pourquoi un wallet retiré garde ses tokens, et pourquoi la clé propriétaire compte pour le contrôle exclusif.
Vérifiez par vous-même
Touchez ou cliquez une question pour voir la réponse.
L’identité d’Alice a été supprimée du registre, mais elle détient encore des tokens. Elle en envoie à Bruno, qui est vérifié. La suppression bloque-t-elle le transfert ?
Pas à elle seule. Dans T-REX, un transfert ordinaire ne vérifie l’identité que du destinataire. Alice, elle, est contrôlée sur ses gels et son solde libre.
Ancien CTO d’Integra. Auteur nommé (1 sur 5) d’ERC-3643, premier auteur d’ERC-6960, co-auteur d’ERC-7410 et co-auteur d’ERC-8203, encore à l’état de brouillon. Conçoit des systèmes d’IA en production et des systèmes Web3 régulés.
Un projet à livrer ou un poste à pourvoir ?
Parlons de votre besoinSuivre les notes techniques
Recevez les nouveaux articles sur l’IA en production et les smart contracts par email.