fix: rename nester to depositor, add docs

pallets/fungible/src/lib.rs

@@ -384,14 +384,16 @@ impl<T: Config> Pallet<T> {
 		amount: u128,
 		nesting_budget: &dyn Budget,
 	) -> DispatchResultWithPostInfo {
-		let nester = from;
-
-		Self::transfer_internal(collection, nester, from, to, amount, nesting_budget)
+		let depositor = from;
+		Self::transfer_internal(collection, depositor, from, to, amount, nesting_budget)
 	}
 
+	/// Transfers tokens from the `from` account to the `to` account.
+	/// The `depositor` is the account who deposits the tokens.
+	/// For instance, the nesting rules will be checked against the `depositor`'s permissions.
 	fn transfer_internal(
 		collection: &FungibleHandle<T>,
-		nester: &T::CrossAccountId,
+		depositor: &T::CrossAccountId,
 		from: &T::CrossAccountId,
 		to: &T::CrossAccountId,
 		amount: u128,
@@ -429,7 +431,7 @@ impl<T: Config> Pallet<T> {
 			// from != to && amount != 0
 
 			<PalletStructure<T>>::nest_if_sent_to_token(
-				nester,
+				depositor,
 				to,
 				collection.id,
 				TokenId::default(),

pallets/nonfungible/src/lib.rs

@@ -718,14 +718,16 @@ impl<T: Config> Pallet<T> {
 		token: TokenId,
 		nesting_budget: &dyn Budget,
 	) -> DispatchResultWithPostInfo {
-		let nester = from;
-
-		Self::transfer_internal(collection, nester, from, to, token, nesting_budget)
+		let depositor = from;
+		Self::transfer_internal(collection, depositor, from, to, token, nesting_budget)
 	}
 
+	/// Transfers an NFT from the `from` account to the `to` account.
+	/// The `depositor` is the account who deposits the NFT.
+	/// For instance, the nesting rules will be checked against the `depositor`'s permissions.
 	pub fn transfer_internal(
 		collection: &NonfungibleHandle<T>,
-		nester: &T::CrossAccountId,
+		depositor: &T::CrossAccountId,
 		from: &T::CrossAccountId,
 		to: &T::CrossAccountId,
 		token: TokenId,
@@ -767,7 +769,7 @@ impl<T: Config> Pallet<T> {
 		};
 
 		<PalletStructure<T>>::nest_if_sent_to_token(
-			nester,
+			depositor,
 			to,
 			collection.id,
 			token,

pallets/refungible/src/lib.rs

@@ -615,14 +615,24 @@ impl<T: Config> Pallet<T> {
 		amount: u128,
 		nesting_budget: &dyn Budget,
 	) -> DispatchResult {
-		let nester = from;
-
-		Self::transfer_internal(collection, nester, from, to, token, amount, nesting_budget)
+		let depositor = from;
+		Self::transfer_internal(
+			collection,
+			depositor,
+			from,
+			to,
+			token,
+			amount,
+			nesting_budget,
+		)
 	}
 
+	/// Transfers RFT tokens from the `from` account to the `to` account.
+	/// The `depositor` is the account who deposits the tokens.
+	/// For instance, the nesting rules will be checked against the `depositor`'s permissions.
 	pub fn transfer_internal(
 		collection: &RefungibleHandle<T>,
-		nester: &T::CrossAccountId,
+		depositor: &T::CrossAccountId,
 		from: &T::CrossAccountId,
 		to: &T::CrossAccountId,
 		token: TokenId,
@@ -697,7 +707,7 @@ impl<T: Config> Pallet<T> {
 			// from != to && amount != 0
 
 			<PalletStructure<T>>::nest_if_sent_to_token(
-				nester,
+				depositor,
 				to,
 				collection.id,
 				token,