lotus/chain/actors/builtin
Steven Allen 30981d0fdd
feat: refactor: actor bundling system (#8838)
1. Include the builtin-actors in the lotus source tree.
2. Embed the bundle on build instead of downloading at runtime.
3. Avoid reading the bundle whenever possible by including bundle
   metadata (the bundle CID, the actor CIDs, etc.).
4. Remove everything related to dependency injection.
    1. We're no longer downloading the bundle, so doing anything ahead
       of time doesn't really help.
    2. We register the manifests on init because, unfortunately, they're
       global.
    3. We explicitly load the current actors bundle in the genesis
       state-tree method.
    4. For testing, we just change the in-use bundle with a bit of a
       hack. It's not great, but using dependency injection doesn't make
       any sense either because, again, the manifest information is
       global.
    5. Remove the bundle.toml file. Bundles may be overridden by
       specifying an override path in the parameters file, or an
       environment variable.

fixes #8701
2022-06-13 10:15:00 -07:00
..
account Use new go-state-types accessors 2022-05-17 15:21:27 -04:00
cron Use new go-state-types accessors 2022-05-17 15:21:27 -04:00
init Use new go-state-types accessors 2022-05-17 15:21:27 -04:00
market Merge branch 'release/v1.15.3' into jen/mergev1153to16 2022-05-31 16:33:18 -04:00
miner Use new go-state-types accessors 2022-05-17 15:21:27 -04:00
multisig Use new go-state-types accessors 2022-05-17 15:21:27 -04:00
paych Use new go-state-types accessors 2022-05-17 15:21:27 -04:00
power Use new go-state-types accessors 2022-05-17 15:21:27 -04:00
reward Use new go-state-types accessors 2022-05-17 15:21:27 -04:00
system Implement function to migrate actors with only code changes 2022-06-10 15:52:32 -04:00
verifreg Use new go-state-types accessors 2022-05-17 15:21:27 -04:00
builtin.go feat: refactor: actor bundling system (#8838) 2022-06-13 10:15:00 -07:00
builtin.go.template feat: refactor: actor bundling system (#8838) 2022-06-13 10:15:00 -07:00
README.md [WIP] Network upgrade support 2020-09-11 20:16:29 -07:00

Actors

This package contains shims for abstracting over different actor versions.

Design

Shims in this package follow a few common design principles.

Structure Agnostic

Shims interfaces defined in this package should (ideally) not change even if the structure of the underlying data changes. For example:

  • All shims store an internal "store" object. That way, state can be moved into a separate object without needing to add a store to the function signature.
  • All functions must return an error, even if unused for now.

Minimal

These interfaces should be expanded only as necessary to reduce maintenance burden.

Queries, not field assessors.

When possible, functions should query the state instead of simply acting as field assessors. These queries are more likely to remain stable across specs-actor upgrades than specific state fields.

Note: there is a trade-off here. Avoid implementing complicated query logic inside these shims, as it will need to be replicated in every shim.