chore(examples): Add examples to show coin balances and total balance per address

bindings/go/examples/coin_balances.go

@@ -0,0 +1,43 @@
+// Copyright (c) 2025 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+package main
+
+import (
+	"fmt"
+	"log"
+
+	sdk "bindings/iota_sdk_ffi"
+)
+
+func isNilError(err error) bool {
+	if sdkErr, ok := err.(*sdk.SdkFfiError); ok {
+		return sdkErr == nil
+	}
+	return false
+}
+
+func main() {
+	client := sdk.GraphQlClientNewDevnet()
+
+	address, err := sdk.AddressFromHex("0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f")
+	if err != nil {
+		log.Fatalf("Failed to parse address: %v", err)
+	}
+
+	coins, err := client.Coins(address, nil, nil)
+	if !isNilError(err) {
+		log.Fatalf("Failed to get coins: %v", err)
+	}
+
+	for _, coin := range coins.Data {
+		fmt.Printf("Coin = 0x%s Balance = %d\n", coin.Id().ToHex(), coin.Balance())
+	}
+
+	balance, err := client.Balance(address, nil)
+	if !isNilError(err) {
+		log.Fatalf("Failed to get balance: %v", err)
+	}
+	fmt.Printf("Total Balance = %d\n", *balance)
+
+}

bindings/go/examples/example.go

@@ -4,7 +4,6 @@
 package main
 
 import (
-	"fmt"
 	"log"
 
 	sdk "bindings/iota_sdk_ffi"
@@ -18,36 +17,19 @@ func isNilError(err error) bool {
 }
 
 func main() {
-	client := sdk.GraphQlClientNewDevnet()
-
 	address, err := sdk.AddressFromHex("0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f")
 	if err != nil {
 		log.Fatalf("Failed to parse address: %v", err)
 	}
 
-	coins, err := client.Coins(address, nil, nil)
-	if !isNilError(err) {
-		log.Fatalf("Failed to get coins: %v", err)
-	}
-
-	for _, coin := range coins.Data {
-		fmt.Printf("ID = 0x%s Balance = %d\n", coin.Id().ToHex(), coin.Balance())
-	}
-
-	balance, err := client.Balance(address, nil)
-	if !isNilError(err) {
-		log.Fatalf("Failed to get balance: %v", err)
-	}
-	fmt.Printf("Total Balance = %d\n", *balance)
-
 	atCheckpoint := uint64(3)
 	inputObject, err := sdk.ObjectIdFromHex("0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f")
 	if err != nil {
 		log.Fatalf("Failed to parse object ID: %v", err)
 	}
 	txFilter := sdk.TransactionsFilter{
 		AtCheckpoint: &atCheckpoint,
-		InputObject: &inputObject,
+		InputObject:  &inputObject,
 	}
 	eventFilter := sdk.EventFilter{
 		Sender: &address,

bindings/kotlin/examples/CoinBalances.kt

@@ -0,0 +1,26 @@
+// Copyright (c) 2025 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import iota_sdk.Address
+import iota_sdk.GraphQlClient
+import kotlinx.coroutines.runBlocking
+
+fun main() = runBlocking {
+        try {
+                val client = GraphQlClient.newDevnet()
+                val address =
+                        Address.fromHex(
+                                "0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f"
+                        )
+
+                val coins = client.coins(address)
+                for (coin in coins.data) {
+                        println("Coin = 0x${coin.id().toHex()} Balance = ${coin.balance()}")
+                }
+
+                val balance = client.balance(address)
+                println("Total Balance = $balance")
+        } catch (e: Exception) {
+                e.printStackTrace()
+        }
+}

bindings/kotlin/examples/Example.kt

@@ -2,47 +2,37 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import iota_sdk.Address
-import iota_sdk.Direction
 import iota_sdk.EventFilter
 import iota_sdk.GraphQlClient
 import iota_sdk.ObjectId
-import iota_sdk.PaginationFilter
 import iota_sdk.TransactionsFilter
 import kotlinx.coroutines.runBlocking
 
 fun main() = runBlocking {
-    try {
-        val client = GraphQlClient.newDevnet()
+        try {
+                val client = GraphQlClient.newDevnet()
 
-        val myAddress =
-                Address.fromHex(
-                        "0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f"
-                )
-
-        val coins = client.coins(myAddress)
-        for (coin in coins.data) {
-            println("ID = 0x${coin.id().toHex()} Balance = ${coin.balance()}")
-        }
-
-        val balance = client.balance(myAddress, null)
-        println("Total Balance = $balance")
-
-        val _txFilter =
-                TransactionsFilter(
-                        atCheckpoint = 3UL,
-                        inputObject =
-                                ObjectId.fromHex(
-                                        "0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f"
-                                ),
-                        // ...other fields as needed
+                val myAddress =
+                        Address.fromHex(
+                                "0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f"
                         )
 
-        val _eventFilter =
-                EventFilter(
-                        sender = myAddress
-                        // ...other fields as needed
-                        )
-    } catch (e: Exception) {
-        e.printStackTrace()
-    }
+                val _txFilter =
+                        TransactionsFilter(
+                                atCheckpoint = 3UL,
+                                inputObject =
+                                        ObjectId.fromHex(
+                                                "0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f"
+                                        ),
+                                // ...other fields as needed
+                                )
+
+                val _eventFilter =
+                        EventFilter(
+                                sender = myAddress
+                                // ...other fields as needed
+                                )
+        } catch (e: Exception) {
+                e.printStackTrace()
+        }
 }

bindings/python/examples/chain_id.py

@@ -8,9 +8,10 @@
 
 async def main():
     client = GraphQlClient.new_devnet()
-    
+
     chain_id = await client.chain_id()
     print("Chain ID:", chain_id)
 
+
 if __name__ == "__main__":
     asyncio.run(main())

bindings/python/examples/coin_balances.py

@@ -0,0 +1,24 @@
+# Copyright (c) 2025 IOTA Stiftung
+# SPDX-License-Identifier: Apache-2.0
+
+from lib.iota_sdk_ffi import *
+
+import asyncio
+
+async def main():
+    client = GraphQlClient.new_devnet()
+
+    address = Address.from_hex(
+        "0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f"
+    )
+
+    coins = await client.coins(address)
+    for coin in coins.data:
+        print(f"Coin = {coin.id().to_hex()} Balance = {coin.balance()}")
+
+    balance = await client.balance(address)
+    print(f"Total Balance = {balance}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

bindings/python/examples/epoch.py

@@ -1,16 +1,17 @@
 # Copyright (c) 2025 IOTA Stiftung
 # SPDX-License-Identifier: Apache-2.0
 
-import asyncio
 from lib.iota_sdk_ffi import GraphQlClient
 
+import asyncio
+
 
 async def main():
     try:
         client = GraphQlClient.new_devnet()
 
         # Get current epoch
-        current_epoch = await client.epoch(None)
+        current_epoch = await client.epoch()
         if current_epoch is None:
             print("Current epoch is None")
             return

bindings/python/examples/example.py

@@ -10,13 +10,10 @@ async def main():
         "0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f"
     )
 
-    coins = await client.coins(my_address)
-    for coin in coins.data:
-        print(f"ID = {coin.id().to_hex()} Balance = {coin.balance()}")
-
-    balance = await client.balance(my_address)
-
-    print(f"Total Balance = {balance}")
+    coins = await client.coins(
+        my_address,
+        PaginationFilter(direction=Direction.FORWARD, cursor=None, limit=None),
+    )
 
     filter = TransactionsFilter(
         at_checkpoint=3,

bindings/python/examples/transactions_with_shared.py

@@ -1,9 +1,10 @@
 # Copyright (c) 2025 IOTA Stiftung
 # SPDX-License-Identifier: Apache-2.0
 
-import asyncio
 from lib.iota_sdk_ffi import *
 
+import asyncio
+
 
 async def main():
     try:

crates/iota-graphql-client/examples/coin_balances.rs

@@ -0,0 +1,34 @@
+// Copyright (c) 2025 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+use iota_graphql_client::{
+    Client,
+    error::Result,
+    pagination::{Direction, PaginationFilter},
+};
+
+#[tokio::main]
+async fn main() -> Result<()> {
+    let client = Client::new_devnet();
+    let address = "0xb14f13f5343641e5b52d144fd6f106a7058efe2f1ad44598df5cda73acf0101f".parse()?;
+    let (_, coins) = client
+        .coins(
+            address,
+            None,
+            PaginationFilter {
+                direction: Direction::Forward,
+                ..Default::default()
+            },
+        )
+        .await?
+        .into_parts();
+
+    for coin in &coins {
+        println!("Coin = {}, Balance = {}", coin.id(), coin.balance());
+    }
+
+    let balance = client.balance(address, None).await?.unwrap_or_default();
+    println!("Total balance = {balance}");
+
+    Ok(())
+}