Kaptos SDK offers a unified API to interact with Aptos services, supporting customizable client settings and facilitating account management and transaction submission with domain-specific language features.
Kaptos is a Kotlin Multiplatform SDK for Aptos. It provides a common API for interacting with Aptos services across multiple platforms.
Initialize Aptos to access the SDK API.
val aptos = Aptos()
If you want to pass in a custom configuration, you can do so by passing in a AptosConfig object.
val config = AptosConfig(AptosSettings(network = Network.LOCAL))
val aptos = Aptos(config)
val modules = aptos.getAccountModules("0x1".toAccountAddress())
val account = Account.generate()
// Create a private key instance for Ed25519 scheme
val privateKey = Ed25519PrivateKey("myEd25519privatekeystring")
// Derive an account from private key
// This is used as a local calculation and therefore is used to instantiate an `Account`
// that has not had its authentication key rotated
val account = Account.fromPrivateKey(privateKey)
// Create a private key instance for Ed25519 scheme
val privateKey = Ed25519PrivateKey("myEd25519privatekeystring")
// Derive an account from private key and address
// create an AccountAddress instance from the account address string
val address = AccountAddress.fromString()
Kaptos provides Domain Specific Language (DSL) for building transactions. The following example demonstrates how to build a simple transaction to transfer coins from one account to another.
val alice = Account.generate()
val bob = Account.generate()
// Creating account credentials does not automatically create an account on-chain.
// You must explicitly create an account on-chain before you can interact with it.
// To do this in testnet, you can use the faucet.
val aliceFaucet = aptos.fundAccount(alice.accountAddress, 1000000000)
val bobFaucet = aptos.fundAccount(bob.accountAddress, 1000000000)
val txn = aptos.execute(alice) {
function = "0x1::coin::transfer"
typeArgs("0x1::aptos_coin::AptosCoin")
args(bob.accountAddress, 1_000_000UL)
}
It also provides pre-built transaction builders for common transactions. For example, to transfer coins from one account
to another, you can use the transferCoinTransaction builder.
val txn = aptos.transferCoinTransaction(alice.accountAddress, bob.accountAddress, 1_000_000UL)
To run the SDK tests, simply run from the root of this repository:
[!NOTE] For a better experience, make sure there is an aptos local node process up and running (can check if there is a process running on port 8080).
./gradlew test
All contributions to Kaptos are welcome. Before opening a PR, please submit an issue detailing the bug or feature. When opening a PR, please ensure that your contribution builds on the KMM toolchain, has been linted with ktfmt <GOOGLE (INTERNAL)>, and contains tests when applicable. For more information, please see the contribution guidelines.
Copyright 2024 McXross
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
Add the following to your common source set:
commonMain.dependencies {
implementation("xyz.mcxross.kaptos:kaptos:<version>")
}
To add Kaptos to a platform-specific project, you can add the following to your platform-specific source set:
Kaptos provides two flavors for Android: kaptos-android and kaptos-android-debug. The kaptos-android flavor is
optimized for release builds, while the kaptos-android-debug flavor is optimized for debug builds.
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-android:<version>")
}
Kaptos provides artifacts for both iOS arm64 and x64 architectures. You can add the following to your iOS project:
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-iosArm64:<version>")
}
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-iosX64:<version>")
}
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-macos:<version>")
}
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-tvos:<version>")
}
Kaptos provides artifacts for both watchOS arm32, arm64 and x64 architectures. You can add the following to your watchOS project:
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-watchosarm32:<version>")
}
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-watchosarm64:<version>")
}
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-watchosx64:<version>")
}
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-js:<version>")
}
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-jvm:<version>")
}
Kaptos provides artifacts for both Linux arm64 and x64 architectures. You can add the following to your Linux project:
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-linuxarm64:<version>")
}
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-linuxx64:<version>")
}
dependencies {
implementation("xyz.mcxross.kaptos:kaptos-mingw:<version>")
}
[!NOTE] Snapshots are available via Sonatype Central's snapshots repository. To use snapshots, add the following to your project:
repositories {
maven("https://central.sonatype.com/repository/maven-snapshots/")
}
Surfaced from shared tags and platforms — no rankings paid for.