Drop Type

type Drop {
  # Core identifiers
  id: ID!
  title: String
  description: String
  shortcode: String # Unique claim URL shortcode
  # Drop configuration
  type: DropType! # TOKEN or NFT
  claimType: ClaimType! # REGULAR, STREAK, REFERRAL, etc.
  status: DropStatus! # DRAFT, ACTIVE, PAUSED, COMPLETED, DELETED
  # Amount configuration
  maxAmount: String! # Maximum claimable amount
  claimedAmount: String! # Currently claimed amount (live data)
  tokenAmount: String # Amount per claim (e.g., "100" or "0" for random)
  remainingBalance: String # Computed: maxAmount - claimedAmount
  tokenBalance: String # Actual token balance in contract
  # Pricing and supply
  price: Float # Price per item (for paid drops)
  supply: Int # Total supply
  estimatedValueUsd: Float # Estimated USD value
  # Status and activity
  isActive: Boolean! # Live blockchain status
  claimDeadline: DateTime # Optional deadline
  # Statistics (computed)
  claimCount: Int # Number of claims made
  claimRate: Float # Percentage claimed
  # Media
  imageUrl: String # Drop image URL
  # Blockchain deployment fields
  dropObjectId: String # On-chain drop object ID
  adminCapId: String # Admin capability ID
  deploymentTxHash: String # Deployment transaction hash
  contractPackageId: String # Smart contract package ID
  backendSigningPubKey: String # Backend signing public key
  coinType: String # Token type identifier
  # Legacy fields
  tokenSymbol: String # Token symbol (use token.symbol instead)
  tokenAddress: String # Token address (use token.address instead)
  # Timestamps
  createdAt: DateTime!
  updatedAt: DateTime!

  # Relationships
  creator: User! # Drop creator
  token: Token # Associated token
  claims: [Claim!]! # All claims made on this drop
  gatingConfig: GatingConfig # Access control configuration
}

enum DropType {
  NFT # Non-fungible token drop
  TOKEN # Fungible token drop
}

enum DropStatus {
  DRAFT # Drop is being configured
  ACTIVE # Drop is live and claimable
  PAUSED # Drop is temporarily disabled
  COMPLETED # Drop has been fully claimed or ended
  DELETED # Drop has been deleted
}

enum ClaimType {
  REGULAR # Standard claim mechanism
  STREAK # Streak-based claiming
  REFERRAL # Referral-based claiming
  OG # Original supporter claims
  ELITE # Elite user claims
  NFT_DROP # NFT-specific drop type
  TOKEN_DROP # Token-specific drop type
}

query GetDropBasics($id: ID!) {
  drop(id: $id) {
    id
    title
    description
    type
    status
    claimType
    shortcode
    imageUrl
    createdAt
  }
}

query GetDropStats($id: ID!) {
  drop(id: $id) {
    id
    title
    maxAmount
    claimedAmount
    remainingBalance
    claimCount
    claimRate
    isActive
    tokenBalance
  }
}

query GetDropWithRelations($id: ID!) {
  drop(id: $id) {
    id
    title
    description
    type
    status
    maxAmount
    claimedAmount
    claimRate
    creator {
      username
      displayName
    }
    token {
      name
      symbol
      decimals
    }
    claims(limit: 5) {
      id
      amount
      claimedAt
      user {
        username
      }
    }
    gatingConfig {
      isActive
      rules {
        description
      }
    }
  }
}

query GetLiveDropData($id: ID!) {
  drop(id: $id) {
    id
    title
    # Live blockchain fields
    claimedAmount
    maxAmount
    remainingBalance
    tokenBalance
    isActive
    # Computed fields
    claimRate
  }
}

# Good: Minimal fields for list view
query DropsList {
  drops {
    id
    title
    status
    claimRate
    type
  }
}

# Avoid: All fields when not needed
query DropsListBad {
  drops {
    id
    title
    description
    # ... all other fields
  }
}

fragment DropBasics on Drop {
  id
  title
  description
  type
  status
  claimType
  shortcode
  imageUrl
}

fragment DropStats on Drop {
  maxAmount
  claimedAmount
  claimCount
  claimRate
  remainingBalance
  isActive
}

query GetDrop($id: ID!) {
  drop(id: $id) {
    ...DropBasics
    ...DropStats
    creator {
      username
      displayName
    }
  }
}

query SafeDropQuery($id: ID!) {
  drop(id: $id) {
    id
    title
    description
    # Handle optional fields
    price
    supply
    claimDeadline
    # Handle relationships that might be null
    token {
      name
      symbol
    }
    gatingConfig {
      isActive
    }
  }
}