Samlingsritningen
KURV körs på Base Sepolia och Solana Devnet i dag. Den här sidan är fälthandboken från ett komplett bygge (HANI the Dog, 1,000 verk, 20 unika), skriven för en skapare som arbetar med en AI-agent via KURV-anslutningen på https://mcp.kurv.fun/mcp. Anslutningen ger agenter samma guide som resursen kurv://blueprint, och verktyget kurv_builder_spec är sanningskällan: där den här sidan och verktyget inte stämmer överens litar du på verktyget.
Anslut en agent
Section titled “Anslut en agent”- Lägg till
https://mcp.kurv.fun/mcpsom fjärr-MCP-server i en klient som stöder fjärr-MCP med OAuth. Anslut en agent med MCP listar klienterna och deras steg. - Logga in på KURV i webbläsaren och godkänn anslutningen. Du väljer vad den får göra (bara läsa, läsa och utkast, eller läsa, utkast och förbereda lansering) och hur länge den gäller.
- Be agenten läsa
kurv://blueprintoch sedan anropakurv_accountochkurv_builder_specför ditt nätverk. Anslutningen erbjuder också promptenbuild-kurv-collection, som leder agenten genom den här sidan med varje godkännandestopp på plats.
Vem gör vad
Section titled “Vem gör vad”Agenten planerar, validerar, skapar utkastet, laddar upp konsten, förhandsvisar och förbereder lanseringen. Du godkänner konsten, exemplen och varje varning, öppnar sedan granskningslänken och signerar lanseringen med din egen plånbok. Agenten driftsätter aldrig, signerar aldrig och ber aldrig om en privat nyckel eller återställningsfras. När konsten är färdig och godkänd tar KURV-delen (validera, skapa, ladda upp, förhandsvisa, förbereda) ungefär 20 minuter. Att göra bra konst tar längre tid, och det ska det göra.
Gränserna
Section titled “Gränserna”| Sak | Gräns |
|---|---|
| Samlingens storlek | 1 till 1,000 verk, unika inräknade: 980 slumpmässiga verk och 20 unika är en storlek på 1,000. |
| Lager | Upp till 12. |
| Egenskapsbilder | Upp till 240 totalt i alla lager, konst som bara används av unika inräknad. Ett tomt lager kostar ingenting. |
| Unika | Upp till 32. |
| Regler | Upp till 48, samma på varje nätverk. |
| Bildfilens storlek | Upp till 2 MiB per bild som skickas en i taget; upp till 20 MiB för en bild i en zip. |
| Duk | Kvadratisk, upp till 2,048 gånger 2,048 pixlar. Varje fil har exakt dukens storlek. |
| Format | Bakgrund: PNG, JPEG eller WebP. Alla andra lager: PNG med riktig transparens. |
| Namnet None | Reserverat i alla skrivsätt. Aldrig en egenskap som heter None, aldrig en tom bild: ett lager blir valfritt genom noneWeight. |
| Beskrivning | Behandla den som obligatorisk: 1 till 2,000 tecken. Den hamnar i varje verks metadata. |
| Utkast | 20 aktiva per konto. kurv_archive_draft frigör en plats direkt; det arkiverade utkastets konst sparas i 30 dagar och tas sedan bort. |
| Förhandsvisningar | Upp till 9 slumpmässiga exempel per anrop, eller upp till 9 valda verknummer, på 64 till 512 pixlar. |
Agenten läser validCombinations efter varje validering: hur många olika verk lagren och reglerna tillåter. Det räknas exakt för rymder upp till ungefär 50 miljoner kombinationer och märks som en uppskattning över det. Håll det med god marginal över samlingens storlek.
Vägen, steg för steg
Section titled “Vägen, steg för steg”Steg som är märkta Godkännande betyder: agenten stannar och väntar på ditt uttryckliga ja.
- Foton. Samla 3 till 10 skarpa foton av det riktiga husdjuret eller figuren: ansikte, ögon, tänder och mun, teckningar, öron. Välj ett huvudfoto med ansiktet i trekvartsprofil.
- Konstnärlig inriktning. En stil, en pose (trekvartsprofil fungerar bäst), en kvadratisk duk (2,048 gånger 2,048 rekommenderas), ett kort stilblad: linjer, skuggning, palett, stämning. Godkännande: huvudfiguren, innan någon egenskap görs.
- Huvudbasen. Figuren i sin slutliga pose på en enfärgad bakgrund, centrerad, i full dukstorlek, direkt igenkännbar som det riktiga husdjuret. Varje egenskap är en redigering av den här huvudbilden, med samma pose, skala och inramning.
- Lager. Lager målas nerifrån och upp: Background, Skin (baslagret), Collar, Teeth, Eyes, Headwear (valfritt). Ungefär sex lager; det är figuren som bär samlingen, inte rekvisitan. Agenten anger baslagret i
base_layeroch ger varje lager en ankarruta där dess egenskaper måste sitta. - Egenskaper. Varje egenskap är en redigering av en kopia av huvudbilden, utklippt så att bara egenskapens egna pixlar syns och allt annat är transparent. Att generera egenskaper på en enfärgad kopia av kroppen håller pälsen borta från dem. En egenskap som glider i position eller skala avvisas.
- Unika. Helt förvandlade kroppar (diamant, krom, lava, brons), var och en med en matchande bakgrund och utan halsband. Deras konst läggs i sitt lager som en egenskap med vikten 0, så den syns aldrig i slumpmässiga verk; den räknas in i de 240 bilderna.
- Regler. Kontaktark med varje hud mot varje halsband, tänder, ögon och huvudbonad. Varje dålig kombination (överlappande, osynlig, ful) blir en grupperad uteslutningsregel med en anteckning som säger varför.
- Godkännande: lagerarken, minst 9 sammansatta exempel, arket med unika, konfigurationen och försäljningsvillkoren, innan utkastet skapas.
- Konfiguration och validering.
kurv_builder_specmed nätverket, sedankurv_validate_collectionmed konfigurationen tills dessissues-lista inte har något fel. Varningar anger det du bör få veta om. Svaret innehållerrequired_assets, exakt de nycklar som ska laddas upp, ochvalidCombinations. - Utkastet.
kurv_create_collectionmedversion: 3, nätverket, konfigurationen, försäljningsvillkoren och en idempotensnyckel, först medcheck_onlysatt till true, sedan på riktigt. Ett misslyckat anrop görs om med samma nyckel. Försäljningsvillkoren har samma form på varje nätverk: se Försäljningsvillkor. - Konsten. En i taget med
kurv_upload_trait(bakgrund, bas och en egenskap per lager först, sedan en förhandsvisning, sedan resten), eller allt på en gång i webbens mappformat viakurv_upload_collection_zip. Ett tomt lager är ennoneWeight, aldrig en transparent PNG. - Kontroll och förhandsvisning.
kurv_validate_collectionmed utkastet kör konstkontrollerna.kurv_preview_collectionmed 9 exempel efter den sista uppladdningen, plus verknumren för varje unikt verk och de mest riskabla kombinationerna. Agenten tittar på varje bild. En lång första förhandsvisning svarar medretry_afteroch de väntande exemplen; agenten anropar igen. - Rättelser utan nytt utkast.
kurv_update_collectionändrar regler, unika, vikter, tips eller beskrivningen på plats; duken kan inte ändras.kurv_replace_trait_imagebyter ut en bild,kurv_rename_traitbyter namn på en egenskap och uppdaterar dess regler och unika,kurv_delete_traittar bort en egenskap som inget hänvisar till. Sedan en ny förhandsvisning. - Godkännande: de slutliga exemplen och varje varning, upplästa för dig.
- Förbered.
kurv_prepare_launchmed utkastet. Vidwarnings_need_reviewförklarar agenten varje varning; först när du har godtagit dem anropar den igen medacknowledge_warningssatt till true. Du får en länk till webbläsaren. - Du signerar. Öppna den enda länken, kontrollera det som är ifyllt, välj Publicera och lansera och signera med din egen plånbok i sista steget. Varje svar går att ändra med ett steg Tillbaka. Inget verktyg signerar åt dig.
Regler
Section titled “Regler”En regel håller två lagers egenskaper isär eller ihop: {"type", "when", "target", "note"}, där type är exclude eller require, och when och target var och en anger ett lager och, om du vill, en egenskap: ett namn eller en lista med namn. Ingen egenskap betyder hela lagret, och when och target måste vara olika lager. Nyckeln är trait: en regel som skrivs med traits avvisas med rätt nyckel angiven, i stället för att i tysthet gälla hela lagret. None får bara stå för ett tomt lager där det lagret har en noneWeight över 0. Gruppera kombinationer i listor för att hålla dig under 48: en regel per grupp av hudar, som listar varje halsband de aldrig får bära.
{"type": "exclude", "note": "Thick fur hides these collars", "when": {"layer": "Skin", "trait": ["Lion Mane", "Fire Fur"]}, "target": {"layer": "Collar", "trait": ["Bow Tie", "Name Tag"]}}Reglerna når verken: samma motor genererar förhandsvisningen och de publicerade filerna, och mintningen delar ut de filerna. Ett unikt verk kan hoppa över reglerna med ignoreRules satt till true; det förblir ändå unikt.
Unika verk är specials: ett namn, varje lager med sin egenskap eller None, ett valfritt låst verknummer och en valfri beskrivning. Ett unikt verk som utelämnar ett lager får det lagret slumpmässigt, och valideringen varnar för vilka lager det gäller. null avvisas, och det gör även ett egenskapsnamn som inte finns.
{"name": "Diamond Grail", "tokenId": 1, "traits": {"Background": "Diamond Vault", "Skin": "Pave Diamond", "Collar": "None", "Teeth": "Diamond Grill", "Eyes": "None"}}Konst som folk vill ha
Section titled “Konst som folk vill ha”- Påkostad, polerad konst. Inget platt, grumligt, uppenbart genererat utseende.
- Starka bakgrunder: kraftiga färger eller rika miljöer. Undvik platsteman (städer, stränder) om de inte är avsiktliga.
- Trekvartsprofil och en igenkännbar likhet med det riktiga husdjuret: teckningar, ögonfärg, öronform.
- Kraftfulla egenskaper anpassade efter figurens kropp, ritade på huvudbildens form. Tänderna passar munnen exakt.
- Ingen svävande huvudbonad. Hattar sitter på huvudet med en kontaktskugga; stora öron går över brättet.
- Kläder sitter oftast dåligt på djur. Välj hellre halsband, kedjor och halsprydnader, och testa dem på varje hud.
- Exklusiva unika verk är helt förvandlade, med matchande bakgrunder och utan halsband.
Anslutningen kontrollerar konsten när den kommer in. Fel stoppar en uppladdning: en dukstorlek som avviker, ett lager ovanför bakgrunden som inte är en PNG med transparens, en bild utan synliga pixlar. Varningar kommer tillbaka för dig att granska: en egenskap utanför sin ankarruta, en egenskap i en annan skala än sitt lager, en egenskap som ligger utanför basens pixelrutnät, en egenskap som fortfarande bär basbilden helt eller delvis, en egenskap som täcker hela duken. En varning kan vara falsk: naturliga ögon i samma lager som solglasögon har en annan storlek med flit. Agenten sätter mixedScales på det lagret, eller acknowledge på egenskapen när du har gått med på det, och konsten förblir som den ska.
Det här läser agenten tillbaka
Section titled “Det här läser agenten tillbaka”Varje validerande verktyg svarar på alla problem på en gång i en enda issues-lista, var och en med en sökväg, en kod, en allvarlighetsgrad, ett meddelande och en åtgärd. En okänd nyckel avvisas med namn, tillsammans med den närmaste giltiga. Nätverket anges med namn (base-sepolia, solana-devnet), och ett utkast utan nätverk använder Base Sepolia och säger det. Försäljningsmetoderna använder webbplatsens namn (fixed, mystery, rising, falling, auction): via anslutningen erbjuder Base fixed, mystery och rising, Solana erbjuder fixed och rising, och försäljningar med fallande pris och auktioner ställs in på webbplatsen. Ett försäljningsfält som nätverket inte har, till exempel en ticker på Solana, avvisas med namn. Metadatan är bevisad av ett test: varje verk följer reglerna, ett unikt verk hamnar på verket det är låst till, och ett tomt lager skrivs som {"trait_type": "<layer>", "value": "None"}.
Färdiga verk
Section titled “Färdiga verk”Verk som redan finns som färdiga bilder hoppar över lagren: kurv_finished_art_limits, sedan kurv_upload_finished_file_part för varje bild och för metadata.json, sedan kurv_import_finished_collection. Byten sparas precis som de kom, animation inräknad, och gränserna för lager gäller inte; webbplatsens aktuella publiceringsgränser gäller. Färdig konst förklarar filerna.
Kända gränser i det här bygget
Section titled “Kända gränser i det här bygget”- I en Solana-försäljning med version 2 kontrolleras värdena av appens egen tolk efter nycklarna, ett i taget; en försäljning med version 3 svarar på alla problem på en gång.
- Ett utkast med färdig konst kan inte redigeras på plats; en rättelse är en ny uppladdning och en ny nyckel.
- Ett arkiverat utkast kan inte återställas via anslutningen; dess konst sparas i 30 dagar.
- Varje nätverk som appen erbjuder är öppet via anslutningen, med samma steg, och
kurv_networkslistar dem. Ett nätverk som appen inte erbjuder avvisas med namn.
Samlingens siffror är ögonblicksbilder, och en lansering flyttar verkligt värde på sitt nätverk; läs Risker och ansvarsfriskrivning innan du ger någon råd om pengar.
Inget här är finansiell rådgivning. Läs Risker och ansvarsfriskrivning innan du mintar, köper eller säljer tillbaka till Vault. Tillbaka till kurv.fun. Integritetspolicy. Användarvillkor. .