O Collection Blueprint

Hoje, o KURV funciona em Base Sepolia e Solana Devnet. Esta página é o guia prático de uma criação completa (HANI the Dog, 1000 peças, 20 únicas), escrito para um criador que trabalha com um agente de IA através do conector do KURV em https://mcp.kurv.fun/mcp. O conector serve o mesmo guia aos agentes como o recurso kurv://blueprint, e a ferramenta kurv_builder_spec é a fonte de verdade: onde esta página e a ferramenta não coincidirem, confie na ferramenta.

Ligar um agente

1. Adicione https://mcp.kurv.fun/mcp como servidor MCP remoto num cliente que suporte MCP remoto com OAuth. Ligar um agente com MCP lista os clientes e os respetivos passos.
2. Inicie sessão no KURV no navegador e aprove a ligação. Escolhe o que pode fazer (só leitura, leitura e rascunhos, ou leitura, rascunhos e preparação do lançamento) e quanto tempo dura.
3. Peça ao agente que leia kurv://blueprint e depois chame kurv_account e kurv_builder_spec para a sua rede. O conector oferece também o prompt build-kurv-collection, que conduz o agente ao longo desta página com todas as paragens para aprovação no sítio.

Quem faz o quê

O agente planeia, valida, cria o rascunho, carrega a arte, pré-visualiza e prepara o lançamento. O criador aprova a arte, as amostras e cada aviso, e depois abre a ligação de revisão e assina o lançamento com a sua própria carteira. O agente nunca implementa, nunca assina e nunca pede uma chave privada ou uma frase de recuperação. Depois de a arte estar acabada e aprovada, a parte do KURV (validar, criar, carregar, pré-visualizar, preparar) demora cerca de 20 minutos. Fazer boa arte demora mais, e assim deve ser.

Os limites

Item	Limite
Tamanho da coleção	De 1 a 1000 peças, únicas incluídas: 980 peças aleatórias e 20 únicas dão um tamanho de 1000.
Camadas	Até 12.
Imagens de atributos	Até 240 no total, em todas as camadas, incluindo a arte usada só pelas únicas. Uma camada vazia não conta.
Únicas	Até 32.
Regras	Até 48, iguais em todas as redes.
Tamanho do ficheiro de imagem	Até 2 MiB por imagem enviada uma a uma; até 20 MiB por imagem dentro de um zip.
Tela	Quadrada, até 2048 por 2048 píxeis. Todos os ficheiros têm 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 torna-se opcional através de noneWeight.
Descrição	Considere-a obrigatória: de 1 a 2000 caracteres. Entra nos metadados de todas as peças.
Rascunhos	20 ativos por conta. kurv_archive_draft liberta um lugar de imediato; a arte do rascunho arquivado é guardada durante 30 dias e depois apagada.
Pré-visualizações	Até 9 amostras aleatórias por chamada, ou até 9 números de peça escolhidos, de 64 a 512 píxeis.

O agente lê validCombinations depois de cada validação: quantas peças distintas as camadas e as regras permitem. É contado com exatidão para espaços até cerca de 50 milhões de combinações e marcado como estimativa acima disso. Mantenha-o confortavelmente acima do tamanho da coleção.

O caminho, passo a passo

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

1. Fotografias. Reúna de 3 a 10 fotografias nítidas do animal ou da personagem real: cara, olhos, dentes e boca, manchas, orelhas. Escolha uma fotografia principal com a cara vista a três quartos.
2. Direção artística. Um estilo, uma pose (a três quartos funciona melhor), uma tela quadrada (recomenda-se 2048 por 2048), uma folha de estilo curta: traço, sombreado, paleta, ambiente. Aprovação: a personagem mestra, antes de se criar qualquer atributo.
3. A base mestra. A personagem na pose final, sobre um fundo liso de uma só cor, centrada, com o tamanho total da tela, reconhecível de imediato como o animal real. Cada atributo é uma edição desta mestra, com a mesma pose, escala e enquadramento.
4. Camadas. As camadas pintam-se de baixo para cima: Background, Skin (a camada base), Collar, Teeth, Eyes, Headwear (opcional). Cerca de seis camadas; é a personagem que sustenta a coleção, não os adereços. O agente indica a camada base em base_layer e dá a cada camada uma caixa de ancoragem onde os seus atributos têm de ficar.
5. Atributos. Cada atributo é uma edição de uma cópia da mestra, recortada para que só se vejam os píxeis do próprio atributo e tudo o resto seja transparente. Gerar os atributos sobre uma cópia do corpo em cor lisa mantém o pelo fora deles. Um atributo que se desvie na posição ou na escala é rejeitado.
6. Únicas. Corpos totalmente transformados (diamante, cromado, lava, bronze), cada um com um fundo a condizer e sem coleira. A sua arte entra na respetiva camada como um atributo com peso 0, para nunca aparecer em peças aleatórias; conta para as 240 imagens.
7. Regras. Folhas de contacto de cada pele com cada atributo de coleira, dentes, olhos e chapéu. Cada par mau (sobreposto, invisível, feio) torna-se uma regra de exclusão agrupada, com uma nota que explica porquê.
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, e depois kurv_validate_collection com a configuração até a lista issues não ter nenhum erro. Os avisos indicam aquilo de que deve ter conhecimento. A resposta traz required_assets, as chaves exatas a carregar, 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 definido como true e depois a sério. Uma chamada falhada repete-se com a mesma chave. As condições de venda têm a mesma forma em todas as redes: consulte Condições de venda.
11. A arte. Uma imagem de cada vez com kurv_upload_trait (primeiro o fundo, a base e um atributo por camada, depois uma pré-visualização, depois o resto), ou tudo de uma vez no formato de pasta do site através de kurv_upload_collection_zip. Uma camada vazia é um noneWeight, nunca um PNG transparente.
12. Verificação e pré-visualização. kurv_validate_collection com o rascunho faz as verificações da arte. kurv_preview_collection com 9 amostras depois do último carregamento, mais os números de peça de cada única e as combinações mais arriscadas. O agente vê todas as imagens. Uma primeira pré-visualização demorada responde com retry_after e as amostras pendentes; o agente volta a chamar.
13. Correções sem um rascunho novo. kurv_update_collection altera regras, únicas, pesos, sugestões ou a descrição no próprio rascunho; a tela não pode mudar. kurv_replace_trait_image troca uma imagem, kurv_rename_trait muda o nome de um atributo e atualiza as respetivas regras e únicas, kurv_delete_trait remove um atributo que nada referencia. Depois, uma nova pré-visualização.
14. Aprovação: as amostras finais e cada aviso, lidos para si.
15. Preparar. kurv_prepare_launch com o rascunho. Perante warnings_need_review, o agente explica cada aviso; só depois de os aceitar volta a chamar com acknowledge_warnings definido como true. Recebe uma ligação para o navegador.
16. Quem assina é o próprio. Abra a única ligação, verifique o que está preenchido, escolha Publicar e lançar e assine com a sua própria carteira no último passo. Cada resposta está a um Voltar de distância. Nenhuma ferramenta assina por si.

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 indicam cada um uma camada e, opcionalmente, um atributo: um nome ou uma lista de nomes. Sem atributo, aplica-se à camada inteira, e when e target têm de ser camadas diferentes. A chave é trait: uma regra escrita com traits é recusada, com a indicação da chave certa, em vez de se aplicar em silêncio à camada inteira. None pode representar uma camada vazia apenas onde essa camada tem um noneWeight acima de 0. Agrupe os pares em listas para ficar abaixo de 48: uma regra por grupo de peles, com a lista de todas as coleiras que nunca podem 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 motor gera a pré-visualização e os ficheiros publicados, e a cunhagem distribui esses ficheiros. Uma única pode ignorar as regras com ignoreRules definido como true; a unicidade mantém-se.

Ú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 deixe uma camada de fora recebe essa camada ao acaso, e a validação avisa quais são essas camadas. null é recusado, tal 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 trabalhada e cuidada. Nada de aspeto plano, baço ou visivelmente gerado.
• Fundos fortes: cores vivas ou cenas ricas. Evite temas de lugares (cidades, praias), a não ser que sejam intencionais.
• Pose a três quartos e uma semelhança reconhecível com o animal real: manchas, cor dos olhos, forma das orelhas.
• Atributos marcantes ajustados ao corpo da personagem, desenhados sobre a forma da mestra. Os dentes encaixam exatamente na boca.
• Nada de chapéus a flutuar. Os chapéus assentam na cabeça com uma sombra de contacto; as orelhas grandes passam por cima da aba.
• A roupa costuma assentar mal em animais. Prefira coleiras, correntes e adornos de pescoço, e experimente-os em todas as peles.
• As únicas de luxo são totalmente transformadas, com fundos a condizer e sem coleira.

O conector verifica a arte à medida que chega. Os erros recusam um carregamento: um tamanho de tela diferente, uma camada acima do fundo que não seja um PNG com transparência, uma imagem sem nenhum píxel visível. Os avisos voltam para serem revistos: um atributo fora da sua âncora, um atributo numa escala diferente da da sua camada, um atributo fora da grelha de píxeis da base, um atributo que ainda traz a imagem da base, inteira ou em parte, um atributo que cobre a tela inteira. Um aviso pode ser falso: olhos naturais na mesma camada que óculos de sol têm um tamanho diferente de propósito. O agente define mixedScales nessa camada, ou acknowledge no atributo depois de o criador concordar, e a arte fica como deve ser.

O que o agente recebe de volta

Cada ferramenta de validação responde a todos os problemas de uma vez numa única lista issues, cada um com um caminho, um código, uma gravidade, uma mensagem e uma solução. Uma chave desconhecida é recusada pelo nome, com a chave válida mais próxima. A rede é indicada pelo nome (base-sepolia, solana-devnet, solana-localnet), e um rascunho sem rede usa Base Sepolia e indica-o. Os métodos de venda usam os nomes do site (fixed, mystery, rising, falling, auction): através do 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 uma verificação automática: cada peça respeita as regras, uma única fica na peça em que está fixada, e uma camada vazia é escrita como {"trait_type": "<layer>", "value": "None"}.

Peças acabadas

As peças que já existem como imagens acabadas dispensam 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 ficam tal como foram enviados, animação incluída, e os limites por camadas não se aplicam; aplicam-se os limites de publicação atuais do site. Trazer arte já feita explica os ficheiros.

Limites conhecidos desta versão

• Os valores de uma venda Solana na versão 2 são verificados pelo analisador da própria aplicação depois das chaves, um de cada vez; uma venda na versão 3 responde a todos os problemas de uma vez.
• Um rascunho de arte acabada não pode ser editado no próprio rascunho; uma correção é um novo carregamento com uma chave nova.
• Um rascunho arquivado não pode ser restaurado através do conector; a sua arte é guardada durante 30 dias.
• A Robinhood Chain não está disponível através do conector: não há configuração de rede nem esquema de venda. Vem depois dos lançamentos na Base e na Solana.

Os números das coleções são instantâneos e um lançamento movimenta valor real na sua rede; leia Riscos e aviso legal antes de aconselhar alguém sobre dinheiro.