Saltar al contenido principal

Complementos

El CLI de Stellar admite complementos de una manera muy sencilla. 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 lo cargará automáticamente.

También puedes instalar complementos que estén disponibles públicamente. Un ejemplo es rs-stellar-strkey; puedes instalarlo utilizando 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, supondremos que ese directorio ya está en tu $PATH.

Advertencia de seguridad

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

Listado de complementos disponibles​

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

$ stellar plugins --list
Installed Plugins:
    strkey

Crear un nuevo complemento​

Como se mencionó anteriormente, los complementos 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 complemento usando bash, así que necesitas un sistema que lo soporte (basado en Unix, o el WSL de Windows).

touch ~/.bin/stellar-hello

Agrega el siguiente contenido al archivo:

#!/usr/bin/env bash

echo "hello from stellar plugin"

Ahora, haz que el archivo sea ejecutable con chmod:

chmod +x ~/.bin/stellar-hello

Si todo está configurado correctamente (es decir, ~/.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

Solución de problemas​

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

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