Blueprint колекції

Сьогодні KURV працює на Base Sepolia і Solana Devnet. Ця сторінка це практичний посібник за підсумками повної збірки (HANI the Dog, 1 000 NFT, 20 унікальних), написаний для автора, який працює з ШІ-агентом через конектор KURV за адресою https://mcp.kurv.fun/mcp. Конектор надає агентам той самий посібник як ресурс kurv://blueprint, а джерелом істини є інструмент kurv_builder_spec: якщо ця сторінка й інструмент розходяться, довіряйте інструменту.

Підключіть агента

1. Додайте https://mcp.kurv.fun/mcp як віддалений MCP-сервер у клієнт, який підтримує віддалений MCP з OAuth. На сторінці Підключіть агента через MCP перелічено клієнти та їхні кроки.
2. Увійдіть у KURV у браузері й схваліть підключення. Ви обираєте, що воно може робити (лише читати; читати й створювати чернетки; або читати, створювати чернетки й готувати запуск) і скільки воно діятиме.
3. Попросіть агента прочитати kurv://blueprint, а потім викликати kurv_account і kurv_builder_spec для вашої мережі. Конектор також пропонує промпт build-kurv-collection, який веде агента цією сторінкою з усіма зупинками для схвалення.

Хто що робить

Агент планує, перевіряє, створює чернетку, завантажує арт, робить прев’ю і готує запуск. Ви схвалюєте арт, зразки й кожне попередження, потім відкриваєте посилання для перевірки й підписуєте запуск власним гаманцем. Агент ніколи не розгортає контракт, ніколи не підписує і ніколи не просить приватний ключ чи сід-фразу. Коли арт готовий і схвалений, частина роботи на боці KURV (перевірка, створення, завантаження, прев’ю, підготовка) триває близько 20 хвилин. Створення хорошого арту займає більше часу, і так і має бути.

Обмеження

Елемент	Обмеження
Розмір колекції	Від 1 до 1 000 NFT разом з унікальними: 980 випадкових NFT і 20 унікальних дають розмір 1 000.
Шари	До 12.
Зображення атрибутів	Загалом до 240 у всіх шарах, разом з артом, який використовують лише унікальні NFT. Порожній шар нічого не коштує.
Унікальні NFT	До 32.
Правила	До 48, однаково в кожній мережі.
Розмір файлу зображення	До 2 MiB на зображення, надіслане окремо; до 20 MiB на одне зображення всередині ZIP.
Полотно	Квадратне, до 2 048 на 2 048 пікселів. Кожен файл має точно розмір полотна.
Формати	Тло: PNG, JPEG або WebP. Кожен інший шар: PNG зі справжньою прозорістю.
Назва None	Зарезервована в будь-якому регістрі. Ніколи не називайте атрибут None і не додавайте порожнє зображення: шар стає необов’язковим через noneWeight.
Опис	Вважайте обов’язковим: від 1 до 2 000 символів. Він потрапляє в метадані кожного NFT.
Чернетки	20 активних на акаунт. kurv_archive_draft одразу звільняє місце; арт архівованої чернетки зберігається 30 днів, а потім видаляється.
Прев’ю	До 9 випадкових зразків за виклик або до 9 обраних номерів NFT, розміром від 64 до 512 пікселів.

Після кожної перевірки агент читає validCombinations: скільки різних NFT дозволяють шари й правила. Для просторів приблизно до 50 мільйонів комбінацій це число рахується точно, а понад це позначається як оцінка. Тримайте його з хорошим запасом вище за розмір колекції.

Шлях, крок за кроком

Кроки з позначкою Схвалення означають: агент зупиняється й чекає вашого явного «так».

1. Фото. Зберіть від 3 до 10 чітких фото справжнього улюбленця чи персонажа: морда, очі, зуби й рот, плями, вуха. Оберіть одне головне фото з мордою у три чверті.
2. Арт-дирекція. Один стиль, одна поза (найкраще у три чверті), одне квадратне полотно (рекомендовано 2 048 на 2 048), короткий стильовий аркуш: лінії, тіні, палітра, настрій. Схвалення: головний персонаж, перш ніж створювати будь-який атрибут.
3. Головна основа. Персонаж у фінальній позі на рівному однотонному тлі, по центру, на повний розмір полотна, одразу впізнаваний як справжній улюбленець. Кожен атрибут це редагування цієї основи з тією самою позою, масштабом і кадруванням.
4. Шари. Шари накладаються знизу вгору: Background (тло), Skin (базовий шар), Collar (нашийник), Teeth (зуби), Eyes (очі), Headwear (головний убір, необов’язковий). Приблизно шість шарів; колекцію тримає персонаж, а не аксесуари. Агент вказує базовий шар у base_layer і задає кожному шару опорну рамку, у якій мають бути його атрибути.
5. Атрибути. Кожен атрибут це редагування копії основи, вирізане так, що видно лише власні пікселі атрибута, а все інше прозоре. Якщо генерувати атрибути на однотонній копії тіла, у них не потрапляє шерсть. Атрибут, що зміщується за положенням чи масштабом, відхиляється.
6. Унікальні NFT. Повністю перетворені тіла (діамант, хром, лава, бронза), кожне з відповідним тлом і без нашийника. Їхній арт додається у свій шар як атрибут з вагою 0, тож він ніколи не з’являється у випадкових NFT; він враховується в ліміт 240 зображень.
7. Правила. Контактні аркуші кожної шкіри з кожним нашийником, зубами, очима й головним убором. Кожна погана пара (накладання, невидимість, некрасивий вигляд) стає груповим правилом виключення з приміткою, яка пояснює чому.
8. Схвалення: аркуші шарів, щонайменше 9 зведених зразків, аркуш унікальних NFT, конфігурація й умови продажу, перш ніж створювати чернетку.
9. Конфігурація й перевірка. kurv_builder_spec із мережею, потім kurv_validate_collection з конфігурацією, доки в її списку issues не залишиться жодної помилки. Попередження називають те, про що вам варто знати. Відповідь містить required_assets, точні ключі для завантаження, і validCombinations.
10. Чернетка. kurv_create_collection з version: 3, мережею, конфігурацією, умовами продажу й ключем ідемпотентності, спершу з check_only, встановленим у true, а потім по-справжньому. Невдалий виклик повторюють із тим самим ключем. Умови продажу мають одну форму в кожній мережі: див. Умови продажу.
11. Арт. Поодинці через kurv_upload_trait (спершу тло, основа й по одному атрибуту на шар, потім прев’ю, потім решта) або все одразу у форматі папки сайту через kurv_upload_collection_zip. Порожній шар це noneWeight, ніколи не прозорий PNG.
12. Перевірка й прев’ю. kurv_validate_collection із чернеткою запускає перевірки арту. kurv_preview_collection з 9 зразками після останнього завантаження, плюс номери кожного унікального NFT і найризикованіших комбінацій. Агент переглядає кожне зображення. Довге перше прев’ю відповідає retry_after і зразками, що ще готуються; агент викликає знову.
13. Виправлення без нової чернетки. kurv_update_collection змінює на місці правила, унікальні NFT, ваги, підказки чи опис; полотно змінити не можна. kurv_replace_trait_image замінює одне зображення, kurv_rename_trait перейменовує атрибут і оновлює його правила й унікальні NFT, kurv_delete_trait видаляє атрибут, на який ніщо не посилається. Потім нове прев’ю.
14. Схвалення: фінальні зразки й кожне попередження, озвучені вам.
15. Підготовка. kurv_prepare_launch із чернеткою. У разі warnings_need_review агент пояснює кожне попередження; лише після того, як ви їх приймете, він викликає знову з acknowledge_warnings, встановленим у true. Ви отримуєте посилання для браузера.
16. Підписуєте ви. Відкрийте єдине посилання, перевірте, що заповнено, виберіть Опублікувати й запустити і підпишіть власним гаманцем на останньому кроці. Кожна відповідь на одне «Назад». Жоден інструмент не підписує за вас.

Правила

Правило тримає атрибути двох шарів окремо або разом: {"type", "when", "target", "note"}, де type це exclude або require, а when і target кожен називає шар і, за бажанням, атрибут: одну назву або список назв. Без атрибута мається на увазі весь шар, і when та target мають бути різними шарами. Ключ називається trait: правило, записане з traits, відхиляється з підказкою правильного ключа, а не мовчки застосовується до всього шару. None може означати порожній шар, лише якщо цей шар має noneWeight більше 0. Групуйте пари в списки, щоб не перевищити 48: одне правило на групу шкір зі списком усіх нашийників, які вони ніколи не мають носити.

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

Правила доходять до NFT: той самий рушій генерує і прев’ю, і опубліковані файли, а мінт видає саме ці файли. Унікальний NFT може оминати правила з ignoreRules, встановленим у true; унікальність усе одно зберігається.

Унікальні NFT

Унікальні NFT це specials: назва, кожен шар зі своїм атрибутом або None, необов’язковий закріплений номер NFT і необов’язковий опис. Унікальний NFT, у якому пропущено шар, отримує цей шар випадково, і перевірка попереджає, які це шари. null відхиляється, як і назва атрибута, якого не існує.

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

Арт, якого хочуть люди

• Ретельний, відшліфований арт. Без плаского, брудного, очевидно згенерованого вигляду.
• Сильні тла: яскраві кольори або насичені сцени. Уникайте тем місць (міста, пляжі), якщо це не задум.
• Поза у три чверті й упізнавана схожість зі справжнім улюбленцем: плями, колір очей, форма вух.
• Виразні атрибути, підігнані до тіла персонажа й намальовані за формою основи. Зуби точно відповідають роту.
• Жодних головних уборів, що висять у повітрі. Капелюхи сидять на голові з контактною тінню; великі вуха лягають поверх крис.
• Одяг на тваринах зазвичай сидить погано. Краще обирайте нашийники, ланцюжки й прикраси на шию і перевіряйте їх на кожній шкірі.
• Преміальні унікальні NFT повністю перетворені, з відповідним тлом і без нашийника.

Конектор перевіряє арт, щойно той надходить. Помилки відхиляють завантаження: інший розмір полотна, шар над тлом, що не є PNG із прозорістю, зображення без жодного видимого пікселя. Попередження повертаються вам на перегляд: атрибут поза своєю опорною рамкою, атрибут в іншому масштабі, ніж його шар, атрибут поза піксельною сіткою основи, атрибут, який досі містить зображення основи повністю чи частково, атрибут, що вкриває все полотно. Одне попередження може бути хибним: природні очі в одному шарі із сонцезахисними окулярами навмисно мають інший розмір. Агент встановлює mixedScales для цього шару або acknowledge для атрибута, щойно ви погодитеся, і арт лишається таким, яким має бути.

Що агент отримує у відповідь

Кожен інструмент перевірки повідомляє про всі проблеми одразу в одному списку issues, кожну зі шляхом, кодом, рівнем серйозності, повідомленням і способом виправлення. Невідомий ключ відхиляється за назвою з найближчим правильним. Мережа називається явно (base-sepolia, solana-devnet, solana-localnet), а чернетка без неї використовує Base Sepolia і повідомляє про це. Способи продажу мають назви з сайту (fixed, mystery, rising, falling, auction): через конектор Base пропонує fixed, mystery і rising, Solana пропонує fixed і rising, а продажі falling і auction налаштовуються на сайті. Поле продажу, якого немає в мережі, наприклад тікер на Solana, відхиляється за назвою. Метадані підтверджує автоматична перевірка: кожен NFT дотримується правил, унікальний NFT потрапляє на закріплений за ним номер, а порожній шар записується як {"trait_type": "<layer>", "value": "None"}.

Готові NFT

NFT, які вже існують як готові зображення, обходяться без шарів: kurv_finished_art_limits, потім kurv_upload_finished_file_part для кожного зображення й metadata.json, потім kurv_import_finished_collection. Байти зберігаються такими, як їх надано, разом з анімацією, і обмеження шарів не діють; діють поточні обмеження публікації на сайті. Про файли читайте на сторінці Додайте готовий арт.

Відомі обмеження цієї збірки

• Значення продажу Solana версії 2 перевіряє власний парсер застосунку після ключів, по одному; продаж версії 3 повідомляє про всі проблеми одразу.
• Чернетку з готовим артом не можна редагувати на місці; виправлення це нове завантаження й новий ключ.
• Архівовану чернетку не можна відновити через конектор; її арт зберігається 30 днів.
• Robinhood Chain недоступна через конектор: немає ні конфігурації мережі, ні схеми продажу. Вона з’явиться після запусків на Base і Solana.

Показники колекцій це знімки, а запуск переміщує реальну вартість у своїй мережі; прочитайте Ризики та застереження, перш ніж радити комусь щодо грошей.