// This file is part of Bizinikiwi. // Copyright (C) Parity Technologies (UK) Ltd. and Dijital Kurdistan Tech Institute // SPDX-License-Identifier: Apache-2.0 // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //! # Atomic Swap //! //! A pezpallet for atomically sending funds. //! //! - [`Config`] //! - [`Call`] //! - [`Pezpallet`] //! //! ## Overview //! //! A pezpallet for atomically sending funds from an origin to a target. A proof //! is used to allow the target to approve (claim) the swap. If the swap is not //! claimed within a specified duration of time, the sender may cancel it. //! //! ## Interface //! //! ### Dispatchable Functions //! //! * [`create_swap`](Call::create_swap) - called by a sender to register a new atomic swap //! * [`claim_swap`](Call::claim_swap) - called by the target to approve a swap //! * [`cancel_swap`](Call::cancel_swap) - may be called by a sender after a specified duration // Ensure we're `no_std` when compiling for Wasm. #![cfg_attr(not(feature = "std"), no_std)] mod tests; extern crate alloc; use alloc::vec::Vec; use codec::{Decode, DecodeWithMemTracking, Encode}; use core::{ marker::PhantomData, ops::{Deref, DerefMut}, }; use pezframe::{ prelude::*, traits::{BalanceStatus, Currency, ReservableCurrency}, }; use scale_info::TypeInfo; /// Pending atomic swap operation. #[derive( Clone, Eq, PartialEq, RuntimeDebugNoBound, Encode, Decode, DecodeWithMemTracking, TypeInfo, MaxEncodedLen, )] #[scale_info(skip_type_params(T))] #[codec(mel_bound())] pub struct PendingSwap { /// Source of the swap. pub source: T::AccountId, /// Action of this swap. pub action: T::SwapAction, /// End block of the lock. pub end_block: BlockNumberFor, } /// Hashed proof type. pub type HashedProof = [u8; 32]; /// Definition of a pending atomic swap action. It contains the following three phrases: /// /// - **Reserve**: reserve the resources needed for a swap. This is to make sure that **Claim** /// succeeds with best efforts. /// - **Claim**: claim any resources reserved in the first phrase. /// - **Cancel**: cancel any resources reserved in the first phrase. pub trait SwapAction { /// Reserve the resources needed for the swap, from the given `source`. The reservation is /// allowed to fail. If that is the case, the the full swap creation operation is cancelled. fn reserve(&self, source: &AccountId) -> DispatchResult; /// Claim the reserved resources, with `source` and `target`. Returns whether the claim /// succeeds. fn claim(&self, source: &AccountId, target: &AccountId) -> bool; /// Weight for executing the operation. fn weight(&self) -> Weight; /// Cancel the resources reserved in `source`. fn cancel(&self, source: &AccountId); } /// A swap action that only allows transferring balances. #[derive( Clone, RuntimeDebug, Eq, PartialEq, Encode, Decode, DecodeWithMemTracking, TypeInfo, MaxEncodedLen, )] #[scale_info(skip_type_params(C))] #[codec(mel_bound())] pub struct BalanceSwapAction> { value: >::Balance, _marker: PhantomData, } impl BalanceSwapAction where C: ReservableCurrency, { /// Create a new swap action value of balance. pub fn new(value: >::Balance) -> Self { Self { value, _marker: PhantomData } } } impl Deref for BalanceSwapAction where C: ReservableCurrency, { type Target = >::Balance; fn deref(&self) -> &Self::Target { &self.value } } impl DerefMut for BalanceSwapAction where C: ReservableCurrency, { fn deref_mut(&mut self) -> &mut Self::Target { &mut self.value } } impl SwapAction for BalanceSwapAction where C: ReservableCurrency, { fn reserve(&self, source: &AccountId) -> DispatchResult { C::reserve(source, self.value) } fn claim(&self, source: &AccountId, target: &AccountId) -> bool { C::repatriate_reserved(source, target, self.value, BalanceStatus::Free).is_ok() } fn weight(&self) -> Weight { T::DbWeight::get().reads_writes(1, 1) } fn cancel(&self, source: &AccountId) { C::unreserve(source, self.value); } } pub use pezpallet::*; #[pezframe::pezpallet] pub mod pezpallet { use super::*; /// Atomic swap's pezpallet configuration trait. #[pezpallet::config] pub trait Config: pezframe_system::Config { /// The overarching event type. #[allow(deprecated)] type RuntimeEvent: From> + IsType<::RuntimeEvent>; /// Swap action. type SwapAction: SwapAction + Parameter + MaxEncodedLen; /// Limit of proof size. /// /// Atomic swap is only atomic if once the proof is revealed, both parties can submit the /// proofs on-chain. If A is the one that generates the proof, then it requires that either: /// - A's blockchain has the same proof length limit as B's blockchain. /// - Or A's blockchain has shorter proof length limit as B's blockchain. /// /// If B sees A is on a blockchain with larger proof length limit, then it should kindly /// refuse to accept the atomic swap request if A generates the proof, and asks that B /// generates the proof instead. #[pezpallet::constant] type ProofLimit: Get; } #[pezpallet::pezpallet] pub struct Pezpallet(_); #[pezpallet::storage] pub type PendingSwaps = StorageDoubleMap< _, Twox64Concat, T::AccountId, Blake2_128Concat, HashedProof, PendingSwap, >; #[pezpallet::error] pub enum Error { /// Swap already exists. AlreadyExist, /// Swap proof is invalid. InvalidProof, /// Proof is too large. ProofTooLarge, /// Source does not match. SourceMismatch, /// Swap has already been claimed. AlreadyClaimed, /// Swap does not exist. NotExist, /// Claim action mismatch. ClaimActionMismatch, /// Duration has not yet passed for the swap to be cancelled. DurationNotPassed, } /// Event of atomic swap pezpallet. #[pezpallet::event] #[pezpallet::generate_deposit(pub(super) fn deposit_event)] pub enum Event { /// Swap created. NewSwap { account: T::AccountId, proof: HashedProof, swap: PendingSwap }, /// Swap claimed. The last parameter indicates whether the execution succeeds. SwapClaimed { account: T::AccountId, proof: HashedProof, success: bool }, /// Swap cancelled. SwapCancelled { account: T::AccountId, proof: HashedProof }, } #[pezpallet::call] impl Pezpallet { /// Register a new atomic swap, declaring an intention to send funds from origin to target /// on the current blockchain. The target can claim the fund using the revealed proof. If /// the fund is not claimed after `duration` blocks, then the sender can cancel the swap. /// /// The dispatch origin for this call must be _Signed_. /// /// - `target`: Receiver of the atomic swap. /// - `hashed_proof`: The blake2_256 hash of the secret proof. /// - `balance`: Funds to be sent from origin. /// - `duration`: Locked duration of the atomic swap. For safety reasons, it is recommended /// that the revealer uses a shorter duration than the counterparty, to prevent the /// situation where the revealer reveals the proof too late around the end block. #[pezpallet::call_index(0)] #[pezpallet::weight(T::DbWeight::get().reads_writes(1, 1).ref_time().saturating_add(40_000_000))] pub fn create_swap( origin: OriginFor, target: T::AccountId, hashed_proof: HashedProof, action: T::SwapAction, duration: BlockNumberFor, ) -> DispatchResult { let source = ensure_signed(origin)?; ensure!( !PendingSwaps::::contains_key(&target, hashed_proof), Error::::AlreadyExist ); action.reserve(&source)?; let swap = PendingSwap { source, action, end_block: pezframe_system::Pezpallet::::block_number() + duration, }; PendingSwaps::::insert(target.clone(), hashed_proof, swap.clone()); Self::deposit_event(Event::NewSwap { account: target, proof: hashed_proof, swap }); Ok(()) } /// Claim an atomic swap. /// /// The dispatch origin for this call must be _Signed_. /// /// - `proof`: Revealed proof of the claim. /// - `action`: Action defined in the swap, it must match the entry in blockchain. Otherwise /// the operation fails. This is used for weight calculation. #[pezpallet::call_index(1)] #[pezpallet::weight( T::DbWeight::get().reads_writes(1, 1) .saturating_add(action.weight()) .ref_time() .saturating_add(40_000_000) .saturating_add((proof.len() as u64).saturating_mul(100)) )] pub fn claim_swap( origin: OriginFor, proof: Vec, action: T::SwapAction, ) -> DispatchResult { ensure!(proof.len() <= T::ProofLimit::get() as usize, Error::::ProofTooLarge); let target = ensure_signed(origin)?; let hashed_proof = blake2_256(&proof); let swap = PendingSwaps::::get(&target, hashed_proof).ok_or(Error::::InvalidProof)?; ensure!(swap.action == action, Error::::ClaimActionMismatch); let succeeded = swap.action.claim(&swap.source, &target); PendingSwaps::::remove(target.clone(), hashed_proof); Self::deposit_event(Event::SwapClaimed { account: target, proof: hashed_proof, success: succeeded, }); Ok(()) } /// Cancel an atomic swap. Only possible after the originally set duration has passed. /// /// The dispatch origin for this call must be _Signed_. /// /// - `target`: Target of the original atomic swap. /// - `hashed_proof`: Hashed proof of the original atomic swap. #[pezpallet::call_index(2)] #[pezpallet::weight(T::DbWeight::get().reads_writes(1, 1).ref_time().saturating_add(40_000_000))] pub fn cancel_swap( origin: OriginFor, target: T::AccountId, hashed_proof: HashedProof, ) -> DispatchResult { let source = ensure_signed(origin)?; let swap = PendingSwaps::::get(&target, hashed_proof).ok_or(Error::::NotExist)?; ensure!(swap.source == source, Error::::SourceMismatch); ensure!( pezframe_system::Pezpallet::::block_number() >= swap.end_block, Error::::DurationNotPassed, ); swap.action.cancel(&swap.source); PendingSwaps::::remove(&target, hashed_proof); Self::deposit_event(Event::SwapCancelled { account: target, proof: hashed_proof }); Ok(()) } } }