Aller au contenu
Aide & guides
Parcourir les guides

Construisez une liste blanche et des détenteurs d'import

Importer des listes CSV, réparer des lignes non valides ou sélectionner des détenteurs de collection par minimum d'avoirs, classement ou tirage aléatoire.

Sur cette page
Un exemple d’importation de détenteurs : filtrer une collection par le nombre minimum d’avoirs, choisir tous, détenteurs supérieurs ou aléatoires, puis passer en revue les portefeuilles sélectionnés et leur allocation minter.
Les avoirs minimum décident qui est admissible. minter allocation décide combien de nouveaux NFT chaque portefeuille importé peut minter . Ce sont des paramètres distincts. Ouvrir l'image pour agrandir

Ouvrez la liste blanche pour la bonne phase

  1. Ouvrez vos paramètres de publication

    Dans votre collection, ouvrez la collection NFT Public minter Modifier les paramètres minter. Choisissez la phase qui devrait avoir un accès restreint.

  2. Choisissez whitelist access

    Chaque phase a sa propre liste ; l'importation dans une phase n'ajoute pas les mêmes portefeuilles à une autre.

  3. Choisissez comment ajouter des portefeuilles

    Utilisez Ajouter un portefeuille pour les adresses individuelles, Importer le fichier CSV pour une liste existante ou Importer des détenteurs pour une collection NFT. Passez en revue les lignes, puis choisissez Utiliser la liste blanche et enregistrer les paramètres minter.

Importer un fichier CSV avec des colonnes facultatives

Vous pouvez importer une liste sans en-tête dans wallet,montant,ordre de prix, y compris wallet-only ou wallet,montant des listes. Le premier portefeuille est conservé. Les adresses non valides restent dans leurs propres lignes pour correction.

Les en-têtes sont facultatifs et leurs noms ne changent pas l'ordre des colonnes: portefeuille d'abord, montant deuxième, prix troisième. Un en-tête détecté est ignoré. Pour définir un prix sans montant, laissez la deuxième colonne vide : portefeuille,,prix.

Les montants sont des nombres entiers positifs. Un montant vierge suit la limite du portefeuille de phase. Les prix utilisent la monnaie native du réseau, telle que ETH ; un prix vide ou omis suit le prix de phase, tandis que 0 rend explicitement le prix de l’œuvre d’art gratuit pour ce portefeuille. Le réseau gas et tous les frais de plate-forme s'appliquent toujours.

Ordre des colonnes (en-tête facultatif)Exemple de ligneQue se passe-t-il ?
Portefeuille0x1111111111111111111111111111111111111111Utilisez la limite de phase et le prix.
wallet,amount0x1111111111111111111111111111111111111111,2Autoriser 2 mints ; utiliser le prix de phase.
wallet,amount,price0x1111111111111111111111111111111111111111,,0.01Utilisez la limite de phase; le prix est 0.01 par NFT.
wallet,amount,price0x1111111111111111111111111111111111111111,2,0Autoriser 2 mints à un prix d'œuvre gratuit.

Corrigez les lignes marquées sans perdre l'importation

  1. Revoyez le numéro

    L'éditeur analyse chaque ligne importée ou ajoutée manuellement. Les adresses non valides, les doubles portefeuilles, les montants non valides et les prix non valides sont indiqués à côté du champ correspondant. Afficher le premier numéro ouvre la page contenant la première ligne marquée.

  2. Vérifiez les données CSV non reconnues

    Les colonnes inconnues, les valeurs supplémentaires et les lignes mal formées restent visibles pour réparation. Copiez toutes les valeurs nécessaires dans le portefeuille, la limite ou les champs de prix, puis choisissez Effacer les données supplémentaires. Effacer ces données élimine ces valeurs supplémentaires, alors vérifiez-les d'abord.

  3. Corriger ou supprimer la ligne

    Modifiez les valeurs marquées ou utilisez le bouton de suppression de la ligne. Les erreurs sont revérifiées lors de la modification. Les adresses en double ne sont pas automatiquement combinées, alors décidez quelle allocation et quel prix conserver.

  4. Appliquez la liste réparée

    Exporter le fichier CSV crée un wallet,montant,prix standard à partir de lignes valides.

Les détenteurs d'importation d'une collection NFT

  1. Choisissez Importer les détenteurs

    Sélectionnez le réseau de la collection source et collez son adresse de contrat. La source peut être une collection différente de celle que vous lancez. Seuls les réseaux configurés et pris en charge apparaissent.

  2. Définissez les NFT minimums détenus

    Entrez le nombre de NFTs qu'un portefeuille doit contenir pour se qualifier. Pour ERC-721 cela compte NFTs ; pour ERC-1155 il compte des copies d'édition dans toute la collection. Ce filtre est appliqué avant toute sélection top ou aléatoire.

  3. Choisissez la méthode de sélection

    Sélectionnez tous les détenteurs admissibles, les détenteurs supérieurs par participations ou les détenteurs admissibles aléatoires. Pour les détenteurs supérieurs ou aléatoires, entrez le nombre de portefeuilles que vous voulez.

  4. Prévisualisez les détenteurs

    Attendez que la liste complète des détenteurs se charge. L'aperçu indique le nombre total de détenteurs, combien sont admissibles et combien sont sélectionnés. Il affiche jusqu'à huit portefeuilles d'échantillons avec leurs avoirs. Vous pouvez annuler une recherche lente sans changer votre liste blanche.

  5. Fixer une allocation optionnelle de minter

    Laissez minter allocation par portefeuille importé vide pour utiliser la limite de phase, ou entrez le nombre chaque portefeuille importé peut minter . Les avoirs existants ne sont pas automatiquement recopiés dans cette allocation. Les prix importés suivent le prix de la phase.

  6. Ajoutez les portefeuilles sélectionnés

    La sélection est ajoutée à vos lignes actuelles. Les portefeuilles déjà listés conservent leur allocation et leur prix existants et sont comptés comme ignorés. Passez en revue la liste complète, puis choisissez Utiliser la liste blanche.

Choisissez tous les détenteurs, en haut ou au hasard

Si moins de portefeuilles sont admissibles que demandé, l'aperçu inclut ce nombre plus petit. Dessine à nouveau fait une nouvelle sélection aléatoire; il n'ajoute pas le tirage précédent à votre liste blanche. La modification des paramètres de collection ou de sélection efface l'ancien aperçu.

Par exemple, une détention minimale de 3 et une allocation de minter de 2 signifie que chaque portefeuille sélectionné doit avoir au moins 3 NFT existants, mais reçoit la permission de minter 2 nouveaux NFT dans cette phase.

SélectionComment ça marcheExemple avec un minimum de 3 NFT
tous les détenteurs éligiblesAjoutez tous les portefeuilles répondant au minimum.Incluez tous les portefeuilles contenant au moins 3 NFT.
Top par holdingsLes plus gros avoirs en premier; les liens sont commandés par adresse de portefeuille.Prenez les 100 plus grands détenteurs de portefeuilles détenant au moins 3 NFT.
Titulaires de qualification aléatoireChaque portefeuille admissible a une chance égale; aucun portefeuille n'est tiré deux fois.Tirez 100 portefeuilles de détenteurs d'au moins 3 NFT. Détenir plus ne donne pas de chances supplémentaires.

Comprendre l'instantané de propriété et les limites

Les importations utilisent des données indexées sur la propriété, qui peuvent accuser un retard par rapport aux transferts récents. L'aperçu s'affiche lorsque Aurora a récupéré les données ; une liste complète des détenteurs est mise en cache pendant cinq minutes maximum. Il s'agit d'une importation unique, pas d'une porte à jetons en direct. Les ventes ou transferts ultérieurs ne suppriment pas automatiquement un portefeuille ni n’ajoutent un nouveau propriétaire.

Les adresses mortes zéro et standard sont exclues. D'autres portefeuilles contractuels peuvent apparaître dans une liste de détenteurs. Passez en revue les adresses sélectionnées si votre projet a des règles d'éligibilité supplémentaires.

Chaque phase prend en charge jusqu'à 50,000 portefeuilles. Les phases ont des listes indépendantes, sans limite de portefeuille distincte à travers la publication. Il s'agit de la limite d'application prise en charge par Aurora, testée pour le traitement des listes et les contrôles minter, plutôt que d'un maximum intégré dans le contrat de collecte.

Le contrat stocke une empreinte digitale compacte de la liste blanche et vérifie la preuve de l’allocation de chaque portefeuille. Aurora prépare et réutilise ces preuves en arrière-plan afin que les listes plus grandes ne bloquent pas d'autres contrôles minter. La limite prise en charge maintient le travail de stockage et de préparation limité.

Les collections au-dessus de 100,000 détenteurs, ou les listes trop grandes pour les limites de réponse du fournisseur, peuvent nécessiter une importation CSV à la place.

Si les importations de holder ne sont pas configurées ou qu'un réseau n'est pas disponible, utilisez un fichier CSV ou contactez l'administrateur. Une recherche échouée ou annulée n'ajoute aucun portefeuille. Réessayez plus tard si le fournisseur de données n'est pas disponible; l'importateur ne choisit pas parmi un résultat incomplet.

Open Collectibles Studio