keep-core icon indicating copy to clipboard operation
keep-core copied to clipboard

feat(scripts): add wallet-operator mapper for consolidation analysis

Open lrsaturnino opened this issue 2 months ago • 1 comments

Add comprehensive wallet-operator mapping toolset for beta staker consolidation analysis. Enables identification of wallets containing deprecated operators and BTC distribution calculations.

Core functionality:

  • query-dkg-events.js: Extracts operator membership from on-chain DKG events
  • analyze-per-operator.js: Calculates BTC distribution by provider
  • validate-operator-list.js: Verifies operator list completeness

Configuration:

  • operators.json: Defines KEEP (4 active) vs DISABLE (16 deprecated) operators
  • Contract ABIs for Bridge and WalletRegistry interactions
  • Archive node RPC support for historical event queries

Documentation:

  • README: Usage guide and integration points
  • Manual sweep procedures and execution scripts
  • Operator consolidation communication guidelines

Integration:

  • Provides data source for monitoring dashboard
  • Supports draining progress assessment
  • Enables manual sweep decision-making

Technical details:

  • Uses threshold cryptography (51/100 signatures)
  • Queries sortition pool for operator address resolution
  • Classifies operators by provider (STAKED, P2P, BOAR, NUCO)

lrsaturnino avatar Oct 27 '25 03:10 lrsaturnino