Collection 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. Правила. Контактные листы каждой шкуры с каждым ошейником, зубами, глазами и головным убором. Каждая плохая пара (пересечение, невидимость, некрасиво) становится сгруппированным правилом exclude с заметкой, объясняющей причину.
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.

Цифры коллекций это снимки, а запуск перемещает реальные ценности в своей сети; прочитайте Риски и отказ от ответственности, прежде чем давать кому-либо советы о деньгах.