Quickstart for iOS

📘
iOS OS 버전 최소 요구사항
LunieWallet SDK 는 iOS 15.0 이상의 OS 버전을 지원합니다. 15.0 미만의 OS 버전에서는 SDK를 포함한 어플리케이션이 런타임에 정상적으로 구동되지 않을 수 있습니다. OS 버전에 관련한 자세한 정보는 iOS & IPad OS Release Note 페이지를 참고하세요.

iOS 프로젝트에 Wallet SDK 연동하기

**Project Target > Package Dependencies 메뉴로 이동한 뒤 [+] 버튼을 클릭하여 루니 지갑 SDK 의존성을 신규로 추가합니다.

Repository:

Free to Download Wallet SDK
Version: 1.0.0

Nodit Console 에 접속하여 가입한 뒤, Wallet SDK Guide 페이지를 참고하여 API Key를 발급 받습니다.

Wallet SDK Guide 바로가기

2에서 발급받은 API Key 사용을 위해 config파일을 신규 생성한 뒤 파일의 내용을 아래와 같이 설정합니다. 분할한 Key Shares를 저장할 서버와 Wallet API Key에 필요한 값을 입력합니다.

projectFilePath/lunie_wallet_configuration.json

{ 
  "webview_server_url": "${WALLET_WEBVIEW_URL}", // If not entered this field, the Nodit server will be used as the default.
  "api_server_url": "${WALLET_API_URL}", // If not entered this field, the Nodit server will be used as the default.
  "wallet_api_key":"${WALLET_API_KEY}" // required field
}

WebView 통신 설정을 추가합니다.

Project Target > Info 메뉴로 이동한 뒤, App Transport Security Settings 항목과 Allow Arbitrary Loads를 Yes로 설정합니다.

<key>App Transport Security Settings </key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

카메라 설정을 추가합니다.

//카메라설정추가
<key>NSCameraUsageDescription</key>
<string>Access camera</string>

//Face ID 설정추가 
<key>Privacy - Face ID Usage Description</key>
<string>Please proceed with the authentication.</string>

SDK 초기화 및 지갑 생성/로드하기

LunieWallet SDK를 import한 후 아래와 같이 선언하여 SDK를 초기화할 수 있습니다.

import LunieWallet
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        //initialize 
        Lunie.initialize()
        GlobalManager.shared.lunieNetwork = NETWORK_ETHEREUM_GOERLI
        return true
    }
    //...
}

iOS Keychain에 저장된 지갑 생성 이력을 조회한 후, 이력이 있을 경우 저장된 니모닉을 통해 지갑을 로드하고 이력이 없는 경우 신규 지갑 Instance를 생성할 수 있습니다.

guard GlobalManager.shared.lunieWallet != nil else {
    return
}
//1. Check Wallet existence
let isAlreadySet = LunieWallet.isAlreadySetWallet()
switch isAlreadySet {
    case .Success(let isAlready):
        if (isAlready) {
      	    // 2. Load saved wallet from SecureLocalStorage
            let lunieInstance = LunieWallet.getInstanceSavedWallet()
            switch lunieInstance {
                case .Success(let data):
                    GlobalManager.shared.lunieWallet = data
                case .Fail(_):
                    GlobalManager.shared.lunieWallet = nil
                    Logger.debug("Fail Load Wallet")
            }
        }
    case .Fail(_):
        GlobalManager.shared.lunieWallet = nil
        Logger.debug("Fail Load Wallet")
}

// Option 2-1. Create New Wallet
var network: LunieNetwork = .init(THE_BALANCE)
let wallet = LunieWallet.getInstanceNewWallet()
switch wallet {
    case .Success(let data):
        GlobalManager.shared.lunieWallet = data
        showAlert("Success Create Wallet")
    case .Fail(_):
        showAlert("WALLET_ALREADY_INITIALIZED")
}

Wallet SDK API

iOS 환경에서 이용 가능한 Wallet API는 다음과 같습니다.

Init For Use

라이브러리 초기화 함수로 Wallet SDK 사용 전 필수로 가장 먼저 호출되어야 합니다.

import LunieWallet
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        //initialize Lunie 
        Lunie.initialize()

        //initialize Network 
				GlobalManager.shared.lunieNetwork = .init(THE_BALANCE)
        return true
    }
    //...
}

//GlobalManager.shared.lunieNetwork is initialized as a singleton LunieNetwork? object for use throughout the entire project.
import LunieWallet
class GlobalManager {
    static let shared = GlobalManager()
    var lunieWallet: LunieWallet?
    var lunieNetwork: LunieNetwork?
    var mpcData: SecretSharesOauth?
    var shardKeys: [String] = []
}

Create New Wallet

새로운 mnemonic key를 생성한 후 이를 이용하여 Wallet Instance를 생성합니다.

import LunieWallet

let wallet = LunieWallet.getInstanceNewWallet()
switch wallet {
    case .Success(let data):
        GlobalManager.shared.lunieWallet = data
        print("Success Create Wallet")
    case .Fail(_):
        print("WALLET_ALREADY_INITIALIZED")
}

Clear Wallet

현재 디바이스에 저장된 Wallet의 Key를 삭제합니다. 이를 이용하여 새로운 Key를 생성해 새로운 주소의 지갑을 생성할 수 있습니다.

let result = LunieWallet.clearWallet()
switch result {
    case .Success(let isclear):
        if (isclear) {
            print("Clear Wallet")
        } else {
            print("Clear Wallet Wrong")
        }
    case .Fail(_):
        print("Clear Wallet Fail")
}

Check Wallet Existence

디바이스에 저장된 지갑이 존재하는지 체크한 후 기기에 저장된 mnemonic key를 불러와 Wallet Instance를 생성합니다.

//1. Check Wallet existence
let isAlreadySet = LunieWallet.isAlreadySetWallet()
switch isAlreadySet {
    case .Success(let isAlready):
        if (isAlready) {
						// 2. Load saved wallet from SecureLocalStorage
            let lunieInstance = LunieWallet.getInstanceSavedWallet()
            switch lunieInstance {
                case .Success(let data):
                    GlobalManager.shared.lunieWallet = data
                case .Fail(_):
                    GlobalManager.shared.lunieWallet = nil
                    print("Fail Load Wallet")
            }
        }
    case .Fail(_):
        GlobalManager.shared.lunieWallet = nil
        print("There are no wallets to read from the device")
}

Load Wallet

현재 디바이스에 저장된 Wallet Instance를 확인한 후, Instance가 존재할 경우, 이를 불러옵니다.

let lunieInstance = LunieWallet.getInstanceSavedWallet()
switch lunieInstance {
  case .Success(let data):
    GlobalManager.shared.lunieWallet = data
  case .Fail(_):
    GlobalManager.shared.lunieWallet = nil
    print("Fail Load Wallet")
}

Recovery Wallet(MPC)

지갑을 복구하는 방법으로 백업해 둔 SecretShares를 이용하여 mnemonic을 복구합니다. 그리고 복구한 mnemonic을 이용하여 Wallet을 복구합니다.

// 1. Get secretShares for backup
var secretKeys : [String] = []
let wallet = LunieWallet.getSecretShares()
switch wallet {
    case .Success(let keys):
        secretKeys = keys
    case .Fail(_):
        print("Fail Load SecretKeys")
}

// 2. recovery wallet from secretShares
let lunieInstance = LunieWallet.recoveryWalletFromSecretKeys(secretKeys: secretKeys)
switch lunieInstance {
    case .Success(let wallet):
        GlobalManager.shared.lunieWallet = wallet
    case .Fail(_):
        GlobalManager.shared.lunieWallet = nil
        print("Fail Load Wallet")
}

// 3. Recovery wallet from mnemonic
let mnemonic = ""
let recoveryWallet = LunieWallet.recoveryWalletFromMnemonic(mnemonic: mnemonic)
switch recoveryWallet {
    case .Success(let wallet):
        GlobalManager.shared.lunieWallet = wallet
    case .Fail(_):
        GlobalManager.shared.lunieWallet = nil
        print("Fail Recovery Wallet")
}

Get Address

해당 네트워크의 HD 지갑 주소를 조회합니다.

let result = GlobalManager.shared.lunieNetwork?.getAddress()
switch result {
    case .Success(let address):
        print(address)
    case .Fail(_):
        print("getAddress Fail")
    case .none:
        print("getAddress none")
}

Get NFTs

특정 주소와 네트워크를 지정하여 해당 지갑이 해당 네트워크에 보유한 NFT를 조회합니다.

let page = 1 // page >= 1
let itemCount = 10 //  1 <= itemCount <= 100,  Default value is 20
let address = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
GlobalManager.shared.lunieNetwork?.getNFTs(address: address, page: page, rpp: 10) { result in
    switch result {
        case .Success(let nftList):
            print(nftList)
        case .Fail(_):
            print("Fail")
    }
}

Get Native Token

특정 주소와 네트워크를 지정하여 해당 지갑이 해당 네트워크에 보유한 Native Token을 조회합니다.

let address = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
GlobalManager.shared.lunieNetwork?.getNativeToken(address:address) { result in
    switch result {
        case .Success(let token):
            print(token)
        case .Fail(_):
            print("Fail")
    }
}

Get Tokens

특정 주소와 네트워크를 지정하여 해당 지갑이 해당 네트워크에 보유한 ERC20을 조회합니다.

let address = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
GlobalManager.shared.lunieNetwork?.getTokens(address:address, page: 1, rpp: 10) { result in
    switch result {
        case .Success(let token):
            print(token)
        case .Fail(_):
            print("Fail")
    }
}

Get Gas Limit(NFT)

특정 주소와 네트워크를 지정하여 해당 지갑이 해당 네트워크에서 NFT를 전송하기 위해 필요한 GasLimit을 조회합니다.

let fromAddress = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
let toAddress = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
let nft = Nft(name: "", contractAddress: "", tokenId: 0, imageUri: "", mediaUri: "", description: "", properties: [], ownerAddress: fromAddress)
GlobalManager.shared.lunieNetwork?.getGasLimit(fromAddress: fromAddress, toAddress: toAddress, nft: nft) { result in
    switch result {
        case .Success(let gasLimit):
            print(gasLimit)
        case .Fail(_):
            print("Fail")
    }
}

Get Gas Limit(Token)

특정 주소와 네트워크를 지정하여 해당 지갑이 해당 네트워크에서 Token를 전송하기 위해 필요한 GasLimit을 조회합니다.

let fromAddress = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
let toAddress = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
let token = Token(name: "", contractAddress: "", symbol: "", decimal: 16, amount: BigInt(0))
GlobalManager.shared.lunieNetwork?.getGasLimit(fromAddress: fromAddress, toAddress: toAddress, token: token, amount: 0) { result in
    switch result {
        case .Success(let gasLimit):
            print(gasLimit)
        case .Fail(_):
            print("Fail")
    }
}

Get Gas Price

특정 주소와 네트워크를 지정하여 해당 지갑이 해당 네트워크에서 Transfer를 실행하기 위해 필요한 GasPrice를 조회합니다.

GlobalManager.shared.lunieNetwork?.getGasPrice() { result in
    switch result {
        case .Success(let gasprice):
            print(gasprice)
        case .Fail(_):
            print("Fail")
    }
}

Get Transaction Result By Hash

트랜잭션의 Hash와 네트워크를 지정하여 해당 트랜잭션의 상세 내역을 조회합니다.

let hash = "<Transaction Hash>"
  GlobalManager.shared.lunieNetwork?.getTransactionResultByHash(hash: hash) { result in
      switch result {
          case .Success(let transaction):
              print(transaction)
          case .Fail(_):
              print("Fail")
      }
  }

Get Account Transaction Results

특정 주소를 이용하여 트랜잭션의 내역을 조회합니다.

let address = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
GlobalManager.shared.lunieNetwork?.getAccountTransactionResults(address: address, page: 1, rpp: 10){ result in
    switch result {
        case .Success(let transaction):
            print(transaction)
        case .Fail(_):
            print("Fail")
    }
}

Get Token Transaction From Address

특정 주소와 네트워크를 지정하여 해당 주소의 ERC20 트랜잭션의 상세 내역을 조회합니다.

let address = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
GlobalManager.shared.lunieNetwork?.getTokenTransactionFromAddress(address: address, page: 1, rpp: 10){ result in
    switch result {
        case .Success(let transaction):
            print(transaction)
        case .Fail(_):
            print("Fail")
    }
}

Transfer NFT

특정 주소와 네트워크를 지정하여 유저의 지갑이 보유한 NFT를 특정 주소로 전송하는 Transfer를 실행합니다.

let toAddress = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
let nft = Nft(name: "", contractAddress: "", tokenId: 0, imageUri: "", mediaUri: "", description: "", properties: [])
GlobalManager.shared.lunieNetwork?.transferNFT(toAddress: toAddress, nft: nft, transferGasFee: nil) { result in
    switch result {
        case .Success(let transaction):
            print(transaction)
        case .Fail(_):
            print("Fail")
    }
}

Transfer Token

특정 주소와 네트워크를 지정하여 유저의 지갑이 보유한 ERC20을 특정 주소로 전송하는 Transfer를 실행합니다.

let toAddress = "0x9858EfFD232B4033E47d90003D41EC34EcaEda94"
let token = Token(name: "", contractAddress: "", symbol: "", decimal: "", amount: BigInt(0))
GlobalManager.shared.lunieNetwork?.transferToken(toAddress: toAddress, token: token, amount: 0, transferGasFee:nil) { result in
    switch result {
        case .Success(let transaction):
            print(transaction)
        case .Fail(_):
            print("Fail")
    }
}

Wallet UI Component Setting

Wallet SDK는 편리한 개발을 지원하기 위해 기본적인 WebView를 지원합니다. 아래 코드를 이용하여 해당 WebView를 확인할 수 있습니다.

DispatchQueue.main.async {
		let lunieWebViewController = Lunie.getWebview()
    self.present(lunieWebViewController, animated: true, completion: nil)
}

//OR 

let lunieWebViewController = Lunie.getWebview()
let width = view.bounds.width
let height = view.bounds.height
lunieWebViewController.view.frame = CGRect(x: 0, y: 0, width: width, height: height)
self.view.addSubview(lunieWebViewController.view)

📘iOS OS 버전 최소 요구사항

iOS 프로젝트에 Wallet SDK 연동하기

SDK 초기화 및 지갑 생성/로드하기

Wallet SDK API

Init For Use

Create New Wallet

Clear Wallet

Check Wallet Existence

Load Wallet

Recovery Wallet(MPC)

Get Address

Get NFTs

Get Native Token

Get Tokens

Get Gas Limit(NFT)

Get Gas Limit(Token)

Get Gas Price

Get Transaction Result By Hash

Get Account Transaction Results

Get Token Transaction From Address

Transfer NFT

Transfer Token

Wallet UI Component Setting

📘
iOS OS 버전 최소 요구사항