Token-Liste und Adress-Tags

Was die Liste ist

Zwei Dateien pro Netzwerk. tokenlist.json führt die geprüften Token auf, im Standardformat der Uniswap Token Lists, sodass jede Wallet, jede DEX-Oberfläche und jeder Aggregator sie unverändert importieren kann. tags.json gibt bekannten Verträgen ein lesbares Label - einen Namen, eine Kategorie und ein Projekt -, sodass ein Explorer „Pepper router“ anzeigen kann, wo er sonst eine hexadezimale Adresse zeigen würde.

Ein gelisteter Token bekommt das Verifiziert-Kennzeichen, sein Logo, seinen Namen und sein Symbol im Explorer, auf Pepper, im Toolkit, auf Names und auf der Account-Seite. Ein getaggter Vertrag erscheint mit seinem Label in Transaktionslisten, auf Adressseiten und in der Suche.

Nichts wird automatisch gelistet. Ein Token, der mit dem Token-Launcher von Pepper gestartet wurde, wird nicht deshalb aufgenommen, weil es ihn gibt; er wird aufgenommen, wenn jemand einen Pull Request öffnet und er die Kriterien erfüllt.

Wo sie liegt

Die Liste liegt in einem öffentlichen GitHub-Repository, github.com/PickleChain/token-list, mit einem Ordner pro Netzwerk:

Innerhalb eines Netzwerkordners:

Die Raw-URLs, immer auf dem neuesten Commit von main:

https://raw.githubusercontent.com/PickleChain/token-list/main/testnet/tokenlist.json
https://raw.githubusercontent.com/PickleChain/token-list/main/testnet/tags.json

Für eine Website holen Sie die Dateien serverseitig und liefern sie von Ihrer eigenen Herkunft aus, statt raw.githubusercontent.com aus den Browsern Ihrer Besucher direkt einzubinden: So bleiben deren IP-Adressen bei keinem Dritten, Sie geraten nicht in die Ratenbegrenzung von GitHub und können die letzte gute Kopie behalten, wenn GitHub nicht erreichbar ist. In einer Wallet oder einer DEX-Oberfläche fügen Sie die Raw-URL von tokenlist.json als eigene Token-Liste hinzu.

Wie die Pickle-Apps sie nutzen

Die Explorer-API ist der einzige Teil des Pickle-Stacks, der für diese Dateien mit GitHub spricht. Sie holt beide etwa alle zehn Minuten, validiert jede Datei als Ganzes - Struktur, Chain-ID, Prüfsummen, Duplikate - und behält die letzte gute Kopie im Speicher und auf der Festplatte. Eine Datei, die durchfällt, wird vollständig verworfen, und die vorherige bleibt im Dienst, sodass ein fehlerhafter Commit nie ein Label oder ein Logo leeren kann. Jede Pickle-Website liest dann die Kopie des Explorers von ihrer eigenen Herkunft:

Die Routen liegen auf https://explorer.picklechain.xyz, hinter der CORS-Allowlist des Explorers: Sie bedienen die Pickle-Websites. Ihre eigene Anwendung liest die Raw-Dateien von oben.

Einen Token hinzufügen

Prüfen Sie zuerst die Kriterien: Ein Pull Request für einen Token, der sie nicht erfüllt, wird geschlossen. Dann, auf Ihrem Fork des Repositorys:

1. Besorgen Sie die Adresse mit Prüfsumme. EIP-55 in gemischter Schreibweise, nicht alles klein. Ist Ihre falsch, gibt der Validator die erwartete Form aus.
2. Fügen Sie das Logo hinzu, in testnet/logos/tokens/, exakt nach dieser Adresse benannt: testnet/logos/tokens/0x0000…dEaD.png (oder .svg). Es muss den Regeln für Logos folgen.
3. Hängen Sie einen Eintrag an tokens in testnet/tokenlist.json an, wie im Beispiel unten.
4. Erhöhen Sie die Version von tokenlist.json - einen Token hinzuzufügen ist ein Minor-Sprung, aus 1.4.2 wird 1.5.0 - und setzen Sie timestamp auf jetzt, in ISO 8601 UTC.
5. Führen Sie die Prüfungen aus mit npm test. Das braucht Node 22 oder neuer und sonst nichts: Der Validator hat keine Abhängigkeiten, es gibt also nichts zu installieren.
6. Öffnen Sie einen Pull Request gegen main. Verlinken Sie in seiner Beschreibung einen Beitrag auf der eigenen Website oder dem offiziellen Account des Projekts, der die Vertragsadresse nennt.

{
  "chainId": 78270,
  "address": "0x0000…dEaD",
  "name": "Example Token",
  "symbol": "EXM",
  "decimals": 18,
  "logoURI": "https://raw.githubusercontent.com/PickleChain/token-list/main/testnet/logos/tokens/0x0000…dEaD.png",
  "extensions": {
    "website": "https://your-project.example",
    "explorer": "https://explorer.picklechain.xyz/address/0x0000…dEaD"
  }
}

0x0000…dEaD steht für Ihre vollständige, 42 Zeichen lange Adresse mit Prüfsumme; es ist ein Platzhalter, kein Token.

Der ganze Ablauf auf der Kommandozeile:

# Fork and clone (or fork on the website and clone your fork):
gh repo fork PickleChain/token-list --clone
cd token-list
git checkout -b add-exm

# Logo, entry, version and timestamp, then:
npm test

git add testnet/tokenlist.json testnet/logos/tokens/
git commit -m "Add Example Token (EXM)"
git push origin add-exm
# ...and open the pull request on GitHub.

Regeln für Logos

Jede Datei unter logos/ muss von der Liste oder den Tags referenziert werden. Ein Logo, auf das nichts verweist, fällt bei den Prüfungen durch, entfernen Sie es also im selben Pull Request wie seinen Eintrag.

Einen Adress-Tag hinzufügen

Tags sind für Verträge gedacht, denen man in Transaktionen begegnet: Protokollverträge, Router, Factories, Pools, Vaults, Spiele, Bridges. Private Wallets werden nie getaggt. Das Projekt muss auf der Pickle Chain live sein, und die Adresse muss sich in der eigenen Dokumentation oder den Deployment-Dateien des Projekts überprüfen lassen.

1. Fügen Sie einen Eintrag hinzu, in tags in testnet/tags.json, geschlüsselt nach der Adresse mit Prüfsumme.
2. Fügen Sie optional ein Logo hinzu, in testnet/logos/tags/ - dieselben Formatregeln wie für ein Token-Logo, beliebiger Dateiname - und lassen Sie logo auf seine Raw-URL zeigen. Mehrere Tags eines Projekts können sich eine Datei teilen.
3. Erhöhen Sie die Version von tags.json und dessen timestamp, führen Sie npm test aus und öffnen Sie den Pull Request.

"0x0000…dEaD": {
  "name": "Example vault",
  "category": "protocol",
  "project": "Example",
  "url": "https://your-project.example",
  "logo": "https://raw.githubusercontent.com/PickleChain/token-list/main/testnet/logos/tags/example.png",
  "note": "Holds deposits and pays out the weekly yield."
}

Die heute definierten Kategorien:

Passt keine, schlagen Sie im selben Pull Request eine neue Kategorie vor: einen kleingeschriebenen Schlüssel von bis zu 20 Zeichen, mit einem name und einer description.

Einen Eintrag ändern oder entfernen

• Einen Eintrag ändern - einen Namen, eine Notiz, eine Website, die Dezimalstellen - indem Sie ihn an Ort und Stelle bearbeiten und die Patch-Version erhöhen. Der Pull Request kommt vom Team des Tokens, wie bei einer Aufnahme.
• Ein Logo ändern, indem Sie die Datei ersetzen. Ein Wechsel zwischen PNG und SVG benennt sie um, aktualisieren Sie also logoURI und löschen Sie die alte Datei.
• Einen Vertrag ersetzen, indem Sie die neue Adresse hinzufügen. Bei einem Tag behalten Sie den alten Eintrag und hängen an seinen Namen (previous) an, damit alte Transaktionen weiterhin klar lesbar sind.
• Einen Eintrag entfernen, indem Sie ihn und seine Logodatei löschen, mit einem Major-Sprung der Version.

Maintainer können einen Token jederzeit entfernen - nach einem Exploit, einem Rug Pull, einem Wechsel auf einen neuen Vertrag oder einer irreführenden Änderung der Metadaten.

Versionen

Jede Datei trägt ihre eigene version, und der Sprung folgt den Regeln der Token Lists. Die CI setzt ihn gegen den Basis-Branch des Pull Requests durch, und eine geänderte Version braucht einen neueren timestamp.

npm test                                      # every list and logo, then the validator's own tests
node scripts/validate.mjs --base origin/main  # also the version bumps, as CI checks them

Was das Review prüft

Jeder Pull Request führt npm test und die Versionsprüfung in GitHub Actions aus, danach prüft ihn ein Maintainer. Ein Token wird aufgenommen, wenn all das zutrifft:

• Er ist im Netzwerk dieses Ordners deployt, und sein Quelltext ist verifiziert oder veröffentlicht.
• Der Pull Request wird vom Team des Tokens geöffnet oder bestätigt, mit einem Link auf einen Beitrag auf der eigenen Website oder dem offiziellen Account des Projekts, der die Vertragsadresse nennt.
• Name und Symbol imitieren keinen anderen Token und kein anderes Projekt. Ein neuer PKL oder WETH wird abgelehnt.
• Er wird tatsächlich genutzt: Liquidität auf Pepper, Halter oder ein laufendes Produkt - kein Token, der vor ein paar Minuten gestartet wurde.
• Der Vertrag hat keinen versteckten Mint, keine Blacklist und keinen Gebührenschalter, den das Team nicht offengelegt hat.

Ein Tag wird aufgenommen, wenn die Adresse ein Vertrag ist, das Projekt auf der Pickle Chain live ist und sich die Adresse in der eigenen Dokumentation oder den Deployment-Dateien des Projekts überprüfen lässt.

Häufige Validierungsfehler

npm test gibt jedes Problem aus, nicht nur das erste. Die häufigsten und ihre Behebung: