WIP: TF Components Package

Cargo.toml

@@ -4,7 +4,7 @@ edition = "2021"
 homepage = "https://www.iota.org"
 license = "Apache-2.0"
 repository = "https://github.com/iotaledger/product-core.rs"
-rust-version = "1.70"
+rust-version = "1.80"
 
 [workspace]
 resolver = "2"

bindings/wasm/iota_interaction_ts/lib/core_client.ts

@@ -5,6 +5,7 @@ import { TransactionSigner } from "~iota_interaction_ts";
 export interface CoreClientReadOnly {
     packageId(): string;
     packageHistory(): string[];
+    tfComponentsPackageId(): string | undefined;
     network(): string;
     iotaClient(): IotaClient;
 }

bindings/wasm/iota_interaction_ts/src/core_client.rs

@@ -18,6 +18,9 @@ extern "C" {
   #[wasm_bindgen(method, js_name = packageHistory)]
   pub fn package_history(this: &WasmCoreClientReadOnly) -> Vec<String>;
 
+  #[wasm_bindgen(method, js_name = tfComponentsPackageId)]
+  pub fn tf_components_package_id(this: &WasmCoreClientReadOnly) -> Option<String>;
+
   #[wasm_bindgen(method, js_name = network)]
   pub fn network(this: &WasmCoreClientReadOnly) -> String;
 

components_move/.prettierignore

@@ -0,0 +1 @@
+build/*

components_move/.prettierrc

@@ -0,0 +1,8 @@
+{
+    "tabWidth": 4,
+    "printWidth": 100,
+    "useModuleLabel": true,
+    "autoGroupImports": "package",
+    "enableErrorDebug": false,
+    "wrapComments": false
+}

components_move/Move.history.json

@@ -0,0 +1,10 @@
+{
+  "aliases": {
+    "testnet": "2304aa97"
+  },
+  "envs": {
+    "testnet": [
+      "0x098767e6cd008f341847ad68089300375a274899b1c718e8cf8f5d57f96e8607"
+    ]
+  }
+}

components_move/Move.lock

@@ -2,7 +2,7 @@
 
 [move]
 version = 3
-manifest_digest = "172E6E9D27DFB64487EDC62DB907AD3642D5693302E78F3727A67B53C44DAD6C"
+manifest_digest = "4E219538E560B52E657002599823A7F5794C484FDEB0EA7DE93DD860C8821C44"
 deps_digest = "F9B494B64F0615AED0E98FC12A85B85ECD2BC5185C22D30E7F67786BB52E507C"
 dependencies = [
   { id = "Iota", name = "Iota" },
@@ -13,15 +13,15 @@ dependencies = [
 
 [[move.package]]
 id = "Iota"
-source = { git = "https://github.com/iotaledger/iota.git", rev = "4698c6723208e052a00c74602d2c8dc0efffe5de", subdir = "crates/iota-framework/packages/iota-framework" }
+source = { git = "https://github.com/iotaledger/iota.git", rev = "e694e2ee8f2f9f0b9b03b843a24ff0f7bcff2930", subdir = "crates/iota-framework/packages/iota-framework" }
 
 dependencies = [
   { id = "MoveStdlib", name = "MoveStdlib" },
 ]
 
 [[move.package]]
 id = "IotaSystem"
-source = { git = "https://github.com/iotaledger/iota.git", rev = "4698c6723208e052a00c74602d2c8dc0efffe5de", subdir = "crates/iota-framework/packages/iota-system" }
+source = { git = "https://github.com/iotaledger/iota.git", rev = "e694e2ee8f2f9f0b9b03b843a24ff0f7bcff2930", subdir = "crates/iota-framework/packages/iota-system" }
 
 dependencies = [
   { id = "Iota", name = "Iota" },
@@ -30,18 +30,26 @@ dependencies = [
 
 [[move.package]]
 id = "MoveStdlib"
-source = { git = "https://github.com/iotaledger/iota.git", rev = "4698c6723208e052a00c74602d2c8dc0efffe5de", subdir = "crates/iota-framework/packages/move-stdlib" }
+source = { git = "https://github.com/iotaledger/iota.git", rev = "e694e2ee8f2f9f0b9b03b843a24ff0f7bcff2930", subdir = "crates/iota-framework/packages/move-stdlib" }
 
 [[move.package]]
 id = "Stardust"
-source = { git = "https://github.com/iotaledger/iota.git", rev = "4698c6723208e052a00c74602d2c8dc0efffe5de", subdir = "crates/iota-framework/packages/stardust" }
+source = { git = "https://github.com/iotaledger/iota.git", rev = "e694e2ee8f2f9f0b9b03b843a24ff0f7bcff2930", subdir = "crates/iota-framework/packages/stardust" }
 
 dependencies = [
   { id = "Iota", name = "Iota" },
   { id = "MoveStdlib", name = "MoveStdlib" },
 ]
 
 [move.toolchain-version]
-compiler-version = "1.14.1"
+compiler-version = "1.19.1"
 edition = "2024.beta"
 flavor = "iota"
+
+[env]
+
+[env.testnet]
+chain-id = "2304aa97"
+original-published-id = "0x098767e6cd008f341847ad68089300375a274899b1c718e8cf8f5d57f96e8607"
+latest-published-id = "0x098767e6cd008f341847ad68089300375a274899b1c718e8cf8f5d57f96e8607"
+published-version = "1"

components_move/examples/counter/sources/counter.move

@@ -1,7 +1,10 @@
 // Copyright (c) 2026 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
-/// Simple shared counter to demonstrate role_mao::RoleMap integration
+/// Simple shared counter to demonstrate role_map::RoleMap integration
+/// It also demonstrates how to use the generic role-data argument of the RoleMap
+/// to implement time-based permissions by storing a weekday in the role data
+/// and checking if the current day matches the stored weekday in the permission check.
 #[test_only]
 module tf_components::counter;
 
@@ -11,13 +14,63 @@ use tf_components::counter_permission::{Self as permission, CounterPermission};
 use tf_components::role_map;
 
 #[error]
-const EPermissionDenied: vector<u8> =
-    b"The role associated with the provided capability does not have the required permission";
+const EWeekDayMismatch: vector<u8> =
+    b"The role associated with the provided capability is restricted to a specific weekday which does not match the current weekday";
+
+public enum Weekday has copy, drop, store {
+    Monday,
+    Tuesday,
+    Wednesday,
+    Thursday,
+    Friday,
+    Saturday,
+    Sunday,
+}
+
+public fun weekday_to_u8(self: &Weekday): u8 {
+    match (self) {
+        Weekday::Monday => 0,
+        Weekday::Tuesday => 1,
+        Weekday::Wednesday => 2,
+        Weekday::Thursday => 3,
+        Weekday::Friday => 4,
+        Weekday::Saturday => 5,
+        Weekday::Sunday => 6,
+    }
+}
+
+public fun monday(): Weekday {
+    Weekday::Monday
+}
+
+public fun tuesday(): Weekday {
+    Weekday::Tuesday
+}
+
+public fun wednesday(): Weekday {
+    Weekday::Wednesday
+}
+
+public fun thursday(): Weekday {
+    Weekday::Thursday
+}
+
+public fun friday(): Weekday {
+    Weekday::Friday
+}
+
+public fun saturday(): Weekday {
+    Weekday::Saturday
+}
+
+public fun sunday(): Weekday {
+    Weekday::Sunday
+}
 
 public struct Counter has key {
     id: UID,
     value: u64,
-    access: role_map::RoleMap<CounterPermission>,
+    access: role_map::RoleMap<CounterPermission, Weekday>,
 }
 
 public fun create(ctx: &mut TxContext): (Capability, ID) {
@@ -76,29 +129,60 @@ public fun create(ctx: &mut TxContext): (Capability, ID) {
     (admin_cap, counter_id)
 }
 
-public fun increment(counter: &mut Counter, cap: &Capability, clock: &Clock, ctx: &TxContext) {
-    assert!(
-        counter
-            .access
-            .is_capability_valid(
-                cap,
-                &permission::increment_counter(),
-                clock,
-                ctx,
-            ),
-        EPermissionDenied,
+public fun increment(self: &mut Counter, cap: &Capability, clock: &Clock, ctx: &TxContext) {
+    self.assert_capability_valid(
+        cap,
+        &permission::increment_counter(),
+        clock,
+        ctx,
+    );
+    self.value = self.value + 1;
+}
+
+public fun assert_capability_valid(
+    self: &Counter,
+    cap: &Capability,
+    permission: &CounterPermission,
+    clock: &Clock,
+    ctx: &TxContext,
+): bool {
+    self.access.assert_capability_valid(
+        cap,
+        permission,
+        clock,
+        ctx
     );
-    counter.value = counter.value + 1;
+    let role_data_option = self.access.get_role_data(cap.role());
+    if (role_data_option.is_some_and!(|required_weekday| {
+            let current_weekday = to_weekday(clock);
+            weekday_to_u8(required_weekday) != current_weekday
+        })) {
+        assert!(false, EWeekDayMismatch);
+    };
+    true
+}
+
+public fun access(self: &Counter): &role_map::RoleMap<CounterPermission, Weekday> {
+    &self.access
 }
 
-public fun access(counter: &Counter): &role_map::RoleMap<CounterPermission> {
-    &counter.access
+public fun access_mut(self: &mut Counter): &mut role_map::RoleMap<CounterPermission, Weekday> {
+    &mut self.access
 }
 
-public fun access_mut(counter: &mut Counter): &mut role_map::RoleMap<CounterPermission> {
-    &mut counter.access
+public fun value(self: &Counter): u64 {
+    self.value
 }
 
-public fun value(counter: &Counter): u64 {
-    counter.value
+/// Returns the day of the week (0 = Monday, 1 = Tuesday, ..., 6 = Sunday)
+/// based on a millisecond Unix timestamp.
+/// The Unix epoch (timestamp 0) was a Thursday (day index 3).
+public fun to_weekday(clock: &Clock): u8 {
+    let timestamp_ms = clock.timestamp_ms();
+    let ms_per_day: u64 = 86_400_000; // 24 * 60 * 60 * 1000
+    let day_count = timestamp_ms / ms_per_day;
+    // Unix epoch is Thursday. If Monday = 0, then Thursday = 3.
+    // So we add 3 to shift the epoch day to Thursday, then mod 7.
+    let weekday = ((day_count + 3) % 7) as u8;
+    weekday
 }