sp_hop/
lib.rs

1// This file is part of Substrate.
2
3// Copyright (C) Parity Technologies (UK) Ltd.
4// SPDX-License-Identifier: Apache-2.0
5
6// Licensed under the Apache License, Version 2.0 (the "License");
7// you may not use this file except in compliance with the License.
8// You may obtain a copy of the License at
9//
10// 	http://www.apache.org/licenses/LICENSE-2.0
11//
12// Unless required by applicable law or agreed to in writing, software
13// distributed under the License is distributed on an "AS IS" BASIS,
14// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15// See the License for the specific language governing permissions and
16// limitations under the License.
17
18//! HOP (Hand-Off Protocol) primitives.
19//!
20//! Contains the runtime API trait for HOP — authorization checks and promotion
21//! of ephemeral pool data to on-chain storage.
22
23#![cfg_attr(not(feature = "std"), no_std)]
24
25extern crate alloc;
26
27sp_api::decl_runtime_apis! {
28	/// Runtime API for HOP.
29	///
30	/// Runtimes that support HOP implement this API so the node can check
31	/// authorization and promote near-expiry pool entries to on-chain storage.
32	#[api_version(1)]
33	pub trait HopRuntimeApi<AccountId> where AccountId: codec::Codec {
34		/// Whether `who` may submit a HOP blob of `data_len` bytes for promotion.
35		///
36		/// Returns `false` for any "not allowed" reason — unknown account, exhausted
37		/// quota, oversized payload, etc.
38		fn can_account_promote(who: AccountId, data_len: u32) -> bool;
39		/// Construct an unsigned promotion extrinsic carrying the user's submit-time
40		/// (in milliseconds from the Unix epoch), signer, signature, and timestamp
41		/// so the runtime pallet can verify consent on-chain.
42		/// `submit_timestamp` is bound into the signed payload and bounds
43		/// the signature's validity window, preventing replay long after the fact.
44		fn create_promotion_extrinsic(
45			data: alloc::vec::Vec<u8>,
46			signer: sp_runtime::MultiSigner,
47			signature: sp_runtime::MultiSignature,
48			submit_timestamp: u64,
49		) -> Block::Extrinsic;
50		/// Maximum data size per promotion extrinsic.
51		fn max_promotion_size() -> u32;
52		/// Whether the content with `hash` is already stored on-chain.
53		///
54		/// Used by HOP's maintenance task to confirm that a previously submitted
55		/// promotion extrinsic actually made it into a block.
56		fn is_promoted_on_chain(hash: [u8; 32]) -> bool;
57	}
58}
sp_hop/lib.rs

sp_hop/
lib.rs
