Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fixing ManualKey<0> to act properly #1670

Merged
merged 4 commits into from
Feb 23, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,11 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Fixed
- Fixing `ManualKey<0>` to act properly - [#1670](https://github.com/paritytech/ink/pull/1670)

## Version 4.0.0

The latest stable release of ink! is here 🥳
Expand Down
62 changes: 58 additions & 4 deletions crates/storage/traits/src/impls/mod.rs
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,14 @@ use ink_primitives::{
KeyComposer,
};

/// The private trait helping identify the [`AutoKey`] key type.
trait KeyType {
/// It is `true` for [`AutoKey`] and `false` for [`ManualKey`].
/// It helps the [`ResolverKey`] select between the user-specified (left key)
/// and the auto-generated (right key) keys.
const IS_AUTO_KEY: bool;
}

/// Auto key type means that the storage key should be calculated automatically.
#[derive(Default, Copy, Clone, PartialEq, Eq, PartialOrd)]
#[cfg_attr(feature = "std", derive(scale_info::TypeInfo))]
Expand All @@ -36,6 +44,10 @@ impl StorageKey for AutoKey {
const KEY: Key = 0;
}

impl KeyType for AutoKey {
const IS_AUTO_KEY: bool = true;
}

impl Debug for AutoKey {
fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
f.debug_struct("AutoKey")
Expand All @@ -55,6 +67,10 @@ impl<const KEY: Key, ParentKey: StorageKey> StorageKey for ManualKey<KEY, Parent
const KEY: Key = KeyComposer::concat(KEY, ParentKey::KEY);
}

impl<const KEY: Key, ParentKey: StorageKey> KeyType for ManualKey<KEY, ParentKey> {
const IS_AUTO_KEY: bool = false;
}

impl<const KEY: Key, ParentKey: StorageKey> Debug for ManualKey<KEY, ParentKey> {
fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
f.debug_struct("ManualKey")
Expand All @@ -67,11 +83,26 @@ impl<const KEY: Key, ParentKey: StorageKey> Debug for ManualKey<KEY, ParentKey>
/// If the `L` type is `AutoKey` it returns auto-generated `R` else `L`.
#[derive(Default, Copy, Clone, PartialEq, Eq, PartialOrd, Debug)]
#[cfg_attr(feature = "std", derive(scale_info::TypeInfo))]
pub struct ResolverKey<L: StorageKey, R: StorageKey>(PhantomData<fn() -> (L, R)>);
pub struct ResolverKey<L, R>(PhantomData<fn() -> (L, R)>);

impl<L: StorageKey, R: StorageKey> StorageKey for ResolverKey<L, R> {
/// `KEY` of the `AutoKey` is zero. If left key is zero, then use right manual key.
const KEY: Key = if L::KEY == 0 { R::KEY } else { L::KEY };
impl<L, R> StorageKey for ResolverKey<L, R>
where
L: StorageKey + KeyType,
R: StorageKey + KeyType,
{
/// If the left key is [`AutoKey`], then use the right auto-generated storage key.
/// Otherwise use the left [`ManualKey`].
const KEY: Key = if L::IS_AUTO_KEY { R::KEY } else { L::KEY };
}

impl<L, R> KeyType for ResolverKey<L, R>
where
L: KeyType,
R: KeyType,
{
/// The right key is always an auto-generated key, the user can specify only the left key.
/// So the left key defines the [`KeyType::IS_AUTO_KEY`] of the [`ResolverKey`].
const IS_AUTO_KEY: bool = L::IS_AUTO_KEY;
}

type FinalKey<T, const KEY: Key, ParentKey> =
Expand All @@ -84,6 +115,7 @@ type FinalKey<T, const KEY: Key, ParentKey> =
impl<T, const KEY: Key, ParentKey> AutoStorableHint<ManualKey<KEY, ParentKey>> for T
where
T: StorableHint<ParentKey>,
<T as StorableHint<ParentKey>>::PreferredKey: KeyType,
T: StorableHint<FinalKey<T, KEY, ParentKey>>,
ParentKey: StorageKey,
{
Expand Down Expand Up @@ -111,6 +143,8 @@ where

#[cfg(test)]
mod tests {
use super::*;

/// Creates test to verify that the primitive types are packed.
#[macro_export]
macro_rules! storage_hint_works_for_primitive {
Expand Down Expand Up @@ -174,4 +208,24 @@ mod tests {
type TupleSix = (i32, u32, String, u8, bool, Box<Option<i32>>);
storage_hint_works_for_primitive!(TupleSix);
}

#[test]
fn storage_key_types_works() {
assert_eq!(<AutoKey as StorageKey>::KEY, 0);
assert_eq!(<ManualKey<123> as StorageKey>::KEY, 123);
assert_eq!(<ManualKey<0> as StorageKey>::KEY, 0);
assert_eq!(<ResolverKey<AutoKey, AutoKey> as StorageKey>::KEY, 0);
assert_eq!(
<ResolverKey<AutoKey, ManualKey<123>> as StorageKey>::KEY,
123
);
assert_eq!(
<ResolverKey<ManualKey<456>, ManualKey<123>> as StorageKey>::KEY,
456
);
assert_eq!(
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Without the fix, it would fail with the 123 storage key=)

<ResolverKey<ManualKey<0>, ManualKey<123>> as StorageKey>::KEY,
0
);
}
}