14 releases (stable)

4.0.0 Jan 26, 2024
3.0.0 Oct 31, 2023
3.0.0-alpha.1 Sep 29, 2023
2.0.0 Sep 7, 2023
0.2.0 Sep 15, 2022

#47 in Emulators

Download history 249/week @ 2023-12-23 1083/week @ 2023-12-30 1137/week @ 2024-01-06 1225/week @ 2024-01-13 1172/week @ 2024-01-20 1849/week @ 2024-01-27 1579/week @ 2024-02-03 1898/week @ 2024-02-10 2114/week @ 2024-02-17 2304/week @ 2024-02-24 1997/week @ 2024-03-02 1669/week @ 2024-03-09 3207/week @ 2024-03-16 1494/week @ 2024-03-23 1989/week @ 2024-03-30 2014/week @ 2024-04-06

9,250 downloads per month
Used in 55 crates (2 directly)

MIT/Apache

10KB
155 lines

Filecoin

Filecoin is a decentralized storage network designed to store humanity's most important information.

This repo contains utilities and libraries to work with the Filecoin Virtual Machine

Coverage Status

Packages

fvm_actor_utils

A set of utilities to help write testable native actors for the Filecoin Virtual Machine. Provides abstractions on top of FVM-SDK functionality that can be shimmed or mocked in unit tests. This includes helpers for:

  • Universal receiver hooks (as defined in FRC-0046)
  • IPLD-compatible blockstore
  • Messaging and address resolution

frc42_dispatch

Reference library containing macros for standard method dispatch. A set of CLI utilities to generate method numbers is also available: fvm_dispatch_tools

Specification Reference Implementation Examples
FRC-0042 frc42_dispatch greeter

frc46_token

Reference library for implementing a standard fungible token in native actors

Specification Reference Implementation Examples
FRC-0046 frc46_token basic_token basic_receiver

frc53_nft

Reference library for implementing a standard non-fungible token in native actors

Specification Reference Implementation Examples
FRC-0053 frc53_nft basic_nft basic_receiver

frc46_factory_token

A configurable actor that can be used as a factory to create instances of FRC-0046-compatible tokens, based on frc46_token and implemented here

License

Dual-licensed: MIT, Apache Software License v2.

Testing

For local coverage testing, please install the grcov crate.

Copyright Protocol Labs, Inc, 2022

Dependencies

~0.3–1.3MB
~28K SLoC