dfinity / dfinity/developer-docs
guides: SNS inspection guide — how to query a live SNS and its canisters
Nessuno ha ancora preso questa issue.
- Lingua principale
- JavaScript
- Stelle
- 4
- Fork
- 5
- Merge medio
- 1g 6h
- PR unite (30g)
- 30
Descrizione
Background
The Learn Hub article "How to Inspect an SNS and Its Dapp Canisters" was evaluated during the Learn Hub migration (#208) and intentionally deferred. It was not part of the old portal docs either.
The staging file is at .migration/learn-hub/how-does-icp-work/sns/how-to-inspect-an-sns-and-its-dapp-canisters.md (marked out-of-scope in the final cleanup).
What the guide would cover
A practical how-to for developers building governance tooling or verifying a live SNS deployment:
- List all deployed SNS instances (query
list_deployed_snseson the SNS-W canisterqaa6y-5yaaa-aaaaa-aaafa-cai) - List all canisters belonging to an SNS (
list_sns_canisterson the SNS root) - Get full canister status and controller hierarchy (
get_sns_canisters_summaryon the SNS root) - Find an SNS root from a known dapp canister ID
- Inspect SNS governance neurons (
list_neuronson the SNS governance canister) - Check token balances (swap, treasury) via
icrc1_balance_of
Why it was deferred
- The Learn Hub source uses
dfxthroughout (banned in this repo). All examples would need to be rewritten foricp canister call. - The content was never in the old portal developer docs.
- The audience is narrow: developers writing governance tooling or operators verifying their own SNS. Most of the canister hierarchy context is already documented in
concepts/sns-framework.md.
When picking this up
- Replace all
dfx canister callexamples withicp canister call. - Verify Candid argument syntax against the SNS governance Candid interface in
.sources/icskills/or the on-chain interface. - Place at
docs/guides/governance/inspecting-sns.mdand add a sidebar entry under the Governance section. - Load the
technical-documentationandsns-launchskills before writing.
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia da .migration/learn-hub/how-does-icp-work/sns/how-to-inspect-an-sns-and-its-dapp-canisters.md e dall’interfaccia Candid di governance di SNS in .sources/icskills/. Sostituisci gli esempi dfx elencati con icp canister call, crea docs/guides/governance/inspecting-sns.md e aggiungi la relativa voce nella sidebar Governance. Il lavoro è completato quando le sei attività di ispezione sono coperte con la sintassi degli argomenti verificata e sono state caricate le skill technical-documentation e sns-launch.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Ambito
- documentation
- Tipo di issue
- Documentazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Stato di attività
- Tranquilla
- Chiarezza
- Specificata chiaramente
- Idoneità per principianti
- 65/100