Eve library

@lilith/token-core

Other

Revision 1

On this page

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.