Canister controller and cycle balance need to be public

PaulLiu · January 16, 2022, 2:36am

For people who are willing to make cycle balance public through the black hole canister, you now can enjoy an automatic topup service too!

Please see Worry about your favorate canister running low on cycles? You got it covered!

gohan · April 4, 2022, 2:16pm

Canister controllers and module hash is available through dfx using

❯ dfx canister --network ic info ivcos-eqaaa-aaaab-qablq-cai
Controllers: hgfyw-myaaa-aaaab-qaaoa-cai
Module hash: 0x2d8060fe316775976ad0a33975e846e98b649536be51c8bcf33a7c61806041c6

github.com

dfinity/sdk/blob/6c892b4ebc97ed9a62e900be4a8b3417a8b4f5ba/src/dfx/src/commands/canister/info.rs

use crate::lib::environment::Environment;
use crate::lib::error::DfxResult;
use crate::lib::models::canister_id_store::CanisterIdStore;
use crate::lib::root_key::fetch_root_key_if_needed;

use anyhow::{anyhow, bail};
use clap::Parser;
use ic_agent::AgentError;
use ic_types::Principal;
use serde_cbor::Value;
use std::convert::TryFrom;

/// Get the hash of a canister’s WASM module and its current controller in a certified way.
#[derive(Parser)]
pub struct InfoOpts {
    /// Specifies the name or id of the canister to get its certified canister information.
    canister: String,
}

pub async fn exec(env: &dyn Environment, opts: InfoOpts) -> DfxResult {

This file has been truncated. show original

How to achieve same by using JavaScript?

gohan · April 4, 2022, 2:18pm

Also, by using nns/lifeline - rno2w-sqaaa-aaaaa-aaacq-cai canister and method canister_status we can get Canister’s controllers information as an error.

any other cleaner approach to get controllers and canister running status, module hash using js/httpAgent?

PaulLiu · April 4, 2022, 8:50pm

dfx actually gets the controller and hash of a canister through read_state call. You can also do that using low level API calls using agent-js.

However, only a controller of a canister can get its cycle balance and other info. This means, unless a canister’s controller purposely decides to expose such info to the public, they will remain private information.

One way for a developer to voluntarily expose such data is to use the black hole canister, simplying by adding the black hole canister id as one of the controllers of your own canister. Then others can send an update call canister_status to the black hole canister to get all status info including remaining cycle balance. It is useful and safe because the black hole canister itself is immutable. I also built a TipJar service to help monitor canister cycle balance and top up them when they run low, and of course, only those with blackhole as one of their controllers are supported.

Topic		Replies	Views
NNS Proposal: Add Public and Restricted canister_status Visibility Governance	15	518	October 10, 2024
I would like to put this to rest DFINITY	0	403	May 5, 2022
NNS Proposal: Make canister_status public to anyone Governance	70	3408	April 8, 2024
Request for Comment: Public & Private NNS Neurons NNS Governance community-consideration	83	2551	July 18, 2024
My confusion about social and asset privacy in Canister DFINITY	5	682	December 21, 2023

Canister controller and cycle balance need to be public

Related topics