Diagnóstico del toolchain de Stellar
Tu SDK de Soroban se está quedando atrás.
kedgeway le pregunta al ecosistema de Stellar en vivo qué versión es la actual y te dice cuánto desfase tienes.
1,285 repos de Soroban usan hoy un SDK obsoleto. Scout vía Raven, 2026-11-11.
fig. 1 — Sallie Gardner al galope · cuadro 08 de 11
E. Muybridge, lám. 626 · Palo Alto, 1878
01 — El ecosistema
Uno de cada cinco repos de Soroban usa un SDK obsoleto.
Scout escaneó 5,863 repos el 2026-11-11. 1,285 de ellos (22%) usan un soroban-sdk obsoleto. Nada en su build se lo avisa.
5,863 repos de Soroban según el estado de soroban-sdk
| estado | repos | proporción |
|---|---|---|
| obsoleto | 1,285 | 22.0% |
| actual | 197 | 3.4% |
| soportado | 4,330 | 73.9% |
| desconocido | 51 | 0.9% |
Fuente: Stellar Raven / Scout · 2026-11-11
- repos escaneados
- 5,863
- obsoletos
- 1,285
- del ecosistema
- 22%
- major actual de soroban-sdk
- 28
02 — Cómo funciona
Comparado con el ecosistema en vivo. Nunca con una lista vieja.
kedgeway busca soroban-sdk en Cargo.toml, incluidas las dependencias del workspace y los renombres con package =, y busca @stellar/stellar-sdk, @stellar/stellar-base y los paquetes heredados soroban-client y stellar-sdk en package.json. Luego consulta a Stellar Raven. Si una fuente falla, el reporte dice DATA_DEGRADED en lugar de adivinar.
01
escanear
Cargo.toml / package.json
02
consultar a raven
Software Versions + Scout
03
diagnosticar
reporte · fuente + hora
Funciona con
- Cargo.toml
- package.json
- GitHub Actions
- Stellar Raven
- Soroban
03 — El reporte
Un reporte para actuar. Cada línea cita su fuente.
Los hallazgos se ordenan por severidad, apuntan al archivo y dicen qué hacer. Cada hallazgo cita su fuente y su hora de observación. Usa --json para máquinas y --fail-on para CI.
Reporte de ejemplo para ./my-contract. Ecosistema: major actual de soroban-sdk 28, observado el 2026-11-11T22:00:57Z, fuente Stellar Raven y Scout.
- Crítico, SDK_DEPRECATED, contracts/hello/Cargo.toml: soroban-sdk 21.0.0 está en un major marcado como obsoleto (actual: 28). Actualiza.
- Crítico, JS_LEGACY_PACKAGE, package.json: soroban-client 1.0.0 es un paquete heredado; reemplázalo por @stellar/stellar-sdk.
Resumen: 2 critical, 0 warning, 0 info.
04 — Hallazgos
Lo que detecta. Dieciocho códigos, tres severidades.
Cada hallazgo nombra el archivo, cita su fuente y la hora en que se observó, y dice qué hacer.
| código | severidad | qué significa |
|---|---|---|
| SDK_DEPRECATED | critical | soroban-sdk está en un major obsoleto o más de un major atrás. |
| JS_LEGACY_PACKAGE | critical | soroban-client o el stellar-sdk sin scope siguen en package.json. |
| SDK_BEHIND | warning | soroban-sdk está exactamente un major detrás del actual. |
| MANIFEST_UNPARSEABLE | warning | No se pudo leer un Cargo.toml, un package.json o un directorio, así que no se revisó. |
| DATA_DEGRADED | warning | Falló una fuente de datos. El reporte lo dice en lugar de adivinar. |
| NO_SDK_FOUND | info | No se encontró ninguna dependencia del SDK de Stellar en la ruta escaneada. |
05 — Instalación
Se instala en un minuto. Después inicia sesión en Raven.
Node 22.12 o posterior. Instala la CLI, inicia sesión en Raven y diagnostica un repo.
El token se guarda en ~/.config/kedgeway/auth.json con modo 0600. --fail-on warning sale con código 2 si algún hallazgo es warning o más grave.
# 1. Install
npm install -g kedgeway
# 2. Sign in to Raven (opens your browser)
kedgeway login
# 3. Diagnose
kedgeway diagnose ./my-contract --fail-on warning
# Or scan a remote repository
kedgeway diagnose https://github.com/o/r06 — Preguntas frecuentes
Preguntas, respondidas. Cortas, sin marketing.
No. kedgeway envía un único script fijo a Stellar Raven, sin nada de tu repo. La comparación se ejecuta en tu máquina.
Inicias sesión en Stellar Raven una sola vez con OAuth en tu navegador. El token se guarda localmente en ~/.config/kedgeway/auth.json.
Sí. --offline reutiliza el snapshot de Raven en caché de tu última ejecución en vivo, y --fixture usa un archivo de snapshot. La primera ejecución en vivo necesita red y una sesión iniciada en Raven.
soroban-sdk en Cargo.toml, y @stellar/stellar-sdk, @stellar/stellar-base y los paquetes heredados soroban-client y stellar-sdk en package.json.
Sí. --fail-on sale con código 2 cuando un hallazgo alcanza el umbral. Para datos en vivo en CI, define el secreto KEDGEWAY_AUTH; o usa un fixture.
Sí. Ejecuta kedgeway init --mode pr. Un job semanal de GitHub Actions compara tus versiones del SDK con datos en vivo de Stellar. Cuando estás atrasado, publica una sola rama, kedgeway/migrate-<major>, y abre un único pull request con los cambios, los hallazgos, los pasos manuales como lista de tareas y la guía de migración. Las nuevas ejecuciones actualizan el mismo PR. Se ejecuta en tu repo con tu propia sesión de Raven: sin servicio alojado, y tu código fuente nunca se reescribe.
npm install -g kedgeway. Necesita Node 22.12 o posterior.
07 — Integraciones
Ya no es un roadmap. Cuatro formas de usarlo.
fig. 9cuadro 05, compuesto en tipografía
Deja de quedarte atrás. Diagnostica y luego migra.
npm install -g kedgeway