O Blueprint da coleção

O KURV funciona hoje na Base Sepolia e na Solana Devnet. Esta página é o guia de campo de uma criação completa (HANI the Dog, 1.000 peças, 20 únicas), escrito para o criador que trabalha com um agente de IA pelo conector do KURV em https://mcp.kurv.fun/mcp. O conector entrega o mesmo guia aos agentes como o recurso kurv://blueprint, e a ferramenta kurv_builder_spec é a fonte da verdade: quando esta página e a ferramenta discordarem, confie na ferramenta.

Conecte um agente

1. Adicione https://mcp.kurv.fun/mcp como servidor MCP remoto em um cliente que aceite MCP remoto com OAuth. Conecte um agente com MCP lista os clientes e os passos de cada um.
2. Entre no KURV pelo navegador e aprove a conexão. Você escolhe o que ela pode fazer (só ler, ler e criar rascunhos, ou ler, criar rascunhos e preparar lançamentos) e por quanto tempo ela vale.
3. Peça ao agente que leia kurv://blueprint e depois chame kurv_account e kurv_builder_spec para a sua rede. O conector também oferece o prompt build-kurv-collection, que conduz o agente por esta página com todas as paradas de aprovação no lugar.

Quem faz o quê

O agente planeja, valida, cria o rascunho, envia a arte, gera as prévias e prepara o lançamento. Você aprova a arte, as amostras e cada aviso, depois abre o link de revisão e assina o lançamento com a sua própria carteira. O agente nunca implanta, nunca assina e nunca pede uma chave privada ou uma frase-semente. Com a arte pronta e aprovada, a parte do KURV (validar, criar, enviar, gerar a prévia, preparar) leva cerca de 20 minutos. Fazer uma arte boa leva mais tempo, e é assim que deve ser.

Os limites

Item	Limite
Tamanho da coleção	De 1 a 1.000 peças, com as únicas incluídas: 980 peças aleatórias e 20 únicas dão um tamanho de 1.000.
Camadas	Até 12.
Imagens de atributos	Até 240 no total, somando todas as camadas, incluindo a arte usada só pelas únicas. Uma camada vazia não custa nada.
Únicas	Até 32.
Regras	Até 48, iguais em todas as redes.
Tamanho do arquivo de imagem	Até 2 MiB por imagem enviada uma de cada vez; até 20 MiB para uma imagem dentro de um zip.
Tela	Quadrada, de até 2.048 por 2.048 pixels. Todo arquivo tem exatamente o tamanho da tela.
Formatos	Fundo: PNG, JPEG ou WebP. Todas as outras camadas: PNG com transparência real.
O nome None	Reservado, com qualquer combinação de maiúsculas e minúsculas. Nunca um atributo chamado None, nunca uma imagem vazia: uma camada fica opcional por meio de noneWeight.
Descrição	Trate como obrigatória: de 1 a 2.000 caracteres. Ela vai para os metadados de todas as peças.
Rascunhos	20 ativos por conta. kurv_archive_draft libera uma vaga na hora; a arte do rascunho arquivado é guardada por 30 dias e depois removida.
Prévias	Até 9 amostras aleatórias por chamada, ou até 9 números de peça escolhidos, de 64 a 512 pixels.

O agente lê validCombinations depois de cada validação: quantas peças distintas as camadas e as regras permitem. O número é contado de forma exata para espaços de até cerca de 50 milhões de combinações e marcado como estimativa acima disso. Mantenha esse número bem acima do tamanho da coleção.

O caminho, passo a passo

Os passos marcados com Aprovação significam: o agente para e espera o seu sim explícito.

1. Fotos. Reúna de 3 a 10 fotos nítidas do pet ou personagem real: rosto, olhos, dentes e boca, marcas, orelhas. Escolha uma foto principal com o rosto em vista de três quartos.
2. Direção de arte. Um estilo, uma pose (três quartos funciona melhor), uma tela quadrada (2.048 por 2.048 recomendados) e uma folha de estilo curta: traço, sombreamento, paleta, clima. Aprovação: o personagem mestre, antes de qualquer atributo ser feito.
3. A base mestre. O personagem na pose final, sobre um fundo liso de uma só cor, centralizado, no tamanho total da tela, reconhecível na hora como o pet real. Todo atributo é uma edição desse mestre, com a mesma pose, escala e enquadramento.
4. Camadas. As camadas são pintadas de baixo para cima: Background, Skin (a camada base), Collar, Teeth, Eyes, Headwear (opcional). Umas seis camadas; quem sustenta a coleção é o personagem, não os acessórios. O agente indica a camada base em base_layer e dá a cada camada uma caixa de ancoragem onde os atributos dela devem ficar.
5. Atributos. Cada atributo é uma edição de uma cópia do mestre, recortada para que só os pixels do próprio atributo fiquem visíveis e todo o resto fique transparente. Gerar os atributos sobre uma cópia do corpo em cor lisa evita que o pelo entre neles. Um atributo que sai da posição ou da escala é recusado.
6. Únicas. Corpos totalmente transformados (diamante, cromo, lava, bronze), cada um com um fundo combinando e sem coleira. A arte delas entra na camada como um atributo com peso 0, para nunca aparecer em peças aleatórias; ela conta para as 240 imagens.
7. Regras. Folhas de contato de cada pele com cada atributo de coleira, dentes, olhos e chapéu. Todo par ruim (sobreposto, invisível, feio) vira uma regra de exclusão agrupada, com uma nota que explica o motivo.
8. Aprovação: as folhas das camadas, pelo menos 9 amostras compostas, a folha das únicas, a configuração e as condições de venda, antes de o rascunho ser criado.
9. Configuração e validação. kurv_builder_spec com a rede, depois kurv_validate_collection com a configuração até a lista issues não ter nenhum erro. Os avisos apontam o que você precisa saber. A resposta traz required_assets, as chaves exatas a enviar, e validCombinations.
10. O rascunho. kurv_create_collection com version: 3, a rede, a configuração, as condições de venda e uma chave de idempotência, primeiro com check_only em true, depois para valer. Uma chamada que falha é repetida com a mesma chave. As condições de venda têm uma única forma em todas as redes: veja Condições de venda.
11. A arte. Uma de cada vez com kurv_upload_trait (fundo, base e um atributo por camada primeiro, depois uma prévia, depois o resto), ou tudo de uma vez no formato de pasta do site por kurv_upload_collection_zip. Uma camada vazia é um noneWeight, nunca um PNG transparente.
12. Verificação e prévia. kurv_validate_collection com o rascunho roda as verificações da arte. kurv_preview_collection com 9 amostras depois do último envio, mais os números de peça de todas as únicas e as combinações mais arriscadas. O agente olha cada imagem. Uma primeira prévia demorada responde retry_after e as amostras pendentes; o agente chama de novo.
13. Correções sem um rascunho novo. kurv_update_collection muda regras, únicas, pesos, dicas ou a descrição no lugar; a tela não pode mudar. kurv_replace_trait_image troca uma imagem, kurv_rename_trait renomeia um atributo e atualiza as regras e as únicas dele, kurv_delete_trait remove um atributo que nada referencia. Depois, uma nova prévia.
14. Aprovação: as amostras finais e todos os avisos, lidos para você.
15. Preparação. kurv_prepare_launch com o rascunho. Em warnings_need_review, o agente explica cada aviso; só depois que você aceita ele chama de novo, com acknowledge_warnings em true. Você recebe um link para o navegador.
16. Você assina. Abra o único link, confira o que está preenchido, escolha Publicar e lançar e assine com a sua própria carteira na última etapa. Cada resposta está a um Voltar de distância. Nenhuma ferramenta assina por você.

Regras

Uma regra mantém os atributos de duas camadas separados ou juntos: {"type", "when", "target", "note"}, em que type é exclude ou require, e when e target nomeiam cada um uma camada e, se quiser, um atributo: um nome ou uma lista de nomes. Sem atributo, vale a camada inteira, e when e target precisam ser camadas diferentes. A chave é trait: uma regra escrita com traits é recusada com o nome da chave certa, em vez de valer em silêncio para a camada inteira. None só pode representar uma camada vazia quando essa camada tem um noneWeight acima de 0. Agrupe os pares em listas para ficar abaixo de 48: uma regra por grupo de peles, listando todas as coleiras que elas nunca devem usar.

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

As regras chegam às peças: o mesmo mecanismo gera a prévia e os arquivos publicados, e a cunhagem entrega esses arquivos. Uma única pode ignorar as regras com ignoreRules em true; a exclusividade continua valendo.

Únicas

As únicas são specials: um nome, cada camada com o seu atributo ou None, um número de peça fixado opcional e uma descrição opcional. Uma única que deixa uma camada de fora recebe essa camada de forma aleatória, e a validação avisa quais camadas são essas. null é recusado, assim como um nome de atributo que não existe.

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

Arte que as pessoas querem

• Arte caprichada e bem acabada. Nada de visual chapado, embaçado ou com cara óbvia de gerado.
• Fundos fortes: cores marcantes ou cenas ricas. Evite temas de lugar (cidades, praias), a não ser que sejam de propósito.
• Pose de três quartos e uma semelhança reconhecível com o pet real: marcas, cor dos olhos, formato das orelhas.
• Atributos marcantes, ajustados ao corpo do personagem, desenhados sobre o formato do mestre. Os dentes se encaixam exatamente na boca.
• Nada de chapéu flutuando. Os chapéus ficam apoiados na cabeça, com sombra de contato; orelhas grandes passam por cima da aba.
• Roupas costumam ficar ruins em animais. Prefira coleiras, correntes e acessórios de pescoço, e experimente-os em todas as peles.
• As únicas premium são totalmente transformadas, com fundos combinando e sem coleira.

O conector verifica a arte à medida que ela chega. Os erros recusam um envio: um tamanho de tela diferente, uma camada acima do fundo que não é um PNG com transparência, uma imagem sem nenhum pixel visível. Os avisos voltam para você revisar: um atributo fora da sua âncora, um atributo em outra escala que a da camada, um atributo fora da grade de pixels da base, um atributo que ainda carrega a imagem da base inteira ou em parte, um atributo que cobre a tela toda. Um aviso pode ser falso: olhos naturais na mesma camada que óculos de sol têm outro tamanho de propósito. O agente define mixedScales nessa camada, ou acknowledge no atributo depois que você concordar, e a arte fica como deve ficar.

O que o agente recebe de volta

Toda ferramenta de validação responde todos os problemas de uma vez em uma lista issues, cada um com um caminho, um código, uma gravidade, uma mensagem e uma correção. Uma chave desconhecida é recusada pelo nome, com a válida mais próxima. A rede é nomeada (base-sepolia, solana-devnet, solana-localnet), e um rascunho sem rede usa a Base Sepolia e avisa isso. Os métodos de venda usam os nomes do site (fixed, mystery, rising, falling, auction): pelo conector, a Base oferece fixed, mystery e rising, a Solana oferece fixed e rising, e as vendas falling e auction são configuradas no site. Um campo de venda que a rede não tem, como um símbolo na Solana, é recusado pelo nome. Os metadados são comprovados por um teste: toda peça respeita as regras, uma única cai na peça em que está fixada, e uma camada vazia é gravada como {"trait_type": "<layer>", "value": "None"}.

Peças prontas

Peças que já existem como imagens prontas pulam as camadas: kurv_finished_art_limits, depois kurv_upload_finished_file_part para cada imagem e para o metadata.json, depois kurv_import_finished_collection. Os bytes são mantidos como foram entregues, com animação, e os limites das camadas não se aplicam; os limites atuais de publicação do site, sim. Traga a arte que você já fez explica os arquivos.

Limites conhecidos desta versão

• Os valores de uma venda da Solana na versão 2 são verificados pelo próprio parser do app depois das chaves, um de cada vez; uma venda na versão 3 responde todos os problemas de uma vez.
• Um rascunho de arte pronta não pode ser editado no lugar; uma correção é um novo envio e uma nova chave.
• Um rascunho arquivado não pode ser restaurado pelo conector; a arte dele é guardada por 30 dias.
• A Robinhood Chain não está disponível pelo conector: não há configuração de rede nem esquema de venda. Ela vem depois dos lançamentos na Base e na Solana.

Os números das coleções são retratos de um momento, e um lançamento movimenta valor real na rede dele; leia Riscos e isenção de responsabilidade antes de orientar alguém sobre dinheiro.