15 releases (7 major breaking)

new 7.0.0 Mar 14, 2025
6.0.0 Nov 21, 2024
5.1.0 Jan 17, 2025
5.0.0 Jun 14, 2024
0.2.0 Sep 15, 2022

#178 in Procedural macros

Download history 1293/week @ 2024-11-22 1100/week @ 2024-11-29 1219/week @ 2024-12-06 1130/week @ 2024-12-13 248/week @ 2024-12-20 121/week @ 2024-12-27 799/week @ 2025-01-03 522/week @ 2025-01-10 1487/week @ 2025-01-17 600/week @ 2025-01-24 1268/week @ 2025-01-31 2123/week @ 2025-02-07 1482/week @ 2025-02-14 1510/week @ 2025-02-21 1294/week @ 2025-02-28 1129/week @ 2025-03-07

5,956 downloads per month
Used in 56 crates (11 directly)

MIT/Apache

15KB
212 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.5–1MB
~20K SLoC