32 releases (8 breaking)

0.12.1 Mar 20, 2023
0.11.1 Feb 24, 2023
0.4.2 Dec 30, 2022
0.2.0-beta.6 Nov 25, 2022
0.1.1-alpha2 Jul 25, 2022

#148 in #abstract


Used in 4 crates

GPL-3.0-or-later

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