iOS SDK Migration Guide

iOS specific migration guide for the May 2025 GYP migration.

Overview

Lucra is launching a major update to the Games You Play (GYP) product. See here for the full description of the changes.

Legacy SDKs and API endpoints will continue to function. However, once a client targets the new SDK versions, all related backend interactions must be updated to the new endpoints. Legacy APIs will not be forward-compatible with the new matchup models.

Further, it is recommended to feature gate mobile version updates so that users on older builds (of iOS or Android apps) don't attempt to create and share old GYP matchups against users who have the updated version.

Migration Guide

iOS – Before

public func getGamesMatchup(matchupId: String) async throws -> LegacyMatchup

iOS – After

public func getRecreationalGamesMatchup(matchupId: String) async throws -> LucraMatchup

New Model

LucraMatchup { 
    id: String 
    updatedAt: Date 
    createdAt: Date 
    creatorId: String 
    creator: LucraUser 
    participantGroups: [LucraMatchupGroup] 
    winningGroup: LucraMatchupGroup? 
    tournamentDetails: TournamentsMatchup? 
    isPublic: Bool 
    status: MatchupStatus 
    subtype: MatchupSubtype 
    type: MatchupType 
    recreationGameExtension: LucraMatchupRecreationalGameExtension? 
}

---

Creating a Matchup

iOS – Before

public func createGamesMatchup(gameTypeId: String, atStake: Decimal) async throws -> GYPCreatedMatchupOutput

iOS – After

public func createRecreationalGame(
    gameTypeId: String,
    atStake: RewardType,
    playStyle: PlayStyle
) async throws -> String
struct RewardType {
    let cashReward: Decimal?
    let tenantReward: LucraReward?
    init(cashReward: Decimal) {
        self.cashReward = cashReward
        self.tenantReward = nil
    }
    init(tenantReward: LucraReward) {
        self.tenantReward = tenantReward
        self.cashReward = nil
    }
}
enum PlayStyle {
    case groupVsGroup
    case freeForAll
}
struct LucraReward {
    let rewardId: String
    let title: String
    let descriptor: String
    let iconUrl: String
    let bannerIconUrl: String?
    let disclaimer: String?
    let metadata: [String: String]?
}

---

Accepting a Matchup

Must differentiate between Group Play and Free-for-All formats.

iOS – After

public func acceptVersusRecreationalGame( matchupId: String, groupId: String ) async throws public func acceptFreeForAllRecreationalGame( matchupId: String ) async throws

---

Cancelling a Matchup

iOS – Before

public func cancelGamesMatchup(matchupId: String) async throws

iOS – After

public func cancelRecreationalGame(matchupId: String) async throws