Saga Docs
Back to Saga
  • Introduction
    • Pegasus Overview
    • Saga Overview
      • Saga Topology
      • Saga Chainlets
      • Saga Shared Security
      • Validator Orchestration Tools
      • Token Mechanism and Economics
      • Validator Selection
      • Partnership Models
      • Paying for Chainlets
      • Staking on Saga
        • Staking your Saga on Keplr
        • Auto-compound your staking rewards with Restake.app
  • Saga Web App
    • Getting Access
    • Quickstart Guide
      • Testnet Quickstart Guide
      • Mainnet Quickstart Guide
    • Account Management
      • Requesting Tokens from Saga Faucet
      • Deposit Funds into Escrow
      • Withdraw Funds from Escrow
      • View Escrow Account Information
    • Working with Chainlet
      • Launch your Chainlet on Testnet
      • Launch your Chainlet on Mainnet
      • Get Chainlet Information
      • View Listing of Chainlets Launched
      • Chainlet APIs & BlockExplorer
      • Configuring Metamask Network
      • Chainlet Billing
      • Restarting a Stopped Chainlet
  • Sagacli
    • Getting Access
    • Quickstart Guide
      • Testnet Quickstart Guide
      • Mainnet Quickstart Guide
    • Download Saga CLI
    • Install Saga CLI
    • Configure Saga CLI
    • Key Management
      • Adding Keys
      • Listing Keys
      • Display Key Details
      • Deleting Keys
      • Renaming Keys
    • Account Management
      • Checking Account Balances
      • Requesting Tokens from Saga Faucet
      • Deposit Funds into Escrow
      • Withdraw Funds from Escrow
      • View Escrow Account Information
    • Working with Chainlet
      • View Listing of Chainlet Types
      • Launch your Chainlet on Testnet
      • Launch your Chainlet on Mainnet
      • Get Chainlet Information
      • View Listing of Chainlets Launched
      • Chainlet APIs & BlockExplorer
      • Configuring Metamask Network
      • Update Chainlet Version
      • Chainlet Billing
      • Restarting a Stopped Chainlet
    • Configuring sagacli - A Deep Dive
    • Searching for Transactions
  • Get Help & Support
Powered by GitBook
On this page
  • Sagacli and Key Management
  • Keyring
  • Supported Functions
  1. Sagacli

Key Management

PreviousConfigure Saga CLINextAdding Keys

Last updated 1 year ago

Sagacli and Key Management

sagacli stores and manages your key pairs. You can either create a new key or import your existing key(s).

These keys may be in any format as long as the format is supported by the Tendermint crypto library. It can be used by light-clients, full nodes, or any other application that needs to sign with a private key.

Keyring

The keyring supports the following backends:

os

Uses the operating system's default credentials store.

file

Uses encrypted file-based keystore within the app's configuration directory. This keyring will request a password each time it is accessed, which may occur multiple times in a single command resulting in repeated password prompts.

kwallet

Uses KDE Wallet Manager as a credentials management application.

pass

Uses the pass command line utility to store and retrieve keys.

test

Stores keys insecurely to disk. It does not prompt for a password to be unlocked and it should be use only for testing purposes.

kwallet and pass backends depend on external tools. Refer to their respective documentation for more information: see and

The pass backend requires .

Supported Functions

To view key management functions supported by sagacli, look at the output below.


$ sagacli keys --help
Usage:
  sagacli keys [command]

Available Commands:
  add         Add an encrypted private key (either newly generated or recovered), encrypt it, and save to <name> file
  delete      Delete the given keys
  list        List all keys
  rename      Rename an existing key
  show        Retrieve key information by name or address

Flags:
  -h, --help   help for keys

Global Flags:
      --controller string          controller grpc url (host:port) (default "https://controller.testnet-sp1.sagarpc.io")
      --from string                Name of private key used to sign (default "bogdan_local")
      --keyring-backend string     Select keyring's backend (os|file|test) (default "file")
      --ledger                     Use the connected Ledger device for signing tx
  -l, --loglevel string            commands logging level (default "info")
      --network-rpc string         <host>:<port> to tendermint rpc interface for remote chain (default "https://spc.testnet-sp1.sagarpc.io")
  -o, --output string              output type <text|json> (default "text")
      --platform-chain-id string   The SPC network chain ID (default "spc-testnet-1")

Use "sagacli keys [command] --help" for more information about a command.
KWallet
pass
GnuPG