Home

Awesome

DFINITY's Rust Agent Repository

GitHub Workflow Status

<!-- This file is only meant to be read on GitHub. It will not be published anywhere. -->

Contributing

Please follow the guidelines in the CONTRIBUTING.md document.

Building

We use cargo to build this repo. Make sure you have rust stable installed. To build the repo:

cargo build

Testing

There are two suites of tests that can be executed from this repo; the regular cargo tests and the ic-ref tests. In order to run the ic-ref tests, you will need a running local reference server. If you do not have one, those tests will be ignored.

Release

To release, increase the version number in all crates and run cargo build to update the lock file.

Packages

This repo has multiple packages in its Cargo workspace.

Package NameLinksDescription
ic-agentREADME DOCThe ic-agent is a library to talk directly to the Replica.
ic-utilsREADME DOCA library of utilities for managing calls and canisters.
icxREADMEA command line utility to use the agent. Not meant to be published, only available in this repo for tests.
ref-testsA package that only exists to run the ic-ref tests with the ic-agent as the connection.