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

#75 in Emulators

Download history 1216/week @ 2024-11-25 1186/week @ 2024-12-02 1336/week @ 2024-12-09 937/week @ 2024-12-16 125/week @ 2024-12-23 159/week @ 2024-12-30 912/week @ 2025-01-06 779/week @ 2025-01-13 1321/week @ 2025-01-20 455/week @ 2025-01-27 1718/week @ 2025-02-03 2071/week @ 2025-02-10 1352/week @ 2025-02-17 1275/week @ 2025-02-24 1431/week @ 2025-03-03 1417/week @ 2025-03-10

5,510 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
~31K SLoC