Promise<string | null>: The promise resolves upon authentication request success and rejects with a specific error code if the request fails. The resolved value is a Decentralized ID token with a default 15-minute lifespan.

Closure

 Copy
import MagicSDK

class LoginViewController: UIViewController {

    @IBOutlet weak var emailInput: UITextField!
    let magic = Magic.shared

    @IBAction func login() {
        guard let magic = magic else { return }
        guard let email = self.emailInput.text else { return }

        let configuration = LoginWithMagicLinkConfiguration(email: email)

        magic.auth.loginWithMagicLink(configuration, response: { response in
            guard let token = response.result
                else { return print("Error:", response.error.debugDescription) }
            print("Result", token)
        })
    }
}

Promise

 Copy
import MagicSDK

class LoginViewController: UIViewController {

    @IBOutlet weak var emailInput: UITextField!
    let magic = Magic.shared

    @IBAction func login() {
        guard let magic = magic else { return }

        let configuration = LoginWithMagicLinkConfiguration(email: self.emailInput.text!)

        magic.auth.loginWithMagicLink(configuration).done({ result in
            print(result) // DIDToken
        }).catch({
            print(error) // handle Error
        })
    }
}

LoginWithMagicLinkConfiguration(showUI: Bool = true, email: String)

• email The user email to log in with.
• showUI If true, show an out-of-the-box pending UI while the request is in flight.

Promise<Bool>: The promise resolves with a true boolean value if update email is successful and rejects with a specific error code if the request fails.

 Copy
import MagicSDK

class MagicViewController: UIViewController {

    let magic = Magic.shared

    // Initiates the flow to update a user's current email to a new one.
    func updateEmail() {

        guard let magic = magic else { return }

        // Assuming user is logged in
        let configuration = UpdateEmailConfiguration(email: "new_user_email@example.com")
        magic.user.updateEmail(configuration, response: { response in
            guard let result = response.result
                else { return print("Error:", response.error.debugDescription) }
            print("Result", result)
        })
    }
}

UpdateEmailConfiguration(showUI: Bool = true, email: String)

• email The user email to update with.
• showUI If true, show an out-of-the-box pending UI while the request is in flight.

Promise<String>: Base64-encoded string representation of a JSON tuple representing [proof, claim]

 Copy
import MagicSDK

class MagicViewController: UIViewController {

    let magic = Magic.shared

    func getIdToken() {
        guard let magic = magic else { return }

        // Assuming user is logged in
        let configuration = GetIdTokenConfiguration(lifespan: 900)

        magic.user.getIdToken(configuration, response: { response in
            guard let token = response.result
                else { return print(response.error.debugDescription) }
            print(token)
        })
    }
}

GetIdTokenConfiguration(lifespan: Int = 900)

• lifespan? (Int): will set the lifespan of the generated token. Defaults to 900s (15 mins)

Promise<String>: Base64-encoded string representation of a JSON tuple representing [proof, claim]

 Copy
import MagicSDK

class MagicViewController: UIViewController {

    let magic = Magic.shared

    func generateIdToken() {
        guard let magic = magic else { return }

        // Assuming user is logged in
        let configuration = GenerateIdTokenConfiguration(lifespan: 900, attachment: "none")

        magic.user.generateIdToken(configuration, response: { response in
            guard let token = response.result
                else { return print("Error:", response.error.debugDescription) }
            print("Result", token)
        })
    }
}

GenerateIdTokenConfiguration(lifespan: Int = 900, attachment: String = 'none')

• lifespan (Number) : will set the lifespan of the generated token. Defaults to 900s (15 mins)
• attachment (String) : will set a signature of serialized data in the generated token. Defaults to "none"

UserMetadata: containing the issuer, email and cryptographic public address of the authenticated user.

 Copy
public struct UserMetadata: MagicResponse {
    public let issuer: String?
    public let publicAddress: String?
    public let email: String?
}

• issuer : The Decentralized ID of the user. In server-side use-cases, we recommend this value to be used as the user ID in your own tables.
• email : Email address of the authenticated user.
• publicAddress: The authenticated user's public address (a.k.a.: public key). Currently, this value is associated with the Ethereum blockchain.

 Copy
import MagicSDK

class MagicViewController: UIViewController {

    let magic = Magic.shared

    func getMetadata() {
        guard let magic = magic else { return }

        // Assuming user is logged in
        magic.user.getMetadata(response: { response in
            guard let metadata = response.result
                else { return print("Error:", response.error.debugDescription) }
            print("Result", metadata)
        })
    }
}

Promise<Bool>

 Copy
import MagicSDK

class MagicViewController: UIViewController {

    let magic = Magic.shared

    func isLoggedIn() {
        guard let magic = magic else { return }

        magic.user.isLoggedIn(response: { response in
            guard let result = response.result
                else { return print("Error:", response.error.debugDescription) }
            print("Result", result)
        })
    }
}

Promise<Bool>

 Copy
import MagicSDK

class MagicViewController: UIViewController {

    let magic = Magic.shared

    func logout() {
        guard let magic = magic else { return }

        // Assuming user is logged in
        magic.user.logout(response: { response in
            guard let result = response.result
                else { return print("Error:", response.error.debugDescription) }
            print("Result", result)
        })
    }
}