15 stable releases (7 major)

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

#72 in Emulators

Download history 1293/week @ 2024-11-22 1110/week @ 2024-11-29 1255/week @ 2024-12-06 1136/week @ 2024-12-13 247/week @ 2024-12-20 135/week @ 2024-12-27 800/week @ 2025-01-03 526/week @ 2025-01-10 1493/week @ 2025-01-17 599/week @ 2025-01-24 1273/week @ 2025-01-31 2103/week @ 2025-02-07 1485/week @ 2025-02-14 1510/week @ 2025-02-21 1294/week @ 2025-02-28 1133/week @ 2025-03-07

5,964 downloads per month
Used in 57 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.2–1.4MB
~30K SLoC