De Collection Blueprint

KURV draait vandaag op Base Sepolia en Solana Devnet. Deze pagina is de veldgids uit een volledige bouw (HANI the Dog, 1.000 stukken, 20 unieke stukken), geschreven voor een maker die met een AI-agent werkt via de KURV-connector op https://mcp.kurv.fun/mcp. De connector levert dezelfde gids aan agents als de resource kurv://blueprint, en de tool kurv_builder_spec is de bron van waarheid: zijn deze pagina en de tool het oneens, vertrouw dan de tool.

Een agent koppelen

1. Voeg https://mcp.kurv.fun/mcp toe als externe MCP-server in een client die externe MCP met OAuth ondersteunt. Een agent koppelen met MCP noemt de clients en hun stappen.
2. Log in de browser in op KURV en keur de koppeling goed. Jij kiest wat ze mag doen (alleen lezen, lezen en concepten, of lezen, concepten en lanceringen voorbereiden) en hoe lang ze geldt.
3. Vraag de agent kurv://blueprint te lezen en daarna kurv_account en kurv_builder_spec voor je netwerk aan te roepen. De connector biedt ook de prompt build-kurv-collection, die de agent langs deze pagina leidt met elk goedkeuringsmoment op zijn plaats.

Wie wat doet

De agent plant, valideert, maakt het concept, uploadt de kunst, maakt voorbeelden en bereidt de lancering voor. Jij keurt de kunst, de voorbeelden en elke waarschuwing goed, opent dan de controlelink en ondertekent de lancering met je eigen wallet. De agent implementeert nooit, ondertekent nooit en vraagt nooit om een privésleutel of herstelzin. Zodra de kunst af en goedgekeurd is, duurt het werk aan de kant van KURV (valideren, maken, uploaden, voorbeelden, voorbereiden) ongeveer 20 minuten. Goede kunst maken duurt langer, en dat hoort ook zo.

De limieten

Onderdeel	Limiet
Omvang van de collectie	1 tot 1.000 stukken, unieke inbegrepen: 980 willekeurige stukken en 20 unieke is een omvang van 1.000.
Lagen	Tot 12.
Kenmerkafbeeldingen	Tot 240 in totaal over alle lagen, kunst die alleen unieke stukken gebruiken inbegrepen. Een lege laag kost niets.
Unieke stukken	Tot 32.
Regels	Tot 48, op elk netwerk hetzelfde.
Bestandsgrootte van een afbeelding	Tot 2 MiB per afbeelding die los wordt verstuurd; tot 20 MiB voor één afbeelding in een zip.
Canvas	Vierkant, tot 2.048 bij 2.048 pixels. Elk bestand is precies zo groot als het canvas.
Formaten	Achtergrond: PNG, JPEG of WebP. Elke andere laag: PNG met echte transparantie.
De naam None	Gereserveerd, in elke schrijfwijze met hoofd- of kleine letters. Nooit een kenmerk dat None heet, nooit een lege afbeelding: een laag wordt optioneel via noneWeight.
Beschrijving	Beschouw haar als verplicht: 1 tot 2.000 tekens. Ze komt in de metadata van elk stuk.
Concepten	20 actieve per account. kurv_archive_draft maakt meteen een plek vrij; de kunst van het gearchiveerde concept wordt 30 dagen bewaard en daarna verwijderd.
Voorbeelden	Tot 9 willekeurige voorbeelden per aanroep, of tot 9 gekozen stuknummers, van 64 tot 512 pixels.

De agent leest na elke validatie validCombinations: hoeveel verschillende stukken de lagen en regels toelaten. Het wordt precies geteld voor ruimtes tot ongeveer 50 miljoen combinaties en daarboven als schatting gemarkeerd. Houd het ruim boven de omvang van de collectie.

De route, stap voor stap

Stappen met Goedkeuring betekenen: de agent stopt en wacht op jouw uitdrukkelijke ja.

1. Foto’s. Verzamel 3 tot 10 scherpe foto’s van het echte huisdier of personage: gezicht, ogen, tanden en bek, tekening, oren. Kies één hoofdfoto met het gezicht in driekwartaanzicht.
2. Artdirection. Eén stijl, één pose (driekwart werkt het best), één vierkant canvas (2.048 bij 2.048 aanbevolen), een kort stijlblad: lijnvoering, schaduw, palet, sfeer. Goedkeuring: het hoofdpersonage, voordat er een kenmerk wordt gemaakt.
3. De hoofdbasis. Het personage in zijn definitieve pose op een vlakke achtergrond in één kleur, gecentreerd, op het volle canvas, meteen herkenbaar als het echte huisdier. Elk kenmerk is een bewerking van deze hoofdversie, met dezelfde pose, schaal en kadrering.
4. Lagen. Lagen worden van onder naar boven geschilderd: Background, Skin (de basislaag), Collar, Teeth, Eyes, Headwear (optioneel). Ongeveer zes lagen; het personage draagt de collectie, niet de accessoires. De agent noemt de basislaag in base_layer en geeft elke laag een ankervak waarin haar kenmerken moeten zitten.
5. Kenmerken. Elk kenmerk is een bewerking van een kopie van de hoofdversie, uitgesneden zodat alleen de eigen pixels van het kenmerk zichtbaar zijn en al het andere transparant is. Kenmerken genereren op een kopie van het lichaam in een vlakke kleur houdt er vacht uit. Een kenmerk dat verschuift in positie of schaal wordt geweigerd.
6. Unieke stukken. Volledig getransformeerde lichamen (diamant, chroom, lava, brons), elk met een passende achtergrond en zonder halsband. Hun kunst gaat in haar laag als kenmerk met een gewicht van 0, zodat ze nooit in willekeurige stukken verschijnt; ze telt mee voor de 240 afbeeldingen.
7. Regels. Contactbladen van elke huid met elk kenmerk voor halsband, tanden, ogen en hoofddeksel. Elk slecht paar (overlappend, onzichtbaar, lelijk) wordt een gegroepeerde uitsluitingsregel met een notitie die zegt waarom.
8. Goedkeuring: de lagenbladen, minstens 9 samengestelde voorbeelden, het blad met unieke stukken, de config en de verkoopvoorwaarden, voordat het concept wordt gemaakt.
9. Config en validatie. kurv_builder_spec met het netwerk, daarna kurv_validate_collection met de config totdat de lijst issues geen fout meer bevat. Waarschuwingen noemen waar je van moet horen. Het antwoord bevat required_assets, de precieze sleutels om te uploaden, en validCombinations.
10. Het concept. kurv_create_collection met version: 3, het netwerk, de config, de verkoopvoorwaarden en een idempotency key, eerst met check_only op true, daarna echt. Een mislukte aanroep wordt opnieuw geprobeerd met dezelfde sleutel. De verkoopvoorwaarden hebben op elk netwerk dezelfde vorm: zie Verkoopvoorwaarden.
11. De kunst. Eén voor één met kurv_upload_trait (eerst de achtergrond, de basis en één kenmerk per laag, dan een voorbeeld, dan de rest), of alles tegelijk in de mapindeling van de website via kurv_upload_collection_zip. Een lege laag is een noneWeight, nooit een transparante PNG.
12. Controleren en voorbeelden. kurv_validate_collection met het concept voert de kunstcontroles uit. kurv_preview_collection met 9 voorbeelden na de laatste upload, plus de stuknummers van elk uniek stuk en de riskantste combinaties. De agent bekijkt elke afbeelding. Een lang eerste voorbeeld antwoordt met retry_after en de voorbeelden die nog komen; de agent roept opnieuw aan.
13. Correcties zonder nieuw concept. kurv_update_collection wijzigt regels, unieke stukken, gewichten, hints of de beschrijving ter plekke; het canvas kan niet veranderen. kurv_replace_trait_image wisselt één afbeelding, kurv_rename_trait hernoemt een kenmerk en werkt zijn regels en unieke stukken bij, kurv_delete_trait verwijdert een kenmerk waar niets naar verwijst. Daarna een nieuw voorbeeld.
14. Goedkeuring: de definitieve voorbeelden en elke waarschuwing, aan jou voorgelezen.
15. Voorbereiden. kurv_prepare_launch met het concept. Bij warnings_need_review legt de agent elke waarschuwing uit; pas nadat jij akkoord gaat, roept hij opnieuw aan met acknowledge_warnings op true. Je krijgt een link voor de browser.
16. Jij ondertekent. Open de ene link, controleer wat er is ingevuld, kies Publiceren en lanceren en onderteken in de laatste stap met je eigen wallet. Elk antwoord is één keer Terug verderop. Geen tool ondertekent voor jou.

Regels

Een regel houdt de kenmerken van twee lagen uit elkaar of bij elkaar: {"type", "when", "target", "note"}, waarbij type exclude of require is, en when en target elk een laag noemen en eventueel een kenmerk: één naam of een lijst met namen. Geen kenmerk betekent de hele laag, en when en target moeten verschillende lagen zijn. De sleutel is trait: een regel die met traits is geschreven, wordt geweigerd met de juiste sleutel erbij, in plaats van stilletjes voor de hele laag te gelden. None mag alleen voor een lege laag staan als die laag een noneWeight boven 0 heeft. Groepeer paren in lijsten om onder de 48 te blijven: één regel per groep huiden, met elke halsband die ze nooit mogen dragen.

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

Regels bereiken de stukken: dezelfde engine maakt het voorbeeld en de gepubliceerde bestanden, en het minten geeft die bestanden uit. Een uniek stuk kan de regels overslaan met ignoreRules op true; uniek blijft het toch.

Unieke stukken

Unieke stukken zijn specials: een naam, elke laag met haar kenmerk of None, een optioneel vastgezet stuknummer en een optionele beschrijving. Een uniek stuk dat een laag weglaat, krijgt die laag willekeurig, en de validatie waarschuwt welke lagen dat zijn. null wordt geweigerd, net als een kenmerknaam die niet bestaat.

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

Kunst die mensen willen

• Kunst met veel aandacht en afwerking. Geen vlakke, modderige, duidelijk gegenereerde look.
• Sterke achtergronden: felle kleuren of rijke scènes. Vermijd plaatsthema’s (steden, stranden), tenzij ze bewust zijn.
• Driekwartpose en een herkenbare gelijkenis met het echte huisdier: tekening, oogkleur, oorvorm.
• Opvallende kenmerken die op het lichaam van het personage passen, getekend op de vorm van de hoofdversie. Tanden passen precies in de bek.
• Geen zwevende hoofddeksels. Hoeden zitten op het hoofd met een contactschaduw; grote oren gaan over de rand.
• Kleding past dieren meestal slecht. Kies liever halsbanden, kettingen en iets om de hals, en probeer ze op elke huid uit.
• Premium unieke stukken zijn volledig getransformeerd, met passende achtergronden en zonder halsband.

De connector controleert de kunst zodra ze binnenkomt. Fouten weigeren een upload: een afwijkende canvasgrootte, een laag boven de achtergrond die geen PNG met transparantie is, een afbeelding zonder zichtbare pixels. Waarschuwingen komen terug zodat jij ze kunt bekijken: een kenmerk buiten zijn anker, een kenmerk op een andere schaal dan zijn laag, een kenmerk dat niet op het pixelraster van de basis ligt, een kenmerk dat de basisafbeelding nog geheel of gedeeltelijk bevat, een kenmerk dat het hele canvas bedekt. Een waarschuwing kan onterecht zijn: natuurlijke ogen in dezelfde laag als een zonnebril hebben bewust een andere grootte. De agent zet mixedScales op die laag, of acknowledge op het kenmerk zodra jij akkoord gaat, en de kunst blijft zoals ze moet zijn.

Wat de agent terugleest

Elke validerende tool beantwoordt alle problemen tegelijk in één lijst issues, elk met een pad, een code, een ernst, een melding en een oplossing. Een onbekende sleutel wordt bij naam geweigerd, met de dichtstbijzijnde geldige. Het netwerk wordt genoemd (base-sepolia, solana-devnet, solana-localnet), en een concept zonder netwerk gebruikt Base Sepolia en zegt dat. Verkoopmethoden gebruiken de namen van de website (fixed, mystery, rising, falling, auction): via de connector biedt Base fixed, mystery en rising, biedt Solana fixed en rising, en verkopen met falling en auction worden op de website ingesteld. Een verkoopveld dat het netwerk niet heeft, zoals een symbool op Solana, wordt bij naam geweigerd. Een geautomatiseerde controle bewijst de metadata: elk stuk volgt de regels, een uniek stuk komt op het stuk waaraan het is vastgezet, en een lege laag wordt geschreven als {"trait_type": "<layer>", "value": "None"}.

Afgewerkte stukken

Stukken die al als afgewerkte afbeeldingen bestaan, slaan de lagen over: kurv_finished_art_limits, dan kurv_upload_finished_file_part voor elke afbeelding en de metadata.json, dan kurv_import_finished_collection. De bytes worden bewaard zoals ze zijn aangeleverd, animatie inbegrepen, en de limieten voor lagen gelden niet; de huidige publicatielimieten van de website wel. Afgewerkte kunst legt de bestanden uit.

Bekende grenzen van deze versie

• De waarden van een Solana-verkoop in versie 2 worden na de sleutels één voor één gecontroleerd door de eigen parser van de app; een verkoop in versie 3 beantwoordt alle problemen tegelijk.
• Een concept met afgewerkte kunst kan niet ter plekke worden bewerkt; een correctie is een nieuwe upload met een nieuwe sleutel.
• Een gearchiveerd concept kan niet via de connector worden hersteld; de kunst ervan wordt 30 dagen bewaard.
• Robinhood Chain is niet beschikbaar via de connector: geen netwerkconfig en geen verkoopschema. Die komt na de lanceringen op Base en Solana.

Getallen van een collectie zijn momentopnamen, en een lancering verplaatst echte waarde op haar netwerk; lees Risico’s en disclaimer voordat je iemand advies over geld geeft.