feat(transaction-builder): Add high level stake and unstake fns

bindings/go/examples/stake/main.go

@@ -34,28 +34,9 @@ func main() {
 
 	coinObjId, _ := sdk.ObjectIdFromHex("0xd04077fe3b6fad13b3d4ed0d535b7ca92afcac8f0f2a0e0925fb9f4f0b30c699")
 
-	iotaSystemAddress := sdk.AddressSystem()
-
-	iotaSystemId := sdk.ObjectIdSystem()
-
-	iotaSystemModule, _ := sdk.NewIdentifier("iota_system")
-
-	requestAddStakeFn, _ := sdk.NewIdentifier("request_add_stake")
-
 	builder := sdk.TransactionBuilderInit(myAddress, client)
 
-	builder.MoveCall(
-		iotaSystemAddress,
-		iotaSystemModule,
-		requestAddStakeFn,
-		[]*sdk.PtbArgument{
-			sdk.PtbArgumentSharedMut(iotaSystemId),
-			sdk.PtbArgumentObjectId(coinObjId),
-			sdk.PtbArgumentAddress(validator.Address),
-		},
-		nil,
-		nil,
-	)
+	builder.Stake(sdk.PtbArgumentObjectId(coinObjId), validator.Address)
 
 	res, err := builder.DryRun(false)
 	if err.(*sdk.SdkFfiError) != nil {

bindings/go/examples/unstake/main.go

@@ -22,23 +22,8 @@ func main() {
 	}
 	stakedIota := stakedIotas.Data[0]
 
-	iotaSystemAddress := sdk.AddressSystem()
-
-	iotaSystemId := sdk.ObjectIdSystem()
-
-	iotaSystemModule, _ := sdk.NewIdentifier("iota_system")
-
-	requestAddStakeFn, _ := sdk.NewIdentifier("request_withdraw_stake")
-
 	builder := sdk.TransactionBuilderInit(stakedIota.Owner().AsAddress(), client)
-	builder.MoveCall(
-		iotaSystemAddress,
-		iotaSystemModule,
-		requestAddStakeFn,
-		[]*sdk.PtbArgument{sdk.PtbArgumentSharedMut(iotaSystemId), sdk.PtbArgumentObjectId(stakedIota.ObjectId())},
-		nil,
-		nil,
-	)
+	builder.Unstake(sdk.PtbArgumentObjectId(stakedIota.ObjectId()))
 
 	res, err := builder.DryRun(false)
 	if err.(*sdk.SdkFfiError) != nil {

bindings/go/iota_sdk_ffi/iota_sdk_ffi.go

@@ -5813,6 +5813,15 @@ func uniffiCheckChecksums() {
 	}
 	}
 	{
+	checksum := rustCall(func(_uniffiStatus *C.RustCallStatus) C.uint16_t {
+		return C.uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_stake()
+	})
+	if checksum != 55725 {
+		// If this happens try cleaning and rebuilding your project
+		panic("iota_sdk_ffi: uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_stake: UniFFI API checksum mismatch")
+	}
+	}
+	{
 	checksum := rustCall(func(_uniffiStatus *C.RustCallStatus) C.uint16_t {
 		return C.uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_transfer_objects()
 	})
@@ -5822,6 +5831,15 @@ func uniffiCheckChecksums() {
 	}
 	}
 	{
+	checksum := rustCall(func(_uniffiStatus *C.RustCallStatus) C.uint16_t {
+		return C.uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_unstake()
+	})
+	if checksum != 65513 {
+		// If this happens try cleaning and rebuilding your project
+		panic("iota_sdk_ffi: uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_unstake: UniFFI API checksum mismatch")
+	}
+	}
+	{
 	checksum := rustCall(func(_uniffiStatus *C.RustCallStatus) C.uint16_t {
 		return C.uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_upgrade()
 	})
@@ -24248,9 +24266,13 @@ type TransactionBuilderInterface interface {
 	SplitCoins(coin *PtbArgument, amounts []*PtbArgument, names []string) *TransactionBuilder
 	// Set the sponsor of the transaction.
 	Sponsor(sponsor *Address) *TransactionBuilder
+	// Stake IOTA coins to a validator.
+	Stake(stake *PtbArgument, validatorAddress *Address) *TransactionBuilder
 	// Transfer a list of objects to the given address, without producing any
 	// result.
 	TransferObjects(recipient *Address, objects []*PtbArgument) *TransactionBuilder
+	// Unstake IOTA coins from their assigned validator.
+	Unstake(stakedIota *PtbArgument) *TransactionBuilder
 	// Upgrade a Move package.
 	//
 	// - `modules`: is the modules' bytecode for the modules to be published
@@ -24589,6 +24611,16 @@ func (_self *TransactionBuilder) Sponsor(sponsor *Address) *TransactionBuilder {
 	}))
 }
 
+// Stake IOTA coins to a validator.
+func (_self *TransactionBuilder) Stake(stake *PtbArgument, validatorAddress *Address) *TransactionBuilder {
+	_pointer := _self.ffiObject.incrementPointer("*TransactionBuilder")
+	defer _self.ffiObject.decrementPointer()
+	return FfiConverterTransactionBuilderINSTANCE.Lift(rustCall(func(_uniffiStatus *C.RustCallStatus) unsafe.Pointer {
+		return C.uniffi_iota_sdk_ffi_fn_method_transactionbuilder_stake(
+		_pointer,FfiConverterPtbArgumentINSTANCE.Lower(stake), FfiConverterAddressINSTANCE.Lower(validatorAddress),_uniffiStatus)
+	}))
+}
+
 // Transfer a list of objects to the given address, without producing any
 // result.
 func (_self *TransactionBuilder) TransferObjects(recipient *Address, objects []*PtbArgument) *TransactionBuilder {
@@ -24600,6 +24632,16 @@ func (_self *TransactionBuilder) TransferObjects(recipient *Address, objects []*
 	}))
 }
 
+// Unstake IOTA coins from their assigned validator.
+func (_self *TransactionBuilder) Unstake(stakedIota *PtbArgument) *TransactionBuilder {
+	_pointer := _self.ffiObject.incrementPointer("*TransactionBuilder")
+	defer _self.ffiObject.decrementPointer()
+	return FfiConverterTransactionBuilderINSTANCE.Lift(rustCall(func(_uniffiStatus *C.RustCallStatus) unsafe.Pointer {
+		return C.uniffi_iota_sdk_ffi_fn_method_transactionbuilder_unstake(
+		_pointer,FfiConverterPtbArgumentINSTANCE.Lower(stakedIota),_uniffiStatus)
+	}))
+}
+
 // Upgrade a Move package.
 //
 // - `modules`: is the modules' bytecode for the modules to be published

bindings/go/iota_sdk_ffi/iota_sdk_ffi.h

@@ -4374,11 +4374,21 @@ void* uniffi_iota_sdk_ffi_fn_method_transactionbuilder_split_coins(void* ptr, vo
 void* uniffi_iota_sdk_ffi_fn_method_transactionbuilder_sponsor(void* ptr, void* sponsor, RustCallStatus *out_status
 );
 #endif
+#ifndef UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_FN_METHOD_TRANSACTIONBUILDER_STAKE
+#define UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_FN_METHOD_TRANSACTIONBUILDER_STAKE
+void* uniffi_iota_sdk_ffi_fn_method_transactionbuilder_stake(void* ptr, void* stake, void* validator_address, RustCallStatus *out_status
+);
+#endif
 #ifndef UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_FN_METHOD_TRANSACTIONBUILDER_TRANSFER_OBJECTS
 #define UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_FN_METHOD_TRANSACTIONBUILDER_TRANSFER_OBJECTS
 void* uniffi_iota_sdk_ffi_fn_method_transactionbuilder_transfer_objects(void* ptr, void* recipient, RustBuffer objects, RustCallStatus *out_status
 );
 #endif
+#ifndef UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_FN_METHOD_TRANSACTIONBUILDER_UNSTAKE
+#define UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_FN_METHOD_TRANSACTIONBUILDER_UNSTAKE
+void* uniffi_iota_sdk_ffi_fn_method_transactionbuilder_unstake(void* ptr, void* staked_iota, RustCallStatus *out_status
+);
+#endif
 #ifndef UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_FN_METHOD_TRANSACTIONBUILDER_UPGRADE
 #define UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_FN_METHOD_TRANSACTIONBUILDER_UPGRADE
 void* uniffi_iota_sdk_ffi_fn_method_transactionbuilder_upgrade(void* ptr, void* package_data, void* package, void* ticket, RustBuffer name, RustCallStatus *out_status
@@ -10318,12 +10328,24 @@ uint16_t uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_split_coins(void
 #define UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_CHECKSUM_METHOD_TRANSACTIONBUILDER_SPONSOR
 uint16_t uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_sponsor(void
 
+);
+#endif
+#ifndef UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_CHECKSUM_METHOD_TRANSACTIONBUILDER_STAKE
+#define UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_CHECKSUM_METHOD_TRANSACTIONBUILDER_STAKE
+uint16_t uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_stake(void
+
 );
 #endif
 #ifndef UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_CHECKSUM_METHOD_TRANSACTIONBUILDER_TRANSFER_OBJECTS
 #define UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_CHECKSUM_METHOD_TRANSACTIONBUILDER_TRANSFER_OBJECTS
 uint16_t uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_transfer_objects(void
 
+);
+#endif
+#ifndef UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_CHECKSUM_METHOD_TRANSACTIONBUILDER_UNSTAKE
+#define UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_CHECKSUM_METHOD_TRANSACTIONBUILDER_UNSTAKE
+uint16_t uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_unstake(void
+
 );
 #endif
 #ifndef UNIFFI_FFIDEF_UNIFFI_IOTA_SDK_FFI_CHECKSUM_METHOD_TRANSACTIONBUILDER_UPGRADE

bindings/kotlin/examples/Stake.kt

@@ -3,7 +3,6 @@
 
 import iota_sdk.Address
 import iota_sdk.GraphQlClient
-import iota_sdk.Identifier
 import iota_sdk.ObjectId
 import iota_sdk.PtbArgument
 import iota_sdk.TransactionBuilder
@@ -33,16 +32,7 @@ fun main() = runBlocking {
 
         val builder = TransactionBuilder.init(myAddress, client)
 
-        builder.moveCall(
-                Address.system(),
-                Identifier("iota_system"),
-                Identifier("request_add_stake"),
-                listOf(
-                        PtbArgument.sharedMut(ObjectId.system()),
-                        PtbArgument.objectId(coinId),
-                        PtbArgument.address(validator.address)
-                ),
-        )
+        builder.stake(PtbArgument.objectId(coinId), validator.address)
 
         val res = builder.dryRun()
 

bindings/kotlin/examples/Unstake.kt

@@ -1,11 +1,8 @@
 // Copyright (c) 2025 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
-import iota_sdk.Address
 import iota_sdk.GraphQlClient
-import iota_sdk.Identifier
 import iota_sdk.ObjectFilter
-import iota_sdk.ObjectId
 import iota_sdk.PtbArgument
 import iota_sdk.TransactionBuilder
 import kotlinx.coroutines.runBlocking
@@ -22,15 +19,7 @@ fun main() = runBlocking {
 
         val builder = TransactionBuilder.init(stakedIota.owner().asAddress(), client)
 
-        builder.moveCall(
-                Address.system(),
-                Identifier("iota_system"),
-                Identifier("request_withdraw_stake"),
-                listOf(
-                        PtbArgument.sharedMut(ObjectId.system()),
-                        PtbArgument.objectId(stakedIota.objectId())
-                ),
-        )
+        builder.unstake(PtbArgument.objectId(stakedIota.objectId()))
 
         val res = builder.dryRun()
 

bindings/kotlin/lib/iota_sdk/iota_sdk_ffi.kt

@@ -2885,6 +2885,10 @@ internal interface UniffiForeignFutureCompleteVoid : com.sun.jna.Callback {
 
 
 
+
+
+
+
 
 
 
@@ -4117,8 +4121,12 @@ fun uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_split_coins(
 ): Short
 fun uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_sponsor(
 ): Short
+fun uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_stake(
+): Short
 fun uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_transfer_objects(
 ): Short
+fun uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_unstake(
+): Short
 fun uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_upgrade(
 ): Short
 fun uniffi_iota_sdk_ffi_checksum_method_transactioneffects_as_v1(
@@ -6490,8 +6498,12 @@ fun uniffi_iota_sdk_ffi_fn_method_transactionbuilder_split_coins(`ptr`: Pointer,
 ): Pointer
 fun uniffi_iota_sdk_ffi_fn_method_transactionbuilder_sponsor(`ptr`: Pointer,`sponsor`: Pointer,uniffi_out_err: UniffiRustCallStatus, 
 ): Pointer
+fun uniffi_iota_sdk_ffi_fn_method_transactionbuilder_stake(`ptr`: Pointer,`stake`: Pointer,`validatorAddress`: Pointer,uniffi_out_err: UniffiRustCallStatus, 
+): Pointer
 fun uniffi_iota_sdk_ffi_fn_method_transactionbuilder_transfer_objects(`ptr`: Pointer,`recipient`: Pointer,`objects`: RustBuffer.ByValue,uniffi_out_err: UniffiRustCallStatus, 
 ): Pointer
+fun uniffi_iota_sdk_ffi_fn_method_transactionbuilder_unstake(`ptr`: Pointer,`stakedIota`: Pointer,uniffi_out_err: UniffiRustCallStatus, 
+): Pointer
 fun uniffi_iota_sdk_ffi_fn_method_transactionbuilder_upgrade(`ptr`: Pointer,`packageData`: Pointer,`package`: Pointer,`ticket`: Pointer,`name`: RustBuffer.ByValue,uniffi_out_err: UniffiRustCallStatus, 
 ): Pointer
 fun uniffi_iota_sdk_ffi_fn_clone_transactioneffects(`ptr`: Pointer,uniffi_out_err: UniffiRustCallStatus, 
@@ -9240,9 +9252,15 @@ private fun uniffiCheckApiChecksums(lib: IntegrityCheckingUniffiLib) {
     if (lib.uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_sponsor() != 25655.toShort()) {
         throw RuntimeException("UniFFI API checksum mismatch: try cleaning and rebuilding your project")
     }
+    if (lib.uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_stake() != 55725.toShort()) {
+        throw RuntimeException("UniFFI API checksum mismatch: try cleaning and rebuilding your project")
+    }
     if (lib.uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_transfer_objects() != 16313.toShort()) {
         throw RuntimeException("UniFFI API checksum mismatch: try cleaning and rebuilding your project")
     }
+    if (lib.uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_unstake() != 65513.toShort()) {
+        throw RuntimeException("UniFFI API checksum mismatch: try cleaning and rebuilding your project")
+    }
     if (lib.uniffi_iota_sdk_ffi_checksum_method_transactionbuilder_upgrade() != 3616.toShort()) {
         throw RuntimeException("UniFFI API checksum mismatch: try cleaning and rebuilding your project")
     }
@@ -40794,12 +40812,22 @@ public interface TransactionBuilderInterface {
      */
     fun `sponsor`(`sponsor`: Address): TransactionBuilder
 
+    /**
+     * Stake IOTA coins to a validator.
+     */
+    fun `stake`(`stake`: PtbArgument, `validatorAddress`: Address): TransactionBuilder
+
     /**
      * Transfer a list of objects to the given address, without producing any
      * result.
      */
     fun `transferObjects`(`recipient`: Address, `objects`: List<PtbArgument>): TransactionBuilder
 
+    /**
+     * Unstake IOTA coins from their assigned validator.
+     */
+    fun `unstake`(`stakedIota`: PtbArgument): TransactionBuilder
+
     /**
      * Upgrade a Move package.
      *
@@ -41234,6 +41262,21 @@ open class TransactionBuilder: Disposable, AutoCloseable, TransactionBuilderInte
 
 
 
+    /**
+     * Stake IOTA coins to a validator.
+     */override fun `stake`(`stake`: PtbArgument, `validatorAddress`: Address): TransactionBuilder {
+            return FfiConverterTypeTransactionBuilder.lift(
+    callWithPointer {
+    uniffiRustCall() { _status ->
+    UniffiLib.INSTANCE.uniffi_iota_sdk_ffi_fn_method_transactionbuilder_stake(
+        it, FfiConverterTypePTBArgument.lower(`stake`),FfiConverterTypeAddress.lower(`validatorAddress`),_status)
+}
+    }
+    )
+    }
+
+
+
     /**
      * Transfer a list of objects to the given address, without producing any
      * result.
@@ -41250,6 +41293,21 @@ open class TransactionBuilder: Disposable, AutoCloseable, TransactionBuilderInte
 
 
 
+    /**
+     * Unstake IOTA coins from their assigned validator.
+     */override fun `unstake`(`stakedIota`: PtbArgument): TransactionBuilder {
+            return FfiConverterTypeTransactionBuilder.lift(
+    callWithPointer {
+    uniffiRustCall() { _status ->
+    UniffiLib.INSTANCE.uniffi_iota_sdk_ffi_fn_method_transactionbuilder_unstake(
+        it, FfiConverterTypePTBArgument.lower(`stakedIota`),_status)
+}
+    }
+    )
+    }
+
+
+
     /**
      * Upgrade a Move package.
      *

bindings/python/examples/stake.py

@@ -27,16 +27,7 @@ async def main():
 
         builder = await TransactionBuilder.init(my_address, client)
 
-        builder.move_call(
-            Address.system(),
-            Identifier("iota_system"),
-            Identifier("request_add_stake"),
-            [
-                PtbArgument.shared_mut(ObjectId.system()),
-                PtbArgument.object_id(coin_id),
-                PtbArgument.address(validator.address),
-            ],
-        )
+        builder.stake(PtbArgument.object_id(coin_id), validator.address)
 
         res = await builder.dry_run()
         if res.error is not None:

bindings/python/examples/unstake.py

@@ -21,15 +21,7 @@ async def main():
             staked_iota.owner().as_address(), client
         )
 
-        builder.move_call(
-            Address.system(),
-            Identifier("iota_system"),
-            Identifier("request_withdraw_stake"),
-            [
-                PtbArgument.shared_mut(ObjectId.system()),
-                PtbArgument.object_id(staked_iota.object_id()),
-            ],
-        )
+        builder.unstake(PtbArgument.object_id(staked_iota.object_id()))
 
         res = await builder.dry_run()
         if res.error is not None: