Library facilitates implementation of WalletConnect protocol v1, enabling secure communication between clients and wallets. Features include customizable connection storage, client-server interaction, and message handling.
KWalletConnect is a Kotlin Multiplatform library for WalletConnect protocol v1.
Add the dependency in your common module's commonMain sourceSet
kotlin {
// ...
sourceSets {
val commonMain by getting {
dependencies {
implementation("io.github.joesteven:kwalletconnect:$last_version")
}
}
}
}
WCConnectionStore is an interface that you need to implement to store the connection data. You can use any storage you want(SqlDelight database/File System...), but you need to implement the interface.
val wcClient = WCClient(store = YourWCConnectionStore())
val config = WCSessionConfig(bridge = "https://bridge.walletconnect.org")
val uri = config.uri
connect will return Result<WCConnection>, you can use this connection to send and receive messages.
val result = wcClient.connect(
config = config,
clientMeta = WCPeerMeta(
name = "Your Client name",
description = "Your client description",
icons = listOf("Your client logo url"),
url = "Your client website"
)
)
//disconnect
wcClient.disconnect(connectionId)
wcClient.request(
connectionId = it.id,
method = "personal_sign",
params = Json.encodeToJsonElement(
listOf("0x48656c6c6f2c207765623321",
it.accounts.first(),
)
).jsonArray
)
You can also get specified connection or current connections by wcClient.getConnection(connectionId) or wcClient.connections
val wcServer = WCServer(store = YourWCConnectionStore())
wcServer.pair(
uri = uri,
clientMeta = YourClientMeta
).onSuccess {
// display a dialog or something for your user to approve or reject the connection
//onSuccess will return a instance of PairRequest, use this instance to approve or reject connection
}.onFailure {
// handle error
}
// approve
pairRequest.approve(
account = listOf("0x1234567890...."),// connected wallet address,
chainId = 1
)
// reject
pairRequest.reject()
// disconnect
wcServer.disconnect(connectionId)
wcServer.request.collect{
// display a dialog or something for your user to respond to the client request
// request contains connectionId and request method
// you will need connection id and request id to response later
}
// send response
wcServer.response(
connectionId = request.connectionId,
requestId = request.method.requestId,
response = response// JsonElement
)
// send error response
wcServer.errorResponse(
connectionId = request.connectionId,
requestId = request.method.requestId,
errorCode = -32000,// error code here
errorMessage = "error message here"
)
-keep class com.mimao.kmp.walletconnect.entity.** { *; }
MIT License
Copyright (c) 2022 itsMimao
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Surfaced from shared tags and platforms — no rankings paid for.