Skip to content

feat(data-processing): add maintainable alias registry for entity nor… - #1152

Open
olatundefay-prog wants to merge 1 commit into
Pulsefy:mainfrom
olatundefay-prog:feature/alias-registry
Open

feat(data-processing): add maintainable alias registry for entity nor…#1152
olatundefay-prog wants to merge 1 commit into
Pulsefy:mainfrom
olatundefay-prog:feature/alias-registry

Conversation

@olatundefay-prog

Copy link
Copy Markdown

#1056

done with this task "Create a maintainable alias registry so projects, assets, and ecosystem terms can be normalized consistently across ingestion and analytics."

…malization

- Add data/alias_registry.yaml as the contributor-editable source of truth
  for canonical names across assets, projects, and ecosystem terms
- Add src/normalization/alias_registry.py with AliasRegistry, RegistryEntry,
  and get_registry() singleton; supports O(1) alias-to-canonical lookups,
  thread-safe loading, and graceful fallback when YAML is unavailable
- Wire keywords.py (CRYPTO_PROJECT_MAP, TICKER_TO_PROJECT) to load from the
  registry at import time, keeping built-in dicts as a resilience fallback
- Wire onchain_entity_linker.py DEFAULT_ASSETS to load from registry on first
  instantiation, falling back to TICKER_TO_PROJECT if registry is unavailable
- Add tests/test_alias_registry.py covering all four acceptance criteria:
  multiple aliases per canonical, normalization used in processing,
  contributor YAML-only workflow, and downstream dataset normalization
@drips-wave

drips-wave Bot commented Jul 28, 2026

Copy link
Copy Markdown

Hey @olatundefay-prog! 👋 It looks like this PR isn't linked to any issue.

If this PR is for one of the issues assigned to you as part of a Wave, please link it to ensure your contribution is tracked properly. You can do this by adding a keyword to the PR description (e.g., Closes #123), or by clicking a button below:

Issue Title
#1056 Data-processing: Entity alias registry and synonym management workflow Link to this issue

ℹ️ Learn more about linking PRs to issues

@Cedarich

Copy link
Copy Markdown
Contributor

@olatundefay-prog kindly fix workflow

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants