The MediterraneanCoin tipbot system associates a virtual wallet to each Twitter user who uses
MediterraneanCoin.
Also, as a bonus, the tipbot provides a small amount of MediterraneanCoins to each user, each time
they update their Twitter status containing the MediterraneanCoin word (case insensitive).
Security warning: we try do to our best in terms of security of our applications, but do not store
large amounts of MediterraneanCoins on your tipbot account!
Your MediterraneanCoins, managed by the tipbot system, are stored in a virtual wallet on which
you operate using your Twitter account (sending status updates containing special commands).
The security of your MediterraneanCoins managed by the tipbot system depends on the security
of your Twitter account.
The system is experimental, please use with care!
Commands to the tipbot are sent through Twitter statuses containing the MediterraneanCoin word.
Note: to receive notifications directly from the tipbot, you need to follow @MEDTipBot; if not, visit
https://twitter.com/MEDTipBot and browse its status updates.
For each status containing the MediterraneanCoin keyword (excluding commands), the twitter user gets
a little MED bonus... try it!
Step 1 Follow MEDTipBot
Click on this link Follow MEDTipBot and press Follow button on Twitter.
Click on this link Follow MEDTipBot and press Follow button on Weibo.
After this step you are ready to use Mediterraneancoin TipBot system
next will see all available commands
getdepositaddress
Post on Twitter #MediterraneanCoin getdepositaddress or click on Direct link to open Twitter or Weibo page with filled content
Weibo: #MEDCoin# getdepositaddress
Direct link Twitter getdepositaddress
Direct link Weibo getdepositaddress
The system responds with a status/notification showing your MED address for performing MED
deposits to your own tipbot wallet.
Example of response from tipbot system:
@YourTwitterScreenName your MED address for deposit is
MjhyKo3CpDKRaC5f3Nhr1aqP61hTYH9Lz5
When sending fundings to your deposit address on the tipbot system, six confirmations are required
(about six minutes for MediterraneanCoin) for confirming the deposit.
showbalance
Post on Twitter #MediterraneanCoin showbalance or click on Direct link to open Twitter or Weibo page with filled content
Weibo: #MEDCoin# showbalance
Direct link Twitter showbalance
For privacy reasons, the system responds with a direct Twitter message to you, showing your MED
balance of your tipbot wallet. The balance is not shown to other users.
To receive the direct message, you need to follow the user @MEDTipBot (the Twitter platform does
not allow to send direct messages to users not following the sender).
example of response from tipbot system (direct message to your Twitter user):
#MediterraneanCoin your balance is 100 MED
mymedaddress
Post on Twitter #MediterraneanCoin mymedaddress MED_ADDRESS or click on Direct link to open Twitter or Weibo page with filled content. Just replace MED_ADDRESS with your MED address
Weibo: #MEDCoin# mymedaddress MED_ADDRESS
Direct link Twitter mymedaddress
Direct link Weibo mymedaddress
- your MediterraneanCoin address on your own wallet (not the tipbot wallet) to be used for
withdrawing MED from the tipbot system (using the “withdraw” command).
The user specifies her/his MED address for retrieval. You can change it anytime. When you set the
address, if will be kept by the tipbot system as your current withdraw address.
After this, to retrieve your MediterraneanCoins you need to use the “withdraw” command.
withdraw
Post on Twitter #MediterraneanCoin withdraw 100 MED or click on Direct link to open Twitter or Weibo page with filled content. Just replace 100 with MED amount what you want to withdraw to MED adress you specify with mymedaddress
Weibo: #MEDCoin# withdraw 100 MED
The user retrieves 100 MEDs to her/his MED address (previously specified with the mymedaddress
command)
There is a fixed fee of 0.1 MED for this operation. The operation is performed immediately.
If successful, the tipbot system replies in this way:
@YourTwitterScreenName, you have been sent 100 MED to your address, tx =
http://explorer.mediterraneancoin.org/tx/...
The status message includes a link to MED explorer for showing the transaction; it can take a few
minutes for the transaction to be shown in the explorer.
sendtip
Post on Twitter #MediterraneanCoin sendtip @jjkosby 500 MED or click on Direct link to open Twitter or Weibo page with filled content. Just replace @jjkosby with Twitter/Weibo screen name of the user to send MediterraneanCoin to, and 500 with amount of MediterraneanCoin to send to the user (will be taken from your balance)
Weibo: #MEDCoin# sendtip @jjkosby 500 MED
The user sends a tip of 500 MED to the twitter user identified by twitter screen name "jjkosby".
The operation is performed immediately and cannot be reversed.
The other user (jjkosby)will see immediately the increase in his/her balance (using
the “showbalance” command).
You can also sendtip like reply in Tweet you like.
send a tip to a user on a different platform (i.e. Weibo).
To send a tip to a user on Weibo, you shall use a command like this:
#MediterraneanCoin sendtip ScreenNameUser@Weibo 10 MED
Post on Twitter #MediterraneanCoin sendtip jjkosby@Weibo 500 MED or click on Direct link to open Twitter page with filled content ready to Tweet. Just replace jjkosby@ with Weibo screen name of the user to send MediterraneanCoin to, and 500 with amount of MediterraneanCoin to send to the user (will be taken from your balance)
Direct link Twitter sendtip to Weibo
sendtipconditional & tipvote
sendtipconditional
Post on Twitter #MediterraneanCoin sendtipconditional @jjkosby 100 MED 2014-09-15T13:18:40 20 votes or click on Direct link to open Twitter page with filled content.
Weibo: #MEDCoin# sendtipconditional @jjkosby 100 MED 2014-09-15T13:18:40 20 votes
Direct link Twitter sendtipconditional
Direct link Weibo sendtipconditional
Parameters:
the Twitter screen name of the user to send MediterraneanCoins to the conditional tip.
the amount of MediterraneanCoin to send to the user (will be taken from your balance); the
minimum amount is 10 MED
the expiration date of this tip; by the specified date and time (UTC format
http://en.wikipedia.org/wiki/ISO_8601 )
the number of needed votes (by other users) for the tip to be conferred to the user; users can
vote this tip with the “tipvote” command; must be greater than zero.
This tip must be voted by other users (see “tipvote” command) the specified amount of times (before
the expiration time) to be considered successful.
If the conditional tip does not get enough “tipvotes” before the expiration date, then the tip amount is
given back to the user who performed the tip. Otherwise, the MED amount is transferred to the
specified user.
The expiration date cannot be too near (1 minute from now) or too far in time (15 days from now).
The expiration date is in UTC format, see also this link for examples:
http://en.wikipedia.org/wiki/ISO_8601
It is possible to specify a fully UTC format, including date, time and timezone.
The tipbot server works in the “ZULU” timezone (GMT+0).
Your wallet associated with the tipbot needs to contain an amount equal or larger than the amount to
send. Use the “showbalance” command to show your balance.
Send a conditional tip to a twitter user; the user receives the tip if and only if enough users vote this tip
before the expiration date.
example:
#MediterraneanCoin sendtipconditional @jjkosby 100 MED 2014-09-15T13:18:40 20 votes
In case the conditional tip is posted successfully, the tipbot system replies with the following message:
@YourScreenName sends conditional tip of 100 MED to user jjkosby, expiration 2014-09-15T13:18:40, needs 20 votes
This message means that the conditional tip of 100 MED has been taken from YourScreenName wallet
and will be kept in reserve for the jjkosby until one of the following events happen:
the conditional tip gets enough votes from other users; in such case, the amount is conferred to jjkosby
the conditional tip expires; in such case, the amount is returned to YourScreenName
tipvote
Post on Twitter #MediterraneanCoin tipvote @jjkosby or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# tipvote @jjkosby
Parameters:
the Twitter screen name of the user to vote a conditional tip for
optional keyword: oldest | newest | random
In case the target user has more than one open conditional tip, you can specify to vote for the most
recent tip (“newest”) , the oldest conditional tip (“oldest”) or a random tip.
If the target user has only one open conditional tip, then the use of an optional keyword is not relevant.
Each user can vote only once for a specific conditional tip associated to a user.
Example:
#MediterraneanCoin tipvote @jjkosby [oldest | newest | random ]
The tipbot system replies with:
@YourScreenName has voted a conditional tip for user @jjkosby, 7/20 (10 MED)
listopentips
Post on Twitter #MediterraneanCoin listopentips or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# listopentips
Direct link Twitter listopentips
Direct link Weibo listopentips
Parameters: none
List the open tips associated with your Twitter user.
#MediterraneanCoin listopentips
example reply:
@MyUserName 3/10(10.00 MED)
This means that there is one open conditional tip for 10 MED, requiring 10 votes (having received 3
votes up to now).
assurancecontract & assurancetip
assurancecontract
Post on Twitter #MediterraneanCoin assurancecontract @jjkosby 1000 MED 2014-09-29 or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# assurancecontract @jjkosby 1000 MED 2014-09-29
Direct link Twitter assurancecontract
Direct link Weibo assurancecontract
Parameters:
the Twitter screen name of the user to send MediterraneanCoins as an assurance contract.
the total amount of MediterraneanCoin to be collected, before the expiration date, and to be sent
to the target user
the expiration date of this tip; by the specified date and time (UTC format
http://en.wikipedia.org/wiki/ISO_8601 )
This functionality has been inspired by this article:
https://en.bitcoin.it/wiki/Contracts#Example_3:_Assurance_contract
This command creates an assurance contract, where all the users contribute with small MED amounts
to reach the total amount of MED before the expiration date.
The expiration date cannot be too near (1 minute from now) or too far in time (30 days from now).
If the target amount of MED is reached (through contributions from other users using the
“assurancetip” command) before the expiration date, then the total amount is transferred to the target
user.
Otherwise, all the tips are given back to the contributing users.
example:
#MediterraneanCoin assurancecontract @jjkosby 1000 MED 2014-09-29
An assurance contract is created by the current user in favor of user jjkosby.
If before the expiration time (2014-09-29 00:00 GMT+0) other users are willing to contribute to this
assurance contract (with “assurancetip” command), then user jjkosby will receive 1000 MED.
Otherwise, all the contributed amounts by each user is given back.
assurancetip
Post on Twitter #MediterraneanCoin assurancetip @jjkosby 100 MED or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# assurancetip @jjkosby 100 MED
Direct link Twitter assurancetip
Direct link Weibo assurancetip
Parameters:
the Twitter screen name of the user to send an assurance tip to
the amount of MediterraneanCoin to be contributed
optional keyword: oldest | newest | random
Contribute with the specified amount of MED to an open contract.
In case the target user has more than one open assurance contract, you can specify to contribute to the
most recent contract (“newest”) , the oldest contract (“oldest”) or a random contract.
If no keyword is used, the default is the oldest contract.
If the target user has only one open assurance contract, then the use of an optional keyword is not
relevant. If there is no open assurance contract associated with the target user, then this tip operation is
not successful and no amount is taken from the current user balance.
example:
#MediterraneanCoin assurancetip @jjkosby 100 MED
The current Twitter user contributes with 100 MED to an open assurance contract. The amount of 100
MED is reserved by the tipbot system (so the current user sees a decrement of his/her MED balance) up
to when one of the following events happen:
the target MED amount of the assurance contract for user jjkosby is reached before the
expiration date; in such case, the MED amount is transferred to jjkosby's balance
the target MED amount is not reached in time; all the contributions by the different users are
sent back to each contributing user.
listopencontracts
Post on Twitter #MediterraneanCoin listopencontracts or click on Direct link to open Twitter or Weibo page with filled.
Weibo: #MEDCoin# listopencontracts
Direct link Twitter listopencontracts
Direct link Weibo listopencontracts
Parameters: none
List the open assurance contracts associated with your Twitter user.
enable
Post on Twitter #MediterraneanCoin enable or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# enable
Parameters: none
By default, each Twitter user enables the tipbot system to send tips etc. If the Twitter user has
previously used the “disable” command, use the “enable” command to re-enable it.
disable
Post on Twitter #MediterraneanCoin disable or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# disable
Parameters: none
If do not want to receive tips et al from the MediterraneanCoin tipbot system, use the “disable”
command and you will be ignored by the tipbot system.
update
Post on Twitter #MediterraneanCoin update or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# update
Parameters: none
When a twitter user follows the @MEDTipBot user, if can take a few hours before the tipbot system
sends updates to the user. To force an updated of the user data, use the “update” command.
createvotepoll & votepoll
createvotepoll
Post on Twitter #MediterraneanCoin createvotepoll 100 MED @jjkosby @user2 @user3 10 votes 2014-09-29 or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# createvotepoll 100 MED @jjkosby @user2 @user3 10 votes 2014-09-29
Direct link Twitter createvotepoll
Direct link Weibo createvotepoll
Parameters:
the Twitter screen names of the competitors (two or more users)
the amount of MediterraneanCoin for the winner (the prize)
the number of votes required to win
the expiration date for the vote poll (optional)
A users establishes a price for the competitor who gets the most votes (before the expiration date).
The expiration date is optional, if not specified is set to 30 days from now.
The vote poll minimum MED amount is 10 MED.
votepoll
Post on Twitter #MediterraneanCoin votepoll @jjkosby or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# votepoll @jjkosby
Parameters:
the Twitter screen name of the competitor to vote
optional keyword: oldest | newest | random
A users votes for a user competing in a votepoll.
Each user can vote only once for each votepoll.
In case the competing user has more than one open vote polls, you can specify to vote for the most
recent vote poll (“newest”) , the oldest vote poll (“oldest”) or a random vote poll . When no keyword is
user, the default is the oldest vote poll.
sendmedto
Post on Twitter #MediterraneanCoin sendmedto 100 MED MED_ADDRESS or click on Direct link to open Twitter or Weibo page with filled content.
Weibo: #MEDCoin# sendmedto 100 MED MED_ADDRESS
Send MED to MED address
Example:
#MediterraneanCoin sendmedto 100 MED MeDcoinLNQXQ4nDnj2dJ6odNKE3KJpFCzJ
#MEDCoin# sendmedto 100 MED MeDcoinLNQXQ4nDnj2dJ6odNKE3KJpFCzJ