#data-conversion #error #novax #address #blockchain #type #multiversx

novax-data

A foundational crate for the NovaX framework, providing essential data types and conversions necessary for working with smart contracts and blockchain interactions

47 releases

0.1.20 Oct 30, 2024
0.1.9 Sep 30, 2024
0.1.7-beta.2 Jul 17, 2024
0.1.4 Mar 31, 2024
0.0.24 Nov 26, 2023

#3 in #novax

Download history 29/week @ 2024-07-29 224/week @ 2024-08-05 221/week @ 2024-08-12 469/week @ 2024-08-19 426/week @ 2024-08-26 82/week @ 2024-09-02 79/week @ 2024-09-09 101/week @ 2024-09-16 102/week @ 2024-09-23 455/week @ 2024-09-30 316/week @ 2024-10-07 93/week @ 2024-10-14 807/week @ 2024-10-21 310/week @ 2024-10-28 39/week @ 2024-11-04 7/week @ 2024-11-11

1,167 downloads per month
Used in 6 crates (4 directly)

GPL-3.0-only

52KB
1K SLoC

novax-data is a crate designed to facilitate data handling and conversions in blockchain-based applications.

This crate provides a robust set of types and utility functions to ease the conversion and management of data structures when working with MultiversX virtual machine and the associated blockchain technology. It encompasses common patterns for data conversion and parsing, especially around address representations, and error handling.

Core Concepts

  • Native and Managed Type Conversion: NativeConvertible and ManagedConvertible are traits provided to bridge the gap between complex smart contract types managed by the MultiversX virtual machine and common Rust types. They facilitate seamless conversions back and forth, supporting a variety of scenarios such as converting a String to a ManagedBuffer or TokenIdentifier.

  • Address Handling: The Address struct along with its associated methods simplify the operations and transformations required when dealing with address representations on the blockchain.

  • Data Parsing and Error Handling: Utility functions like parse_query_return_string_data and parse_query_return_bytes_data are provided to parse and decode data from blockchain queries. Comprehensive error types like DataError, AddressError, and UtilsError centralize error handling, making error propagation and management straightforward.

Usage

Most of the time, developers won't have to include novax-data directly as a dependency. Its primary purpose is to serve as a foundational utility crate used by other "novax" crates such as "novax", "novax-executor", "novax-token", etc. However, if direct usage is required:

use novax_data::{Address, NativeConvertible, ManagedConvertible, parse_query_return_string_data, DataError};

// ... your code here ...

For detailed examples and usage of each type and utility function, refer to their respective module and function documentation.

Modules

  • types: Defines core types like Address, and the conversion traits NativeConvertible and ManagedConvertible.
  • constants: (Further details can be provided as needed)
  • error: Centralizes error definitions including DataError, AddressError, and UtilsError for robust error handling.
  • utils: Provides utility functions for data parsing and other common operations.

For a deep dive into each module and to understand the various types, traits, and functions provided, navigate through the module documentation below.

Dependencies

~18–30MB
~476K SLoC