How to ...
How to apply for funding in a currency?
How to add someone else's account to my client?
How to make transfers with OCS?
How to exchange liquidity?
How to port an account to another client?
How to become a referee for a currency?
How to become a notary?
How to add images to proposals and applications?
How to open an OCS account?
To open a new account you need to start the OCS client, go to Operator tasks -> Create new account
and type in the name of the new account. Note that the name provided is a local name that should be different from
(local) account names used so far on your machine. An account is not identified by its name and also not by its owner/creator.
Instead an OCS account
is essentially a pair of keys: a private key and a public key. The public key is submitted to the notary, you are currently connected to,
for registration, while the private key remains on your machine.
The public key is used to distinguish this account from other accounts, but
also to verify transactions and other entries signed with the private key that should remain known to you only.
To verify that your account was successfully created and the public key submitted and notarized go to
Operator tasks -> Show account info
. You should be able to display basic information regarding your
newly created account and to recover
the account's ID (Key Id). This ID is sufficient to identify your account, in particular to perform transfers to it.
Note that account movements for all OCS accounts are public, it is, however, not public who the owner of a given account is. You remain anonymous as the owner of your account unless you choose to make this information public. You can set up and manage arbitrarily many accounts.
How to apply for funding in a currency?
To apply for the financing of an economic operation you first need to find the currency, in which you will request funds, under
Operator tasks -> Show liquidity info
.
Choose the name of the currency or insert the ID of the respective currency (if known). Once the parameters and description
of the currency are displayed click on APPLY FOR LIQUIDITY
. Next fill in the form and submit your proposal. Make sure that the description part
is not bigger than 1.5 MB.
Note that your proposal must follow the guidelines defined in the currency description. Otherwise it is unlikely to be approved.
An application that is ignored is automatically rejected after some time without you getting any feedback. Please make sure to include an e-mail address
and/or other contact details to your submissions to allow interested community members to give you feedback.
How to add someone else's account to my client?
In order to add someone's account to your client you need to know the ID (Key Id) of the respective account and, ideally,
also its hash value.
Go to Operator tasks -> Show account info
and insert the ID. Once the account has been found and its
data has been displayed you should check the hash value to make sure that you are dealing with the right account.
Then click on ASSIGN NAME
and type in the name under which you want the client
to denote this account in the future. If after doing so you close the account info window and reopen it via
Operator tasks -> Show account info
the account name should now be listed directly under Account
.
How to make transfers with OCS?
Before being able to make transfers to someone else's account you must first add it to your client.
To transfer liquidity in either a currency or an obligation go to Operator tasks -> Transfer liquidity
and fill in the
form.
If you want someone else to transfer liquidity to your account, e.g. in return for a good or service, you can place a
so-called transfer
request: Go to Operator tasks -> Request liquidity -> Create new request
and fill in the form. After this you should be able to
determine the ID of the newly created request via Operator tasks -> Request liquidity -> Show existing requests
.
This ID is then copied and sent to the person or group of people who you expect to satisfy this particular request.
In order to fulfill a given transfer request go to Operator tasks -> Show transaction info
and insert
the ID of the transfer request. Once the information has been displayed click on
SATISFY THIS REQUEST
and fill in the form.
How to exchange liquidity?
For the purpose of exchanging some amount in a given currency or obligation into an amount of another currency or obligation you can either find and accept an existing exchange offer or place an exchange offer yourself.
For the first option go to Operator tasks -> Exchange liquidity -> Show existing offers
and fill in the form to
search for existing offers. In order to accept any of the offers displayed copy the respective ID and go to
Operator tasks -> Show transaction info
and insert the ID. After the data concerning this offer has been displayed
click on ACCEPT THIS OFFER
and fill in the form.
In order to place a new offer go to Operator tasks -> Exchange liquidity -> Create new offer
and fill in the
form. After this you should verify that the offer was successfully notarized by being able to find it under
Operator tasks -> Exchange liquidity -> Show existing offers
. In order to delete the offer determine and copy its ID
and go to Operator tasks -> Show transaction info
. Insert the ID and request data concerning the offer.
Then click on ACCEPT THIS OFFER
and choose your account as the source account. Finally, click on
Delete offer
.
How to port an account to another client?
When using different instances of the OCS client (e.g. on different machines) you can port an account from a client A to a client B using the following procedure:
First make sure that neither of the clients is running. Now open the directory conf/keys
in the directory
of client A. Assume we want to port an account named "AccountXYZ" (local name used by client A) that you happen to be the owner of.
Then the directory conf/keys
should contain the file AccountXYZ.PRVTkey
.
Now copy this file to the directory conf/keys
of client B. Before proceeding further you may rename the new file to any name
you like, e.g. AccountABC.PRVTkey
, but make sure that the file still ends with .PRVTkey
and that the new name is not already used
in client B for another account. Now start client B. After a few seconds the newly added account should be listed under Account
when opening Operator tasks -> Show account info
.
The above procedure can also be performed for a .PBLCkey
file instead of a .PRVTkey
file.
However, in this case you will not be able to make transfers from that
account with client B and the account will be treated as someone else's account.
How to become a referee for a currency?
To submit a referee application go to Referee tasks -> Show currency info
and find the respective currency. After displaying
the currency's description click on APPLY FOR REFEREE STATUS
and fill in the form. Make sure that the description part
is not bigger than 1.5 MB.
Note that your application must follow the guidelines defined in the currency description. Otherwise it is unlikely to be approved.
An application that is ignored is automatically rejected after some time without you getting any feedback. Please make sure to include an e-mail address
and/or other contact details to your applications to allow interested community members to give you feedback.
How to become a notary?
To submit a notary application go to Notary tasks -> Show lineage info
and click on Notary application
.
Now fill in the form making sure that the description part is not bigger than 1.5 MB.
Note that as a notary you must be knowledgeable about the protocols and procedures used in the technical implementation of the OCS as described
in its constitution, follow all guidelines and fulfill all requirements defined in it.
An application that is ignored is automatically rejected after some time without you getting any feedback. Please make sure to include an e-mail address
and/or other contact details to your applications to allow interested community members to give you feedback.
How to add images to proposals and applications?
You should avoid adding large images as the total size of a submission cannot exceed 1.5 MB. Instead,
you may choose to simply add a URL of or a link to an external image file. Smaller images may be inserted directly using data URI's:
This is a red dotA data URI maker can be found here.
{{data:image/png;base64,
iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAYAAACNMs+9AAAABGdBTUEAALGP
C/xhBQAAAAlwSFlzAAALEwAACxMBAJqcGAAAAAd0SU1FB9YGARc5KB0XV+IA
AAAddEVYdENvbW1lbnQAQ3JlYXRlZCB3aXRoIFRoZSBHSU1Q72QlbgAAAF1J
REFUGNO9zL0NglAAxPEfdLTs4BZM4DIO4C7OwQg2JoQ9LE1exdlYvBBeZ7jq
ch9//q1uH4TLzw4d6+ErXMMcXuHWxId3KOETnnXXV6MJpcq2MLaI97CER3N0
vr4MkhoXe0rZigAAAABJRU5ErkJggg==}}
based on a data URI.