Der Collection Blueprint

KURV läuft heute auf Base Sepolia und Solana Devnet. Diese Seite ist der Praxisleitfaden aus einem vollständigen Build (HANI the Dog, 1.000 Stücke, 20 Unikate), geschrieben für einen Creator, der mit einem KI-Agenten über den KURV-Connector unter https://mcp.kurv.fun/mcp arbeitet. Der Connector liefert Agenten denselben Leitfaden als Ressource kurv://blueprint, und das Tool kurv_builder_spec ist die maßgebliche Quelle: Wo diese Seite und das Tool sich widersprechen, vertrau dem Tool.

Einen Agenten verbinden

1. Füge https://mcp.kurv.fun/mcp als entfernten MCP-Server in einem Client hinzu, der entferntes MCP mit OAuth unterstützt. Einen Agenten per MCP verbinden listet die Clients und ihre Schritte.
2. Melde dich im Browser bei KURV an und erlaube die Verbindung. Du wählst, was sie darf (nur lesen, lesen und Entwürfe, oder lesen, Entwürfe und Startvorbereitung) und wie lange sie gilt.
3. Bitte den Agenten, kurv://blueprint zu lesen und dann kurv_account und kurv_builder_spec für dein Netzwerk aufzurufen. Der Connector bietet außerdem den Prompt build-kurv-collection, der den Agenten mit jedem Freigabestopp an seinem Platz durch diese Seite führt.

Wer was macht

Der Agent plant, validiert, erstellt den Entwurf, lädt die Kunst hoch, erstellt Vorschauen und bereitet den Start vor. Du gibst die Kunst, die Beispiele und jede Warnung frei, öffnest dann den Prüflink und signierst den Start mit deiner eigenen Wallet. Der Agent stellt nie bereit, signiert nie und fragt nie nach einem privaten Schlüssel oder einer Seed-Phrase. Sobald die Kunst fertig und freigegeben ist, dauert der Teil bei KURV (validieren, erstellen, hochladen, Vorschau, vorbereiten) etwa 20 Minuten. Gute Kunst zu machen dauert länger, und das soll so sein.

Die Grenzen

Element	Grenze
Größe der Kollektion	1 bis 1.000 Stücke, Unikate eingeschlossen: 980 zufällige Stücke und 20 Unikate ergeben eine Größe von 1.000.
Ebenen	Bis zu 12.
Merkmalsbilder	Insgesamt bis zu 240 über alle Ebenen, Kunst nur für Unikate eingeschlossen. Eine leere Ebene kostet nichts.
Unikate	Bis zu 32.
Regeln	Bis zu 48, in jedem Netzwerk gleich.
Dateigröße der Bilder	Bis zu 2 MiB pro Bild, das einzeln gesendet wird; bis zu 20 MiB für ein Bild in einem ZIP.
Leinwand	Quadratisch, bis zu 2.048 mal 2.048 Pixel. Jede Datei hat genau die Größe der Leinwand.
Formate	Hintergrund: PNG, JPEG oder WebP. Jede andere Ebene: PNG mit echter Transparenz.
Der Name None	In jeder Schreibweise reserviert. Nie ein Merkmal namens None, nie ein leeres Bild: Eine Ebene wird über noneWeight optional.
Beschreibung	Als Pflicht behandeln: 1 bis 2.000 Zeichen. Sie steht in den Metadaten jedes Stücks.
Entwürfe	20 aktive pro Konto. kurv_archive_draft macht sofort einen Platz frei; die Kunst des archivierten Entwurfs wird 30 Tage aufbewahrt und dann entfernt.
Vorschauen	Bis zu 9 zufällige Beispiele pro Aufruf oder bis zu 9 gewählte Stücknummern, mit 64 bis 512 Pixeln.

Der Agent liest nach jeder Validierung validCombinations: wie viele verschiedene Stücke die Ebenen und Regeln zulassen. Bis zu etwa 50 Millionen Kombinationen wird genau gezählt, darüber als Schätzung gekennzeichnet. Halte den Wert deutlich über der Größe der Kollektion.

Der Weg, Schritt für Schritt

Mit Freigabe markierte Schritte bedeuten: Der Agent hält an und wartet auf dein ausdrückliches Ja.

1. Fotos. Sammle 3 bis 10 scharfe Fotos des echten Haustiers oder der Figur: Gesicht, Augen, Zähne und Maul, Zeichnung, Ohren. Wähle ein Hauptfoto mit dem Gesicht in Dreiviertelansicht.
2. Art Direction. Ein Stil, eine Pose (Dreiviertel funktioniert am besten), eine quadratische Leinwand (2.048 mal 2.048 empfohlen), ein kurzes Style Sheet: Linienführung, Schattierung, Palette, Stimmung. Freigabe: die Masterfigur, bevor irgendein Merkmal entsteht.
3. Die Master-Basis. Die Figur in ihrer endgültigen Pose auf einem flachen, einfarbigen Hintergrund, zentriert, in voller Leinwandgröße, sofort als das echte Haustier zu erkennen. Jedes Merkmal ist eine Bearbeitung dieses Masters, mit derselben Pose, demselben Maßstab und demselben Bildausschnitt.
4. Ebenen. Ebenen werden von unten nach oben gemalt: Background, Skin (die Basisebene), Collar, Teeth, Eyes, Headwear (optional). Etwa sechs Ebenen; die Figur trägt die Kollektion, nicht die Requisiten. Der Agent nennt die Basisebene in base_layer und gibt jeder Ebene einen Ankerrahmen, in dem ihre Merkmale sitzen müssen.
5. Merkmale. Jedes Merkmal ist eine Bearbeitung einer Kopie des Masters, so freigestellt, dass nur die eigenen Pixel des Merkmals sichtbar sind und alles andere transparent ist. Wer Merkmale auf einer einfarbigen Kopie des Körpers erzeugt, hält Fell aus ihnen heraus. Ein Merkmal, das in Position oder Maßstab verrutscht, wird abgelehnt.
6. Unikate. Vollständig verwandelte Körper (Diamant, Chrom, Lava, Bronze), jeweils mit passendem Hintergrund und ohne Halsband. Ihre Kunst kommt als Merkmal mit einem Gewicht von 0 in ihre Ebene, damit sie nie in zufälligen Stücken erscheint; sie zählt zu den 240 Bildern.
7. Regeln. Kontaktbögen jeder Haut mit jedem Halsband-, Zahn-, Augen- und Kopfbedeckungsmerkmal. Jedes schlechte Paar (überlappend, unsichtbar, hässlich) wird zu einer gruppierten Ausschlussregel mit einer Notiz, die sagt, warum.
8. Freigabe: die Ebenenbögen, mindestens 9 zusammengesetzte Beispiele, der Bogen mit den Unikaten, die Konfiguration und die Verkaufsbedingungen, bevor der Entwurf erstellt wird.
9. Konfiguration und Validierung. kurv_builder_spec mit dem Netzwerk, dann kurv_validate_collection mit der Konfiguration, bis ihre Liste issues keinen Fehler mehr enthält. Warnungen nennen, wovon du wissen solltest. Die Antwort enthält required_assets, die genauen Schlüssel zum Hochladen, und validCombinations.
10. Der Entwurf. kurv_create_collection mit version: 3, dem Netzwerk, der Konfiguration, den Verkaufsbedingungen und einem Idempotenzschlüssel, zuerst mit check_only auf true, dann richtig. Ein fehlgeschlagener Aufruf wird mit demselben Schlüssel wiederholt. Die Verkaufsbedingungen haben auf jedem Netzwerk dieselbe Form: siehe Verkaufsbedingungen.
11. Die Kunst. Einzeln mit kurv_upload_trait (zuerst Hintergrund, Basis und ein Merkmal pro Ebene, dann eine Vorschau, dann der Rest) oder alles auf einmal im Ordnerformat der Website über kurv_upload_collection_zip. Eine leere Ebene ist ein noneWeight, nie ein transparentes PNG.
12. Prüfen und Vorschau. kurv_validate_collection mit dem Entwurf führt die Kunstprüfungen aus. kurv_preview_collection mit 9 Beispielen nach dem letzten Upload, dazu die Stücknummern jedes Unikats und der riskantesten Kombinationen. Der Agent sieht sich jedes Bild an. Eine lange erste Vorschau antwortet mit retry_after und den ausstehenden Beispielen; der Agent ruft erneut auf.
13. Korrekturen ohne neuen Entwurf. kurv_update_collection ändert Regeln, Unikate, Gewichte, Hinweise oder die Beschreibung an Ort und Stelle; die Leinwand lässt sich nicht ändern. kurv_replace_trait_image tauscht ein Bild, kurv_rename_trait benennt ein Merkmal um und aktualisiert seine Regeln und Unikate, kurv_delete_trait entfernt ein Merkmal, auf das nichts verweist. Danach eine neue Vorschau.
14. Freigabe: die endgültigen Beispiele und jede Warnung, dir vorgelesen.
15. Vorbereiten. kurv_prepare_launch mit dem Entwurf. Bei warnings_need_review erklärt der Agent jede Warnung; erst wenn du zustimmst, ruft er erneut mit acknowledge_warnings auf true auf. Du bekommst einen Browserlink.
16. Du signierst. Öffne den einen Link, prüfe, was eingetragen ist, wähle Veröffentlichen und starten und signiere im letzten Schritt mit deiner eigenen Wallet. Jede Antwort ist nur ein Zurück entfernt. Kein Tool signiert für dich.

Regeln

Eine Regel hält die Merkmale zweier Ebenen auseinander oder zusammen: {"type", "when", "target", "note"}, wobei type entweder exclude oder require ist und when und target jeweils eine Ebene nennen und optional ein Merkmal: einen Namen oder eine Liste von Namen. Kein Merkmal bedeutet die ganze Ebene, und when und target müssen verschiedene Ebenen sein. Der Schlüssel heißt trait: Eine Regel, die mit traits geschrieben ist, wird abgelehnt und der richtige Schlüssel genannt, statt still für die ganze Ebene zu gelten. None darf nur dort für eine leere Ebene stehen, wo diese Ebene ein noneWeight über 0 hat. Fasse Paare in Listen zusammen, um unter 48 zu bleiben: eine Regel pro Gruppe von Häuten, mit jedem Halsband, das sie nie tragen dürfen.

{"type": "exclude", "note": "Thick fur hides these collars", "when": {"layer": "Skin", "trait": ["Lion Mane", "Fire Fur"]}, "target": {"layer": "Collar", "trait": ["Bow Tie", "Name Tag"]}}

Regeln kommen bei den Stücken an: Dieselbe Engine erzeugt die Vorschau und die veröffentlichten Dateien, und das Minten gibt genau diese Dateien aus. Ein Unikat kann die Regeln mit ignoreRules auf true überspringen; die Einzigartigkeit gilt trotzdem.

Unikate

Unikate sind specials: ein Name, jede Ebene mit ihrem Merkmal oder None, eine optional fixierte Stücknummer und eine optionale Beschreibung. Ein Unikat, das eine Ebene auslässt, bekommt für diese Ebene ein zufälliges Merkmal, und die Validierung warnt, welche Ebenen das sind. null wird abgelehnt, ebenso ein Merkmalsname, den es nicht gibt.

{"name": "Diamond Grail", "tokenId": 1, "traits": {"Background": "Diamond Vault", "Skin": "Pave Diamond", "Collar": "None", "Teeth": "Diamond Grill", "Eyes": "None"}}

Kunst, die Leute wollen

• Aufwendige, ausgefeilte Kunst. Kein flacher, matschiger, offensichtlich generierter Look.
• Starke Hintergründe: kräftige Farben oder reiche Szenen. Vermeide Ortsthemen (Städte, Strände), außer sie sind gewollt.
• Dreiviertelpose und eine erkennbare Ähnlichkeit mit dem echten Haustier: Zeichnung, Augenfarbe, Ohrform.
• Kräftige Merkmale, die zum Körper der Figur passen, auf die Form des Masters gezeichnet. Die Zähne passen genau ins Maul.
• Keine schwebenden Kopfbedeckungen. Hüte sitzen mit einem Kontaktschatten auf dem Kopf; große Ohren gehen über die Krempe.
• Kleidung sitzt an Tieren meist schlecht. Nimm lieber Halsbänder, Ketten und Halsschmuck und probiere sie an jeder Haut aus.
• Premium-Unikate sind vollständig verwandelt, mit passenden Hintergründen und ohne Halsband.

Der Connector prüft die Kunst, sobald sie ankommt. Fehler lehnen einen Upload ab: eine abweichende Leinwandgröße, eine Ebene über dem Hintergrund, die kein PNG mit Transparenz ist, ein Bild ohne sichtbare Pixel. Warnungen kommen zurück, damit du sie prüfst: ein Merkmal außerhalb seines Ankers, ein Merkmal in einem anderen Maßstab als seine Ebene, ein Merkmal neben dem Pixelraster der Basis, ein Merkmal, das das Basisbild noch ganz oder teilweise enthält, ein Merkmal, das die ganze Leinwand bedeckt. Eine Warnung kann falsch sein: Natürliche Augen in derselben Ebene wie Sonnenbrillen haben absichtlich eine andere Größe. Der Agent setzt mixedScales auf diese Ebene oder acknowledge auf das Merkmal, sobald du zustimmst, und die Kunst bleibt, wie sie sein soll.

Was der Agent zurückliest

Jedes validierende Tool beantwortet jedes Problem auf einmal in einer Liste issues, jedes mit Pfad, Code, Schweregrad, Meldung und Behebung. Ein unbekannter Schlüssel wird mit Namen abgelehnt, zusammen mit dem nächstliegenden gültigen. Das Netzwerk wird genannt (base-sepolia, solana-devnet, solana-localnet), und ein Entwurf ohne Netzwerk nutzt Base Sepolia und sagt das. Verkaufsarten tragen die Namen der Website (fixed, mystery, rising, falling, auction): Über den Connector bietet Base fixed, mystery und rising, Solana bietet fixed und rising, und Verkäufe mit fallendem Preis und Auktionen werden auf der Website eingerichtet. Ein Verkaufsfeld, das das Netzwerk nicht hat, etwa ein Kürzel auf Solana, wird mit Namen abgelehnt. Die Metadaten sind durch einen Test belegt: Jedes Stück hält die Regeln ein, ein Unikat landet auf dem Stück, auf das es fixiert ist, und eine leere Ebene wird als {"trait_type": "<layer>", "value": "None"} geschrieben.

Fertige Stücke

Stücke, die es schon als fertige Bilder gibt, überspringen die Ebenen: kurv_finished_art_limits, dann kurv_upload_finished_file_part für jedes Bild und die metadata.json, dann kurv_import_finished_collection. Die Bytes bleiben, wie sie geliefert wurden, Animation eingeschlossen, und die Grenzen für Ebenen gelten nicht; die aktuellen Veröffentlichungsgrenzen der Website schon. Fertige Kunst mitbringen erklärt die Dateien.

Bekannte Grenzen dieses Builds

• Die Werte eines Solana-Verkaufs in Version 2 werden nach den Schlüsseln vom eigenen Parser der App geprüft, einer nach dem anderen; ein Verkauf in Version 3 beantwortet jedes Problem auf einmal.
• Ein Entwurf mit fertiger Kunst lässt sich nicht an Ort und Stelle bearbeiten; eine Korrektur ist ein neuer Upload mit einem neuen Schlüssel.
• Ein archivierter Entwurf lässt sich über den Connector nicht wiederherstellen; seine Kunst wird 30 Tage aufbewahrt.
• Robinhood Chain ist über den Connector nicht verfügbar: keine Netzwerkkonfiguration und kein Verkaufsschema. Sie kommt nach den Starts auf Base und Solana.

Kollektionszahlen sind Momentaufnahmen, und ein Start bewegt echten Wert in seinem Netzwerk; lies Risiken und Haftungsausschluss, bevor du jemanden in Geldfragen berätst.