WaaS SDK

WaaS SDK の README ファイル

iOS 用 WaaS SDK

• iOS 用 ABC WaaS SDK

---

要件

• iOS 13

---

インストール

Swift パッケージマネージャー

Package.swift に .package(url:_:) を追加してください:

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

---

SDK 初期化

URL、clientId、clientSecret は ABC WaaS コンソールで確認できます。

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

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

[WaaS 管理者]

---

使い方

1. ABC ログイン

1-1. ログイン用メールを送信

// email: ログインコードを受け取るメールアドレス
// language: 送信するメールの言語（韓国語、英語、インドネシア語、ベトナム語、タイ語、日本語）をサポート
// completion: 完了コールバック (Void / Error)

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

例

let client = WaasClient()    
client.sendLoginCode(        
	email: testEmail,        
	language: .current
) { result in        
	if case .failure = result {            
		// エラーを処理        
	}    
}

1-2. メールのコードでログインする

// email: ログインするメールアドレス
// code: メールに記載されている6桁のコード
// completion: 完了コールバック (OauthToken / Error)

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

例

client.login(        
	email: testEmail,        
	code: "961210" // 受け取ったメールのコード    
) { result in        
	switch result {        
	case .success(let authToken):            
		// abc の oauth トークンを保存        
	case .failure(let error):            
		// エラーを処理        
	}
}

1-3. トークンのリフレッシュ

// token: リフレッシュトークン
// completion: 完了コールバック (OauthToken / Error)

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

例

client.refreshToken(        
	token: refreshToken
) { result in        
	switch result {        
	case .success(let authToken):            
		// abc の oauth トークンを保存        
	case .failure(let error):            
		// エラーを処理        
	}
}

2. WaaS で署名する

2-1. EVM トランザクションの署名

// accessToken: ログイン後に発行された AccessToken
// keyPassword: ユーザーが入力したパスワード
// transaction: 署名する EVM トランザクション形式
// network: 署名するネットワーク (ethereum, polygon, klaytn ...)

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

例

// 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. SDK でサポートされていないメソッドの使用例

WaaS にはあるが、SDK でサポートされていない API の使用方法です。

以下の例は EVM の eth_estimateGas を呼び出す方法です。

ABC WaaS (eth_estimateGas)

// accessToken があれば WaaS が提供するさまざまな API を利用できます。

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)
}