[framework] Adds publisher module (#7196)

Finalizes the experiment myself and @amnn started; and proposes a
`publisher` module.

The goal of this module is to enable recognition of the Publisher
authority. Potentially it could be used for:
1. Setting rules / registering a type in a system, such as metadata,
AFTER the module was published
2. Authorizing admin actions (effectively replacing AdminCap which is
often added manually)

crates/sui-cost/tests/snapshots/empirical_transaction_cost__good_snapshot-2.snap

@@ -4,13 +4,13 @@ expression: common_costs_estimate
 ---
 {
   "MergeCoin": {
-    "computation_cost": 6847,
-    "storage_cost": 9817,
+    "computation_cost": 6942,
+    "storage_cost": 9958,
     "storage_rebate": 0
   },
   "Publish": {
-    "computation_cost": 7652,
-    "storage_cost": 10939,
+    "computation_cost": 7802,
+    "storage_cost": 11161,
     "storage_rebate": 0
   },
   "SharedCounterAssertValue": {
@@ -29,8 +29,8 @@ expression: common_costs_estimate
     "storage_rebate": 0
   },
   "SplitCoin": {
-    "computation_cost": 6825,
-    "storage_cost": 9784,
+    "computation_cost": 6921,
+    "storage_cost": 9926,
     "storage_rebate": 0
   },
   "TransferPortionSuiCoin": {

crates/sui-framework/deps/move-stdlib/sources/address.move

@@ -0,0 +1,12 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/// Provides a way to get address length since it's a
+/// platform-specific parameter.
+module std::address {
+    /// Should be converted to a native function.
+    /// Current implementation only works for Sui.
+    public fun length(): u64 {
+        20
+    }
+}

crates/sui-framework/deps/move-stdlib/sources/type_name.move

@@ -3,7 +3,12 @@
 
 /// Functionality for converting Move types into values. Use with care!
 module std::type_name {
-    use std::ascii::String;
+    use std::ascii::{Self, String};
+    use std::address;
+    use std::vector;
+
+    /// ASCII Character code for the `:` (colon) symbol.
+    const ASCII_COLON: u8 = 58;
 
     struct TypeName has copy, drop, store {
         /// String representation of the type. All types are represented
@@ -18,12 +23,55 @@ module std::type_name {
 
     /// Return a value representation of the type `T`.
     public native fun get<T>(): TypeName;
+    spec get {
+        pragma opaque;
+    }
 
     /// Get the String representation of `self`
     public fun borrow_string(self: &TypeName): &String {
         &self.name
     }
 
+    /// Get Address string (Base16 encoded), first part of the TypeName.
+    public fun get_address(self: &TypeName): String {
+        // Base16 (string) representation of an address has 2 symbols per byte.
+        let len = address::length() * 2;
+        let str_bytes = ascii::as_bytes(&self.name);
+        let addr_bytes = vector[];
+        let i = 0;
+
+        // Read `len` bytes from the type name and push them to addr_bytes.
+        while (i < len) {
+            vector::push_back(
+                &mut addr_bytes,
+                *vector::borrow(str_bytes, i)
+            );
+            i = i + 1;
+        };
+
+        ascii::string(addr_bytes)
+    }
+
+    /// Get name of the module.
+    public fun get_module(self: &TypeName): String {
+        // Starts after address and a double colon: `<addr as HEX>::`
+        let i = address::length() * 2 + 2;
+        let str_bytes = ascii::as_bytes(&self.name);
+        let module_name = vector[];
+
+        loop {
+            let char = vector::borrow(str_bytes, i);
+            if (char != &ASCII_COLON) {
+                vector::push_back(&mut module_name, *char);
+                i = i + 1;
+            } else {
+                break
+            }
+        };
+
+        ascii::string(module_name)
+    }
+
     /// Convert `self` into its inner String
     public fun into_string(self: TypeName): String {
         self.name

crates/sui-framework/docs/bcs.md

@@ -134,16 +134,6 @@ For when bytes length is less than required for deserialization.
 
 
 
-<a name="0x2_bcs_SUI_ADDRESS_LENGTH"></a>
-
-Address length in Sui is 20 bytes.
-
-
-<pre><code><b>const</b> <a href="bcs.md#0x2_bcs_SUI_ADDRESS_LENGTH">SUI_ADDRESS_LENGTH</a>: u64 = 20;
-</code></pre>
-
-
-
 <a name="0x2_bcs_to_bytes"></a>
 
 ## Function `to_bytes`
@@ -242,13 +232,13 @@ Read address from the bcs-serialized bytes.
 
 
 <pre><code><b>public</b> <b>fun</b> <a href="bcs.md#0x2_bcs_peel_address">peel_address</a>(<a href="">bcs</a>: &<b>mut</b> <a href="bcs.md#0x2_bcs_BCS">BCS</a>): <b>address</b> {
-    <b>assert</b>!(v::length(&<a href="">bcs</a>.bytes) &gt;= <a href="bcs.md#0x2_bcs_SUI_ADDRESS_LENGTH">SUI_ADDRESS_LENGTH</a>, <a href="bcs.md#0x2_bcs_EOutOfRange">EOutOfRange</a>);
+    <b>assert</b>!(v::length(&<a href="">bcs</a>.bytes) &gt;= <a href="_length">address::length</a>(), <a href="bcs.md#0x2_bcs_EOutOfRange">EOutOfRange</a>);
     <b>let</b> (addr_bytes, i) = (v::empty(), 0);
     <b>while</b> (i &lt; 20) {
         v::push_back(&<b>mut</b> addr_bytes, v::pop_back(&<b>mut</b> <a href="">bcs</a>.bytes));
         i = i + 1;
     };
-    <a href="address.md#0x2_address_from_bytes">address::from_bytes</a>(addr_bytes)
+    address::from_bytes(addr_bytes)
 }
 </code></pre>
 

crates/sui-framework/docs/object.md

@@ -185,7 +185,7 @@ Make an <code><a href="object.md#0x2_object_ID">ID</a></code> from raw bytes.
 
 
 <pre><code><b>public</b> <b>fun</b> <a href="object.md#0x2_object_id_from_bytes">id_from_bytes</a>(bytes: <a href="">vector</a>&lt;u8&gt;): <a href="object.md#0x2_object_ID">ID</a> {
-    <a href="object.md#0x2_object_id_from_address">id_from_address</a>(<a href="address.md#0x2_address_from_bytes">address::from_bytes</a>(bytes))
+    <a href="object.md#0x2_object_id_from_address">id_from_address</a>(address::from_bytes(bytes))
 }
 </code></pre>