ink_primitives/
lib.rs

1// Copyright (C) Use Ink (UK) Ltd.
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15//! Utilities in use by ink!.
16//!
17//! These are kept separate from ink! core utilities to allow for more dynamic inter-crate
18//! dependencies. The main problem is that today Cargo manages crate features on a
19//! per-crate basis instead of a per-crate-target basis thus making dependencies from
20//! `ink` (or others) to `ink_env` or `ink_storage` impossible.
21//!
22//! By introducing `ink_primitives` we have a way to share utility components between
23//! `ink_env` or `ink_storage` and other parts of the framework, like `ink`.
24
25#![doc(
26    html_logo_url = "https://use.ink/img/crate-docs/logo.png",
27    html_favicon_url = "https://use.ink/crate-docs/favicon.png"
28)]
29#![cfg_attr(not(feature = "std"), no_std)]
30
31mod arithmetic;
32mod key;
33pub mod reflect;
34pub mod types;
35
36pub use self::{
37    key::{
38        Key,
39        KeyComposer,
40    },
41    reflect::{
42        DecodeDispatch,
43        DispatchError,
44    },
45    types::{
46        AccountId,
47        AccountIdMapper,
48        Address,
49        Clear,
50        DepositLimit,
51        Hash,
52    },
53};
54pub mod contract;
55
56pub use primitive_types::{
57    H160,
58    H256,
59    U256,
60};
61
62/// An error emitted by the smart contracting language.
63///
64/// This is different than errors from:
65/// - Errors from the contract, which are programmer defined
66/// - Errors from the underlying execution environment (e.g `pallet-revive`)
67#[non_exhaustive]
68#[repr(u32)]
69#[derive(Debug, Copy, Clone, PartialEq, Eq, ::scale::Encode, ::scale::Decode)]
70#[cfg_attr(feature = "std", derive(::scale_info::TypeInfo))]
71pub enum LangError {
72    /// Failed to read execution input for the dispatchable.
73    CouldNotReadInput = 1u32,
74}
75
76/// The `Result` type for ink! messages.
77pub type MessageResult<T> = ::core::result::Result<T, LangError>;
78
79/// The `Result` type for ink! constructors.
80pub type ConstructorResult<T> = ::core::result::Result<T, LangError>;
ink_primitives/lib.rs

ink_primitives/
lib.rs
