Eve library

Cryptocurrency Payment Orchestrator

Other

Revision 1

On this page

Handles cryptocurrency payments for Lilith premium content. The orchestrator coordinates wallet handoff, quote construction, compliance, settlement verification, revenue distribution, and access provisioning.

Pipeline#

  1. Compliance guard – validates purchase intent and settlement safety.
  2. Content catalog – retrieves premium content metadata, pricing, and access policy.
  3. Pricing engine – emits on-chain quotes with fee and revenue split breakdowns.
  4. Wallet gateway – generates smart contract call data and verifies settlement receipts.
  5. Session store – persists payment session state transitions and expiry.
  6. Ledger – records authorizations, settlements, and failure trails.
  7. Royalty splitter – computes creator/platform/treasury payouts per settlement.
  8. Access manager – activates premium content access following confirmed payment.
  9. Notification service – informs the buyer and stakeholders of lifecycle events.
  10. Analytics reporter – publishes metrics for observability and financial reporting.

Usage#

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

const service = createCryptoPaymentService({
  contentCatalog,
  pricingEngine,
  walletGateway,
  sessionStore,
  ledger,
  royaltySplitter,
  accessManager,
  notificationService,
  analyticsReporter,
  complianceGuard,
});

const session = await service.createPaymentSession({
  contentId: 'premium-meditation-aurora',
  walletAddress: '0xuserwallet',
  chainId: 137,
  quantity: 1,
  locale: 'en-US',
  referralCode: 'LUMINA2025',
});

await service.confirmSettlement({
  sessionId: session.sessionId,
  transactionHash: '0xsettle',
});

Tests#

bash
npx jest --config apps/lilith/svc-payment-orchestrator/jest.config.cjs --runInBand