shaha

Constructor de bases de datos hash y herramienta de búsqueda inversa. SHA + aha!

Construye bases de datos hash precomputadas a partir de listas de palabras y luego consúltalas para encontrar preimágenes.

Instalación

cargo install shaha

O compilar desde el código fuente:

git clone https://github.com/oritwoen/shaha
cd shaha
cargo build --release

Uso

Construir una base de datos hash

# Single algorithm (default: sha256)
shaha build words.txt

# Multiple algorithms
shaha build words.txt -a md5 -a sha256 -a keccak256

# Custom output file
shaha build words.txt -o mydb.parquet

# With source metadata
shaha build rockyou.txt -a hash160 -s rockyou

Consultar por preimagen

# Find preimage by hash
shaha query 5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8

# Prefix search
shaha query 5e8848

# Filter by algorithm
shaha query 5e8848 -a sha256

# Output formats
shaha query 5e8848 --format plain   # default
shaha query 5e8848 --format json
shaha query 5e8848 --format table

Información de la base de datos

shaha info hashes.parquet

Salida:

Database: "hashes.parquet"
Records:  1000000
Size:     45.32 MB
Algorithms: sha256, md5, keccak256
Sources:  rockyou

Algoritmos

Formato de almacenamiento

Las bases de datos se almacenan como archivos Apache Parquet con compresión ZSTD.

Esquema:

Los archivos Parquet pueden consultarse con DuckDB, Polars, Spark o Cloudflare R2 SQL.

Casos de uso

• Investigación de seguridad - búsquedas inversas de hash
• Desafíos CTF - descifrado rápido de hashes
• Forense - identificación de contraseñas conocidas
• Análisis de blockchain - investigación de direcciones de Bitcoin/Ethereum

Configuración

La configuración se carga desde (en orden de prioridad):

1. Banderas de CLI
2. Variables de entorno
3. .shaha.toml en el directorio actual
4. ~/.config/shaha/config.toml

Ejemplo de archivo de configuración

[storage.r2]
endpoint = "https://account-id.r2.cloudflarestorage.com"
bucket = "my-bucket"
access_key_id = "your-access-key"
secret_access_key = "your-secret-key"
region = "auto"
path = "hashes.parquet"

[defaults]
algorithms = ["sha256", "md5"]
output = "hashes.parquet"

Almacenamiento R2/S3

Construye y consulta directamente desde Cloudflare R2 o almacenamiento compatible con S3:

# Build to R2
shaha build words.txt --r2

# Query from R2
shaha query 5e8848 --r2

Variables de entorno:

• SHAHA_R2_ENDPOINT - URL del endpoint S3/R2
• SHAHA_R2_BUCKET - Nombre del bucket
• SHAHA_R2_ACCESS_KEY_ID o AWS_ACCESS_KEY_ID
• SHAHA_R2_SECRET_ACCESS_KEY o AWS_SECRET_ACCESS_KEY
• SHAHA_R2_PATH - Ruta dentro del bucket
• SHAHA_R2_REGION - Región (por defecto: "auto")

Hoja de ruta

• Catálogo de datos R2 - integración de Apache Iceberg para consultas más rápidas

Licencia

MIT