@levrbet/shared 0.5.76 → 0.5.77

package/README.md

@@ -52,7 +52,7 @@ The Prisma schema is bundled in this package and the client is auto-generated on
 ```bash
 npx levrbet-prisma-setup
 # Or directly:
-npx prisma generate --schema=node_modules/@levrbet/shared/prisma/schema.prisma
+npx prisma generate --schema=node_modules/@levrbet/shared/prisma
 ```
 
 ## Development

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@levrbet/shared",
-  "version": "0.5.76",
+  "version": "0.5.77",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -27,7 +27,7 @@
   },
   "files": [
     "dist",
-    "prisma/schema.prisma",
+    "prisma",
     "scripts"
   ],
   "bin": {

package/prisma/auth.prisma

@@ -0,0 +1,53 @@
+enum LevrService {
+  Auth
+  Orderbook
+  OracleCore
+  OraclePeriphery
+  OracleProcessor
+  Leaderboard
+  Lab
+  LiquidationEngine
+  LambdaFunctions
+}
+
+enum ApiKeyScope {
+  Read
+  Write
+}
+
+model ApiKey {
+  objectId   String        @id @default(auto()) @map("_id") @db.ObjectId
+  apiKeyId   String        @unique
+  userId     String
+  ethAddress String?
+  name       String
+  ciphertext String
+  kmsKeyId   String
+  service    LevrService? // Optional: restrict key to a specific service
+  scopes     ApiKeyScope[]
+  isActive   Boolean       @default(true)
+  expiresAt  DateTime?
+  lastUsedAt DateTime?
+  usageCount Int           @default(0)
+  createdAt  DateTime      @default(now())
+  updatedAt  DateTime      @updatedAt
+
+  @@index([userId, isActive])
+  @@index([service, isActive])
+}
+
+model AuditLog {
+  objectId   String   @id @default(cuid()) @map("_id")
+  action     String // e.g., "api_key.created", "application.created", "token.validated"
+  resourceId String? // ID of the resource being acted upon
+  metadata   Json     @default("{}")
+  ipAddress  String?
+  userAgent  String?
+  timestamp  DateTime @default(now())
+  // Relations
+  userId     String
+
+  @@index([action])
+  @@index([timestamp])
+  @@index([userId])
+}

package/prisma/campaigns.prisma

@@ -0,0 +1,31 @@
+model FreeBetCampaign {
+  objectId    String  @id @default(auto()) @map("_id") @db.ObjectId
+  merkleRoot  String  @unique
+  campaignId  Int
+  chainId     Int
+  name        String
+  description String
+  txHash      String?
+
+  entries FreeBetCampaignEntry[]
+
+  createdAt DateTime @default(now())
+
+  @@unique([chainId, campaignId])
+}
+
+model FreeBetCampaignEntry {
+  objectId   String  @id @default(auto()) @map("_id") @db.ObjectId
+  merkleRoot String
+  ethAddress String
+  proof      Json?
+  amount     BigInt  @default(0)
+  nonce      Int     @default(0)
+  spent      Boolean @default(false)
+  paused     Boolean @default(false)
+
+  campaign FreeBetCampaign @relation(fields: [merkleRoot], references: [merkleRoot])
+
+  @@unique([merkleRoot, ethAddress, nonce])
+  @@index([ethAddress])
+}

package/prisma/markets.prisma

@@ -0,0 +1,74 @@
+enum Sides {
+  A
+  B
+  C
+}
+
+enum MarketType {
+  FullTimeWinner
+  OverUnder
+}
+
+enum MarketStatus {
+  Open
+  Closed
+  Settled
+  Refunded
+}
+
+model Odds {
+  objectId        String       @id @default(auto()) @map("_id") @db.ObjectId
+  txHash          String
+  odds            Json // define for the specific market type
+  prices          Json
+  timestamp       DateTime
+  marketType      MarketType
+  details         Json? // the unique details for the odds
+  gamePhase       GamePhase
+  gamePeriod      Int
+  gameClock       Int
+  gameProgressBps Int?
+  chainId         Int
+  marketPhase     MarketStatus
+  provider        String? // optional for now to avoid breaking staging
+  opticOddsOddsId String? // optional for now to avoid breaking staging
+  lsportsOddsId   String? // optional for now to avoid breaking staging
+
+  levrGameObjectId String @db.ObjectId
+  marketObjectId   String @db.ObjectId
+  gameMarketId     String
+  market           Market @relation(fields: [marketObjectId], references: [objectId])
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+
+model Market {
+  objectId             String       @id @default(auto()) @map("_id") @db.ObjectId
+  chainId              Int
+  gameId               Int
+  levrMarketId         String
+  levrMarketContract   String
+  gameMarketId         String       @unique
+  txHash               String
+  maturedAt            DateTime?
+  leveraged            Boolean      @default(false)
+  isMatured            Boolean      @default(false)
+  normalizationFactor  Float
+  marketDetails        Json
+  marketRiskAllocation Json
+  providers            Json
+  activeProvider       Json
+  marketType           MarketType
+  status               MarketStatus
+  winner               Sides?
+  targetLine           Float? // for over under markets
+
+  levrGameObjectId String   @db.ObjectId // new unique identifier
+  levrGame         LevrGame @relation(fields: [levrGameObjectId], references: [objectId])
+
+  odds Odds[]
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}

package/prisma/notifications.prisma

@@ -0,0 +1,35 @@
+enum NotificationType {
+  BetPlaced
+  BetSettled
+  BetCredit
+  Deposit
+  Withdrawal
+  ReferralSignup
+  ReferralRewardEarned
+  ReferralPayoutPublished
+  MarketSettled
+  GameLive
+  ApiKeyCreated
+  SecurityAlert
+  GreylistFlagged
+  Promo
+}
+
+model Notification {
+  objectId  String           @id @default(auto()) @map("_id") @db.ObjectId
+  userId    String           @db.ObjectId
+  user      User             @relation("UserNotifications", fields: [userId], references: [objectId])
+  type      NotificationType
+  title     String
+  message   String
+  metadata  Json             @default("{}") // arbitrary event payload (e.g. amount, txHash, gameMarketId)
+  actionUrl String? // optional deep link for the client to route to on click
+  readAt    DateTime?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([userId])
+  @@index([userId, readAt])
+  @@index([type])
+}

package/prisma/orderbook.prisma

@@ -0,0 +1,123 @@
+enum MMDecisionOutcome {
+  QUOTED
+  SKIPPED
+  CANCELLED_ALL
+  ABORTED
+  ERROR
+}
+
+enum MMDecisionReason {
+  NO_REF_PRICE
+  OUTSIDE_WINDOW
+  PAST_STOP
+  BUDGET_EXHAUSTED
+  MARKET_CLOSED
+}
+
+enum MMDecisionTrigger {
+  ODDS_MOVEMENT
+  HEARTBEAT
+  STATUS_CHANGE
+  INITIAL
+}
+
+enum OrderDirection {
+  BID
+  ASK
+}
+
+enum TerminalOrderStatus {
+  FILLED
+  CANCELLED
+}
+
+model ClosedOrder {
+  objectId        String              @id @default(auto()) @map("_id") @db.ObjectId
+  orderId         String              @unique
+  chainId         Int
+  gameId          Int
+  gameMarketId    String
+  levrMarketId    String
+  side            Int
+  direction       OrderDirection
+  type            String
+  status          TerminalOrderStatus
+  price           Int
+  ethAddress      String
+  cancelReason    String?
+  cancelDetails   String?
+  transactionHash String?
+
+  // BID-specific
+  budget       String?
+  filledBudget String?
+  leverage     Float?
+
+  // ASK-specific
+  volume       String?
+  filledVolume String?
+  positionId   String?
+
+  placedAt   DateTime
+  resolvedAt DateTime @default(now())
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  @@index([ethAddress])
+  @@index([ethAddress, status])
+  @@index([ethAddress, resolvedAt(sort: Desc)])
+  @@index([chainId, gameMarketId])
+}
+
+model MarketMakerDecision {
+  objectId        String   @id @default(auto()) @map("_id") @db.ObjectId
+
+  // Identity / routing
+  chainId         Int
+  gameId          Int
+  gameMarketId    String
+  side            Int                       // Side enum (numeric, matches ClosedOrder)
+  marketType      MarketType
+
+  // Outcome
+  outcome         MMDecisionOutcome
+  reason          MMDecisionReason?
+  trigger         MMDecisionTrigger
+
+  // Inputs snapshot
+  refPrice        Int?                      // 3dp
+  gameProgressBps Int?
+
+  // Budget snapshot (e6 values as strings)
+  onChainBalance      String?
+  totalBidBudget      String?
+  marketBidBudget     String?
+  cumulativeBidSpend  String?
+  numActiveMarkets    Int?
+  numActiveSides      Int?
+  askAvailable        String?
+  positionId          String?
+
+  // Computed ladders (price 3dp, size e6 as string)
+  bidLevels       Json                      // [{ price, size }]
+  askLevels       Json                      // [{ price, size }]
+
+  // Action summary
+  bidEdits        Int      @default(0)
+  bidsPlaced      Int      @default(0)
+  bidsCancelled   Int      @default(0)
+  askEdits        Int      @default(0)
+  asksPlaced      Int      @default(0)
+  asksCancelled   Int      @default(0)
+  activeOrderCount    Int?
+  expectedOrderCount  Int?
+
+  // Concrete order operations issued this cycle
+  operations      Json                      // [{ op, direction, orderId?, price, size, success, error? }]
+
+  createdAt       DateTime @default(now())
+
+  @@index([gameId, createdAt(sort: Desc)])
+  @@index([gameMarketId, side, createdAt(sort: Desc)])
+  @@index([createdAt])
+}

package/prisma/referrals.prisma

@@ -0,0 +1,123 @@
+enum ReferralStatus {
+  Pending
+  Active
+  Suspended
+  Completed
+}
+
+enum GreylistStatus {
+  None // Not flagged — included in Merkle
+  Flagged // Active greylist — excluded from Merkle
+  Cleared // Admin-cleared — re-included in future epochs
+  Confirmed // Admin-confirmed fraud — permanently excluded
+}
+
+enum EpochStatus {
+  Active
+  Processing
+  Completed
+  Failed
+}
+
+enum ReferralTier {
+  T1
+  T2
+  T3
+}
+
+model Referral {
+  objectId       String         @id @default(auto()) @map("_id") @db.ObjectId
+  referrerId     String         @db.ObjectId
+  referredId     String         @db.ObjectId
+  referralCode   String
+  referralSource String? // e.g. campaign or link source
+  status         ReferralStatus @default(Active)
+  greylistStatus GreylistStatus @default(None) // Denormalized flag for fast filtering in fee computation
+
+  // Relations
+  referrer User @relation("ReferrerRelations", fields: [referrerId], references: [objectId])
+  referred User @relation("ReferredRelations", fields: [referredId], references: [objectId])
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([referrerId])
+  @@index([referredId])
+}
+
+model ReferralEpoch {
+  objectId    String      @id @default(auto()) @map("_id") @db.ObjectId
+  periodId    String      @unique
+  periodStart DateTime
+  periodEnd   DateTime
+  timezone    String      @default("America/Mexico_City")
+  status      EpochStatus @default(Active)
+
+  // On-chain reward info (one root per epoch)
+  totalFeesUsd    Float?
+  rewardPoolUsd   Float?
+  merkleRoot      String?
+  merkleTxHash    String?
+  rootPublishedAt DateTime?
+  notes           String?
+
+  ReferralRewards ReferralReward[]
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+
+model ReferralReward {
+  objectId String @id @default(auto()) @map("_id") @db.ObjectId
+  userId   String @db.ObjectId
+  epochId  String @db.ObjectId
+  periodId String // denormalized for readability (e.g. "2025W45")
+
+  // --- Aggregates ---
+  referredBetVolumeUsd Float        @default(0.0)
+  referredFeeUsd       Float        @default(0.0)
+  tier                 ReferralTier @default(T1)
+  tierPercentage       Float        @default(0.025)
+
+  // --- Payouts ---
+  payoutBeforeScaleUsd Float   @default(0.0)
+  payoutScaledUsd      Float   @default(0.0)
+  payoutTokenUnits     String? // token base units (string for precision)
+  scaleFactor          Float?
+
+  // --- Claim sync info ---
+  isClaimedOnChain      Boolean   @default(false)
+  claimedTxHash         String?
+  lastSyncedFromChainAt DateTime?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  // --- Relations ---
+  user  User          @relation("UserRewards", fields: [userId], references: [objectId])
+  epoch ReferralEpoch @relation(fields: [epochId], references: [objectId])
+
+  @@unique([userId, periodId])
+  @@index([epochId])
+  @@index([userId])
+}
+
+model GreylistEntry {
+  objectId      String         @id @default(auto()) @map("_id") @db.ObjectId
+  walletAddress String // The greylisted wallet (referrer OR referee)
+  status        GreylistStatus @default(None)
+  reason        String // Why flagged (e.g. "velocity anomaly", "wallet clustering", "manual flag")
+  source        String // What triggered it: "admin", "system:velocity", "system:clustering"
+  flaggedBy     String? // Admin userId who flagged (null if system-flagged)
+  reviewedBy    String? // Admin userId who reviewed (cleared/confirmed)
+  reviewedAt    DateTime? // When reviewed
+  reviewNotes   String? // Admin notes on review decision
+  metadata      Json? // Arbitrary data: IP patterns, cluster info, etc.
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([walletAddress])
+  @@index([status])
+  @@index([walletAddress, status])
+}