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

Abierto
#228 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
65/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Tranquilo

Línea de trabajo

Comienza con .migration/learn-hub/how-does-icp-work/sns/how-to-inspect-an-sns-and-its-dapp-canisters.md y la interfaz Candid de gobernanza de SNS en .sources/icskills/. Reemplaza los ejemplos de dfx indicados por icp canister call, crea docs/guides/governance/inspecting-sns.md y añade su entrada en la barra lateral de Governance. La tarea estará terminada cuando las seis tareas de inspección estén cubiertas con la sintaxis de argumentos verificada y se hayan cargado las skills technical-documentation y sns-launch.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.
Lenguaje dominante
JavaScript
Estrellas
4
Forks
5
Merge medio
1 d 6 h
PR fusionados (30 d)
30

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de dfinity/developer-docs

Todos los issues de dfinity/developer-docs

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.