dfinity / dfinity/developer-docs

guides: SNS inspection guide — how to query a live SNS and its canisters

Aperta
#228 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

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:

  1. List all deployed SNS instances (query list_deployed_snses on the SNS-W canister qaa6y-5yaaa-aaaaa-aaafa-cai)
  2. List all canisters belonging to an SNS (list_sns_canisters on the SNS root)
  3. Get full canister status and controller hierarchy (get_sns_canisters_summary on the SNS root)
  4. Find an SNS root from a known dapp canister ID
  5. Inspect SNS governance neurons (list_neurons on the SNS governance canister)
  6. Check token balances (swap, treasury) via icrc1_balance_of

Why it was deferred

  • The Learn Hub source uses dfx throughout (banned in this repo). All examples would need to be rewritten for icp 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 call examples with icp 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.md and add a sidebar entry under the Governance section.
  • Load the technical-documentation and sns-launch skills before writing.

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. 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

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.