컬렉션 블루프린트

KURV는 지금 Base Sepolia와 Solana Devnet에서 돌아가요. 이 페이지는 실제로 완성한 빌드(HANI the Dog, 1,000점, 고유 작품 20점)에서 나온 현장 안내서로, https://mcp.kurv.fun/mcp의 KURV 커넥터를 통해 AI 에이전트와 함께 일하는 크리에이터를 위해 썼어요. 커넥터는 같은 안내서를 리소스 kurv://blueprint로 에이전트에게 제공하고, 도구 kurv_builder_spec이 기준이에요. 이 페이지와 도구가 다르면 도구를 믿으세요.

에이전트 연결하기

1. 원격 MCP와 OAuth를 지원하는 클라이언트에 https://mcp.kurv.fun/mcp를 원격 MCP 서버로 추가하세요. MCP로 에이전트 연결하기에 클라이언트와 그 단계가 있어요.
2. 브라우저에서 KURV에 로그인하고 연결을 승인하세요. 연결이 할 수 있는 일(읽기만, 읽기와 초안, 또는 읽기와 초안과 런칭 준비)과 유지 기간은 당신이 골라요.
3. 에이전트에게 kurv://blueprint를 읽고, 당신의 네트워크로 kurv_account와 kurv_builder_spec을 호출하라고 하세요. 커넥터는 프롬프트 build-kurv-collection도 제공하는데, 승인 정지점을 모두 지키며 에이전트를 이 페이지대로 이끌어요.

누가 무엇을 하나요

에이전트는 계획하고, 검증하고, 초안을 만들고, 아트를 올리고, 미리 보고, 런칭을 준비해요. 당신은 아트와 샘플과 모든 경고를 승인한 뒤, 검토 링크를 열어 자신의 지갑으로 런칭에 서명해요. 에이전트는 배포하지 않고, 서명하지 않고, 개인 키나 시드 구문을 묻지 않아요. 아트가 끝나고 승인되면 KURV 쪽 일(검증, 생성, 업로드, 미리보기, 준비)은 약 20분이 걸려요. 좋은 아트를 만드는 데는 더 오래 걸리고, 그래야 해요.

한도

항목	한도
컬렉션 크기	1점에서 1,000점까지, 고유 작품 포함. 무작위 980점과 고유 작품 20점이면 크기는 1,000이에요.
레이어	최대 12개.
특성 이미지	모든 레이어를 합쳐 최대 240장, 고유 작품만 쓰는 아트 포함. 빈 레이어에는 비용이 들지 않아요.
고유 작품	최대 32점.
규칙	최대 48개, 어느 네트워크에서나 같아요.
이미지 파일 크기	한 장씩 보내는 이미지는 최대 2 MiB. zip 안의 이미지 한 장은 최대 20 MiB.
캔버스	정사각형, 최대 2,048 × 2,048 픽셀. 모든 파일이 캔버스와 정확히 같은 크기예요.
형식	배경: PNG, JPEG 또는 WebP. 다른 모든 레이어: 진짜 투명도가 있는 PNG.
None이라는 이름	대소문자를 가리지 않고 예약돼 있어요. None이라는 특성도, 빈 이미지도 만들지 마세요. 레이어는 noneWeight로 선택 사항이 돼요.
설명	필수로 다루세요: 1자에서 2,000자. 모든 작품의 메타데이터에 들어가요.
초안	계정당 활성 초안 20개. kurv_archive_draft는 자리를 바로 비우고, 보관한 초안의 아트는 30일 동안 지킨 뒤 지워요.
미리보기	호출당 무작위 샘플 최대 9점, 또는 고른 작품 번호 최대 9개, 64에서 512 픽셀로.

에이전트는 검증마다 validCombinations를 읽어요. 레이어와 규칙이 허락하는 서로 다른 작품의 수예요. 약 50백만 조합까지는 정확히 세고, 그 위로는 추정치라고 표시해요. 컬렉션 크기보다 넉넉히 크게 유지하세요.

경로, 한 걸음씩

승인이라고 표시한 단계에서는 에이전트가 멈추고 당신의 분명한 “예”를 기다려요.

1. 사진. 실제 반려동물이나 캐릭터의 선명한 사진 3장에서 10장을 모으세요: 얼굴, 눈, 이빨과 입, 무늬, 귀. 얼굴이 4분의 3 측면으로 보이는 대표 사진 1장을 고르세요.
2. 아트 방향. 스타일 1개, 포즈 1개(4분의 3 측면이 가장 잘 맞아요), 정사각형 캔버스 1개(2,048 × 2,048 권장), 짧은 스타일 시트: 선, 음영, 팔레트, 분위기. 승인: 특성을 만들기 전의 마스터 캐릭터.
3. 마스터 베이스. 최종 포즈의 캐릭터를 평평한 단색 배경 위에, 가운데에, 캔버스 전체 크기로 그려 실제 반려동물임을 바로 알아볼 수 있게 하세요. 모든 특성은 이 마스터를 편집한 것으로, 같은 포즈, 비율, 구도예요.
4. 레이어. 레이어는 아래에서 위로 그려져요: Background, Skin(베이스 레이어), Collar, Teeth, Eyes, Headwear(선택). 레이어는 여섯 개쯤. 컬렉션을 이끄는 건 캐릭터이고 소품이 아니에요. 에이전트는 base_layer에 베이스 레이어를 적고, 각 레이어에 특성이 놓여야 할 앵커 상자를 줘요.
5. 특성. 각 특성은 마스터 복사본을 편집한 것으로, 특성 자신의 픽셀만 보이고 나머지는 투명하게 잘라내요. 몸의 단색 복사본 위에서 특성을 만들면 털이 섞이지 않아요. 위치나 비율이 어긋난 특성은 거부돼요.
6. 고유 작품. 완전히 변신한 몸(다이아몬드, 크롬, 용암, 브론즈), 각각 어울리는 배경, 목걸이 없음. 그 아트는 가중치 0인 특성으로 해당 레이어에 들어가므로 무작위 작품에는 절대 나오지 않아요. 240장 이미지 수에는 포함돼요.
7. 규칙. 모든 스킨과 모든 목걸이, 이빨, 눈, 머리 장식 특성을 조합한 콘택트 시트. 나쁜 조합(잘림, 보이지 않음, 보기 싫음)마다 이유를 적은 메모가 있는 묶음 제외 규칙이 돼요.
8. 승인: 초안을 만들기 전의 레이어 시트, 합성 샘플 최소 9점, 고유 작품 시트, 설정, 판매 조건.
9. 설정과 검증. 네트워크로 kurv_builder_spec, 그다음 설정으로 kurv_validate_collection을 issues 목록에 오류가 없을 때까지 반복해요. 경고는 당신이 들어야 할 것을 짚어요. 답에는 올릴 정확한 키인 required_assets와 validCombinations가 들어 있어요.
10. 초안. version: 3, 네트워크, 설정, 판매 조건, 멱등 키로 kurv_create_collection을 먼저 check_only를 true로, 그다음 실제로 호출해요. 실패한 호출은 같은 키로 다시 시도해요. 판매 조건은 모든 네트워크에서 같은 형태예요. 판매 조건을 보세요.
11. 아트. kurv_upload_trait로 한 장씩(배경, 베이스, 레이어마다 특성 하나 먼저, 그다음 미리보기, 그다음 나머지), 또는 kurv_upload_collection_zip으로 웹 폴더 형식을 한 번에. 빈 레이어는 noneWeight이고, 투명 PNG가 아니에요.
12. 확인과 미리보기. 초안으로 kurv_validate_collection을 호출하면 아트 검사가 돌아가요. 마지막 업로드 뒤 샘플 9점으로 kurv_preview_collection을 호출하고, 모든 고유 작품과 가장 위험한 조합의 작품 번호도 넘겨요. 에이전트는 모든 이미지를 봐요. 오래 걸리는 첫 미리보기는 retry_after와 남은 샘플을 답하고, 에이전트는 다시 호출해요.
13. 새 초안 없는 수정. kurv_update_collection은 규칙, 고유 작품, 가중치, 힌트, 설명을 제자리에서 바꿔요. 캔버스는 바꿀 수 없어요. kurv_replace_trait_image는 이미지 한 장을 교체하고, kurv_rename_trait는 특성 이름을 바꾸며 그 규칙과 고유 작품을 갱신하고, 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"]}}

규칙은 작품까지 닿아요. 같은 엔진이 미리보기와 게시 파일을 만들고, 민팅은 그 파일을 건네요. 고유 작품은 ignoreRules를 true로 두어 규칙을 건너뛸 수 있어요. 그래도 유일성은 지켜져요.

고유 작품

고유 작품은 specials예요: 이름, 모든 레이어와 그 특성 또는 None, 선택적인 고정 작품 번호, 선택적인 설명. 레이어를 빠뜨린 고유 작품은 그 레이어를 무작위로 받고, 검증이 어느 레이어인지 경고해요. null은 거부되고, 존재하지 않는 특성 이름도 거부돼요.

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

사람들이 원하는 아트

• 공들여 다듬은 아트. 평평하고 흐릿하고 뻔히 생성된 느낌은 피해요.
• 강한 배경: 대담한 색이나 풍성한 장면. 장소 테마(도시, 해변)는 의도가 아니면 피해요.
• 4분의 3 측면 포즈와 실제 반려동물을 알아볼 수 있는 닮음: 무늬, 눈 색, 귀 모양.
• 캐릭터의 몸에 맞춘 대담한 특성을 마스터의 형태 위에 그려요. 이빨은 입에 정확히 맞아요.
• 떠 있는 머리 장식은 없어요. 모자는 접촉 그림자와 함께 머리에 앉고, 큰 귀는 챙 위로 나와요.
• 옷은 대개 동물에게 맞지 않아요. 목걸이, 체인, 목 장식을 고르고 모든 스킨에서 확인하세요.
• 프리미엄 고유 작품은 완전히 변신하고, 어울리는 배경이 있고, 목걸이가 없어요.

커넥터는 아트가 도착하는 대로 검사해요. 오류는 업로드를 거부해요: 다른 캔버스 크기, 배경 위에 있으면서 투명도 있는 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의 티커처럼 네트워크에 없는 판매 항목은 이름으로 거부돼요. 메타데이터는 검증으로 증명돼요: 모든 작품이 규칙을 지키고, 고유 작품은 고정된 작품에 놓이고, 빈 레이어는 {"trait_type": "<layer>", "value": "None"}으로 적혀요.

완성된 작품

이미 완성된 이미지로 있는 작품은 레이어를 건너뛰어요: kurv_finished_art_limits, 그다음 모든 이미지와 metadata.json에 kurv_upload_finished_file_part, 그다음 kurv_import_finished_collection. 바이트는 애니메이션까지 그대로 지켜지고, 레이어 한도는 적용되지 않아요. 웹사이트의 현재 게시 한도가 적용돼요. 완성 아트가 파일을 설명해요.

이 빌드의 알려진 한계

• 버전 2 Solana 판매의 값은 키 다음에 앱 자체 파서가 하나씩 검사해요. 버전 3 판매는 모든 문제를 한 번에 답해요.
• 완성 아트 초안은 제자리에서 수정할 수 없어요. 수정은 새 업로드와 새 키예요.
• 보관한 초안은 커넥터로 복원할 수 없어요. 아트는 30일 동안 지켜요.
• Robinhood Chain은 커넥터로 쓸 수 없어요: 네트워크 설정도 판매 스키마도 없어요. Base와 Solana 런칭 뒤에 와요.

컬렉션 수치는 스냅숏이고, 런칭은 그 네트워크에서 실제 가치를 움직여요. 돈에 대해 누군가에게 조언하기 전에 위험과 면책 조항을 읽으세요.