iOS SDK

이 페이지에서는 BApp에서 Klip을 활용하기 위한 App2App iOS SDK를 소개합니다.

요구 사항

• iOS 12.0 이상

• Swift 5.0 이상

• Xcode 13.4 이상

환경 설정

Klip iOS SDK는 별도의 가입 절차가 필요하지 않습니다. HTTP 통신이 가능한 어느 환경에서도 동작합니다. 다만, 기본적으로 Klip 앱이나 모바일 카카오톡이 설치된 환경에서 호출해야 합니다. Klip 앱이나 카카오톡 더보기 탭의 Klip을 실행하여 Klip 사용자의 승인을 받아야 하기 때문입니다.

1. Klip SDK 다운로드

다운로드 페이지에서 Klip iOS SDK를 다운받습니다.

2. Klip SDK Framework 추가

Klip SDK Framework를 Import하여 개발 프로젝트에 추가

1. 개발 중인 프로젝트를 Xcode로 실행

2. Xcode > 개발 프로젝트의 TARGETS 선택 > General Tab > Framworks, Libraries, and Embedded Content Tab > 왼쪽 하단의 + 버튼을 클릭

3. Source Directory에 다운받은 Klip SDK 프로젝트의 sdk 디렉토리를 선택, 클릭한 후 Next를 클릭

4. 왼쪽의 Project navigator의 Frameworks에 해당 SDK가 Import 되었는지 확인 후 build 수행

! Apple App Store 등록용 앱 빌드 시에는 `KlipLib.xcframework`만 포함되어야 합니다. `KlipLib-simulator.xcframework`는 개발 환경에만 사용해주세요.

Klip SDK 소스가 개발 프로젝트에 복사되고 라이브러리 코드를 직접 수정할 수 있습니다.

3. Info.plist 설정

앱 실행 허용 목록(Allowlist) 등록하기

iOS 9.0 이상에서 iOS SDK로 카카오톡 등 애플리케이션 실행 기능을 이용하려면 Info.plist 파일에 설정을 추가하여 커스텀 스킴 정보를 등록해야 합니다.

[Info] > [Custom iOS Target Properties]에 Array 타입 키(Key)인 LSApplicationQueriesSchemes를 추가하고, 해당 키의 'Item'으로 커스텀 스킴에 사용할 값인 'klip', 'kakaotalk', 'itms-apps'를 추가합니다.

 	<key>LSApplicationQueriesSchemes</key>
 	<array>
 		<string>klip</string>
 		<string>kakaotalk</string>
 		<string>itms-apps</string>
 	</array>

4. Source Import 설정

v2.1.0 이상

import KlipLib

v2.1.0 미만

import KlipSDK

API

개요

App2App API 요청은 크게 prepare, request, getResult의 순서로 진행이 됩니다.

• prepare는 어떠한 요청을 할지 요청을 정의하는 단계로 총 5가지 종류의 요청이 존재

• request는 함수 호출을 통해 Klip으로 화면이 전환되어 실제 서명 프로세스를 진행

• getResult는 함수 호출을 통해 결과값을 받고 확인

추가적으로 getCardList는 BApp 개발의 편의를 위해 Klip 사용자의 NFT 목록을 받아올 수 있도록 제공되는 함수입니다.

KlipSDK.shared

Klip SDK를 사용하기 위한 인스턴스를 생성합니다.

Return Value

Type	Description
Klip	Klip 인스턴스

Example

let klip = KlipSDK.shared

KlipSDK.shared.prepare

KlipSDK.shared.prepare(request: KlipRequest, bappInfo: BAppInfo, completion: @escaping(KlipCallback<KlipTxResponse>) -> Void) App2App API 요청 처리를 준비하고 request key를 발급합니다.

Request 값에 사용할 객체

• Klip 연결 타입(=인증)의 경우 AuthRequest

• KLAY 전송 타입의 경우 KlayTxRequest

• Token 전송 타입의 경우 TokenTxRequest

• Card 전송 타입의 경우 CardTxRequest

• Contract 실행 타입의 경우 ContractTxRequest

• Sign Message 실행 타입의 경우 SignMessageRequest

Parameters

Name	Type	Description
request	KlipRequest	요청 타입에 따른 요청정보
bappInfo	BAppInfo	요청 앱 정보
callback	KlipCallback<KlipTxResponse>	요청 응답 결과를 받을 콜백함수입니다. 처리가 완료되면, 완료결과인 KlipTxResponse를 전송받고, 처리가 실패되면, 실패결과인KlipErrorResponse를 전송받습니다.

Klip 사용자에게 동의 요청시, request와 bappInfo에 입력된 정보가 출력됩니다. 응답 결과에 포함된 request key는 사용자에게 트랜잭션을 요청하기 위한 컨텍스트 키의 역할을 수행하며, 사용자 동의 요청 및 결과확인 API와 함께 사용 됩니다.

Example 1. 사용자 정보 획득하기

// 사용자 정보 획득 요청문
let req: AuthRequest = AuthRequest();

// BApp 정보
let bappInfo: BAppInfo = BAppInfo(name : "BApp Name");

// 응답 결과 Callback
KlipSDK.shared.prepare(request: req, bappInfo: bappInfo) { result in
    switch result {
    case .success(let response):
    case .failure(let error):
    }
}

Example 2. KLAY 전송하기

// KLAY 전송 트랜잭션 요청문
let req: KlayTxRequest = KlayTxRequest(to: "0x..receiver address..", amount: "10")
  
KlipSDK.shared.prepare(request: req, bappInfo: bappInfo) { result in
    switch result {
    case .success(let response):
    case .failure(let error):
    }
}

Example 3. Token 전송하기

// Token 전송 트랜잭션 요청문
let req: TokenTxRequest = TokenTxRequest(to: "0x..receiver address..", amount: "10", contract: "0x..token contract address..")
  
KlipSDK.shared.prepare(request: req, bappInfo: bappInfo) { result in
    switch result {
    case .success(let response):
    case .failure(let error):
    }
}

Example 4. Card 전송하기

// Card 전송 트랜잭션 요청문
let req: CardTxRequest = CardTxRequest(to: "0x..receiver address..", contract: "0x..card contract address..", cardId: "9")
  
KlipSDK.shared.prepare(request: req, bappInfo: bappInfo) { result in
    switch result {
    case .success(let response):
    case .failure(let error):
    }
}

Example 5. Contract 실행하기

// Contract 전송 트랜잭션 요청문
let req: ContractTxRequest = ContractTxRequest(to: "0x..contract address..", value: "10", abi: "{...}", params: "[{...}]")
  
KlipSDK.shared.prepare(request: req, bappInfo: bappInfo) { result in
    switch result {
    case .success(let response):
    case .failure(let error):
    }
}

Example 6. Sign Message 실행하기

// Sign Message 요청문
let req = SignMessageRequest(value: "message", from: "0x..contract address..")
  
KlipSDK.shared.prepare(request: req, bappInfo: bappInfo) { result in
    switch result {
    case .success(let response):
    case .failure(let error):
    }
}

KlipSDK.shared.request

KlipSDK.shared.request(requestKey: String, isKlipAppCall: Bool = false) -> Void Deep Link를 이용하여 Klip에 인증 또는 서명을 요청합니다. 다음의 경우에는 Apple App Store 내 Klip 또는 카카오톡 앱 다운로드 화면으로 자동 이동합니다.

• 실행 중인 스마트폰 기기에 Klip 앱이나 카카오톡이 설치되지 않은 경우

• Klip 앱이 사용할 수 없는 버전인 경우

• QR code를 이용한 request 스텝 처리는 QR code 예제 항목을 참조하십시오.

KlipSDK.shared.request의 isKlipAppCall 파라미터 설정에 따라 먼저 호출하는 앱이 달라집니다. isKlipAppCall의 기본값은 false이며 이 때는 카카오톡 내 Klip을 실행합니다. isKlipAppCall 값을 true로 변경하면 실행 중인 스마트폰 기기에 Klip 앱과 카카오톡 설치 여부를 확인한 후 아래와 같은 순서로 실행됩니다.

1. 기기에 Klip 앱이 설치된 경우 Klip 앱 먼저 실행

2. 기기에 Klip 앱이 설치되지 않은 경우 카카오톡 Klip 실행

3. 기기에 카카오톡과 Klip 앱 모두 설치되지 않은 경우 App Store의 Klip 앱 다운로드 페이지로 이동

Parameters

Name	Type	Description
requestKey	String	(Klip 서버로부터 받은) 요청번호
isKlipAppCall	Bool	Klip 앱을 우선 호출 시 true (기본값: false)

Example

KlipSDK.shared.request(requestKey: "request key...", isKlipAppCall: true)

KlipSDK.shared.getResult

KlipSDK.shared.getResult(requestKey: String, completion: @escaping(KlipCallback<KlipTxResponse>) -> Void) App2App API 요청에 대한 결과를 확인합니다.

Parameters

Name	Type	Description
requestKey	String	(Klip 서버로부터 받은) 요청번호
callback	KlipCallback<KlipTxResponse>	요청 응답 결과를 받을 콜백함수입니다. 처리가 완료되면, 완료결과인 KlipTxResponse를 전송받고, 처리가 실패되면, 실패결과인KlipErrorResponse를 전송받습니다.

Example

KlipSDK.shared.getResult(requestKey: "request key...") { result in
    switch result {
    case .success(let response):
    case .failure(let error):
    }
}

KlipSDK.shared.getCardList

KlipSDK.shared.getCardList(cardAddress: String, userAddress: String, cursor: String?, completion: @escaping(KlipCallback<CardListResponse>) -> Void) 사용자의 모든 카드 중 특정 카드의 목록을 가져옵니다.

Parameters

Name	Type	Description
cardAddress	String	조회할 카드 주소
userAddress	String	조회할 사용자 주소
cursor	String	(optional) 조회할 커서값입니다. 만약, 조회할 카드의 보유목록이 100개 이상이면, 다음 100개 정보를 받을 수 있습니다.
callback	KlipCallback<CardListResponse>	요청 응답 결과를 받을 콜백함수입니다. 처리가 완료되면, 카드목록인 CardListResponse를 전송받고, 처리가 실패되면, 실패 결과인KlipErrorResponse를 전송받습니다.

Example

KlipSDK.shared.getCardList(cardAddress: "0x..card address..", userAddress: "0x..user address..", cursor: nil) { result in
    switch result {
    case .success(let response):
    case .failure(let error):
    }
}

Error Code

Http Status	Error Code	Description
-	-	Klip REST API 에러코드와 동일
500	10	Klip SDK에서 에러 발생 (ex, Http 연결 실패)
500	21	Klip SDK에서 에러 발생 (Klip REST API 미지원 에러코드)
500	22	Klip SDK에서 에러 발생 (Klip Protocol 에러)

이 문서 혹은 Klip에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.