ic-testkit

PocketIC-oriented test utilities for Internet Computer canister tests.

This crate is the published Rust package in the ic-testkit workspace. It provides:

• direct re-exports of PocketIc and PocketIcBuilder
• typed Candid query/update helpers with contextual, structured errors
• canister install and retry helpers
• cached single- and multi-canister PocketIC baseline pools
• deterministic fake principals and account-like values
• transactional external artifact sets and content-addressed Wasm builds with bounded cache retention
• compact benchmark marker parsing, aggregation, comparison, and report writing
• canister-side Performance::measure marker emission

ic-testkit does not wrap the PocketIC simulator API, serialize independent instances, or own PocketIC's server-binary cache. Tests normally create one fresh PocketIc each and use its inherent methods for simulator operations; focused extension traits provide reusable harness behavior.

Most users should read the repository README for setup, examples, local checks, and release notes.

The repository also includes a complete multi-canister baseline recipe and a transactional external-artifact example that are compiled by the crate's normal all-target checks.