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

Enable Merklized Distributions in Assets Pallet #5400

Open
wants to merge 82 commits into
base: master
Choose a base branch
from

Conversation

shawntabrizi
Copy link
Member

@shawntabrizi shawntabrizi commented Aug 19, 2024

Depends on: #3881

This PR introduces a way for an asset issuer to distribute their token to many users using a single merkle root.

Users then present a merkle proof which is verified, and triggers the do_mint function.

A tracking storage ensures that each user only claims their distribution a single time.

The design allows for multiple distributions per asset id.

@shawntabrizi
Copy link
Member Author

This PR is blocked because the data structures in binary-merkle-tree crate are not usable in the runtime because usize does not work with Encode, Decode, or TypeInfo.

@@ -538,4 +538,20 @@ impl<T: frame_system::Config> pallet_assets::WeightInfo for WeightInfo<T> {
.saturating_add(T::DbWeight::get().reads(1_u64))
.saturating_add(T::DbWeight::get().writes(1_u64))
}

fn mint_distribution() -> Weight {
Weight::default()
Copy link
Contributor

Choose a reason for hiding this comment

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

TODO prior to merge

Comment on lines +326 to +335

#[derive(Eq, PartialEq, Copy, Clone, RuntimeDebug, Encode, Decode, TypeInfo, MaxEncodedLen)]
pub struct DistributionInfo<AssetId, Hash> {
// The asset id we are distributing.
pub asset_id: AssetId,
// The merkle root which represents all the balances to distribute.
pub merkle_root: Hash,
// Whether the distribution is still active.
pub active: bool,
}
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
#[derive(Eq, PartialEq, Copy, Clone, RuntimeDebug, Encode, Decode, TypeInfo, MaxEncodedLen)]
pub struct DistributionInfo<AssetId, Hash> {
// The asset id we are distributing.
pub asset_id: AssetId,
// The merkle root which represents all the balances to distribute.
pub merkle_root: Hash,
// Whether the distribution is still active.
pub active: bool,
}
/// Foo bar baz
#[derive(Eq, PartialEq, Copy, Clone, RuntimeDebug, Encode, Decode, TypeInfo, MaxEncodedLen)]
pub struct DistributionInfo<AssetId, Hash> {
/// The asset id we are distributing.
pub asset_id: AssetId,
/// The merkle root which represents all the balances to distribute.
pub merkle_root: Hash,
/// Whether the distribution is still active.
pub active: bool,
}

@@ -1798,6 +1848,92 @@ pub mod pallet {
)?;
Ok(())
}

/// Mint a distribution of assets of a particular class.
Copy link
Contributor

Choose a reason for hiding this comment

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

Something about this can go into the main top docs and then in https://docs.rs/pallet-assets/latest/pallet_assets/?

Copy link
Contributor

@kianenigma kianenigma left a comment

Choose a reason for hiding this comment

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

Some small nits remaining, but the overall logic is good

Copy link
Contributor

@Ank4n Ank4n left a comment

Choose a reason for hiding this comment

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

First pass. Haven't looked yet at the proving trie code.

substrate/frame/assets/src/lib.rs Outdated Show resolved Hide resolved
pub(super) fn do_mint_distribution(
id: T::AssetId,
merkle_root: DistributionHashOf<T, I>,
maybe_check_issuer: Option<T::AccountId>,
Copy link
Contributor

Choose a reason for hiding this comment

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

why Option? Is always called with Some() ?

Copy link
Member Author

Choose a reason for hiding this comment

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

this is the same pattern used in other functions which allows a low level API to call this function without having to provide the issuer. For example if some low level trait or pallet wanted to call this function without requiring user authorization or anything like that

if all_refunded {
Self::deposit_event(Event::<T, I>::DistributionCleaned { distribution_id });
// Refund weight only the amount we actually used.
Ok(Some(T::WeightInfo::destroy_distribution(refund_count)).into())
Copy link
Contributor

Choose a reason for hiding this comment

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

What is the incentive to clean up state? Shouldn't we refund all fees?

Copy link
Member Author

Choose a reason for hiding this comment

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

anyone can clean up state... but yeah we could add a deposit here for doing a distribution


info.active = false;

MerklizedDistribution::<T, I>::insert(&distribution_id, info);
Copy link
Contributor

Choose a reason for hiding this comment

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

Is this never cleaned? Would we not just keep bloating state then?

Copy link
Member Author

Choose a reason for hiding this comment

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

updated code to remove this at the end

) -> DispatchResult {
let origin = ensure_signed(origin)?;
let id: T::AssetId = id.into();
Self::do_mint_distribution(id, merkle_root, Some(origin))?;
Copy link
Contributor

Choose a reason for hiding this comment

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

Thinking out loud: Should we not take some kind of deposit here (charging for the storage), that is only refunded when state (MerklizedDistributionTracker) is cleaned up? What stops some one to create large number of distributions?

substrate/frame/assets/src/lib.rs Outdated Show resolved Hide resolved
@paritytech-review-bot paritytech-review-bot bot requested a review from a team September 23, 2024 21:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
T2-pallets This PR/Issue is related to a particular pallet.
Projects
Status: No status
Development

Successfully merging this pull request may close these issues.

4 participants