feat(iota-sdk-ffi): Add from/to_bcs methods to all FFI exposed core types

crates/iota-sdk-ffi/Cargo.toml

@@ -18,6 +18,7 @@ base64ct = { version = "1.6.0", features = ["alloc", "std"] }
 bcs = "0.1.6"
 derive_more = { version = "2.0", features = ["from", "deref", "display"] }
 hex = "0.4.3"
+paste = "1.0"
 primitive-types = { version = "0.14", features = ["impl-serde"] }
 rand = "0.8"
 roaring = { version = "0.11.2", default-features = false }

crates/iota-sdk-ffi/src/lib.rs

@@ -137,3 +137,43 @@ pub fn hex_encode(input: &[u8]) -> String {
 pub fn hex_decode(input: String) -> crate::error::Result<Vec<u8>> {
     Ok(hex::decode(input)?)
 }
+
+#[macro_export]
+macro_rules! export_record_enum_bcs_conversion {
+    ($($name:ident),+ $(,)?) => {
+        paste::paste! {$(
+            /// Create `$name` from BCS encoded bytes.
+            #[uniffi::export]
+            pub fn [< $name:snake _from_bcs >](bcs: Vec<u8>) -> crate::error::Result<$name> {
+                let data = bcs::from_bytes::<iota_types::$name>(&bcs)?;
+                Ok(data.into())
+            }
+
+            /// Convert `$name` to BCS encoded bytes.
+            #[uniffi::export]
+            pub fn [< $name:snake _to_bcs >](data: $name) -> crate::error::Result<Vec<u8>> {
+                let data: iota_types::$name = data.into();
+                Ok(bcs::to_bytes(&data)?)
+            }
+        )+}
+    }
+}
+
+#[macro_export]
+macro_rules! export_object_bcs_conversion {
+    ($($name:ident),+ $(,)?) => {$(
+        #[uniffi::export]
+        impl $name {
+            /// Create this type from BCS encoded bytes.
+            #[uniffi::constructor]
+            pub fn from_bcs(bcs: Vec<u8>) -> crate::error::Result<Self> {
+                Ok(Self(bcs::from_bytes::<iota_types::$name>(&bcs)?))
+            }
+
+            /// Convert this type to BCS encoded bytes.
+            pub fn to_bcs(&self) -> crate::error::Result<Vec<u8>> {
+                Ok(bcs::to_bytes(&self.0)?)
+            }
+        }
+    )+}
+}

crates/iota-sdk-ffi/src/types/address.rs

@@ -1,7 +1,12 @@
 // Copyright (c) 2025 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
-use crate::error::Result;
+use base64ct::Encoding;
+
+use crate::{
+    base64_encode,
+    error::{Result, SdkFfiError},
+};
 
 /// Unique identifier for an Account on the IOTA blockchain.
 ///
@@ -71,6 +76,11 @@ impl Address {
         Ok(Self(iota_types::Address::from_hex(hex)?))
     }
 
+    #[uniffi::constructor]
+    pub fn from_bcs(bcs: Vec<u8>) -> Result<Self> {
+        Ok(Self(bcs::from_bytes::<iota_types::Address>(&bcs)?))
+    }
+
     #[uniffi::constructor]
     pub fn generate() -> Self {
         let mut rng = rand::thread_rng();
@@ -84,4 +94,8 @@ impl Address {
     pub fn to_hex(&self) -> String {
         self.0.to_hex()
     }
+
+    pub fn to_bcs(&self) -> Result<Vec<u8>> {
+        Ok(bcs::to_bytes(&self.0)?)
+    }
 }

crates/iota-sdk-ffi/src/types/checkpoint.rs

@@ -5,7 +5,11 @@ use std::sync::Arc;
 
 use iota_types::GasCostSummary;
 
-use crate::types::{digest::Digest, signature::UserSignature, validator::ValidatorCommitteeMember};
+use crate::{
+    error::Result,
+    export_object_bcs_conversion, export_record_enum_bcs_conversion,
+    types::{digest::Digest, signature::UserSignature, validator::ValidatorCommitteeMember},
+};
 
 pub type CheckpointSequenceNumber = u64;
 pub type CheckpointTimestamp = u64;
@@ -272,6 +276,18 @@ impl CheckpointCommitment {
     }
 }
 
+/// Data, which when included in a [`CheckpointSummary`], signals the end of an
+/// `Epoch`.
+///
+/// # BCS
+///
+/// The BCS serialized form for this type is defined by the following ABNF:
+///
+/// ```text
+/// end-of-epoch-data = (vector validator-committee-member) ; next_epoch_committee
+///                     u64                                 ; next_epoch_protocol_version
+///                     (vector checkpoint-commitment)      ; epoch_commitments
+/// ```
 #[derive(uniffi::Record)]
 pub struct EndOfEpochData {
     pub next_epoch_committee: Vec<ValidatorCommitteeMember>,
@@ -318,3 +334,12 @@ impl From<EndOfEpochData> for iota_types::EndOfEpochData {
         }
     }
 }
+
+export_object_bcs_conversion!(
+    CheckpointSummary,
+    CheckpointContents,
+    CheckpointTransactionInfo,
+    CheckpointCommitment
+);
+
+export_record_enum_bcs_conversion!(EndOfEpochData);

crates/iota-sdk-ffi/src/types/crypto/mod.rs

@@ -11,6 +11,7 @@ use iota_types::SignatureScheme;
 
 use crate::{
     error::Result,
+    export_object_bcs_conversion,
     types::{address::Address, signature::SimpleSignature},
 };
 
@@ -210,3 +211,14 @@ impl_crypto_object!(
     /// ```
     Secp256r1Signature
 );
+
+export_object_bcs_conversion!(
+    Ed25519PublicKey,
+    Bls12381PublicKey,
+    Secp256k1PublicKey,
+    Secp256r1PublicKey,
+    Ed25519Signature,
+    Bls12381Signature,
+    Secp256k1Signature,
+    Secp256r1Signature,
+);

crates/iota-sdk-ffi/src/types/crypto/multisig.rs

@@ -5,12 +5,15 @@ use std::sync::Arc;
 
 use iota_types::SignatureScheme;
 
-use crate::types::{
-    address::Address,
-    crypto::{
-        Ed25519PublicKey, Ed25519Signature, Secp256k1PublicKey, Secp256k1Signature,
-        Secp256r1PublicKey, Secp256r1Signature,
-        zklogin::{ZkLoginAuthenticator, ZkLoginPublicIdentifier},
+use crate::{
+    export_object_bcs_conversion,
+    types::{
+        address::Address,
+        crypto::{
+            Ed25519PublicKey, Ed25519Signature, Secp256k1PublicKey, Secp256k1Signature,
+            Secp256r1PublicKey, Secp256r1Signature,
+            zklogin::{ZkLoginAuthenticator, ZkLoginPublicIdentifier},
+        },
     },
 };
 
@@ -410,3 +413,11 @@ impl MultisigMember {
         self.0.weight()
     }
 }
+
+export_object_bcs_conversion!(
+    MultisigMemberSignature,
+    MultisigMemberPublicKey,
+    MultisigAggregatedSignature,
+    MultisigCommittee,
+    MultisigMember
+);

crates/iota-sdk-ffi/src/types/crypto/passkey.rs

@@ -7,6 +7,7 @@ use iota_crypto::Verifier;
 
 use crate::{
     error::Result,
+    export_object_bcs_conversion,
     types::{address::Address, crypto::Secp256r1PublicKey, signature::SimpleSignature},
 };
 
@@ -113,3 +114,5 @@ impl PasskeyPublicKey {
         self.0.derive_address().into()
     }
 }
+
+export_object_bcs_conversion!(PasskeyAuthenticator);

crates/iota-sdk-ffi/src/types/crypto/zklogin.rs

@@ -7,6 +7,7 @@ use iota_types::{Jwk, JwkId, ZkLoginClaim};
 
 use crate::{
     error::{Result, SdkFfiError},
+    export_object_bcs_conversion, export_record_enum_bcs_conversion,
     types::{address::Address, signature::SimpleSignature},
 };
 
@@ -430,3 +431,14 @@ pub struct Jwk {
     /// Algorithm parameter, <https://datatracker.ietf.org/doc/html/rfc7517#section-4.4>
     pub alg: String,
 }
+
+export_object_bcs_conversion!(
+    ZkLoginAuthenticator,
+    ZkLoginPublicIdentifier,
+    ZkLoginProof,
+    CircomG1,
+    CircomG2,
+    Bn254FieldElement
+);
+
+export_record_enum_bcs_conversion!(ZkLoginClaim, JwkId, Jwk);

crates/iota-sdk-ffi/src/types/digest.rs

@@ -1,7 +1,7 @@
 // Copyright (c) 2025 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
-use crate::error::Result;
+use crate::{error::Result, export_object_bcs_conversion};
 
 /// A 32-byte Blake2b256 hash output.
 ///
@@ -46,3 +46,5 @@ impl Digest {
         self.0.to_base58()
     }
 }
+
+export_object_bcs_conversion!(Digest);

crates/iota-sdk-ffi/src/types/events.rs

@@ -9,7 +9,11 @@ use iota_graphql_client::query_types::{
 };
 use iota_types::{Identifier, StructTag};
 
-use crate::types::{address::Address, digest::Digest, object::ObjectId};
+use crate::{
+    error::Result,
+    export_object_bcs_conversion, export_record_enum_bcs_conversion,
+    types::{address::Address, digest::Digest, object::ObjectId},
+};
 
 /// An event
 ///
@@ -141,3 +145,6 @@ impl TransactionEvents {
         self.0.digest().into()
     }
 }
+
+export_record_enum_bcs_conversion!(Event);
+export_object_bcs_conversion!(TransactionEvents);

crates/iota-sdk-ffi/src/types/execution_status.rs

@@ -5,7 +5,11 @@ use std::sync::Arc;
 
 use iota_types::{CommandArgumentError, Identifier, TypeArgumentError};
 
-use crate::types::{address::Address, digest::Digest, object::ObjectId};
+use crate::{
+    error::Result,
+    export_record_enum_bcs_conversion,
+    types::{address::Address, digest::Digest, object::ObjectId},
+};
 
 /// The status of an executed Transaction
 ///
@@ -756,3 +760,12 @@ pub enum TypeArgumentError {
     /// A type provided did not match the specified constraint
     ConstraintNotSatisfied,
 }
+
+export_record_enum_bcs_conversion!(
+    ExecutionStatus,
+    ExecutionError,
+    MoveLocation,
+    CommandArgumentError,
+    PackageUpgradeError,
+    TypeArgumentError
+);

crates/iota-sdk-ffi/src/types/gas.rs

@@ -3,6 +3,8 @@
 
 use iota_types::GasCostSummary;
 
+use crate::export_record_enum_bcs_conversion;
+
 /// Summary of gas charges.
 ///
 /// Storage is charged independently of computation.
@@ -55,3 +57,5 @@ pub struct GasCostSummary {
     /// system.
     pub non_refundable_storage_fee: u64,
 }
+
+export_record_enum_bcs_conversion!(GasCostSummary);

crates/iota-sdk-ffi/src/types/object.rs

@@ -11,6 +11,7 @@ pub type Version = iota_types::Version;
 
 use crate::{
     error::Result,
+    export_object_bcs_conversion, export_record_enum_bcs_conversion,
     types::{
         address::Address,
         digest::Digest,
@@ -636,3 +637,13 @@ impl GenesisObject {
         self.0.data().clone().into()
     }
 }
+
+export_record_enum_bcs_conversion!(ObjectReference, TypeOrigin, UpgradeInfo, MoveStruct);
+export_object_bcs_conversion!(
+    ObjectId,
+    Object,
+    ObjectData,
+    MovePackage,
+    Owner,
+    GenesisObject
+);

crates/iota-sdk-ffi/src/types/signature.rs

@@ -7,6 +7,7 @@ use iota_types::{SignatureScheme, ZkLoginClaim};
 
 use crate::{
     error::Result,
+    export_object_bcs_conversion, export_record_enum_bcs_conversion,
     types::crypto::{
         Ed25519PublicKey, Ed25519Signature, Secp256k1PublicKey, Secp256k1Signature,
         Secp256r1PublicKey, Secp256r1Signature, multisig::MultisigAggregatedSignature,
@@ -319,3 +320,5 @@ impl SimpleSignature {
         (*self.0.as_secp256r1_pub_key()).into()
     }
 }
+
+export_object_bcs_conversion!(UserSignature, SimpleSignature);

crates/iota-sdk-ffi/src/types/struct_tag.rs

@@ -5,6 +5,7 @@ use std::sync::Arc;
 
 use crate::{
     error::Result,
+    export_object_bcs_conversion,
     types::{address::Address, type_tag::TypeTag},
 };
 
@@ -106,3 +107,5 @@ impl StructTag {
         self.0.address().into()
     }
 }
+
+export_object_bcs_conversion!(Identifier, StructTag);