SDK de Kotlin

Kaptos es un SDK Multiplataforma de Kotlin para interactuar con la blockchain de Aptos a través de varias plataformas. Ofrece una API consistente para solicitudes de datos, envíos de transacciones, y más, facilitando el desarrollo de apps multiplataforma con lógica de negocio compartida. El SDK incluye clientes asíncronos de Aptos para interacciones suaves con la blockchain.

Kaptos también proporciona SDKs específicos de plataforma para JVM, Android, iOS, JS, Linux, macOS y Windows.

Plataformas compatibles

AndroidiOStvOSwatchOSNode.jsJVMLinuxmacOSWindows

Versión actual

Características

Type-safe: El SDK es completamente type-safe y proporciona un rico conjunto de tipos para todas las operaciones.
Expresivo: Kaptos proporciona una API simple y expresiva estilo DSL para construir transacciones.
Multiplataforma: Escribe aplicaciones multiplataforma con lógica de negocio compartida.
API Consistente: Todas las operaciones tienen una API uniforme y consistente a través de todas las plataformas.
Soporte BCS: El SDK usa BCS por defecto para serialización y deserialización de transacciones.
Asíncrono: Todas las operaciones de blockchain son asíncronas.
Configurable: El SDK proporciona clientes altamente configurables para todas las plataformas.

Instalación

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

El SDK de Android proporciona sabores para builds tanto de release como debug. Para usar el sabor debug, agrega lo siguiente a tu build.gradle:

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

El SDK es compatible con iosArm64, iosX64, y iosSimulatorArm64. Dependiendo de cómo esté configurado tu proyecto, puedes agregar las siguientes dependencias:

Para iosArm64:

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

Para iosX64:

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

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

El SDK solo soporta Linux x64. Para agregar la dependencia, usa lo siguiente:

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

El SDK solo soporta macOS x64, macOS arm64, y simulador macOS arm64. Para agregar la dependencia, usa lo siguiente:

Para macOS x64:

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

Para macOS arm64:

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

El SDK solo soporta Windows x64. Para agregar la dependencia, usa lo siguiente:

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

Realizar una Transacción

Abajo hay un ejemplo de cómo puedes realizar una transacción usando el SDK de Kotlin. El fragmento demuestra la API lean más reciente, donde construir, firmar y enviar ocurre en una sola llamada.

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

El SDK también proporciona métodos pre-construidos para operaciones de transacción comunes. Por ejemplo, puedes usar el método transferCoinTransaction para generar una transacción de transferencia entre dos cuentas como se muestra abajo:

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

Entonces puedes firmar y enviar esta transacción.

Ejemplos

Para más ejemplos sobre cómo y qué puedes hacer con el SDK de Kotlin, revisa lo siguiente:

Inicio Rápido Integra Aptos en < 5 minutos

Proyectos Únicos y Multiplataforma Explora varias apps demo, proyectos únicos y multiplataforma, sobre cómo usar el SDK