6.2. Bank Commands

6.2. Bank Commands
Prev	Chapter 6. Basic Agent Reference	Next

All of the bank commands implicitly operate on the user's bank account. The commands also have an administrative form that allows the administrator perform operations on users' accounts. This form is

tycoon -b admin_account_name bank -a -b account_name command command_args

For example, to check Bob's balance, do the following:

[asmith@alicehost ~]# tycoon -b __Bank
bank -a -b bob.johnson@hp.com get_balance

The following are the bank commands.

6.2.1. bank get_balance

tycoon bank get_balance

This prints out the user's current bank balance.

6.2.2. bank create_account

tycoon bank create_account account_name initial_deposit account_public_key_file_name

initial_deposit: This is the initial amount to be deposited in the new account. These funds are transferred from the creating user's bank account.
account_public_key: This is the file name of the new account's public key.

This creates a new bank account. The new account's public key should have been generated as described in Section. Although account creation is usually performed by the bank administrator using the administrative form described above, this is not required. In fact, any user who already has a Tycoon account can create a new Tycoon user account.

The initial deposit is necessary in case the bank has reached a preset maximum number of accounts, n. If the initial deposit of the new account is more than the balance of at least one of the existing accounts, then the account with the smallest balance is evicted and the account is created. Otherwise, the creation of the new account is rejected.

6.2.3. bank transfer

tycoon bank transfer recipient amount

recipient: This is the bank account name of the recipient of the transfer.
amount: This is the amount to transfer.

This transfers funds from the user's account to someone else's account. This can be used for transactions outside the scope of the Tycoon markets.

6.2.4. bank get_history

tycoon bank get_history

This gets a list of a user's recent transactions from the bank. This can be used to reconcile disputes about transfers.

6.2.5. bank delete_account

tycoon bank delete_account account_name

This deletes the specified bank account. The funds in the account disappear, so use this command with caution.

6.2.6. bank setup

tycoon bank setup

XXX Undocumented