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
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
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 |
Reference library for implementing a standard fungible token in native actors
| Specification | Reference Implementation | Examples |
|---|---|---|
| FRC-0046 | frc46_token | basic_token basic_receiver |
Reference library for implementing a standard non-fungible token in native actors
| Specification | Reference Implementation | Examples |
|---|---|---|
| FRC-0053 | frc53_nft | basic_nft basic_receiver |
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
Dual-licensed: MIT, Apache Software License v2.
The tests require downloading a builtin-actors bundle. Either run the tests with make test or run make test-deps before running tests manually with cargo.
You can change the actors version by changing ACTORS_VERSION in the Makefile. If you want to test with a custom bundle entirely, replace the testing/bundles/builtin-actors.car symlink with the custom bundle. Note, however, that running make test will revert that change, so you'll want to test with cargo test manually.
For local coverage testing, please install the grcov crate.
Copyright Protocol Labs, Inc, 2022