Skip to main content

silica-scope

Interactive terminal reader for a finished SILICA AArch64 decode sweep.

SILICA decodes all 2³² AArch64 encodings through Capstone, LLVM, Unicorn and ARM's own XML spec and writes the result to artifacts/. silica-scope reads those published artifacts and lets you walk them: per-tool agreement, a heat map of the 256-shard encoding space, the disagreement corpus, and the filing-ready reproducers.

It never runs a sweep. Pure Python, no native dependencies — reading a finished sweep is all it does.

Install

pipx install silica-scope

Run

silica-scope                          # finds the nearest artifacts/ from $PWD
silica-scope /path/to/silica/artifacts
SILICA_ARTIFACTS=/path/to/artifacts silica-scope
silica-scope --report                 # static summary, no TUI

Panes

key pane what's in it
1 overview headline counts, per-tool agreement, taxonomy, provenance, what's on disk
2 map the 2³² space as a 16×16 shard grid, four colour channels
3 corpus stream disagreements/*.zst, filter by category, inspect any word
4 reproducers the filing-ready writeups, parsed and cross-checked

? for the full keymap, / to look up any 32-bit encoding, r to reload from disk, q to quit.

The map's row is a shard id's high nibble and its column the low nibble, so shard 0xab sits at row a, column b, covering 0xab000000..0xabffffff. Press m to cycle the colour channel; x computes exact popcount(tool XOR spec) per shard straight off bitmaps/ when those are present (it reads 4 × 512 MiB, so it's opt-in).

Partial artifacts

A published SILICA checkout ships only artifacts/reproducers/ and artifacts/result_hash.txt — the bitmaps, shard records and corpus are multi-gigabyte and regenerated locally. silica-scope treats that as a normal state, not an error: panes that have no data say what's missing and where it looked, and the overview never claims a sweep it can't see evidence of. A file that exists but is malformed is reported, per pane and in a problems banner.

Source

Source, issues and the full SILICA sweep engine live at github.com/nluevano/silica — see tui/README.md there for building from a checkout.

Apache-2.0.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

silica_scope-0.1.0.tar.gz (48.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

silica_scope-0.1.0-py3-none-any.whl (47.0 kB view details)

Uploaded Python 3

File details

Details for the file silica_scope-0.1.0.tar.gz.

File metadata

  • Download URL: silica_scope-0.1.0.tar.gz
  • Upload date:
  • Size: 48.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for silica_scope-0.1.0.tar.gz
Algorithm Hash digest
SHA256 15f40aaf408ec3711f784226b6637f6c71d98d5ba09cee13fb6690afe42ffdc8
MD5 d22473f900b35e549178033c5051e9e8
BLAKE2b-256 21b6e6a8cacaa2f24a1fae66659841f6ee6c493aabbd243782359c3a19bdbcfc

See more details on using hashes here.

Provenance

The following attestation bundles were made for silica_scope-0.1.0.tar.gz:

Publisher: publish-scope.yml on Nathan-Luevano/silica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file silica_scope-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: silica_scope-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 47.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for silica_scope-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ba8d1d965087baffddbf769a335e962623d0039a9b44b6165fe158f89fdc6a72
MD5 191c4c26e97a92efcedc90d795eeb3cc
BLAKE2b-256 2b504b3a16540b7148fa051ba2f620b80310be2c512e4d07a7ceda6ec1c7087f

See more details on using hashes here.

Provenance

The following attestation bundles were made for silica_scope-0.1.0-py3-none-any.whl:

Publisher: publish-scope.yml on Nathan-Luevano/silica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page