Eve library

Creator Royalty Service

Other

Revision 1

On this page

Automates revenue sharing for Lilith creators by orchestrating royalty schedules, sale-based distributions, scheduled payouts, and compliance logging.

Pipeline#

  1. Compliance auditor – validates schedule definitions and payout distributions.
  2. Schedule registry – persists royalty schedules and version revisions.
  3. Share calculator – computes dynamic payout allocations per sale.
  4. Scheduled payout calculator – aggregates outstanding royalties for periodic runs.
  5. Payment executor – dispatches on-chain transactions for recipients.
  6. Royalty ledger – records distributions and emits audit events.
  7. Payout scheduler – determines next payout execution window.
  8. Notification + analytics – informs stakeholders and publishes telemetry.

Usage#

ts
import { createCreatorRoyaltyService } from './service';

const service = createCreatorRoyaltyService({
  scheduleRegistry,
  shareCalculator,
  scheduledPayoutCalculator,
  paymentExecutor,
  complianceAuditor,
  royaltyLedger,
  payoutScheduler,
  notificationService,
  analyticsReporter,
});

const { schedule } = await service.createSchedule({
  metadata: {
    assetId: 'sacred-art-108',
    assetType: 'sacred_art',
    title: 'Lilith Moon Bloom',
    createdBy: '0xLilith',
  },
  recipients: [
    { address: '0xCreator', percentage: 70, role: 'creator' },
    { address: '0xCollaborator', percentage: 20, role: 'collaborator' },
    { address: '0xPlatform', percentage: 10, role: 'platform' },
  ],
  allocationStrategy: 'fixed_split',
  minPayoutThreshold: '100000000000000000',
  chainId: 137,
  payoutFrequency: 'weekly',
});

Tests#

bash
npx jest --config apps/lilith/svc-creator-royalty/jest.config.cjs --runInBand