This directory should contain all the replica’s Rust code.
Warning: we are still working to clean up the documentation to provide a clean mapping of the rust code.
In the meantime, the least we can do is provide you an easy way to do that very first thing what we would do when encountering repos which look interesting: git clone them and see if they compile locally.
To do that simplest of steps:
-
install rust
-
cd rs
-
cargo build --release --bin replica
-
Specify the new API in the Internet Computer Reference repository and consult the canister os team for any help or review needed.
-
Ensure that the acceptance test suite is updated:
hs/spec_compliance
andrs/tests/testing_verification/wabt_tests
. Inform @team-testing of the work required. -
Ensure that the Rust CDK is updated: Rust Canister Development Kit. Inform @eng-sdk of the work required.
-
Ensure that Motoko is updated: Motoko. Inform @eng-motoko of the work required.
-
Implement the new API:
system_api
andembedders
crates. -
Unit tests: functionality and wasm validation code tests.
-
Update the implementation of the universal canister and replace
universal-canister.wasm
with the newly generated one. -
Update the interface of the rust canister and add tests.
-
Add system tests that cover the new API.
-
Once the Public Spec is released and implementation merged in the master branch, Motoko and Rust CDK can be updated to use the new API. For more details, please contact @eng-motoko and @eng-sdk.