Shared token/NFT primitives for Lilith services. This package is intentionally small and focuses on cross-domain types and helpers so the individual tokenized services (achievement-token, creator-royalty, native-token, ritual-access, sacred-art, sacred-music, sacred-space, token-access) can stay focused on their domain logic.
What’s Included#
- Types: base metadata envelope, mint receipts, storage URIs, chain/network info, royalty recipients, allocation buckets, access policy pieces, and token launch config.
- Helpers: minimal address validator (
isAddress) and royalty recipient validation (validateRecipients).
Usage#
ts
import { isAddress, MintResult, RoyaltyRecipient } from '@lilith/token-core';
if (!isAddress(wallet)) throw new Error('bad address');
const receipt: MintResult = {
tokenId: 1n,
transactionHash: '0xabc',
network: 'polygon',
};
Notes#
- Keep scope narrow—avoid pulling domain-specific flows here. If you need a new primitive that multiple token services share, add the type and a brief test/validation helper.
- Address validation matches current tests (40 or 41 hex chars after
0x). If stricter checksum logic is needed, extend the helper here and adopt incrementally. - This package is private and used inside the monorepo; no publication intended.