WaaS SDK

Readme file for WaaS SDK

WaaS SDK for iOS

• ABC WaaS SDK for iOS

---

Requirements

• iOS 13

---

Installation

Swift Package Manager

Add .package(url:_:) to your Package.swift:

dependencies: [
	.package(url: "https://github.com/ahnlabio/waas-ios-sdk.git",
	.branch("main"))
]

---

SDK Initialization

You can check the URL, clientId, and clientSecret in the ABC WaaS Console.

// url: https://docs.waas.myabcwallet.com/getting-started/guide/support/
// abcAccessKey: client id
// abcAccessSecret: client secret

Waas.config(    
		url: "",    
		abcAccessKey: "",    
		abcAccessSecret: "",    
		csURL: "",    
		csPort: ""
)

[WaaS Admin]

---

Usage

1. ABC Login

1-1. Send login email

// email: the email that will receive the login code
// language: the language for the sent email (supports Korean, English, Indonesian, Vietnamese, Thai, Japanese)
// completion: completion callback (Void / Error)

public func sendLoginCode(    
	email: String,    
	language: Language = .current,    
	completion: @escaping (Result<Void, Error>) -> Void
)

Example

let client = WaasClient()    
client.sendLoginCode(        
	email: testEmail,        
	language: .current
) { result in        
	if case .failure = result {            
		// handle Error        
	}    
}

1-2. Login with email code

// email: the email to log in with
// code: the 6-digit code written in the email
// completion: completion callback (OauthToken / Error)

public func login(    
	email: String,    
	code: String,    
	completion: @escaping (Result<OauthToken, Error>) -> Void
)

Example

client.login(        
	email: testEmail,        
	code: "961210" // email code you received    
) { result in        
	switch result {        
	case .success(let authToken):            
		// save abc oauth token        
	case .failure(let error):            
		// handle Error        
	}
}

1-3. Token refresh

// token: refresh token
// completion: completion callback (OauthToken / Error)

public func refreshToken(    
	token: String,    
	completion: @escaping (Result<OauthToken, Error>) -> Void
)

Example

client.refreshToken(        
	token: refreshToken
) { result in        
	switch result {        
	case .success(let authToken):            
		// save abc oauth token        
	case .failure(let error):            
		// handle Error        
	}
}

2. Sign with WaaS

2-1. EVM Transaction signing

// accessToken: AccessToken issued after login
// keyPassword: password entered by the user
// transaction: EVM Transaction format to be signed
// network: network to sign for (ethereum, polygon, klaytn ...)

public func signTransaction(    
	accessToken: String,
	keyPassword: String,    
	transaction: EVMTransaction,    
	network: EVMNetwork
) async throws -> String

Example

// storage to save keyshare

let storage = MemorySignerStorage()
let signer = EVMSignClient(storage: storage)
let signature = try await signer.signTransaction(    
	accessToken: accessToken,    
	keyPassword: keyPassword,    
	transaction: .init(        
		to: "0xFF5f861bed0dfB81aC389aD88d956fE4653cf5D7",        
		value: "0x0"    
	),
	network: .ethereumTestnet
)

3. Example of using a method not supported by the SDK

This is how to use APIs that exist in WaaS but are not supported by the SDK.

The example below shows how to call eth_estimateGas of EVM.

ABC WaaS (eth_estimateGas)

// With just an accessToken, you can use various APIs supported by WaaS.

func testEstimatedGas() async throws {    
	let urlString = "\(Waas.config.url.absoluteString)/wapi/v2/gas/estimate/legacy"    
	let url = URL(string: urlString)    
	let request = URLRequest(        
		url: url,        
		method: .post,        
		contentType: .urlEncoded,        
		headers: ["Authorization": "Bearer \(accessToken)"],        
		body: [            
			"network": EVMNetwork.ethereumTestnet.pathName,            
			"to": "0xFF5f861bed0dfB81aC389aD88d956fE4653cf5D7",            
			"from": "0xFF5f861bed0dfB81aC389aD88d956fE4653cf5D7",            
			"value": "0x0"        
		]    
	)!    
	
	let (data, response) = try await URLSession.shared.data(for: request)    
	let text = String(data: data, encoding: .utf8)    
	print(text)
}