NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io, #5063 most downloaded on crates.io
Candid is an interface description language (IDL) for interacting with canisters running on the Internet Computer.
Latest stable
0.10.40
Last release 17 days ago
05 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Some releases are documented
notes for 35 of the last 60 stable releases
4 versions withdrawn
withdrawn after publishing
7 years old
124 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
The candid_parser::types module has been renamed to candid_parser::syntax.
Breaking changes:
candid_parser::types module has been renamed to candid_parser::syntax.Non-breaking changes:
Supports collecting line comments as doc comments in the following cases:
// This is a valid doc comment for the service
service : {
greet : (text) -> (text);
}
service : {
// This is a valid doc comment for greet
greet : (text) -> (text);
}
// This is a valid doc comment for type A
type A = record {
my_field : text;
};
type A = record {
// This is a valid doc comment for my_field
my_field : text;
};
type B = record {
// This is a valid doc comment for nat element
nat;
text;
}
type C = variant {
// This is a valid doc comment for my_variant_field
my_variant_field : nat;
};
Adds the IDLMergedProg struct, used to collect the syntax types when parsing Candid declarations.
Supports reflecting doc comments from Candid declarations to the generated bindings. To enable this feature, we had to change the following:
candid_parser::bindings::motoko::compile function now takes an additional &IDLMergedProg parameter.candid_parser::bindings::rust::compile function now takes an additional &IDLMergedProg parameter.candid_parser::bindings::typescript::compile function now takes an additional &IDLMergedProg parameter.candid::pretty::syntax module has been added. It exposes the pretty_print function, which is used to pretty print the IDLMergedProg struct. The behavior is similar to the already existing candid::pretty::candid::compile function, but uses the syntax types instead of the candid types.Supports reflecting doc comments from Rust canister methods to the Candid generated bindings. Example:
/// Doc comment for greet,
/// even on multiple lines
#[candid_method(query)]
fn greet(name: &str) -> String {
format!("Hello, {name}!")
}
The generated Candid bindings will then look like this:
service : {
// Doc comment for greet,
// even on multiple lines
greet : (text) -> (text);
}
To support this feature, hhe following have been added:
candid::pretty::candid::DocComments struct, which is used to collect doc comments from Rust canister methods, in the candid_derive::export_service macro.candid::pretty::candid::compile_with_docs function, which takes a &DocComments parameter.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Add import service in parser to allow merging services.
import service in parser to allow merging services.Nothing published for this version
One column per quarter.