feat!: hold at most one complex transaction filter

bindings/csharp/examples/AddressTransactions/Program.cs

@@ -16,8 +16,8 @@ static async Task Main(string[] args)
         var client = GraphQlClient.NewLocalnet();
         var address = Address.FromHex("0xa7c2cf9d8f8d95ff69d7a598c49c77acc36253f496f064a533ad306879b40bfa");
 
-        var outgoing = await client.Transactions(filter: new TransactionsFilter(SentAddress: address));
-        var incoming = await client.Transactions(filter: new TransactionsFilter(RecvAddress: address));
+        var outgoing = await client.Transactions(filter: new TransactionsFilter().WithSentAddress(address));
+        var incoming = await client.Transactions(filter: new TransactionsFilter().WithRecvAddress(address));
 
         Console.WriteLine($"Transactions for {address.ToHex()}");
 

bindings/csharp/examples/PackageInspect/Program.cs

@@ -328,7 +328,7 @@ static bool TryExtractPolicy(string contents, out byte policy)
     static async Task<ObjectId?> ResolveUpgradeCapId(GraphQlClient client, ObjectId packageId)
     {
         var page = await client.TransactionsEffects(
-            new TransactionsFilter(ChangedObject: packageId),
+            new TransactionsFilter().WithChangedObject(packageId),
             new PaginationFilter(Direction.Forward, Limit: 1)
         );
 
@@ -528,7 +528,7 @@ ObjectId packageId
         while (true)
         {
             var page = await client.TransactionsDataEffects(
-                new TransactionsFilter(ChangedObject: packageId),
+                new TransactionsFilter().WithChangedObject(packageId),
                 ForwardPage(cursor)
             );
 
@@ -559,7 +559,7 @@ ObjectId upgradeCapId
         while (true)
         {
             var page = await client.TransactionsDataEffects(
-                new TransactionsFilter(InputObject: upgradeCapId),
+                new TransactionsFilter().WithInputObject(upgradeCapId),
                 ForwardPage(cursor)
             );
 

bindings/csharp/examples/TransactionsWithFunction/Program.cs

@@ -8,7 +8,7 @@ class Program
     static async Task Main(string[] args)
     {
         var client = GraphQlClient.NewTestnet();
-        var transactions = await client.Transactions(filter: new TransactionsFilter(Function: "0x3::iota_system::request_add_stake"));
+        var transactions = await client.Transactions(filter: new TransactionsFilter().WithFunction("0x3::iota_system::request_add_stake"));
 
         foreach (var transaction in transactions.Data)
         {

bindings/csharp/examples/TransactionsWithShared/Program.cs

@@ -11,7 +11,7 @@ static async Task Main(string[] args)
 
         var sharedObjId = ObjectId.FromHex("0x7cab491740d51e0d75b26bf9984e49ba2e32a2d0694cabcee605543ed13c7dec");
 
-        var transactions = await client.Transactions(filter: new TransactionsFilter(InputObject: sharedObjId));
+        var transactions = await client.Transactions(filter: new TransactionsFilter().WithInputObject(sharedObjId));
 
         foreach (var transaction in transactions.Data)
         {

bindings/go/examples/address_transactions/main.go

@@ -23,16 +23,14 @@ func main() {
 		log.Fatalf("Failed to parse address: %v", err)
 	}
 
-	outgoing, err := client.Transactions(&iota_sdk.TransactionsFilter{
-		SentAddress: &address,
-	}, nil)
+	sentFilter := iota_sdk.NewTransactionsFilter().WithSentAddress(address)
+	outgoing, err := client.Transactions(&sentFilter, nil)
 	if err != nil {
 		log.Fatalf("Failed to fetch outgoing transactions: %v", err)
 	}
 
-	incoming, err := client.Transactions(&iota_sdk.TransactionsFilter{
-		RecvAddress: &address,
-	}, nil)
+	recvFilter := iota_sdk.NewTransactionsFilter().WithRecvAddress(address)
+	incoming, err := client.Transactions(&recvFilter, nil)
 	if err != nil {
 		log.Fatalf("Failed to fetch incoming transactions: %v", err)
 	}

bindings/go/examples/package_inspect/main.go

@@ -369,8 +369,9 @@ func extractPolicy(contents string) (uint8, bool) {
 
 func resolveUpgradeCapID(client *iota_sdk.GraphQlClient, packageID *iota_sdk.ObjectId) (*iota_sdk.ObjectId, error) {
 	limit := int32(1)
+	filter := iota_sdk.NewTransactionsFilter().WithChangedObject(packageID)
 	page, err := client.TransactionsEffects(
-		&iota_sdk.TransactionsFilter{ChangedObject: &packageID},
+		&filter,
 		&iota_sdk.PaginationFilter{Direction: iota_sdk.DirectionForward, Limit: &limit},
 	)
 	if err != nil {
@@ -544,10 +545,11 @@ func usesUpgradeCapForMakeImmutable(tx *iota_sdk.Transaction, upgradeCapID *iota
 
 func wasPackagePublishedAsImmutable(client *iota_sdk.GraphQlClient, packageID *iota_sdk.ObjectId) (bool, error) {
 	var cursor *string
+	filter := iota_sdk.NewTransactionsFilter().WithChangedObject(packageID)
 
 	for {
 		page, err := client.TransactionsDataEffects(
-			&iota_sdk.TransactionsFilter{ChangedObject: &packageID},
+			&filter,
 			forwardPage(cursor),
 		)
 		if err != nil {
@@ -573,10 +575,11 @@ func wasPackagePublishedAsImmutable(client *iota_sdk.GraphQlClient, packageID *i
 
 func wasUpgradeCapUsedForMakeImmutable(client *iota_sdk.GraphQlClient, upgradeCapID *iota_sdk.ObjectId) (bool, error) {
 	var cursor *string
+	filter := iota_sdk.NewTransactionsFilter().WithInputObject(upgradeCapID)
 
 	for {
 		page, err := client.TransactionsDataEffects(
-			&iota_sdk.TransactionsFilter{InputObject: &upgradeCapID},
+			&filter,
 			forwardPage(cursor),
 		)
 		if err != nil {

bindings/go/examples/transactions_with_function/main.go

@@ -13,10 +13,8 @@ import (
 func main() {
 	client := iota_sdk.GraphQlClientNewTestnet()
 
-	function := "0x3::iota_system::request_add_stake"
-	transactions, err := client.Transactions(&iota_sdk.TransactionsFilter{
-		Function: &function,
-	}, nil)
+	filter := iota_sdk.NewTransactionsFilter().WithFunction("0x3::iota_system::request_add_stake")
+	transactions, err := client.Transactions(&filter, nil)
 	if err != nil {
 		log.Fatalf("Failed to get transactions: %v", err)
 	}

bindings/go/examples/transactions_with_shared/main.go

@@ -23,7 +23,8 @@ func main() {
 
 	sharedObjId := objIdFromHex("0x7cab491740d51e0d75b26bf9984e49ba2e32a2d0694cabcee605543ed13c7dec")
 
-	transactions, err := client.Transactions(&iota_sdk.TransactionsFilter{InputObject: &sharedObjId}, nil)
+	filter := iota_sdk.NewTransactionsFilter().WithInputObject(sharedObjId)
+	transactions, err := client.Transactions(&filter, nil)
 	if err != nil {
 		log.Fatalf("Failed to get transactions: %v", err)
 	}

bindings/kotlin/examples/AddressTransactions.kt

@@ -18,8 +18,8 @@ fun main() = runBlocking {
         val address =
             Address.fromHex("0xa7c2cf9d8f8d95ff69d7a598c49c77acc36253f496f064a533ad306879b40bfa")
 
-        val outgoing = client.transactions(TransactionsFilter(sentAddress = address))
-        val incoming = client.transactions(TransactionsFilter(recvAddress = address))
+        val outgoing = client.transactions(TransactionsFilter().withSentAddress(address))
+        val incoming = client.transactions(TransactionsFilter().withRecvAddress(address))
 
         println("Transactions for ${address.toHex()}")
 

bindings/kotlin/examples/PackageInspect.kt

@@ -248,7 +248,7 @@ private fun extractPolicy(contents: Value): Int? =
 private suspend fun resolveUpgradeCapId(client: GraphQlClient, packageId: ObjectId): ObjectId? {
     val page =
         client.transactionsEffects(
-            TransactionsFilter(changedObject = packageId),
+            TransactionsFilter().withChangedObject(packageId),
             PaginationFilter(direction = Direction.FORWARD, limit = 1),
         )
 
@@ -368,7 +368,7 @@ private suspend fun wasPackagePublishedAsImmutable(
     while (true) {
         val page =
             client.transactionsDataEffects(
-                TransactionsFilter(changedObject = packageId),
+                TransactionsFilter().withChangedObject(packageId),
                 forwardPage(cursor),
             )
 
@@ -395,7 +395,7 @@ private suspend fun wasUpgradeCapUsedForMakeImmutable(
     while (true) {
         val page =
             client.transactionsDataEffects(
-                TransactionsFilter(inputObject = upgradeCapId),
+                TransactionsFilter().withInputObject(upgradeCapId),
                 forwardPage(cursor),
             )
 

bindings/kotlin/examples/TransactionsWithFunction.kt

@@ -10,7 +10,7 @@ fun main() = runBlocking {
         val client = GraphQlClient.newTestnet()
         val transactions =
             client.transactions(
-                TransactionsFilter(function = "0x3::iota_system::request_add_stake")
+                TransactionsFilter().withFunction("0x3::iota_system::request_add_stake")
             )
         for (transaction in transactions.data) {
             println("Digest: ${transaction.transaction.digest().toBase58()}")

bindings/kotlin/examples/TransactionsWithShared.kt

@@ -12,7 +12,7 @@ fun main() = runBlocking {
 
         val sharedObjId =
             ObjectId.fromHex("0x7cab491740d51e0d75b26bf9984e49ba2e32a2d0694cabcee605543ed13c7dec")
-        val transactions = client.transactions(TransactionsFilter(inputObject = sharedObjId))
+        val transactions = client.transactions(TransactionsFilter().withInputObject(sharedObjId))
 
         for (transaction in transactions.data) {
             println("Digest: ${transaction.transaction.digest().toBase58()}")

bindings/python/examples/address_transactions.py

@@ -18,9 +18,9 @@ async def main():
         "0xa7c2cf9d8f8d95ff69d7a598c49c77acc36253f496f064a533ad306879b40bfa")
 
     outgoing = await client.transactions(
-        TransactionsFilter(sent_address=address))
+        TransactionsFilter().with_sent_address(address))
     incoming = await client.transactions(
-        TransactionsFilter(recv_address=address))
+        TransactionsFilter().with_recv_address(address))
 
     print(f"Transactions for {address.to_hex()}")
 

bindings/python/examples/package_inspect.py

@@ -223,7 +223,7 @@ def extract_policy(contents):
 
 async def resolve_upgrade_cap_id(client, package_id):
     page = await client.transactions_effects(
-        TransactionsFilter(changed_object=package_id),
+        TransactionsFilter().with_changed_object(package_id),
         PaginationFilter(direction=Direction.FORWARD, limit=1),
     )
 
@@ -343,7 +343,7 @@ async def was_package_published_as_immutable(client, package_id):
 
     while True:
         page = await client.transactions_data_effects(
-            TransactionsFilter(changed_object=package_id),
+            TransactionsFilter().with_changed_object(package_id),
             forward_page(cursor),
         )
 
@@ -363,7 +363,7 @@ async def was_upgrade_cap_used_for_make_immutable(client, upgrade_cap_id):
 
     while True:
         page = await client.transactions_data_effects(
-            TransactionsFilter(input_object=upgrade_cap_id),
+            TransactionsFilter().with_input_object(upgrade_cap_id),
             forward_page(cursor),
         )
 

bindings/python/examples/transactions_with_function.py

@@ -9,7 +9,8 @@
 async def main():
     client = GraphQlClient.new_testnet()
     transactions = await client.transactions(
-        TransactionsFilter(function="0x3::iota_system::request_add_stake"),)
+        TransactionsFilter().with_function(
+            "0x3::iota_system::request_add_stake"),)
     for transaction in transactions.data:
         print("Digest:", transaction.transaction.digest().to_base58())
 

bindings/python/examples/transactions_with_shared.py

@@ -13,7 +13,7 @@ async def main():
         "0x7cab491740d51e0d75b26bf9984e49ba2e32a2d0694cabcee605543ed13c7dec")
 
     transactions = await client.transactions(
-        TransactionsFilter(input_object=shared_obj_id),)
+        TransactionsFilter().with_input_object(shared_obj_id),)
 
     for transaction in transactions.data:
         print("Digest:", transaction.transaction.digest().to_base58())

bindings/swift/examples/AddressTransactions.swift

@@ -17,9 +17,9 @@ struct AddressTransactionsExample {
       hex: "0xa7c2cf9d8f8d95ff69d7a598c49c77acc36253f496f064a533ad306879b40bfa")
 
     let outgoing = try await client.transactions(
-      filter: TransactionsFilter(sentAddress: address))
+      filter: TransactionsFilter().withSentAddress(sentAddress: address))
     let incoming = try await client.transactions(
-      filter: TransactionsFilter(recvAddress: address))
+      filter: TransactionsFilter().withRecvAddress(recvAddress: address))
 
     print("Transactions for \(address.toHex())")
 

bindings/swift/examples/PackageInspect.swift

@@ -277,7 +277,7 @@ private func resolveUpgradeCapId(
   packageId: ObjectId
 ) async throws -> ObjectId? {
   let page = try await client.transactionsEffects(
-    filter: TransactionsFilter(changedObject: packageId),
+    filter: TransactionsFilter().withChangedObject(changedObject: packageId),
     paginationFilter: PaginationFilter(direction: .forward, limit: 1)
   )
 
@@ -421,7 +421,7 @@ private func wasPackagePublishedAsImmutable(
 
   while true {
     let page = try await client.transactionsDataEffects(
-      filter: TransactionsFilter(changedObject: packageId),
+      filter: TransactionsFilter().withChangedObject(changedObject: packageId),
       paginationFilter: forwardPage(cursor: cursor)
     )
 
@@ -447,7 +447,7 @@ private func wasUpgradeCapUsedForMakeImmutable(
 
   while true {
     let page = try await client.transactionsDataEffects(
-      filter: TransactionsFilter(inputObject: upgradeCapId),
+      filter: TransactionsFilter().withInputObject(inputObject: upgradeCapId),
       paginationFilter: forwardPage(cursor: cursor)
     )
 

bindings/swift/examples/TransactionsWithFunction.swift

@@ -8,7 +8,7 @@ struct TransactionsWithFunctionExample {
   static func main() async throws {
     let client = GraphQlClient.newTestnet()
     let transactions = try await client.transactions(
-      filter: TransactionsFilter(function: "0x3::iota_system::request_add_stake"))
+      filter: TransactionsFilter().withFunction(function: "0x3::iota_system::request_add_stake"))
     for transaction in transactions.data {
       print("Digest:", transaction.transaction.digest().toBase58())
     }

bindings/swift/examples/TransactionsWithShared.swift

@@ -12,7 +12,7 @@ struct TransactionsWithSharedExample {
       hex: "0x7cab491740d51e0d75b26bf9984e49ba2e32a2d0694cabcee605543ed13c7dec")
 
     let transactions = try await client.transactions(
-      filter: TransactionsFilter(inputObject: sharedObjId))
+      filter: TransactionsFilter().withInputObject(inputObject: sharedObjId))
 
     for transaction in transactions.data {
       print("Digest:", transaction.transaction.digest().toBase58())

bindings/wasm/examples/address_transactions.mjs

@@ -22,10 +22,10 @@ const address = Address.fromHex(
 );
 
 const outgoing = await client.transactions(
-  TransactionsFilter.new({ sentAddress: address }),
+  new TransactionsFilter().withSentAddress(address),
 );
 const incoming = await client.transactions(
-  TransactionsFilter.new({ recvAddress: address }),
+  new TransactionsFilter().withRecvAddress(address),
 );
 
 console.log(`Transactions for ${address.toHex()}`);

bindings/wasm/examples/package_inspect.mjs

@@ -125,7 +125,7 @@ function extractPolicy(contents) {
 
 async function resolveUpgradeCapId(client, packageId) {
   const page = await client.transactionsEffects(
-    TransactionsFilter.new({ changedObject: packageId }),
+    new TransactionsFilter().withChangedObject(packageId),
     PaginationFilter.new({ direction: Direction.Forward, limit: 1 }),
   );
   for (const effects of page.data) {
@@ -246,7 +246,7 @@ async function wasPackagePublishedAsImmutable(client, packageId) {
   let cursor = undefined;
   while (true) {
     const page = await client.transactionsDataEffects(
-      TransactionsFilter.new({ changedObject: packageId }),
+      new TransactionsFilter().withChangedObject(packageId),
       forwardPage(cursor),
     );
     for (const txData of page.data) {
@@ -262,7 +262,7 @@ async function wasUpgradeCapUsedForMakeImmutable(client, upgradeCapId) {
   let cursor = undefined;
   while (true) {
     const page = await client.transactionsDataEffects(
-      TransactionsFilter.new({ inputObject: upgradeCapId }),
+      new TransactionsFilter().withInputObject(upgradeCapId),
       forwardPage(cursor),
     );
     for (const txData of page.data) {

bindings/wasm/examples/transactions_with_function.mjs

@@ -7,7 +7,7 @@ await initAsync();
 
 const client = GraphQlClient.newTestnet();
 const transactions = await client.transactions(
-  TransactionsFilter.new({ function: "0x3::iota_system::request_add_stake" }),
+  new TransactionsFilter().withFunction("0x3::iota_system::request_add_stake"),
 );
 for (const transaction of transactions.data) {
   console.log("Digest:", transaction.transaction.digest().toBase58());

bindings/wasm/examples/transactions_with_shared.mjs

@@ -17,7 +17,7 @@ const sharedObjId = ObjectId.fromHex(
 );
 
 const transactions = await client.transactions(
-  TransactionsFilter.new({ inputObject: sharedObjId }),
+  new TransactionsFilter().withInputObject(sharedObjId),
 );
 
 for (const transaction of transactions.data) {