Kaptos - Kotlin SDK

Kaptos 是一个 Kotlin 多平台 SDK，可在多种平台上与 Aptos 区块链交互。它为数据请求、交易提交等操作提供一致的 API，使应用能共享业务逻辑并实现跨平台开发。 SDK 内置异步 Aptos 客户端，可顺畅地与区块链交互。

Kaptos 还为 JVM、Android、iOS、JS、Linux、macOS 和 Windows 提供平台专用 SDK。

支持的平台

AndroidiOStvOSwatchOSNode.jsJVMLinuxmacOSWindows

当前版本

功能

类型安全：SDK 完全类型安全，并为所有操作提供丰富的类型。
表达力强：Kaptos 提供简洁且富有表达力的 DSL 风格 API，用于构建交易。
多平台：使用共享业务逻辑编写跨平台应用。
一致的 API：所有操作在各平台上都采用统一且一致的 API。
支持 BCS：SDK 默认使用 BCS 对交易进行序列化和反序列化。
异步：所有区块链操作均为异步操作。
可配置：SDK 为所有平台提供高度可配置的客户端。

安装

commonMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos:<version>")
}

jvmMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-jvm:<version>")
}

androidMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-android:<version>")
}

Android SDK 同时为 release 和 debug 构建提供 flavor。如需使用 debug flavor，请在 build.gradle 中添加以下内容：

androidMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-android-debug:<version>")
}

SDK 兼容 iosArm64、iosX64 和 iosSimulatorArm64。请根据项目配置添加以下依赖：

对于 iosArm64：

iosMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-iosArm64:<version>")
}

对于 iosX64：

iosMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-iosX64:<version>")
}

jsMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-js:<version>")
}

SDK 仅支持 Linux x64。请使用以下内容添加依赖：

linuxMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-linux:<version>")
}

SDK 仅支持 macOS x64、macOS arm64 和 macOS arm64 模拟器。请使用以下内容添加依赖：

对于 macOS x64：

macosMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-macosX64:<version>")
}

对于 macOS arm64：

macosMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-macosArm64:<version>")
}

SDK 仅支持 Windows x64。请使用以下内容添加依赖：

mingwMain.dependencies {
  implementation("xyz.mcxross.kaptos:kaptos-mingwX64:<version>")
}

执行交易

下面的示例展示如何使用 Kotlin SDK 执行交易。该代码片段采用最新的精简 API，将构建、签名和提交合并为一次调用。

val result = aptos.execute(signer = alice) {
  function = "0x1::coin::transfer"
  typeArgs("0x1::aptos_coin::AptosCoin")
  args(bob.accountAddress, 1_000_000UL)
}

SDK 也为常见交易操作提供预构建方法。例如，您可以使用 transferCoinTransaction 方法生成两个账户之间的转账交易：

val txn = aptos.transferCoinTransaction(
     alice.accountAddress,
     bob.accountAddress,
     SEND_AMOUNT
   )

然后可以对此交易进行签名，并提交。

示例

若要了解使用 Kotlin SDK 能完成的更多操作和示例，请查看以下内容：

快速入门在 5 分钟内集成 Aptos

单平台和多平台项目浏览使用 SDK 的各种演示应用、单平台项目和多平台项目。