Documentación / Uso / Hallazgos

Hallazgos

Cada hallazgo tiene una severidad, un código, el archivo al que se aplica, un mensaje y la evidencia que lo respalda. Hay dieciocho códigos.

critical: SDK_DEPRECATED, JS_SDK_DEPRECATED, JS_LEGACY_PACKAGE, CLI_DEPRECATED
warning: SDK_BEHIND, JS_SDK_BEHIND, SDK_UNKNOWN, JS_SDK_UNKNOWN, MANIFEST_UNPARSEABLE, DATA_DEGRADED, CLI_BEHIND, CLI_UNKNOWN, RUST_TARGET_LEGACY, RUST_TOOLCHAIN_OLD
info: SDK_CURRENT, JS_SDK_CURRENT, NO_SDK_FOUND, CLI_CURRENT

Cuando un lockfile resuelve una dependencia, la evidencia lo indica, por ejemplo resolved 21.7.6 from Cargo.lock; manifest ^21, y la comparación usa la versión resuelta. Cuando el lockfile es ambiguo, se usa la versión del manifiesto y la evidencia lo anota. Consulta Qué escanea.

Las verificaciones de JavaScript comparan contra el release actual de @stellar/stellar-sdk. @stellar/stellar-base se compara con ese mismo release.

SDK_DEPRECATED

critical

Significado: soroban-sdk está en un major que Scout lista como obsoleto y que es inferior al major actual, o está más de un major por detrás del major actual.
Evidencia que se muestra: La comparación de majors: por ejemplo major 21 < current major 28 and appears in the Scout deprecated sample, o major 21 < current major 28 - 1, seguida de la fuente y la hora de observación.
Qué hacer: Actualiza soroban-sdk al major actual que aparece en el encabezado del reporte. Las notas de versión se obtienen de la búsqueda en la documentación (consulta Fuentes de datos).

SDK_BEHIND

warning

Significado: soroban-sdk está exactamente un major por detrás del major actual.
Evidencia que se muestra: major N = current major M - 1, con la fuente y la hora de observación.
Qué hacer: Planifica la actualización al major actual. Todavía no es obsoleto.

SDK_CURRENT

info

Significado: soroban-sdk está en el major actual o en uno más reciente.
Evidencia que se muestra: major N >= current major M, con la fuente y la hora de observación.
Qué hacer: Nada. Si el major es más reciente que el del ecosistema, el mensaje dice or newer.

SDK_UNKNOWN

warning

Significado: No se pudo interpretar la versión de soroban-sdk en el manifiesto, o el major actual no está disponible, así que no se hizo ninguna comparación.
Evidencia que se muestra: Version unparseable from manifest; no comparison made o Current major evidence unavailable; no deprecation claim made.
Qué hacer: Si la versión no se puede interpretar, declara una versión simple como 21.0.0 (consulta Qué escanea). Si el major actual no está disponible, busca un hallazgo DATA_DEGRADED y vuelve a ejecutar.

JS_SDK_DEPRECATED

critical

Significado: Una dependencia del SDK de Stellar para JavaScript está más de un major por detrás del release actual.
Evidencia que se muestra: major N < current major M - 1, con la fuente y la hora de observación.
Qué hacer: Actualiza a la versión actual de @stellar/stellar-sdk. Revisa sus notas de versión por cambios incompatibles.

JS_SDK_BEHIND

warning

Significado: Una dependencia del SDK de Stellar para JavaScript está exactamente un major por detrás del release actual.
Evidencia que se muestra: major N = current major M - 1, con la fuente y la hora de observación.
Qué hacer: Planifica la actualización al major actual.

JS_SDK_CURRENT

info

Significado: Una dependencia del SDK de Stellar para JavaScript está en el major actual o en uno más reciente.
Evidencia que se muestra: major N >= current major M, con la fuente y la hora de observación.
Qué hacer: Nada.

JS_SDK_UNKNOWN

warning

Significado: No se pudo interpretar la versión, o el release actual del SDK de JavaScript no está disponible, así que no se hizo ninguna comparación.
Evidencia que se muestra: Version unparseable from manifest o Current JS SDK version evidence unavailable.
Qué hacer: Declara una versión simple, o busca DATA_DEGRADED y vuelve a ejecutar.

JS_LEGACY_PACKAGE

critical

Significado: El repo depende del paquete heredado soroban-client o del paquete sin scope stellar-sdk.
Evidencia que se muestra: Legacy package name detected in manifest, con la fuente de referencia y la hora de observación.
Qué hacer: Reemplázalo por @stellar/stellar-sdk.

MANIFEST_UNPARSEABLE

warning

Significado: No se pudo leer o interpretar un Cargo.toml, un package.json o un directorio. Sus dependencias no se verificaron.
Evidencia que se muestra: El mensaje de error del parser o del sistema de archivos.
Qué hacer: Corrige el archivo o el directorio ilegible (por ejemplo, TOML o JSON inválido, o un error de permisos) y vuelve a ejecutar. Hasta entonces, esa ruta queda sin verificar.

DATA_DEGRADED

warning

Significado: Una de las fuentes del ecosistema falló o devolvió datos parciales, o se usó un snapshot en caché vencido o de respaldo. Los veredictos relacionados pueden quedar como desconocidos o incompletos.
Evidencia que se muestra: Reported while collecting the snapshot observed <time>. El mensaje nombra la fuente que falló, por ejemplo stellarDocs.get_doc_page: .... La columna de archivo dice (ecosystem data).
Qué hacer: Vuelve a ejecutar. Si persiste, verifica la disponibilidad de Raven y lee en el mensaje qué fuente falló.

NO_SDK_FOUND

info

Significado: No se detectó ninguna dependencia de soroban-sdk ni del SDK de Stellar para JavaScript en la ruta escaneada.
Evidencia que se muestra: Scanned Cargo.toml and package.json files under <root>.
Qué hacer: Revisa la ruta. Las carpetas como node_modules y target se omiten, y el escaneo se detiene cuatro niveles más abajo.

CLI_DEPRECATED

critical

Significado: Un stellar-cli fijado está dos o más majors por detrás de la Stellar CLI actual. Un hallazgo por cada versión fijada; no se reporta nada si el repo no fija ninguna.
Evidencia que se muestra: La versión fijada y el archivo y la línea de donde sale, por ejemplo pinned in .github/workflows/ci.yml:23. La comparación usa la versión de la Stellar CLI de la página oficial Software Versions.
Qué hacer: Actualiza la versión fijada al major actual de la Stellar CLI.

CLI_BEHIND

warning

Significado: Un stellar-cli fijado está exactamente un major por detrás de la Stellar CLI actual.
Evidencia que se muestra: La versión fijada y el archivo y la línea de donde sale, por ejemplo pinned in .github/workflows/ci.yml:23.
Qué hacer: Planifica la actualización al major actual.

CLI_CURRENT

info

Significado: Un stellar-cli fijado está en el major actual (o en uno más reciente).
Evidencia que se muestra: La versión fijada y el archivo y la línea de donde sale, por ejemplo pinned in .github/workflows/ci.yml:23.
Qué hacer: Nada.

CLI_UNKNOWN

warning

Significado: Existe un stellar-cli fijado, pero su versión no se puede interpretar (por ejemplo, un nombre de rama o una expresión de CI), o la versión actual de la Stellar CLI no está disponible, así que no se emite ningún veredicto.
Evidencia que se muestra: La versión fijada y el archivo y la línea de donde sale, por ejemplo pinned in .github/workflows/ci.yml:23.
Qué hacer: Fija una versión simple, o busca DATA_DEGRADED y vuelve a ejecutar.

RUST_TARGET_LEGACY

warning

Significado: wasm32-unknown-unknown está declarado en un repo con soroban-sdk y sin wasm32v1-none. La Stellar CLI 23+ compila para wasm32v1-none. Un hallazgo por cada lugar donde se declara.
Evidencia que se muestra: El archivo y la línea que lo declaran, como rust-toolchain.toml, .cargo/config.toml, un workflow, un Makefile o un script.
Qué hacer: Ejecuta rustup target add wasm32v1-none y decláralo donde está declarado el target heredado.

RUST_TOOLCHAIN_OLD

warning

Significado: Un canal de Rust fijado es anterior a 1.84.0 en un repo con soroban-sdk. La guía de configuración requiere Rust v1.84.0 o posterior. stable y nightly no cuentan como versiones fijadas.
Evidencia que se muestra: El canal fijado y el archivo y la línea de donde sale.
Qué hacer: Sube el canal fijado a 1.84.0 o posterior.