Add Kotlin example for fetching transactions and update Java example

Signed-off-by: andreypfau <[email protected]>

Author: andreypfau

Writerside/topics/Overview.md

@@ -10,7 +10,7 @@ hands‑on guides and API details, see the other topics in this documentation se
 
 ## What is TON SDK?
 
-A collection of modular libraries published on Maven Central under the `org.ton.kotlin` group. Each module focuses on a
+A collection of modular libraries published on Maven Central under the `org.ton.sdk` group. Each module focuses on a
 well‑defined layer of the TON stack, from low‑level binary formats up to ready‑to‑use APIs.
 
 ### Key features
@@ -43,147 +43,48 @@ README for the latest coordinates and versions.
 
 - Indexers and backends that need to parse blocks/transactions and verify proofs.
 - Wallets and apps that compose and serialize messages and contracts.
-- Services querying blockchain data via the Lite Client.
+- Services querying blockchain data via the Lite Client or TON Center http client.
 - Tooling and middleware that rely on TL‑B codecs and BOC manipulation.
 
 ## Installation
 
-Add TON SDK modules from Maven Central. Use the coordinates under the org.ton.kotlin group. Keep module versions
-aligned (e.g., 0.5.0).
-
-Gradle (Kotlin DSL):
-
-```kotlin
-val tonVersion = "0.5.0"
-
-dependencies {
-    implementation("org.ton.kotlin:ton-kotlin-tvm:$tonVersion")        // Cells/BOC
-    implementation("org.ton.kotlin:ton-kotlin-crypto:$tonVersion")     // Crypto
-    implementation("org.ton.kotlin:ton-kotlin-tlb:$tonVersion")        // TL-B codec
-    implementation("org.ton.kotlin:ton-kotlin-liteclient:$tonVersion") // Lite client API
-    // Optional:
-    implementation("org.ton.kotlin:ton-kotlin-contract:$tonVersion")   // Contracts helpers
-    implementation("org.ton.kotlin:ton-kotlin-adnl:$tonVersion")       // ADNL transport
-}
-```
-
-Gradle (Groovy DSL):
-
-```groovy
-def tonVersion = '0.5.0'
-
-dependencies {
-    implementation "org.ton.kotlin:ton-kotlin-tvm:$tonVersion"
-    implementation "org.ton.kotlin:ton-kotlin-crypto:$tonVersion"
-    implementation "org.ton.kotlin:ton-kotlin-tlb:$tonVersion"
-    implementation "org.ton.kotlin:ton-kotlin-liteclient:$tonVersion"
-    // Optional:
-    implementation "org.ton.kotlin:ton-kotlin-contract:$tonVersion"
-    implementation "org.ton.kotlin:ton-kotlin-adnl:$tonVersion"
-}
-```
-
-Maven:
-
-```xml
-
-<dependencies>
-    <dependency>
-        <groupId>org.ton.kotlin</groupId>
-        <artifactId>ton-kotlin-tvm</artifactId>
-        <version>0.5.0</version>
-    </dependency>
-    <dependency>
-        <groupId>org.ton.kotlin</groupId>
-        <artifactId>ton-kotlin-crypto</artifactId>
-        <version>0.5.0</version>
-    </dependency>
-    <dependency>
-        <groupId>org.ton.kotlin</groupId>
-        <artifactId>ton-kotlin-tlb</artifactId>
-        <version>0.5.0</version>
-    </dependency>
-    <dependency>
-        <groupId>org.ton.kotlin</groupId>
-        <artifactId>ton-kotlin-liteclient</artifactId>
-        <version>0.5.0</version>
-    </dependency>
-    <!-- Optional -->
-    <dependency>
-        <groupId>org.ton.kotlin</groupId>
-        <artifactId>ton-kotlin-contract</artifactId>
-        <version>0.5.0</version>
-    </dependency>
-    <dependency>
-        <groupId>org.ton.kotlin</groupId>
-        <artifactId>ton-kotlin-adnl</artifactId>
-        <version>0.5.0</version>
-    </dependency>
-</dependencies>
-```
+Add TON SDK modules from Maven Central. Use the coordinates under the org.ton.sdk group. Keep module versions
+aligned (e.g., 0.6.0).
+
+<tabs>
+<tab id="maven" title="Maven">
+<code-block lang="xml" src="../../examples/java-maven-project/pom.xml" include-symbol="dependencies"/>
+</tab>
+<tab id="gradle-kts" title="build.gradle.kts">
+<code-block lang="kotlin" src="../../examples/build.gradle.kts" include-lines="10-12"/>
+</tab>
+</tabs>
 
 ## Quick start
 
 Add the artifacts you need from Maven Central and start from the level that fits your use case.
 
-### Kotlin (JVM/Android)
-
-Creating a Cell and serializing to BOC:
-
-```kotlin
-val cell = org.ton.cell.buildCell {
-    storeUInt(0xDEADBEEFu, 32)
-}
-val boc: ByteArray = org.ton.boc.BagOfCells.of(cell).toByteArray()
-```
-
-Decoding a TL‑B object (schema provided by block‑tlb module):
-
-```kotlin
-val block = org.ton.tlb.loadTlb<Block>(boc)
-```
-
-### Java (JVM)
-
-Creating a Cell and serializing to BOC:
-
-```java
-public class Example {
-    static void main(String[] args) {
-        var builder = org.ton.cell.CellBuilderKt.beginCell();
-        builder.storeUInt(0xDEADBEEF, 32);
-        org.ton.cell.Cell cell = builder.endCell();
-        byte[] boc = org.ton.boc.BagOfCells.Companion.of(new org.ton.cell.Cell[]{cell}).toByteArray();
-    }
-}
-```
+<tabs>
+<tab id="java" title="Java">
+<code-block lang="Java" src="../../examples/java-maven-project/src/main/java/org/ton/sdk/example/GetTransactionExample.java" include-symbol="main"/>
+</tab>
+<tab id="kotlin" title="Kotlin">
+<code-block lang="kotlin" src="../../examples/kotlin-gradle-project/src/jvmMain/kotlin/GetTransactionExample.kt" include-symbol="main"/>
+</tab>
+</tabs>
 
 See examples/ and tests in the repository for more scenarios.
 
 ## Supported platforms
 
 - JVM / Android — Kotlin and Java (first‑class)
 - iOS — Swift via Kotlin Multiplatform bindings (availability may vary by module)
-- Desktop/Server — JVM
+- Desktop/Server — JVM (JDK 8+)
 - Other Kotlin targets may be available per‑module; check each module’s README or Gradle metadata.
 
-## Versioning and compatibility
-
-- Semantic‑like versioning across modules. Prefer matching versions (e.g., 0.5.x) for best compatibility.
-- Wire formats (BOC, TL‑B) follow TON specifications; backwards compatibility is preserved unless TON protocol changes.
-
 ## Where to go next
 
 - Project README: architecture, badges, and links
 - Wiki/Docs: deeper guides and API references
 - Examples directory: runnable samples
 - Telegram chat: community support and announcements
-
-## Glossary
-
-- Cell — The fundamental immutable binary structure in TON used by TVM.
-- BOC (Bag of Cells) — A container format for serializing graphs of Cells.
-- TL‑B — Type language for describing binary data structures in TON.
-- ADNL — Abstract Datagram Network Layer, a TON network transport.
-- RLDP — Reliable Link over Datagram Protocol used over ADNL.
-- Lite Client — A client that queries TON blockchain data without running a full node.

examples/build.gradle.kts

@@ -8,8 +8,7 @@ kotlin {
     sourceSets {
         commonMain {
             dependencies {
-                api(projects.tonKotlinLiteclient)
-                api(projects.tonKotlinContract)
+                api("org.ton.sdk:ton-sdk-toncenter-client:0.6.0-SNAPSHOT")
             }
         }
     }

examples/java-maven-project/src/main/java/org/ton/sdk/example/GetTransactionExample.java

@@ -9,16 +9,22 @@
 
 import java.math.BigInteger;
 import java.util.concurrent.ExecutionException;
+import java.util.concurrent.Future;
 
 public class GetTransactionExample {
     public static void main(String[] args) throws ExecutionException, InterruptedException {
+        // create TON Center v3 http client
         TonCenterV3Client client = TonCenterV3Client.create();
-        TonCenterTransactionsResponse response = client.transactionsAsync(
+
+        // Get 10 last transactions for account
+        Future<TonCenterTransactionsResponse> response = client.transactionsAsync(
                 new TonCenterTransactionsRequestBuilder()
                         .address(AddressStd.parse("UQAKtVj024T9MfYaJzU1xnDAkf_GGbHNu-V2mgvyjTuP6uYH"))
-                        .limit(15)
-        ).get();
-        for (TonCenterTransaction transaction : response.transactions()) {
+                        .limit(10)
+        );
+
+        // Print transactions info and balance after transaction
+        for (TonCenterTransaction transaction : response.get().transactions()) {
             Coins balance = transaction.accountStateAfter().balance();
 
             BigInteger value = BigInteger.ZERO;

examples/kotlin-gradle-project/build.gradle.kts

@@ -0,0 +1,20 @@
+plugins {
+    kotlin("multiplatform")
+}
+
+repositories {
+    mavenLocal()
+    mavenCentral()
+}
+
+kotlin {
+    jvm()
+
+    sourceSets {
+        jvmMain {
+            dependencies {
+                api("org.ton.sdk:ton-sdk-toncenter-client-jvm:0.6.0-SNAPSHOT")
+            }
+        }
+    }
+}

examples/kotlin-gradle-project/src/jvmMain/kotlin/GetTransactionExample.kt

@@ -0,0 +1,36 @@
+@file:Suppress("OPT_IN_USAGE")
+
+package org.ton.sdk.example
+
+import kotlinx.coroutines.Deferred
+import kotlinx.coroutines.GlobalScope
+import kotlinx.coroutines.async
+import kotlinx.coroutines.runBlocking
+import org.ton.sdk.bigint.toBigInt
+import org.ton.sdk.blockchain.address.AddressStd
+import org.ton.sdk.toncenter.client.TonCenterV3Client
+import org.ton.sdk.toncenter.client.transactions
+import org.ton.sdk.toncenter.model.TonCenterTransactionsResponse
+
+object GetTransactionExample {
+    @JvmStatic
+    fun main(args: Array<String>) = runBlocking {
+        // create TON Center v3 http client
+        val client: TonCenterV3Client = TonCenterV3Client.create()
+
+        // Get 10 last transactions for account
+        val response: Deferred<TonCenterTransactionsResponse> = GlobalScope.async {
+            client.transactions {
+                account += AddressStd.parse("UQAKtVj024T9MfYaJzU1xnDAkf_GGbHNu-V2mgvyjTuP6uYH")
+                limit = 10
+            }
+        }
+
+        // Print transactions info and balance after transaction
+        response.await().transactions.forEach { transaction ->
+            val balance = transaction.accountStateAfter.balance
+            val value = balance?.value ?: 0.toBigInt()
+            println("hash=${transaction.hash} lt=${transaction.lt} balance=$value")
+        }
+    }
+}

settings.gradle.kts

@@ -39,6 +39,8 @@ submodule("liteclient")
 submodule("contract")
 submodule("dict")
 
+submodule("examples-kotlin-gradle-project", path = "examples/kotlin-gradle-project", "sdk")
+
 //submodule("provider", group = "sdk")
 //submodule("provider-core", "provider/core", group = "sdk")
 //submodule("provider-liteapi", "provider/liteapi")