The avatar cosmetic service constructs fully layered avatars and mints them as NFTs. It integrates with asset libraries, generative color harmonization, and storage providers.
Pipeline#
- Asset loader – pulls the base avatar and cosmetic PNG/SVG layers.
- Layer composer – merges layers into a single composite image.
- Palette generator – harmonizes color accents for metadata + UI.
- Storage – uploads composite + thumbnail assets (e.g., IPFS).
- Metadata builder – emits ERC-721 metadata with cosmetic traits.
- Minter – submits to on-chain mint adapter.
Usage#
ts
import { createAvatarCosmeticService } from './service';
const service = createAvatarCosmeticService({
assetLoader,
layerComposer,
paletteGenerator,
storage,
metadataBuilder,
minter,
});
const minted = await service.mintAvatar({
seekerName: 'Rowan',
baseAvatarId: 'celestial-fluid',
cosmetics: [
{ assetId: 'halo', intensity: 'luminous' },
{ assetId: 'robes', colorway: 'midnight' },
],
theme: 'night sky sanctuary',
});
Tests#
bash
npx jest --config apps/lilith/svc-avatar-cosmetic/jest.config.cjs --runInBand