You can check the version of dfx you have installed by running the following command:
You get to the Candid UI a little differently in the latest release:
Test functions in a browser
dfx command-line interface and the Network Nervous System application—to share a common description for a service.
Based on the type signature of the actor, Candid also provides a web interface that allows you to call canister functions for testing and debugging.
After you have deployed your project locally using the
dfx deploy or
dfx canister install command, you can access the Candid web interface endpoint in a browser. This web interface—the Candid UI—exposes the service description in a form, enabling you to quickly view and test functions and experiment with entering different data types without writing any front-end code.
To use the Candid web interface to test canister functions:
- Copy the Candid UI canister identifier for your application.
- Open a browser and navigate to the address and port number specified in the
dfx.json configuration file.
By default, the
local network binds to the
127.0.0.1:8000 address and port number.
- Add the required
canisterId and UI canister identifier to the URL.
For example, the full URL should look similar to the following but with the
canister_identifier that was returned by the
dfx deploy or
dfx canister install command:
In the form displayed, you can provide a canister identifier or choose a Candid description (
.did ) file to display.
- Paste the
<project-name>_assets canister identifier for your application into the Provide a canister ID field, then click Go .
- Review the list of function calls and types defined in the program.
- Type a value of the appropriate type for a function or click Random to generate a value, then click Call or Query to see the result.
Note that depending on the data type, the Candid interface might display additional configuration settings for testing functions. For example, if a function takes an array, you might need to specify the number of items in the array before entering values.
In this example, each function accepts an array of text strings. Therefore, you first select the length of the array, then set values for each item before clicking Call .