Ang Collection Blueprint

Tumatakbo ang KURV sa Base Sepolia at Solana Devnet ngayon. Ang pahinang ito ang field guide mula sa isang tunay at kumpletong build (HANI the Dog, 1,000 piraso, 20 unique), isinulat para sa creator na nakikipagtrabaho sa isang AI na ahente sa pamamagitan ng KURV connector sa https://mcp.kurv.fun/mcp. Ibinibigay ng connector ang parehong gabay sa mga ahente bilang resource na kurv://blueprint, at ang tool na kurv_builder_spec ang pinagmulan ng katotohanan: kung magkaiba ang pahinang ito at ang tool, paniwalaan ang tool.

Ikonekta ang isang ahente

1. Idagdag ang https://mcp.kurv.fun/mcp bilang remote na MCP server sa isang client na sumusuporta sa remote na MCP na may OAuth. Nakalista sa Ikonekta ang ahente gamit ang MCP ang mga client at ang mga hakbang nila.
2. Mag-log in sa KURV sa browser at aprubahan ang koneksyon. Ikaw ang pumipili kung ano ang maaari nitong gawin (basa lamang; basa at mga draft; o basa, mga draft at paghahanda ng launch) at kung gaano ito tatagal.
3. Hilingin sa ahente na basahin ang kurv://blueprint, pagkatapos tawagin ang kurv_account at kurv_builder_spec para sa network mo. May inaalok ding prompt na build-kurv-collection ang connector, na naglalakad sa ahente sa pahinang ito nang buo ang bawat hintuan ng pag-apruba.

Sino ang gumagawa ng ano

Nagpaplano, nagbe-validate, gumagawa ng draft, nag-a-upload ng art, nagpi-preview at naghahanda ng launch ang ahente. Inaaprubahan mo ang art, ang mga sample at ang bawat babala, pagkatapos binubuksan mo ang review link at pumipirma sa launch gamit ang sarili mong wallet. Hindi kailanman nagde-deploy ang ahente, hindi pumipirma at hindi humihingi ng private key o seed phrase. Kapag tapos at aprubado na ang art, ang bahagi ng KURV (validate, create, upload, preview, prepare) ay tumatagal ng humigit-kumulang 20 minuto. Mas matagal ang paggawa ng magandang art, at dapat nga.

Ang mga limitasyon

Bagay	Limitasyon
Laki ng koleksyon	1 hanggang 1,000 piraso, kasama ang mga unique: 980 random na piraso at 20 unique ay laki na 1,000.
Mga layer	Hanggang 12.
Mga larawan ng trait	Hanggang 240 sa kabuuan sa lahat ng layer, kasama ang art na ginagamit lamang ng mga unique. Walang gastos ang walang lamang layer.
Mga unique	Hanggang 32.
Mga rule	Hanggang 48, pareho sa bawat network.
Laki ng image file	Hanggang 2 MiB bawat larawang ipinadala nang isa-isa; hanggang 20 MiB para sa isang larawan sa loob ng zip.
Canvas	Parisukat, hanggang 2,048 by 2,048 pixel. Eksaktong kasukat ng canvas ang bawat file.
Mga format	Background: PNG, JPEG o WebP. Bawat ibang layer: PNG na may tunay na transparency.
Ang pangalang None	Nakareserba sa anumang capitalization. Huwag kailanman gumawa ng trait na None at huwag gumamit ng walang lamang larawan: nagiging opsyonal ang layer sa pamamagitan ng noneWeight.
Paglalarawan	Ituring na kinakailangan: 1 hanggang 2,000 character. Napupunta ito sa metadata ng bawat piraso.
Mga draft	20 aktibo bawat account. Agad na nagpapalaya ng puwesto ang kurv_archive_draft; 30 araw na nakatago ang art ng na-archive na draft bago alisin.
Mga preview	Hanggang 9 na random na sample bawat tawag, o hanggang 9 na piniling numero ng piraso, sa 64 hanggang 512 pixel.

Binabasa ng ahente ang validCombinations pagkatapos ng bawat validation: ilang magkakaibang piraso ang pinapayagan ng mga layer at mga rule. Eksaktong binibilang ito para sa mga espasyong hanggang humigit-kumulang 50 milyong kombinasyon at tinatatakan bilang tantiya kung lampas doon. Panatilihin itong malayo sa ibabaw ng laki ng koleksyon.

Ang daan, hakbang-hakbang

Ang mga hakbang na may markang Pag-apruba ay nangangahulugang: humihinto ang ahente at naghihintay ng malinaw mong oo.

1. Mga larawan. Kolektahin ang 3 hanggang 10 malinaw na larawan ng tunay na alaga o karakter: mukha, mga mata, ngipin at bibig, mga marka, mga tainga. Pumili ng isang pangunahing larawan na nakikita ang mukha sa three-quarter na anggulo.
2. Direksyon ng art. Isang istilo, isang pose (pinakaangkop ang three-quarter), isang parisukat na canvas (inirerekomenda ang 2,048 by 2,048), isang maikling style sheet: linya, lilim, palette, mood. Pag-apruba: ang master na karakter, bago gawin ang anumang trait.
3. Ang master base. Ang karakter sa huling pose nito sa patag na iisang-kulay na background, nakasentro, buong laki ng canvas, agad nakikilala bilang ang tunay na alaga. Bawat trait ay edit ng master na ito, na may parehong pose, scale at framing.
4. Mga layer. Pinipinta ang mga layer mula ibaba pataas: Background, Skin (ang base layer), Collar, Teeth, Eyes, Headwear (opsyonal). Mga anim na layer; ang karakter ang nagdadala ng koleksyon, hindi ang mga prop. Pinapangalanan ng ahente ang base layer sa base_layer at binibigyan ang bawat layer ng anchor box kung saan dapat umupo ang mga trait nito.
5. Mga trait. Bawat trait ay edit ng kopya ng master, ginupit upang ang sariling pixel lamang ng trait ang nakikita at transparent ang lahat ng iba. Ang paggawa ng mga trait sa iisang-kulay na kopya ng katawan ay naglalayo ng balahibo sa kanila. Tinatanggihan ang trait na lumilihis sa posisyon o scale.
6. Mga unique. Mga ganap na nagbagong katawan (diamante, chrome, lava, bronse), bawat isa may katugmang background at walang collar. Napupunta ang art nila sa layer nito bilang trait na may weight na 0, kaya hindi ito kailanman lumalabas sa mga random na piraso; binibilang ito sa 240 na larawan.
7. Mga rule. Mga contact sheet ng bawat skin kasama ang bawat trait ng collar, ngipin, mata at headwear. Bawat masamang pares (nagkakaltasan, hindi nakikita, pangit) ay naging pinagsamang exclude rule na may note na nagsasabi kung bakit.
8. Pag-apruba: ang mga layer sheet, hindi bababa sa 9 na pinagsamang sample, ang sheet ng mga unique, ang config at ang mga tuntunin ng sale, bago gawin ang draft.
9. Config at validation. kurv_builder_spec kasama ang network, pagkatapos kurv_validate_collection kasama ang config hanggang walang error ang listahang issues nito. Pinapangalanan ng mga babala ang dapat mong marinig. Dala ng sagot ang required_assets, ang eksaktong mga key na ia-upload, at ang validCombinations.
10. Ang draft. kurv_create_collection kasama ang version: 3, ang network, ang config, ang mga tuntunin ng sale at isang idempotency key, una na true ang check_only, pagkatapos nang totoo. Sinusubukang muli ang bigong tawag gamit ang parehong key. Iisa ang hugis ng mga tuntunin ng sale sa bawat network: tingnan ang Mga tuntunin ng sale.
11. Ang art. Isa-isa sa pamamagitan ng kurv_upload_trait (background, base at isang trait bawat layer muna, pagkatapos preview, pagkatapos ang iba), o sabay-sabay sa web folder format sa pamamagitan ng kurv_upload_collection_zip. Ang walang lamang layer ay noneWeight, hindi kailanman transparent na PNG.
12. Suriin at i-preview. Pinapatakbo ng kurv_validate_collection kasama ang draft ang mga pagsusuri ng art. kurv_preview_collection na may 9 na sample pagkatapos ng huling upload, dagdag ang mga numero ng piraso ng bawat unique at ng pinakamapanganib na kombinasyon. Tinitingnan ng ahente ang bawat larawan. Sumasagot ng retry_after at ng mga nakabinbing sample ang matagal na unang preview; tumatawag muli ang ahente.
13. Mga ayos nang walang bagong draft. Binabago ng kurv_update_collection ang mga rule, mga unique, mga weight, mga hint o ang paglalarawan sa lugar; hindi mababago ang canvas. Pinapalitan ng kurv_replace_trait_image ang isang larawan, pinapalitan ng kurv_rename_trait ang pangalan ng trait at ina-update ang mga rule at unique nito, inaalis ng kurv_delete_trait ang trait na walang tumutukoy. Pagkatapos bagong preview.
14. Pag-apruba: ang mga huling sample at ang bawat babala, binasa sa iyo.
15. Maghanda. kurv_prepare_launch kasama ang draft. Sa warnings_need_review ipinapaliwanag ng ahente ang bawat babala; pagkatapos mo lamang tanggapin ay tumatawag itong muli na true ang acknowledge_warnings. Makakakuha ka ng browser link.
16. Ikaw ang pipirma. Buksan ang isang link, tingnan ang nakalagay, piliin ang I-publish at ilunsad, at pumirma gamit ang sarili mong wallet sa huling hakbang. Bawat sagot ay isang Bumalik lang ang layo. Walang tool na pipirma para sa iyo.

Mga rule

Pinaghihiwalay o pinagsasama ng rule ang mga trait ng dalawang layer: {"type", "when", "target", "note"}, kung saan ang type ay exclude o require, at ang when at target ay bawat isa nagpapangalan ng layer at, opsyonal, ng trait: isang pangalan o listahan ng mga pangalan. Walang trait ay nangangahulugang buong layer, at dapat magkaibang layer ang when at target. Ang key ay trait: tinatanggihan ang rule na isinulat na traits na may pangalan ng tamang key, sa halip na tahimik na ilapat sa buong layer. Maaaring kumatawan ang None sa walang lamang layer kung ang layer na iyon ay may noneWeight na lampas sa 0 lamang. Pagsamahin ang mga pares sa mga listahan upang manatili sa ilalim ng 48: isang rule bawat grupo ng mga skin, na naglilista ng bawat collar na hindi nila dapat isuot kailanman.

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

Umaabot sa mga piraso ang mga rule: ang parehong engine ang gumagawa ng preview at ng mga nai-publish na file, at ang mga file na iyon ang ibinibigay ng pag-mint. Maaaring lumaktaw sa mga rule ang unique na true ang ignoreRules; nananatili pa rin ang pagiging natatangi.

Mga unique

Ang mga unique ay specials: isang pangalan, bawat layer na may trait nito o None, isang opsyonal na nakapirming numero ng piraso at isang opsyonal na paglalarawan. Ang unique na nag-iwan ng layer ay nakakakuha ng layer na iyon nang random, at nagbababala ang validation kung aling mga layer iyon. Tinatanggihan ang null, gayundin ang pangalan ng trait na wala.

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

Art na gusto ng mga tao

• Masikap at pinakintab na art. Walang patag, malabo, halatang ginawa ng makina na itsura.
• Malalakas na background: matatapang na kulay o masaganang eksena. Iwasan ang mga tema ng lugar (mga lungsod, mga dalampasigan) maliban kung sinadya.
• Three-quarter na pose at nakikilalang hawig ng tunay na alaga: mga marka, kulay ng mata, hugis ng tainga.
• Matatapang na trait na akma sa katawan ng karakter, iginuhit sa hugis ng master. Eksaktong akma ang ngipin sa bibig.
• Walang lumulutang na headwear. Nakaupo ang mga sumbrero sa ulo na may contact shadow; lumalampas ang malalaking tainga sa gilid ng sumbrero.
• Kadalasang hindi akma ang damit sa mga hayop. Piliin ang mga collar, kadena at palamuti sa leeg, at subukan ang mga ito sa bawat skin.
• Ganap na nagbago ang mga premium na unique, may katugmang background at walang collar.

Sinusuri ng connector ang art pagdating nito. Tinatanggihan ng mga error ang upload: ibang laki ng canvas, layer sa ibabaw ng background na hindi PNG na may transparency, larawang walang nakikitang pixel. Bumabalik ang mga babala para suriin mo: trait sa labas ng anchor nito, trait na iba ang scale sa layer nito, trait na wala sa pixel grid ng base, trait na may dala pang buo o bahagi ng larawan ng base, trait na tumatakip sa buong canvas. Maaaring mali ang isang babala: ang natural na mga mata sa iisang layer kasama ang salaming pang-araw ay sinadyang magkaiba ang laki. Itinatakda ng ahente ang mixedScales sa layer na iyon, o ang acknowledge sa trait kapag pumayag ka na, at nananatili ang art kung paano ito dapat.

Ang binabasa pabalik ng ahente

Sinasagot ng bawat tool na nagbe-validate ang bawat problema nang sabay-sabay sa iisang listahang issues, bawat isa may path, code, severity, mensahe at remedyo. Tinatanggihan sa pangalan ang hindi kilalang key kasama ang pinakamalapit na wastong key. Pinapangalanan ang network (base-sepolia, solana-devnet, solana-localnet), at ang draft na wala nito ay gumagamit ng Base Sepolia at sinasabi iyon. Gumagamit ang mga paraan ng sale ng mga pangalan ng website (fixed, mystery, rising, falling, auction): sa pamamagitan ng connector nag-aalok ang Base ng fixed, mystery at rising, nag-aalok ang Solana ng fixed at rising, at ang mga falling at auction na sale ay inaayos sa website. Tinatanggihan sa pangalan ang field ng sale na wala sa network, gaya ng ticker sa Solana. Napatunayan ang metadata sa pamamagitan ng isang pagsusuri: sumusunod sa mga rule ang bawat piraso, dumadapo ang unique sa pirasong ipinako sa kanya, at isinusulat ang walang lamang layer bilang {"trait_type": "<layer>", "value": "None"}.

Mga tapos na piraso

Nilalaktawan ng mga pirasong umiiral na bilang tapos na larawan ang mga layer: kurv_finished_art_limits, pagkatapos kurv_upload_finished_file_part para sa bawat larawan at sa metadata.json, pagkatapos kurv_import_finished_collection. Iniingatan ang mga byte kung paano ibinigay, kasama ang animation, at hindi umiiral ang mga limitasyon ng layer; umiiral ang kasalukuyang mga limitasyon ng publication ng website. Ipinapaliwanag ng Tapos na art ang mga file.

Mga kilalang limitasyon ng build na ito

• Sinusuri ng sariling parser ng app ang mga halaga ng version 2 na Solana sale pagkatapos ng mga key, isa-isa; sinasagot ng version 3 na sale ang bawat problema nang sabay-sabay.
• Hindi mae-edit sa lugar ang draft ng tapos na art; ang pag-aayos ay bagong upload at bagong key.
• Hindi maibabalik ang na-archive na draft sa pamamagitan ng connector; 30 araw na nakatago ang art nito.
• Hindi magagamit ang Robinhood Chain sa pamamagitan ng connector: walang network config at walang sale schema. Darating ito pagkatapos ng mga launch sa Base at Solana.

Mga snapshot ang mga bilang ng koleksyon at naglilipat ng tunay na halaga sa network nito ang isang launch; basahin ang Mga panganib at disclaimer bago payuhan ang sinuman tungkol sa pera.