fix: optional timestamp genesis

.github/workflows/android_ci.yml

@@ -0,0 +1,76 @@
+name: Android CI
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  android:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v5
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '21'
+
+      - uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: 1.85.0
+          targets: aarch64-linux-android, arm-linux-androideabi, armv7-linux-androideabi, i686-linux-android, thumbv7neon-linux-androideabi, x86_64-linux-android
+
+      - name: Install Cargo-NDK
+        run: cargo install cargo-ndk@^3.5
+
+      - name: Install Android ndk
+        uses: nttld/setup-ndk@v1
+        with:
+          ndk-version: r27d
+
+      - name: Build AAR
+        run: cargo pkg transact aar
+
+      - name: Host Test
+        working-directory: packages/android/algokit_transact
+        run: ./gradlew test
+
+      - name: Enable KVM
+        run: |
+          echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+          sudo udevadm control --reload-rules
+          sudo udevadm trigger --name-match=kvm
+
+      - name: Install emulator dependencies
+        run: sudo apt-get update && sudo apt-get install -y libx11-xcb1 libglu1-mesa
+
+      - name: Free Disk Space (Ubuntu)
+        uses: AdityaGarg8/remove-unwanted-software@v5
+        with:
+          remove-dotnet: true
+          remove-haskell: true
+          remove-codeql: true
+          remove-docker-images: true
+          remove-large-packages: true
+
+      - name: Android Test
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: 34
+          arch: x86_64
+          script: ./gradlew connectedAndroidTest
+          working-directory: packages/android/algokit_transact
+
+      - name: Archive Build Output
+        uses: actions/upload-artifact@v4
+        if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
+        with:
+          name: algokit_transact.aar
+          path: packages/android/algokit_transact/build/outputs/aar/algokit_transact-release.aar

.gitignore

@@ -1,4 +1,7 @@
 /target
+*.dylib
+*.a
+*.so
 .zed/
 .venv/
 crates/**/dist/
@@ -7,9 +10,18 @@ node_modules/
 .dmypy.json
 .build
 .bin/
+.vscode/
 .DS_Store
+*.idea
 wheelhouse/
 
+# Android/Kotlin
+.gradle/
+build/
+*.iml
+local.properties
+gradle-wrapper.jar
+
 # Insta snapshot testing
 *.snap.new
 *.pending-snap
@@ -22,6 +34,7 @@ AGENTS.md
 .opencode/
 .references/
 .kiro/
+.kotlin/
 
 packages/python/**/*algokit_*.py
 packages/python**/*.dll

Cargo.toml

@@ -23,6 +23,7 @@ snafu = { version = "0.8" }
 base32 = { version = "0.5.1" }
 sha2 = { version = "0.10.8" }
 rstest = { version = "0.25.0" }
+serde_path_to_error = { version = "^0.1" }
 
 [workspace.metadata.bin]
 polytest = { version = "0.3.0", locked = true }

README.md

@@ -30,6 +30,12 @@ The exported interfaces should be purely functional without any state owned by R
 
 ## Contributing
 
+## Build Scripts
+
+`cargo pkg` will run the build script. For example: `cargo pkg transact kt` builds `algokit_transact` for `kotlin`.
+
+The scripts are defined in [tools/build_pkgs] for each language.
+
 ### Learning Resources
 
 If you are new to Rust or UniFFI, check out the [learning resources document](./docs/contributing/learning_resources.md)

api/oas_generator/rust_oas_generator/generator/template_engine.py

@@ -490,6 +490,10 @@ def _generate_base_files(self, context: dict[str, Any], output_dir: Path) -> dic
             files[src_dir / "msgpack_value_bytes.rs"] = self.template_engine.render_template(
                 "base/msgpack_value_bytes.rs.j2", context
             )
+            # Provide msgpack helper to deserialize msgpack strings as raw bytes
+            files[src_dir / "msgpack_string_bytes.rs"] = self.template_engine.render_template(
+                "base/msgpack_string_bytes.rs.j2", context
+            )
 
         return files
 

api/oas_generator/rust_oas_generator/templates/apis/api.rs.j2

@@ -100,7 +100,7 @@ pub async fn {{ operation.rust_function_name }}(
         match content_type {
             ContentType::Json => {
                 let content = resp.text().await?;
-                serde_json::from_str(&content).map_err(Error::from)
+                serde_path_to_error::deserialize(&mut serde_json::Deserializer::from_str(&content)).map_err(Error::from)
             },
             ContentType::Text => Err(Error::from(serde_json::Error::custom("Received `text/plain` content type response that cannot be converted to `{{ get_success_response_type(operation) }}`"))),
             ContentType::Unsupported(unknown_type) => Err(Error::from(serde_json::Error::custom(format!("Received `{unknown_type}` content type response that cannot be converted to `{{ get_success_response_type(operation) }}`")))),

api/oas_generator/rust_oas_generator/templates/apis/endpoint.rs.j2

@@ -208,9 +208,9 @@ pub async fn {{ operation.rust_function_name }}(
         .unwrap_or("application/json");
 
     match ContentType::from(content_type) {
-        ContentType::Json => serde_json::from_slice(&response.body).map_err(|e| Error::Serde { message: e.to_string() }),
+        ContentType::Json => serde_path_to_error::deserialize(&mut serde_json::Deserializer::from_slice(&response.body)).map_err(|e| Error::Serde { message: e.to_string() }),
         {% if operation.supports_msgpack %}
-        ContentType::MsgPack => rmp_serde::from_slice(&response.body).map_err(|e| Error::Serde { message: e.to_string() }),
+        ContentType::MsgPack => serde_path_to_error::deserialize(&mut rmp_serde::Deserializer::new(std::io::Cursor::new(&response.body))).map_err(|e| Error::Serde { message: e.to_string() }),
         {% else %}
         ContentType::MsgPack => Err(Error::Serde { message: "MsgPack not supported".to_string() }),
         {% endif %}

api/oas_generator/rust_oas_generator/templates/base/Cargo.toml.j2

@@ -20,6 +20,7 @@ serde_with = { version = "^3.8", default-features = false, features = [
   "macros",
 ] }
 serde_json = "^1.0"
+serde_path_to_error = { workspace = true }
 serde_repr = "^0.1"
 serde_bytes = "^0.11"
 

api/oas_generator/rust_oas_generator/templates/base/lib.rs.j2

@@ -8,6 +8,7 @@ uniffi::setup_scaffolding!();
 pub mod apis;
 pub mod models;
 {% if client_type == "Algod" %}
+pub mod msgpack_string_bytes;
 pub mod msgpack_value_bytes;
 {% endif %}
 

api/oas_generator/rust_oas_generator/templates/base/msgpack_string_bytes.rs.j2

@@ -0,0 +1,39 @@
+/// Custom serde module for deserializing msgpack strings as raw bytes.
+///
+/// Msgpack strings may contain arbitrary bytes that aren't valid UTF-8.
+/// This module deserializes the raw string bytes into Vec<u8> without
+/// requiring UTF-8 validity.
+use serde::{Deserialize, Deserializer, Serializer};
+
+/// Deserialize a msgpack string as raw bytes
+pub fn deserialize<'de, D>(deserializer: D) -> Result<Option<Vec<u8>>, D::Error>
+where
+    D: Deserializer<'de>,
+{
+    // Use rmpv::Value to capture the raw msgpack value
+    let value: Option<rmpv::Value> = Option::deserialize(deserializer)?;
+
+    match value {
+        Some(rmpv::Value::String(s)) => {
+            // rmpv::Utf8String gives us access to raw bytes even if not valid UTF-8
+            Ok(Some(s.into_bytes()))
+        }
+        Some(rmpv::Value::Binary(b)) => Ok(Some(b)),
+        Some(_) => Err(serde::de::Error::custom(
+            "expected string or binary, got other type",
+        )),
+        None => Ok(None),
+    }
+}
+
+/// Serialize bytes as a msgpack binary
+pub fn serialize<S>(value: &Option<Vec<u8>>, serializer: S) -> Result<S::Ok, S::Error>
+where
+    S: Serializer,
+{
+    match value {
+        Some(bytes) => serializer.serialize_bytes(bytes),
+        None => serializer.serialize_none(),
+    }
+}
+

api/oas_generator/rust_oas_generator/templates/models/block/block_app_eval_delta.rs.j2

@@ -41,9 +41,10 @@ pub struct BlockAppEvalDelta {
     #[serde_as(as = "Option<Vec<Bytes>>")]
     #[serde(rename = "sa", skip_serializing_if = "Option::is_none")]
     pub shared_accounts: Option<Vec<Vec<u8>>>,
-    /// [lg] Application log outputs as strings (msgpack strings).
+    /// [lg] Application log outputs.
+    #[serde_as(as = "Option<Vec<Bytes>>")]
     #[serde(rename = "lg", skip_serializing_if = "Option::is_none")]
-    pub logs: Option<Vec<String>>,
+    pub logs: Option<Vec<Vec<u8>>>,
 }
 
 impl AlgorandMsgpack for BlockAppEvalDelta {

api/oas_generator/rust_oas_generator/templates/models/block/block_eval_delta.rs.j2

@@ -21,8 +21,13 @@ pub struct BlockEvalDelta {
     #[serde(rename = "at")]
     pub action: u32,
     /// [bs] bytes value.
-    #[serde(rename = "bs", skip_serializing_if = "Option::is_none")]
-    pub bytes: Option<String>,
+    #[serde(
+        with = "crate::msgpack_string_bytes",
+        default,
+        rename = "bs",
+        skip_serializing_if = "Option::is_none"
+    )]
+    pub bytes: Option<Vec<u8>>,
     /// [ui] uint value.
     #[serde(rename = "ui", skip_serializing_if = "Option::is_none")]
     pub uint: Option<u64>,