Guía Rápida del SDK de Kotlin

Esta guía te lleva desde instalación hasta una transacción confirmada usando la forma actual de la API de Kaptos.

1. Instalar el SDK

   Kaptos publica artefactos multiplataforma y específicos por plataforma en Maven Central.

   Multiplataforma

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

   JVM (ejemplo)

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

2. Configurar el cliente

   val aptos = Aptos(
     AptosConfig(
       settings = AptosSettings(
         network = Network.DEVNET,
         clientConfig = ClientConfig(maxRetries = 10),
       )
     )
   )

   Nota

   Kaptos es Kotlin Multiplatform. Algunas opciones HTTP cambian por target, pero el uso de la API se mantiene consistente.

3. Leer datos de cadena

   val ledgerInfo = aptos.getLedgerInfo().expect("Failed to fetch ledger info")
   println("Ledger version: ${ledgerInfo.ledgerVersion}")
   
   val chainId = aptos.getChainId().expect("Failed to fetch chain id")
   println("Chain id: $chainId")

4. Crear y financiar cuentas

   val alice = Account.generate()
   val bob = Account.generate()
   
   aptos.fundAccount(accountAddress = alice.accountAddress, amount = 100_000_000L).expect("Failed to fund Alice")
   aptos.fundAccount(accountAddress = bob.accountAddress, amount = 100_000_000L).expect("Failed to fund Bob")

   Para patrones single-key y multi-key, revisa Cuentas.

5. Construir y enviar una transacción

   El builder lean usa typeArgs(...) y args(...).

   val pendingTxn =
     aptos
       .execute(signer = alice) {
         function = "0x1::coin::transfer"
         typeArgs("0x1::aptos_coin::AptosCoin")
         args(bob.accountAddress, 1_000_000UL)
       }
       .expect("Failed to build/sign/submit transaction")

6. Esperar confirmación

   val executedTxn =
     aptos
       .waitForTransaction(HexInput.fromString(pendingTxn.hash))
       .expect("Transaction did not execute successfully")
   
   println("Executed transaction version: ${executedTxn.version}")

¿Necesitas más control (build/sign/submit por separado, fee payer, simulación)? Revisa Construir Transacciones.