Series Lab
English Overview (for Solana reviewers & international developers):
Series Lab (series-lab, v1.25.1, MIT) is a non-custodial local studio and CLI for creating, quality-checking, and launching generative NFT collections (Lab → Studio → Release). Live web app: lab.w3ir.io · Documentation site (EN/UA): studio.w3ir.io.
- Verify tests locally:
npm install && npm test (904 automated tests in 138 test files, including browser end-to-end runs in real Chrome) · npm run docs:check.
- Solana & Metaplex Core modules (foundation for the standalone
solana-launch-kit package): src/core-flow.mjs (Metaplex Core Candy Machine pipeline: release-init, upload, guards, mint, reveal, verify), src/arweave-upload.mjs (permanent Arweave storage via Irys), src/deploy-kit.mjs & src/release-config.mjs (cm-config.json generation, devnet-first defaults, royalty configuration), src/candy-verify.mjs (read-only on-chain check of a deployed Candy Machine v3 / Core Candy Machine and its Candy Guard), src/allowlist.mjs (Merkle allowlist for the Core Candy Guard allowList guard), src/marketplace-kit.mjs (Tensor / Magic Eden / OpenSea listing checklists, copy and banner/avatar sizes), src/compress.mjs (optional, shrinks frames to Metaplex's recommended ≤ 1 MB), and src/imageqa.mjs / src/checklist.mjs (automated collection QC).
- Non-custodial by design: Private keys and seed phrases are never requested or stored by the server; all on-chain actions use local CLI keypairs or client-side Wallet Standard signing.
Series Lab від W3IR — майстерня для генеративних NFT-серій і LoRA-датасетів: Lab → Studio → Release.
- Версія:
1.25.1 — з 1.20.0: правдива Довідка з розділом «Підтримка», /terms/ і /privacy/ на хості Lab, ID латиницею з транслітерацією, видалення риси й поле «хто» в Конструкторі, тираж N + 1 і префікс імені з назви серії в Експорті, живий баланс у шапці, відсутній архів це 404, а не 500, ціль 44 px на сенсорних екранах і класи замість інлайн-стилів, гібрид як явний сценарій і series doctor --release, підгонка шару PNG під обличчя на кадрі моделі (layerAlign), зсув шару на кадр, походження набору з шарами у Відборі, перевірка «архів збігається з пресетом» перед платною генерацією, чекліст «риси видно на кадрах» із підтвердженням автора, довідка по одному розділу, розбиття server/index.mjs (14 модулів маршрутів) і server/ui/app.js на модулі; з 1.12.0: проєкти (власні активи, кошик, перенесення наборів), позначка «створено ШІ» й підпис C2PA, CSP і власні бібліотеки замість CDN, гібридні шари «ШІ + ручні», вкладки 8 · Деплой і 9 · Маркет, Arweave (Irys) і шлях випуску upload → guards → verify, публічний хост lab.w3ir.io (вхід гаманцем, оплата USDC, бекапи) (CHANGELOG · бачення)
- Папка на диску:
series-studio · npm-пакет series-lab · ліцензія MIT
- Розміщення розробки:
127.0.0.1. Ключі API не потрапляють у браузер; приватні ключі гаманців і сид-фрази майстерня не запитує й не зберігає.
Новачок? Почніть з посібника або вкладки ❓ Довідка. З тієї ж вкладки відкриваються сторінки для автора на цьому ПК: http://127.0.0.1:5344/studio/docs/ (англійською /studio/docs/en/) — етапи, вкладки, основа, риси, експорт і короткий пресет. Окремий сайт для цього не потрібен. Вхід — лише гаманець (MetaMask / Coinbase / Phantom); сторінка /login.
Сервер розробки стоїть на 127.0.0.1 — це адреса процесу на ПК, не окремий продукт. Вхід, кредити, дані по гаманцю й адмін — повний режим (SERIES_MODE=public за замовчуванням). SERIES_MODE=local — теки репозиторію без акаунтів, лише loopback. Той самий сервер на хості — docs/HOSTING.md: що задати, що лишається на ПК (keypair, series mint, series reveal), і що https://studio.w3ir.io лишається статичним сайтом. Живий виклад цим репозиторієм не робиться.
Що вміє
пресет + seed → унікальні детерміновані рецепти (DNA + промпти) → базова картинка серії (+ Vision Assist) → рендер у кілька потоків з живим прогресом або складання шарів PNG (на базу чи гібридно поверх кадрів ШІ) → відбір (keep/redo, AI Triage, версії) → експорт (перевірений архів, ERC-721 / Metaplex / Ordinals ZIP, CSV, Arweave через Irys, хеш походження, позначка «створено ШІ» в метаданих, вітрина, датасет LoRA) → набір деплою (типово Core Candy Machine; Sugar — застарілий; EVM: Thirdweb; Ordinals: інструкція) → на цьому ПК release-init, upload, hidden, guards, mplx cm create, verify, series mint --keypair, series reveal --keypair → набір маркетплейсу (продаж: Solana — Magic Eden і Tensor; EVM — OpenSea; Bitcoin — Ordinals). Майстерня ключ не бере. Розкриття EVM лишається в кабінеті Thirdweb.
Страховка для грошей і файлів (працює автоматично):
| Механізм | Що робить |
|---|
| Версії рендерів | Перегенерація не затирає оплачену картинку — попередня йде в out/<набір>/versions/<N>/, у Відборі її можна повернути. |
| Кошик | Видалення проєктів переносить їх у кошик проєктів, а заміна бази, шарів і трейтів — у out/trash/ (відновлення: Адмін → Ресурси). У Відборі «Видалити» стирає кадр назавжди (другий клік), а «Прибрати з набору» лишає файл у версіях. |
| Денна межа витрат (локальний режим) | SERIES_SPEND_CAP_USD блокує запуск понад межу ще до виклику платного API. На публічному хості вимкнена. |
| Журнал витрат | Кожен платний виклик: out/render-log.jsonl у SERIES_MODE=local; у public — data/render-log.jsonl (спільний журнал сервера). |
| Автостоп batch | Після 5 помилок рушія поспіль решта черги не запускається. |
| DNA / оцінка | Пакетна генерація блокується при збіжній DNA; «Згенерувати» — лише після безкоштовної оцінки. |
| Захист API | Сервер відхиляє запити з інших сайтів (CSRF) і чужі Host (DNS rebinding). |
| Заголовки безпеки й CSP | Кожна відповідь має nosniff, X-Frame-Options, Referrer-Policy, Permissions-Policy, а по HTTPS Strict-Transport-Security. Content-Security-Policy типово лише в режимі звітів (SERIES_CSP, docs/HOSTING.md). Код сторінок оплати й входу не береться зі сторонніх CDN. |
| Позначка «створено ШІ» | Експорт записує її в метадані PNG (ai-disclosure.json у ZIP); необов'язковий підпис C2PA робить series c2pa на вашому ПК (docs/C2PA.md). |
Швидкий запуск
Вимоги: Node ≥ 22.13.
npm install
npm test
npm start # http://127.0.0.1:5344/studio/ (або /login у public)
# Windows: start-lab.bat / stop-lab.bat · без браузера: npm run lab:serve
# зовнішнє тестування з ПК через тунель Cloudflare: npm run lab:tunnel (docs/HOSTING.md)
# власний бекап (леджер + дані гаманців) у backups/: npm run backup
Спробувати без ключів: двигун mock на «5 · Генерація». SERIES_MODE=local — без входу, лише для тек репо.
Ключі та налаштування
Скопіюйте .env.example у .env і перезапустіть.
| Змінна | Призначення |
|---|
SERIES_MODE | public (типово) — вхід гаманцем; local — без акаунтів, лише loopback |
AUTH_SESSION_SECRET, ADMIN_WALLETS, TEAM_WALLETS | Сесія, адміни й командні гаманці. Якщо ADMIN_WALLETS / TEAM_WALLETS не задані — лишаються типові адреси; заданий список їх замінює |
FAL_KEY, REPLICATE_API_TOKEN, OPENAI_API_KEY, STABILITY_API_KEY, RUNWARE_API_KEY, POLLINATIONS_API_KEY | Хмарні рушії |
COMFYUI_URL, A1111_URL, LOCAL_GPU_CREDIT_COST | Local GPU на ПК; у public — плата підтримки Lab (кр/кадр) |
ANTHROPIC_API_KEY | Vision Assist / AI Triage через Claude (опційно) |
ANTHROPIC_MODEL | Модель Claude для Vision Assist і AI-критика (типово claude-sonnet-5-5) |
IRYS_MAX_PRICE_SOL | Ліміт ціни серверного завантаження в Arweave, SOL (0.05); вище — відмова до оплати, нестача на Irys поповнюється з гаманця |
IRYS_PRIVATE_KEY | Серверна кнопка Arweave в Експорті (окремий гаманець з малим балансом). Для випуску краще series upload --keypair — ключ лишається на ПК |
IRYS_NETWORK | Мережа Irys для CLI-завантаження випуску: mainnet (типово) або devnet (репетиція за тестові SOL; те саме, що прапорець --devnet) |
SERIES_TELEGRAM_BOT_TOKEN, SERIES_TELEGRAM_CHAT_ID | Сповіщення від імені Series Lab |
SOLANA_PAY_RECIPIENT (+ SOLANA_RPC_URL) | Поповнення кредитів: USDC у Solana переказом напряму, без посередника; публічна адреса-отримувач, ключ не потрібен |
RESOURCE_COVER_DAYS, RESOURCE_LIABILITY_SHARE, RESOURCE_MIN_USD, RESOURCE_BALANCE_STALE_DAYS, RESOURCE_ALERT_REPEAT_HOURS | Рекомендований баланс по провайдерах (Адмін → Ресурси): дні покриття (14), частка вартості вже виданих кредитів у резерві (0,25), мінімум на провайдера ($5), днів до застарілого ручного балансу (14) |
Етапи майстерні
| # | Вкладка | Що робите |
|---|
| 1 | Огляд | Назва, ID, кількість, seed → «Почати серію» / «Спін-оф» / «Зберегти пресет». Сценарій: гібрид (типовий), лише ШІ або лише шари. Рушій і сила у згорнутому «Додатково»; Генерація їх підхоплює. Рекомендація гібриду — Kontext і 0,35, кнопкою; типове 0,45 саме не змінюється. |
| 2 | Основа | Головна базова картинка (рядок, чи призначено головну); 🤖 Vision Assist. |
| 3 | Конструктор | Шість кроків: старт (шаблон або пак), варіанти рис (і PNG-шари з перевіркою покриття), що змінюється, єдиний стиль, перегляд промпту для рушія, перевірити й зберегти («Далі» зберігає незбережене). |
| 4 | Рецепти | Три кроки: «Зібрати тексти», список і правка номера, рідкість; «Додатково»: diff зерна, порівняння архівів, хвилі. |
| 5 | Генерація | «12 пілотів — порахувати» → оцінка → генерація. Без зібраних рецептів — плашка з переходом на «4». У шляху новачка рушій і сила лише показані (зміна на Огляді). |
| 6 | Відбір | ✓ / ↻, порівняння, Triage, схожі кадри, версії. «Видалити» стирає кадр назавжди (другий клік; кошик лише для проєктів), «Прибрати з набору» лишає файл у версіях. |
| 7 | Експорт | Архів випуску → портал; інші ZIP / CSV / Arweave / вітрина / хаб. Спершу «Перевірити чекліст», потім «Зібрати ZIP». |
| 8 | Деплой | «Зібрати набір деплою». Типово Solana (Core Candy Machine, спочатку devnet). Sugar — пункт «застарілий». Підказка про окремий ключ, готові команди (копіювання): series doctor --release, series hidden після upload, series guards. Файл ключа не читається. У шляху новачка порадник запуску прихований. |
| 9 | Маркет | «Зібрати набір маркетплейсу». Solana: Magic Eden і Tensor. EVM: OpenSea. Bitcoin: Ordinals. |
| — | Адмін | Система (тривоги, пам'ять, диск, бекапи, запити), Ресурси, Економіка, статистика, помилки — лише адмін-гаманець. |
| — | Довідка | Путівник, швидкий старт, словник, FAQ. |
На опціях — підказки при наведенні. Інтерфейс uk / en.
CLI (bin/series.mjs)
node bin/series.mjs doctor
node bin/series.mjs doctor --release --keypair deployer.json
node bin/series.mjs engines
node bin/series.mjs validate presets/demo-series.json
node bin/series.mjs build presets/demo-series.json -o out/demo-archive.json
node bin/series.mjs diff-seed presets/demo-series.json
node bin/series.mjs render presets/demo-series.json --engine mock --limit 5
node bin/series.mjs triage out/mock-s0.45 --provider heuristic --apply
node bin/series.mjs provenance out/fal-s0.45 -o out/provenance.json
node bin/series.mjs dataset out/demo-archive.json --images out/fal-s0.45 --trigger my_hero -o out/dataset.zip
node bin/series.mjs upscale out/fal-s0.45 # результат в out/fal-s0.45-2x, оригінали не чіпає
node bin/series.mjs repair-png out/pollinations-s0.45 --dry-run
node bin/series.mjs c2pa out/fal-s0.45 --cert signer-chain.pem --key signer-key.pem
node bin/series.mjs pin out/fal-s0.45 --dry-run
node bin/series.mjs release-init out/demo-archive.json -o release.json --creator <адреса> --price 0.2
node bin/series.mjs upload <тека-набору> --keypair deployer.json --max-price 1
node bin/series.mjs upload <тека-набору> --keypair deployer.json --devnet # репетиція за тестові SOL, посилання тимчасові
node bin/series.mjs guards release.json -o guard-config.json
node bin/series.mjs guards release.json --allowlist wallets.txt
node bin/series.mjs hidden <тека-набору> --uri <посилання-на-hidden.json>
node bin/series.mjs mint release.json --keypair minter.json
node bin/series.mjs reveal <тека-набору> --keypair creator.json
node bin/series.mjs compose out/demo-archive.json --layers layers --base input/primary.png -o out/layers
node bin/series.mjs compose out/demo-archive.json --layers layers --over out/fal-s0.35 --only hat,scarf
node bin/series.mjs compose out/demo-archive.json --layers layers --over out/fal-s0.35 --base input/primary.png # риси з layerAlign підганяються під кадр
node bin/series.mjs compose out/demo-archive.json --layers layers --base input/primary.png --preview 7 -o out/preview-7.png
node bin/series.mjs verify release.json
node bin/series.mjs notify "Готово"
node bin/series.mjs manifest out/demo-archive.json --profile opensea
node bin/series.mjs showcase out/demo-archive.json -o out/showcase.html
node bin/series.mjs release-config out/demo-archive.json --profile magiceden -o out/cm-config.json
# --legacy пише застарілий Sugar у sugar/; без прапорця — Core Candy Machine
Структура
| Шлях | Призначення |
|---|
presets/ | Пресети серій |
libraries/traits/ | Паки рис |
templates/ | Шаблони пресетів і ComfyUI |
input/ | Базові картинки |
out/ | Архіви, набори, versions/, trash/, бандли; у local ще render-log.jsonl |
data/ | Леджер, дані гаманців і (у public) render-log.jsonl (gitignored) |
workspace/ | Автозбереження UI |
src/ | Ядро + platform/ (вхід, кредити) |
server/ | HTTP, /login, guard; routes/ (admin, kits, review, export, generate, base, projects, presets, recipes, layers, versions-trash, credits, platform, storage, archives, tools); Studio UI: ui/app.js (стан, boot()) і модулі вкладок ui/app-*.js |
deploy/series-lab/ | Staging / бекап (за командою хостингу) |
.github/workflows/ | health.yml, deploy-site.yml (тестів у GitHub немає: npm run ci) |
bin/series.mjs | CLI |
scripts/ | Перевірки документів, збір сайту, build-vendor.mjs (бібліотеки для браузера) |
server/ui/vendor/ | Зібрані з наших залежностей solana-tx.js і evm-address.js (npm run vendor) |
test/ | Автотести (npm test; npm run coverage — з порогом покриття src/; — пошук нестабільних) |
Документація
Термінологія: базова картинка(и) серії; primary = головна базова. Мінт Solana Core — series mint на цьому ПК. Продаж — на майданчику. Розкриття EVM — кабінет Thirdweb.
Ліцензія
MIT © 2026 W3IR
