Saltar al contenido principal

Plugins

El Stellar CLI admite plugins de una manera muy simple. Todo lo que necesitas es un ejecutable (no tiene que ser un binario) en tu PATH que comience con stellar- y el CLI lo detectará y cargará automáticamente.

También puedes instalar plugins que están disponibles públicamente. Un ejemplo es rs-stellar-strkey; puedes instalarlo usando cargo de Rust:

cargo install --locked stellar-strkey --features cli

Eso instalará el binario stellar-strkey en tu directorio ~/.cargo/bin. Para el propósito de este ejemplo, asumiremos que ese directorio ya está en tu $PATH.

Advertencia de seguridad

¡Ten cuidado! Los plugins tienen el mismo acceso a tu sistema que el Stellar CLI en sí. Solo instala plugins de fuentes en las que confíes.

Listar plugins disponibles​

Para listar los plugins disponibles en tu sistema, usa el comando stellar plugins --list:

$ stellar plugins --list
Installed Plugins:
    strkey

Crear un nuevo plugin​

Como se mencionó anteriormente, los plugins solo necesitan ser un ejecutable disponible en tu PATH que comience con stellar-. Comienza creando un nuevo archivo llamado stellar-hello. Este ejemplo muestra cómo crear un plugin usando bash, así que necesitas un sistema que lo soporte (basado en Unix o WSL de Windows).

touch ~/.bin/stellar-hello

Agrega el siguiente contenido al archivo:

#!/usr/bin/env bash

echo "hello from stellar plugin"

Ahora, haz el archivo ejecutable con chmod:

chmod +x ~/.bin/stellar-hello

Si todo está configurado correctamente (es decir, el ~/.bin está en tu PATH y ~/.bin/stellar-hello es ejecutable), deberías poder encontrarlo:

$ stellar plugins --list
Installed Plugins:
    hello
    strkey

Finalmente, puedes ejecutarlo llamando a stellar hello:

$ stellar hello
hello from stellar plugin

Resolución de problemas​

Si Stellar CLI no puede encontrar tu plugin, asegúrate de limpiar todos los elementos anteriores:

  • Asegúrate de que el archivo comience con stellar-
  • Verifica que sea ejecutable (chmod +x)
  • Verifica que su ubicación esté en tu PATH
  • Reinicia tu terminal o recarga tu configuración de shell