alfred

README

Alfred

A loyal and tireless butler for your stellar wallets

Table of Contents

• Feature
• Install
• Usage
  • Typical workflow
  • Importing a wallet
  • Creating a random wallet
    • Creating a vanity address
  • Show balances:
  • Sending lumens or assets
  • Adding contacts
  • Sharing an account
  • Setting data
  • Trust an asset
• Disclaimer
• Credits
• Donate

Feature

• Single human readable yaml file
• AES encryption for seeds
• Contacts/aliases
• (very) easy to use
• Create shared accounts
  • 1 master in full control (dictator) with multiple possible payers (having medium access)
• Set Data using manage_data

Install

• MacOS: brew install celrenheit/taps/alfred
• Windows/Linux: https://github.com/celrenheit/alfred/releases
• From Source: go get -u github.com/celrenheit/alfred

Usage

Typical workflow

Importing a wallet

alfred import 

Optionaly, you can name your wallet using alfred import --name "my awesome wallet"

Creating a random wallet

alfred new

Creating a vanity address

alfred new --suffix "HUG"

Optionaly, you can name your wallet using alfred new --name "my awesome wallet"

Show balances:

alfred balances

Output:

+----------------------------------------------------------+----------+-----------+
|                          WALLET                          | CURRENCY |  BALANCE  |
+----------------------------------------------------------+----------+-----------+
| GCXXY622NRUFSBIA5Z3MVYKOXKZYGPC5Z6VCPVQ2JUPYSNHQJNXC3P7Z | XLM      | 2.9999700 |
+----------------------------------------------------------+----------+-----------+

Sending lumens or assets

alfred send 10 XLM from master to jennifer

Adding contacts

alfred new contact

Sharing an account

alfred please share account savings with alice, bob and celine

Setting data

In this example, it will set data key-value pairs for the selected account:

alfred please set data mykey1 = myvalue1, mykey2 = myvalue2 

It possible to setup the contents of a file (using from keyword) as the value of a key:

alfred please set data mykey1 from ./text.txt

NOTE: If you want your keys or values to have spaces or special characters, you have to use quotes ("or ') around the whole query and the key/value:

alfred please 'set data "my key 1" = "my value 1", "my key 2" from "./text space.txt"' 

Trust an asset

To trust an asset known to Alfred:

alfred trust MOBI

Alternatively, you can trust for a custom asset using:

alfred trust HUG GXXXX

Where GXXX is the issuing account.

Disclaimer

USE AT YOUR OWN RISK. Always keep your secret seeds in a safe place (for example, a paper wallet).

Credits

Partial list of assets are coming from the great stellarterm project. Go check it out.

Donate

If you which to donate, use the command below:

alfred donate

... or the following address:

XLM: GCDMBL2SDMM74I2EOM5XHF7LMMDXFEJQIZ5N2ORK6HBSHM5INLALFRED