Skip to content

Releases: near/borsh-rs

borsh-v1.1.1

25 Oct 21:55
73f7d7f
Compare
Choose a tag to compare

Other

  • add test_schema_conflicts (#254)
  • addressed warnings in docs generation (#252)
  • simplify discriminants handling in schema derives (#241)

borsh-derive-v1.1.1

25 Oct 21:54
73f7d7f
Compare
Choose a tag to compare
chore: release (#253)

Co-authored-by: dj8yf0μl <feepdake27@gmail.com>

borsh-v1.1.0

13 Oct 19:03
e8d67c9
Compare
Choose a tag to compare

Added

  • relax schema_container_of target requirement with ?Sized to allow slices (#245)

Fixed

  • fully qualify #cratename::BorshSchema in derive-generated code to void function name collisions leading to compilation errors (#244)

borsh-derive-v1.1.0

13 Oct 19:03
e8d67c9
Compare
Choose a tag to compare
chore: release (#246)

Signed-off-by: release-plz <release-plz@github.com>
Co-authored-by: release-plz <release-plz@github.com>

borsh-v1.0.0

06 Oct 14:47
6e7fc28
Compare
Choose a tag to compare

The year is 2653 and the best yet-to-be citizens of the Terran Federation are fighting
and mostly just dying in a relentless interstellar war against the Arachnids.
Yet the structure of our society has changed through the course of this confrontation.

The members of the Arachnid brain caste and queens have infiltrated the circles of our
most influential political and industrial leaders. Either directly, or via the Arachnid technology
called "Brain Bugs". This tech alone can accomplish what the Arachnid starship paratroopers
will not ever be capable to do.

Simple, straightforward and performant serialization libraries can set us in course to remedy this dangerous
stalemate situation by cleaning the minds of its users from even the tiniest of Brain Bugs.

Robert A. Heinlein, 1959 (a newspaper ad)

[Thanks]

borsh-rs 1.0.0 release was first conceived and then brought into existence by minds of:

Contributors, who imposed powerful impact on the past, present and future of this library are specially recognized:

  • Michal Nazarewicz @mina86 - for revisiting BorshSchema feature, rethinking it, bringing up great ideas and coming up with the
    fairly involved algorithm of max_serialized_size implementation.
  • Alex Kladov @matklad - for maintaining a superhuman ability of context switching in under 2 minutes and scanning through 15k lines of code
    in under 10 minutes, while leaving out under 1% relevant details.
  • Marco Ieni @MarcoIeni - for developing release-plz automation.
  • Vlad Frolov @frol - for keeping an eye on the big picture and striking just the right balance between
    performance and versatility, ease of use and extensibility and tons of other such hard to reconcile pairs.

[Migration guides]

This section contains links to short documents, describing problems encountered during update of borsh
version to v1.0.0 for related repositories.

[Summary of changes]

  • Library's structure was made more modular and optimized with respect to visibility
    of its public/private constituents and ease of access to them.

  • borsh's traits derives and their attributes had their capabilities extended and unified,
    both with respect to external interfaces and internal implementation. Please visit borsh_derive
    documentation pages if you're interested in more of the details.

  • The consistency property of deserialization, declared in Borsh Specification, became an
    opt-in feature de_strict_order for hash collections.

  • Support of explicit enum discriminants was added to derives of borsh traits.
    It has been added in somewhat limited form, only allowing the values of u8 range literals.

    use borsh::{BorshSerialize, BorshDeserialize, BorshSchema};
    
    <<<<<<< borsh-v0.10.3
    #[derive(BorshDeserialize, BorshSerialize, BorshSchema)]
    pub enum CurveType {
        ED25519 = 0, // 0 as u8 in enum tag
        SECP256K1 = 2, // 1 as u8 in enum tag
    }
    =======
    #[derive(BorshDeserialize, BorshSerialize, BorshSchema)]
    #[borsh(use_discriminant=false)]
    pub enum CurveType {
        ED25519 = 0, // 0 as u8 in enum tag
        SECP256K1 = 2, // 1 as u8 in enum tag
    }
    // vs
    #[derive(BorshDeserialize, BorshSerialize, BorshSchema)]
    #[borsh(use_discriminant=true)]
    pub enum CurveType {
        ED25519 = 0, // 0 as u8 in enum tag
        SECP256K1 = 2, // 2 as u8 in enum tag
    }
    >>>>>>> borsh-v1.0.0
  • RUSTSEC-2023-0033 has been resolved.
    It has been resolved by forbidding collections with dynamic runtime length to contain zero-sized types
    with runtime errors, happening on serialization or deserialization.
    Arrays with non-Copy and non-Clone ZST singletons of length > 1 gracefully panic on deserialization,
    not causing memory faults.

    Using collections with dynamic runtime length (tagged sequences) for containing ZSTs was also deemed
    wasteful of CPU cycles and a way to perform dos attacks.
    Such a case is now flagged as error when using new BorshSchemaContainer::validate method for user-defined
    types or instantiations of BorshSchema-supporting types with inappropriate parameters, defined by the library:

    let schema = BorshSchemaContainer::for_type::<Vec<core::ops::RangeFull>>();
    assert_eq!(
        Err(
          SchemaContainerValidateError::ZSTSequence("Vec<RangeFull>".to_string())
        ), 
        schema.validate()
    );
  • BorshSchema was extended with max_serialized_size implementation, which now unlocks support of borsh
    by a plethora of bounded types to express statically defined size limits of serialized representation of these types.

  • schema BorshSchemaContainer api was made future-proof.

  • schema Definition was extended with more variants, fields and details to uncover some of the
    implied details of serialization format.
    BorshSchema can now express a wider range of types. All types, which have BorshSchema defined by the library,
    now have a Definition.

  • schema Declaration-s were renamed to follow Rust-first rule and not be a mix of Rust types naming/syntax and syntax
    from other languages.

    use borsh::schema::BorshSchema;
    
    <<<<<<< borsh-v0.10.3
    assert_eq!("nil", <()>::declaration());
    assert_eq!("string", <String>::declaration());
    assert_eq!("Array<u64, 42>", <[u64; 42]>::declaration());
    assert_eq!("Tuple<u8, bool, f32>", <(u8, bool, f32)>::declaration());
    =======
    assert_eq!("()", <()>::declaration());
    assert_eq!("String", <String>::declaration());
    assert_eq!("[u64; 42]", <[u64; 42]>::declaration());
    assert_eq!("(u8, bool, f32)", <(u8, bool, f32)>::declaration());
    >>>>>>> borsh-v1.0.0

[Stability guarantee]

  • borsh's serialization format is guaranteed to NOT change throughout 1.x releases.
  • borsh's public APIs not gated by unstable__schema feature are guaranteed to NOT break
    throughout 1.x releases.
  • It's perceived, that new feature requests may potentially come for BorshSchema from outside of near ecosystem,
    thus borsh's public APIs gated by unstable__schema MAY break throughout 1.x releases.

borsh-derive-v1.0.0

06 Oct 14:47
6e7fc28
Compare
Choose a tag to compare
chore: release 1.0.0 (#240)

borsh-v1.0.0-alpha.6

02 Oct 15:27
75d91ec
Compare
Choose a tag to compare

Added

  • add borsh::object_length helper (#236)

Other

  • add examples for borsh::to_vec, borsh::to_writer, borsh::object_length (#238)
  • [breaking] completely remove deprecated BorshSerialize::try_to_vec (#221)

borsh-derive-v1.0.0-alpha.6

02 Oct 15:27
75d91ec
Compare
Choose a tag to compare
chore: release (#239)

Signed-off-by: release-plz <release-plz@github.com>
Co-authored-by: release-plz <release-plz@github.com>

borsh-v1.0.0-alpha.5

26 Sep 19:53
d2c63ac
Compare
Choose a tag to compare

Added

  • [breaking] add DiscriminantValue to Definition::Enum::variants tuples (#232)
  • [breaking] add length_width to schema::Definition::Sequence (#229)
  • add definition of String/str (#226)
  • [breaking] add Definition::Sequence::length_range field (#220)
  • [breaking] add Definition::Primitive (#222)
  • max_size: various small refactoring (#223)
  • check Definition::Enum’s tag_width when validating schema (#224)
  • add (de)serialisation + schema for more core::ops::Range... types (full, open-ended, inclusive) (#213)
  • add BorshSchema implementation for core::num::NonZero... integers (#214)
  • [breaking] introduce borsh::io with either items of std:io or private borsh::nostd_io module reexported (std or no_std) (#212)
  • Introduce borsh::max_serialized_size function, borsh::schema::BorshSchemaContainer::for_type method (#209)

Other

  • [breaking] rename "Tuple<T0, T1, T2...>" -> "(T0, T1, T2...)" (schema::Declaration) (#234)
  • [breaking] rename "nil" -> "()", "string" -> "String", "nonzero_u16" -> "NonZeroU16" (schema::Declaration) (#233)
  • [breaking] rename "Array<T0, N>" -> "[T0; N]" (schema::Declaration) (#235)
  • [breaking] split ValidationError from MaxSizeError; validate and max_serialized_size made BorshSchemaContainer's methods (#219)
  • [breaking] declare and rename schema feature to be unstable__ (may break in 1.x versions)
  • Add Definition::Enum::tag_width field (#215)

borsh-derive-v1.0.0-alpha.5

26 Sep 19:53
d2c63ac
Compare
Choose a tag to compare
chore: release (#217)

Signed-off-by: release-plz <release-plz@github.com>
Co-authored-by: release-plz <release-plz@github.com>