Documentation

Complete guide to the eIOU protocol and wallet commands.

What is the eIOU Protocol?

The eIOU protocol is a revolutionary way to handle digital transactions. It combines the simplicity of traditional IOUs with the power of modern technology to create a seamless, secure, and efficient system for transferring value.

Protocol Commands

👥

Contacts

💸

Transactions

🔗

Peer to Peer

  • → Request P2P - Initiate indirect transactions
  • → Receive P2P Request - Process incoming
  • → Respond P2P - Reply to requests
  • → Receive P2P Response - Handle responses
⚙️

Settings

Commands Detail

The owner of the account (user) interacts with other users (contacts) in the following ways:

👥 Contacts

My Info

Outputs the user information including:

  • Their locators
  • Their pubkey
  • Their balance
  • Their balance detail

Examples:

eiou info
eiou info detail

Add Contact

Add a contact on the local database and send a request for the contact to do the same.

Example:

eiou add 123address.tor Alice 0.1 10 USD

Parameters: Address/URI, Name, Fee (percent), Main Nominal Credit, Main Currency

Accept Contact

Accept a contact request and add the contact back.

Example:

eiou add 123address.tor Bob 0.2 20 USD

Parameters: Address/URI, Name, Fee, Main Nominal Credit, Main Currency

View Contact

Read contact information from the local database.

Examples:

eiou viewcontact 123address.tor
eiou viewcontact Alice

Parameters: Address/URI or Name

Update Contact

Update information about a contact.

Examples:

eiou update 123address.tor name Alice
eiou update 123address.tor all Alice 0.1 100

Parameters: Address/URI, Type (name, fee, credit, or all), Value(s)

Delete Contact

Remove contact from the local database, and delete any eIOUs associated with them.

Example:

eiou delete 123address.tor

Parameters: Address/URI

Search Contacts

Lookup contact by name, or return all contacts.

Examples:

eiou search
eiou search Alice

Parameters: Name (optional)

💸 Transactions

Send eIOU

Transfer value to a contact, routing through Peers of Peers if needed.

Examples:

eiou send Alice 100 USD
eiou send 123address.tor 100 USD

Parameters: Name or Address/URI, Amount, Currency

View eIOU Totals

Queries the local database for eIOUs, and returns the total for outstanding balances.

Examples:

eiou viewbalances
eiou viewbalances Alice
eiou viewbalances 123address.tor

View Transaction History

Queries the local database for transaction history.

Examples:

eiou history
eiou history Alice
eiou history 123address.tor

⚙️ Settings

Help

Displays available commands and how they work.

Examples:

eiou help
eiou help generate

View Settings

Shows the current configuration settings.

Example:

eiou viewsettings

Update Settings

Change settings for the user.

Example:

eiou changesettings

Generate Wallet

Create a new passphrase and generate a keypair.

Example:

eiou generate 123address.tor

Ready to Get Started?

Try out the eIOU protocol with our interactive demos and start experiencing digital cash today.