Satoshi of BTC Kingdom

An Ethereum contract, living on the blockchain, that will make you a King or Queen, might grant you riches, and will immortalize your name.

Who is the Monarch?
Hall of Monarchs
What's this about?
I Want to Rule!
Neighbouring Kingdoms
FAQ
Disclaimer

Who is the Monarch?

As of 2017-05-25 20:40:29 UTC, the illustrious (but perhaps last?) Satoshi of BTC Kingdom was Satoshi Nakamoto, the most noble among men, possesor of a title respected even more than King, proud owner of a crown for which countless swords have crossed and for which blood has covered all the fields - how mighty is he, who sits in the Hall of Monarchs.

Important: This webpage is no longer being updated - the contract will continue to work on the blockchain but new rulers will NOT be listed here. Thank you to all the past Kings / Queens / Satoshis and for your interest in King of the Ether / Satoshi of BTC Kingdom.

Hall of Monarchs

Up to 2017-05-25 20:40:29 UTC, these were the hallowed rulers of the Satoshi of BTC Kingdom Throne, immortalized in the block-chain:

Number	Name	Claim Price Paid	Profit Made
3	Satoshi Nakamoto (0xe9250a3ccd0f053afbad2a839286e1d623ba00bc)	225 FINNEY (0.225 ETHER)
2	Emil Samsarov (0xe9250a3ccd0f053afbad2a839286e1d623ba00bc)	150 FINNEY (0.15 ETHER)	70.5 FINNEY (0.0705 ETHER)
1	Tetragrammaton (0xda00004325930dbcb2ce697674370e3c4b15dffa)	100 FINNEY (0.1 ETHER)	47 FINNEY (0.047 ETHER)

What's this about?

The Satoshi of BTC Kingdom Throne awaits you. It can be yours for a price - here are the contract rules:

Suppose - for example - the current throne claim price is 10 ETHER. (To find out what it really is, see below.)
You like the sound of being the Monarch, so you send 10 ETHER to the contract.
This makes you the illustrious new Satoshi of BTC Kingdom. Your name will be added to the Hall of Monarchs in the blockchain.
The contract will then send your 10 ETHER (less a small commission) to the previous Monarch you have usurped, as compensation.
The claim price for the throne will then go up by 50%, to 15 ETHER. (It eventually stops increasing at 100000 ETHER for safety).
If an usurper comes along who is willing to pay 15 ETHER, she will depose you and become Queen, and you will receive her payment of 15 ETHER (less a small commission) as compensation - a tidy profit for you.
However, an ancient curse applies to the throne: every Monarch dies once their reign reaches 7710 days 6 hours. No compensation is paid if this happens, and the claim price for the next monarch is reset back to the original starting price of 100 FINNEY (0.1 ETHER).
But surely a successor will appear within 7710 days 6 hours, and even if they don't, you'll be immortalised in the blockchain at least ...

How Can I Rule?

Important: This webpage is no longer being updated - the contract will continue to work on the blockchain but new rulers will NOT be listed here. For this reason we do NOT recommend sending funds to the contract, but we've left the instructions below just in case someone wants to usurp the last known ruler (even if no-one can see they have!) ... Thank you to all the past Kings / Queens / Satoshis and for your interest in King of the Ether / Satoshi of BTC Kingdom.

Claim by Interacting with the Satoshi of BTC Kingdom Contract in the Ethereum Wallet

If you're using a recent version of the Ethereum Wallet, you can watch and interact with the Satoshi of BTC Kingdom contract to become ruler - this shows off the power of Ethereum best!

1. Open your Ethereum Wallet. Choose 'Contracts' in the top-bar, then click 'Watch Contract'.

2. On the 'Watch Contract' pop-up, fill in the following details:
For CONTRACT NAME, enter ' Satoshi of BTC Kingdom'.
For CONTRACT ADDRESS, enter:

For JSON INTERFACE, copy-and-paste this:
[{"constant":false,"inputs":[{"name":"_monarchName","type":"string"}],"name":"claimThrone","outputs":[],"type":"function"}, {"constant":false,"inputs":[],"name":"withdrawFunds","outputs":[],"type":"function"}, {"constant":false,"inputs":[{"name":"_toAddress","type":"address"},{"name":"_valueWei","type":"uint256"},{"name":"_extraGas","type":"uint256"}],"name":"withdrawFundsAdvanced","outputs":[],"type":"function"}, {"constant":false,"inputs":[{"name":"_replacement","type":"address"}],"name":"replaceWizard","outputs":[],"type":"function"}, {"constant":true,"inputs":[],"name":"currentClaimPriceWei","outputs":[{"name":"priceInWei","type":"uint256"}],"type":"function"}, {"constant":true,"inputs":[],"name":"currentClaimPriceInFinney","outputs":[{"name":"priceInFinney","type":"uint256"}],"type":"function"}, {"constant":true,"inputs":[],"name":"numberOfMonarchs","outputs":[{"name":"totalCount","type":"uint256"}],"type":"function"}, {"constant":true,"inputs":[{"name":"","type":"uint256"}],"name":"monarchsByNumber","outputs":[{"name":"compensationAddress","type":"address"},{"name":"name","type":"string"},{"name":"coronationTimestamp","type":"uint256"},{"name":"claimPriceWei","type":"uint256"},{"name":"compensationWei","type":"uint256"}],"type":"function"}, {"constant":true,"inputs":[],"name":"isLivingMonarch","outputs":[{"name":"alive","type":"bool"}],"type":"function"}, {"constant":true,"inputs":[],"name":"kingdomName","outputs":[{"name":"","type":"string"}],"type":"function"}, {"constant":true,"inputs":[],"name":"rules","outputs":[{"name":"startingClaimPriceWei","type":"uint256"},{"name":"maximumClaimPriceWei","type":"uint256"},{"name":"claimPriceAdjustPercent","type":"uint256"},{"name":"curseIncubationDurationSeconds","type":"uint256"},{"name":"commissionPerThousand","type":"uint256"}],"type":"function"}, {"constant":true,"inputs":[{"name":"_address","type":"address"}],"name":"fundsOf","outputs":[{"name":"valueWei","type":"uint256"}],"type":"function"}, {"constant":true,"inputs":[],"name":"world","outputs":[{"name":"","type":"address"}],"type":"function"}, {"constant":true,"inputs":[],"name":"topWizard","outputs":[{"name":"","type":"address"}],"type":"function"}, {"constant":true,"inputs":[],"name":"subWizard","outputs":[{"name":"","type":"address"}],"type":"function"}, {"constant":true,"inputs":[{"name":"_monarchName","type":"string"}],"name":"validateProposedMonarchName","outputs":[{"name":"allowed","type":"bool"}],"type":"function"}, {"inputs":[{"name":"_kingdomName","type":"string"},{"name":"_world","type":"address"},{"name":"_topWizard","type":"address"},{"name":"_subWizard","type":"address"},{"name":"_startingClaimPriceWei","type":"uint256"},{"name":"_maximumClaimPriceWei","type":"uint256"},{"name":"_claimPriceAdjustPercent","type":"uint256"},{"name":"_curseIncubationDurationSeconds","type":"uint256"},{"name":"_commissionPerThousand","type":"uint256"}],"type":"constructor"}, {"anonymous":false,"inputs":[{"indexed":false,"name":"monarchNumber","type":"uint256"}],"name":"ThroneClaimedEvent","type":"event"}, {"anonymous":false,"inputs":[{"indexed":false,"name":"toAddress","type":"address"},{"indexed":false,"name":"valueWei","type":"uint256"}],"name":"CompensationSentEvent","type":"event"}, {"anonymous":false,"inputs":[{"indexed":false,"name":"toAddress","type":"address"},{"indexed":false,"name":"valueWei","type":"uint256"}],"name":"CompensationFailEvent","type":"event"}, {"anonymous":false,"inputs":[{"indexed":false,"name":"byAddress","type":"address"},{"indexed":false,"name":"valueWei","type":"uint256"}],"name":"CommissionEarnedEvent","type":"event"}, {"anonymous":false,"inputs":[{"indexed":false,"name":"oldWizard","type":"address"},{"indexed":false,"name":"newWizard","type":"address"}],"name":"WizardReplacedEvent","type":"event"}, {"anonymous":false,"inputs":[{"indexed":false,"name":"fromAddress","type":"address"},{"indexed":false,"name":"toAddress","type":"address"},{"indexed":false,"name":"valueWei","type":"uint256"}],"name":"FundsWithdrawnEvent","type":"event"}]
Yes, it's very long, make sure you copy it all. Click 'OK' to add the contract to the collection of 'Custom Contracts' you're watching.

3. Click on the ' Satoshi of BTC Kingdom' contract you just added to the 'Custom Contracts' section. You should now be able to interact with the Satoshi of BTC Kingdom contract using the 'READ FROM CONTRACT' section on the left, and the 'WRITE TO CONTRACT section on the right.

4. Under the 'WRITE TO CONTRACT' section, choose 'Claim Throne' from the 'Select Function' drop-down. Fill in these details:

Monarch Name	What should we call you, your majesty? (Names must be 1 to 25 characters long, English alphabet only, contain at least one letter or number, and use only symbols ! ( ) - . _) To double-check if the name is allowed first, you can use the 'Validate proposed monarch name' in the 'READ FROM CONTRACT' section on the left.
Execute From	Which Ethereum Wallet account do you want to use? It's generally recommended to use the 'Etherbase' account, not contract-wallets. Don't lose the account - your compensation payment will only be sent to this account.
Send	You'll need to specify the claim price you will send here. The Satoshi of BTC Kingdom contract page in the Ethereum Wallet will show the latest in the 'Current claim price in finney' section on the left of the screen.

5. Click 'Execute'. You'll be prompted for your password, then click 'Send Transaction'.

6. After you've sent the transaction, wait for it to confirm, then reload this page - it may take a few minutes to appear.

Neighbouring Kingdoms

Price of the Satoshi of BTC Kingdom too high? Want a Kingdom with fewer uppity peasants?

For just 1 ETHER (plus a little gas money) you can fork your own alternative Kingdom where you make the rules, you get a 50% share of the commission, and you get your own web page just like this one.

Interested? Or just want to see (and rule!) other Kingdoms people have created? See More of the World!.

FAQ

Where does the source code for the contract live?

github.com - KingOfTheEtherThrone.sol

What's the address of the contract?

The contract for Satoshi of BTC Kingdom is located at 0x267ac866397c4212ea7867789ba0af0a2dd74109.

Its Contract JSON Interface is:

[{"constant":false,"inputs":[{"name":"_monarchName","type":"string"}],"name":"claimThrone","outputs":[],"type":"function"},
 {"constant":false,"inputs":[],"name":"withdrawFunds","outputs":[],"type":"function"},
 {"constant":false,"inputs":[{"name":"_toAddress","type":"address"},{"name":"_valueWei","type":"uint256"},{"name":"_extraGas","type":"uint256"}],"name":"withdrawFundsAdvanced","outputs":[],"type":"function"},
 {"constant":false,"inputs":[{"name":"_replacement","type":"address"}],"name":"replaceWizard","outputs":[],"type":"function"},
 {"constant":true,"inputs":[],"name":"currentClaimPriceWei","outputs":[{"name":"priceInWei","type":"uint256"}],"type":"function"},
 {"constant":true,"inputs":[],"name":"currentClaimPriceInFinney","outputs":[{"name":"priceInFinney","type":"uint256"}],"type":"function"},
 {"constant":true,"inputs":[],"name":"numberOfMonarchs","outputs":[{"name":"totalCount","type":"uint256"}],"type":"function"},
 {"constant":true,"inputs":[{"name":"","type":"uint256"}],"name":"monarchsByNumber","outputs":[{"name":"compensationAddress","type":"address"},{"name":"name","type":"string"},{"name":"coronationTimestamp","type":"uint256"},{"name":"claimPriceWei","type":"uint256"},{"name":"compensationWei","type":"uint256"}],"type":"function"},
 {"constant":true,"inputs":[],"name":"isLivingMonarch","outputs":[{"name":"alive","type":"bool"}],"type":"function"},
 {"constant":true,"inputs":[],"name":"kingdomName","outputs":[{"name":"","type":"string"}],"type":"function"},
 {"constant":true,"inputs":[],"name":"rules","outputs":[{"name":"startingClaimPriceWei","type":"uint256"},{"name":"maximumClaimPriceWei","type":"uint256"},{"name":"claimPriceAdjustPercent","type":"uint256"},{"name":"curseIncubationDurationSeconds","type":"uint256"},{"name":"commissionPerThousand","type":"uint256"}],"type":"function"},
 {"constant":true,"inputs":[{"name":"_address","type":"address"}],"name":"fundsOf","outputs":[{"name":"valueWei","type":"uint256"}],"type":"function"},
 {"constant":true,"inputs":[],"name":"world","outputs":[{"name":"","type":"address"}],"type":"function"},
 {"constant":true,"inputs":[],"name":"topWizard","outputs":[{"name":"","type":"address"}],"type":"function"},
 {"constant":true,"inputs":[],"name":"subWizard","outputs":[{"name":"","type":"address"}],"type":"function"},
 {"constant":true,"inputs":[{"name":"_monarchName","type":"string"}],"name":"validateProposedMonarchName","outputs":[{"name":"allowed","type":"bool"}],"type":"function"},
 {"inputs":[{"name":"_kingdomName","type":"string"},{"name":"_world","type":"address"},{"name":"_topWizard","type":"address"},{"name":"_subWizard","type":"address"},{"name":"_startingClaimPriceWei","type":"uint256"},{"name":"_maximumClaimPriceWei","type":"uint256"},{"name":"_claimPriceAdjustPercent","type":"uint256"},{"name":"_curseIncubationDurationSeconds","type":"uint256"},{"name":"_commissionPerThousand","type":"uint256"}],"type":"constructor"},
 {"anonymous":false,"inputs":[{"indexed":false,"name":"monarchNumber","type":"uint256"}],"name":"ThroneClaimedEvent","type":"event"},
 {"anonymous":false,"inputs":[{"indexed":false,"name":"toAddress","type":"address"},{"indexed":false,"name":"valueWei","type":"uint256"}],"name":"CompensationSentEvent","type":"event"},
 {"anonymous":false,"inputs":[{"indexed":false,"name":"toAddress","type":"address"},{"indexed":false,"name":"valueWei","type":"uint256"}],"name":"CompensationFailEvent","type":"event"},
 {"anonymous":false,"inputs":[{"indexed":false,"name":"byAddress","type":"address"},{"indexed":false,"name":"valueWei","type":"uint256"}],"name":"CommissionEarnedEvent","type":"event"},
 {"anonymous":false,"inputs":[{"indexed":false,"name":"oldWizard","type":"address"},{"indexed":false,"name":"newWizard","type":"address"}],"name":"WizardReplacedEvent","type":"event"},
 {"anonymous":false,"inputs":[{"indexed":false,"name":"fromAddress","type":"address"},{"indexed":false,"name":"toAddress","type":"address"},{"indexed":false,"name":"valueWei","type":"uint256"}],"name":"FundsWithdrawnEvent","type":"event"}]

You can watch it on a chain explorer if you like.

How much is the commission charge?

2%. This is shared equally between the top-wizard (the original creator of the first contract) and the sub-wizard (the creator of the individual kingdom).

Haven't I seen something like this before?

Yes, probably - there are/were a number of Bitcoin chain games along similar lines (though they normally seemed to involve owning a magnificent gem or a special coin).

The difference with Ethereum is that you don't have to trust the author not to run away with the money - instead, you can inspect the contract and rely on the blockchain to ensure it is executed as written.

This contract was somewhat inspired by ethereumpyramid.com (to which this contract is in no way affiliated or connected).

You might also be thinking of one of our Neighbouring Kingdoms.

Is this the first version of this contract? Or have there been other throne contracts?

This is the third version of the contract. Learn more about the past ages (including celebrity rulers!).

When a monarch is struck down by the curse, where does the money go?

Ah - I see what you mean, but it doesn't quite work like that - there isn't really any money to go anywhere when that happens! For example, if a monarch pays 15 ether to claim the throne from someone, then that 15 ether is not held by the contract - it is sent to the monarch before her as compensation (minus a little commission). So it's not like the 15 ether they paid is "lost" if the curse hits them - it had already gone to the ruler they usurped 7710 days 6 hours days earlier. The one exception is when someone claims an empty throne that's back at the starting price of 100 FINNEY (0.1 ETHER) - in that case it goes to the "wizards" behind the throne as commission.

I think something went wrong. Can I have my money back?

Ah. Well, you see, one downside of trustless autonomous contracts executing on the blockchain is that there is no possibility of human intervention - (almost) no-one can reach into the back of the machine and tweak things, even if they wanted to. Besides, there is no money to give back - it's all been given to the previous monarch, remember? So refunds are - regrettably - both impossible and unethical.

Is this safe? Or will we up with all the ether trapped in a DarkKingdom?

As the Disclaimer below points out, sending funds to experimental contracts using experimental wallets in experimental crypto-currency networks is probably not particularly safe.

However, we have put considerable effort into mitigating the risks - see our Contract Safety Checklist.

I have a question that isn't listed here!

Try the discussion thread on reddit.com.

Disclaimer

This is intended as a bit of fun and to explore what a contract running on the Ethereum blockchain can do. Please don't spend money you can't afford to lose - keep it fun.

If you suspect that spending crypto-currencies on virtual thrones for non-existent kingdoms is illegal in your jurisdiction, please avoid participating (and complain to your political representatives).

Please note that while the contract will live as long as the Ethereum blockchain, no warranty is given that this website will continue to exist or will continue to promote the contract or list your name.

Under no circumstances will refunds or compensation be paid even if the contract steals all your money and/or shoots your dog. The author disclaims all liability for the operation of the contract which should be considered its own autonomous entity as far as permitted by law - it is your responsiblity to study its likely behaviour before interacting with it, including taking into account that the actual behaviour of the compiled EVM bytecode in a real eth/geth node may differ from the assumed behaviour based on the apparent intent of the solidity source code.

By interacting with the contract you agree to accept the conditions in this section as well as those listed at ethereum.org/agreement.