32 releases (8 breaking)
0.12.1 |
|
---|---|
0.11.1 | Feb 24, 2023 |
0.4.2 | Dec 30, 2022 |
0.2.0-beta.6 | Nov 25, 2022 |
0.1.1-alpha2 |
|
#148 in #abstract
Used in 4 crates
220KB
5K
SLoC
Abstract
This package contains everything you need to interact with Abstract contracts.
This package contains:
- Abstract contract interface messages
- Abstract contract states
- Abstract objects (preferably use the re-exported version in Abstract-SDK)
Usage
// Import a contract Exec/Init/Query message
abstract_os::contract::ExecuteMsg
// Import a contract state lay-out
abstract_os::contract::state::STATE
// Import a state object
abstract_os::object::ProxyValue;
Messages
Each interface in individually commented.
States
Each state-layout is also individually covered
Objects
Abstract Objects are used to store information along with helper functions. We provide these as imports so the data can be retrieved externally (using Raw Queries).
If you want to use these objects in your own contracts we suggest using the abstract-sdk package.
lib.rs
:
Abstract OS
Abstract OS is the interface-defining crate to the Abstract OS smart-contract framework.
Description
This crate provides the key utilities that are required to integrate with or write Abstract contracts.
Messages
All interfacing message structs are defined here so they can be imported.
use abstract_os::manager::ExecuteMsg;
Assets
cw-asset
is used for asset-management.
If a message requests a String value for an Asset field then you need to provide the human-readable ans_host key.
The full list of supported assets and contracts is given here.
The contract will handel address retrieval internally.
State
The internal state for each contract is also contained within this crate. This ensures that breaking changes to the internal state are easily spotted. It also allows for tight and low-gas integration between contracts by performing raw queries on these states. A contract's state object can be imported and used like:
use crate::manager::state::OS_ID
let os_id = OS_ID.query(querier, manager_address).unwrap();
The internally stored objects are also contained within this package in crate::objects
.
Names
Abstract contract names are used internally and for version management. They are exported for ease of use:
use abstract_os::PROXY;
Errors
An AbstractError
wraps error throws by StdError
or AssetError
. It is also use in the objects to throw errors.
Dependencies
~4.5–6.5MB
~139K SLoC