etheria_source

Source code for Etheria and the contracts around it, with each contract's mainnet address and the evidence that the source here matches the code on the chain.

Etheria is a decentralized 3D virtual world of unique hexagonal water and land tiles, created and deployed to the Ethereum blockchain in October 2015. Its provably scarce land tiles can be owned, transferred, and customized with voxel-based sculptures, and its entire world state, including ownership and build data, is stored natively on-chain. Etheria cannot be altered against its owners' will or destroyed, not even by its creator, and will persist as long as Ethereum does.

Website: etheria.world

Etheria

Version	Address	Deployed (UTC)	Source	Source match
v0.9	0xe468d26721b703d224d05563cb64746a7a40e1f4	block 407810, 2015-10-19 14:54	etheria-0pt9_0xe46.sol	Exact (solc 0.1.6, recipe)
v1.0	0xe414716f017b5c1457bf98e985bccb135dff81f2	block 420373, 2015-10-22 03:34	etheria-1pt0_0xe41.sol	Exact (solc 0.1.6, recipe)
v1.1	0x169332ae7d143e4b5c6baedb2fef77bfbddb4011	block 459708, 2015-10-29 21:11	etheria-1pt1_0x169.sol	Exact (solc 0.1.6, recipe)
v1.2	0xb21f8684f23dbb1008508b4de91a0aaedebdb7e4	block 470957, 2015-11-01 01:20	etheria-1pt2_0xb21.sol	Exact (solc 0.1.6, recipe)

Each file starts with a comment giving the address, the function signatures, the ABI and notes on the match, followed by the source.

• v0.9 and v1.0 change tile owners only through offers (makeOffer, acceptOffer and related functions). These check msg.sender, so a contract can own and move their tiles, which is what lets them be wrapped as ERC-721 tokens (see Wrappers below).

• v1.1 and v1.2 move tiles with setOwner, which checks tx.origin, the account that signed the transaction. They will be wrapped as ERC-721 tokens soon after Ethereum's frame transactions (EIP-8141) go live, which let a contract send its own transactions (see Exchanges below).

  Until then, keep v1.1 and v1.2 tiles in a dedicated wallet: an ordinary account (EOA) that you use only with the Etheria contracts and the EtheriaExchangeXL exchanges. Because setOwner trusts tx.origin, any contract that runs during a transaction sent from the tile-holding account can move its tiles. That includes contracts that a seemingly safe app calls along the way, such as hooks run by some token and marketplace transfers. Never send these tiles to a contract address either: a contract can't move a tile it receives.

• v0.9 has no kill function. v1.0, v1.1 and v1.2 have one, but each is locked, so it can never run.

Compiling these. solc 0.1.6 exists only as a soljson build in ethereum/solc-bin; a pinned copy is in verification/compiler/. Its output can depend on what the same compiler instance compiled before, so each version matches only through a recipe: v0.9 and v1.1 by compiling their file several times in one instance, v1.0 and v1.2 by compiling padded copies of their sources after two unrelated helper contracts. verification/ has the recipes and a script that runs them.

Helper contracts

Contract	Address	Used by	Source
BlockDefinitionStorage	0x782bdf7015b71b64f6750796dd087fde32fd6fdc	v0.9, v1.0	_BlockDefinitionStorage_0x782.sol
BlockDefinitionStorage	0xd4e686a1fbf1bfe058510f07cd3936d3d5a70589	v1.1, v1.2	_BlockDefinitionStorage_0xd4e.sol
MapElevationStorage	0x68549d7dbb7a956f955ec1263f55494f05972a6b	v0.9 to v1.2	_MapElevationStorage_0x685.sol

BlockDefinitionStorage holds the brick shapes used by the original build mechanics. MapElevationStorage holds each tile's elevation, which decides land and water. All three are locked, so their data can no longer change.

Wrappers (v0.9 and v1.0)

Wrapper	Address	Source
EtheriaWrapper for v0.9	0x4b1705c75fde41e35e454ddd14e5d0a0eac06280	EtheriaWrapper-v0pt9_0x4b1.sol
EtheriaWrapper for v1.0	0x629a493a94b611138d4bee231f94f5c08ab6570a	EtheriaWrapper-v1pt0_0x629.sol

These turn v0.9 and v1.0 tiles into standard ERC-721 tokens, using the tiles' own offer functions. Both are Solidity 0.8.7 and verified on Etherscan. The files explain how to wrap and unwrap. Wrappers for v1.1 and v1.2 will follow soon after EIP-8141 goes live (see Exchanges below).

Exchanges (v1.1 and v1.2)

Exchange	Address	Trades	Source
EtheriaExchangeXL v1.1	0x341db17810769e7470b22d75127c37eec44f8179	v1.1 tiles	EtheriaExchangeXL-1pt1_0x341.sol
EtheriaExchangeXL v1.2	0x111b76dbbe885d05793de91254554f0a781d15db	v1.2 tiles	EtheriaExchangeXL-1pt2_0x111.sol

v1.1 and v1.2 tiles will be wrapped as ERC-721 tokens soon after Ethereum's frame transactions (EIP-8141, scheduled for the Hegotá upgrade) go live. Frame transactions let a contract account send transactions itself, so a wrapper can pass setOwner's tx.origin check. Until then, these tiles trade through EtheriaExchangeXL, which works with the tiles directly and never holds one. Use it from the dedicated tile wallet described above. How it works:

• Bids: a bidder deposits ETH for any tile that falls within the ranges of columns, rows, elevation and neighbouring water tiles they choose. A range can be a single tile.
• Accepting a bid: the tile's owner accepts from their own account. In that same transaction the exchange calls setOwner, which moves the tile straight to the bidder, and credits the seller with the bid minus a fee. The contract caps the fee at 5%; feeRate() gives the current rate in basis points.
• Asks: prices that owners post for buyers to see. Nothing is held for them.
• Withdrawals: bidders can cancel their bids, and sellers collect their proceeds, at any time.

Both exchanges are the same contract, one pointed at v1.1 and one at v1.2, compiled with Solidity 0.8.6 and verified on Etherscan. Once the v1.1 and v1.2 wrappers are live, the exchanges will be decommissioned.

Test contracts from before v0.9: NKNVELSC/

Four test versions (v0.6, v0.7, v0.8 and v0.85) deployed in September and October 2015 are still on the chain. Each has a fatal bug, so none of them is a usable Etheria, and anything offering their tiles is a scam. NKNVELSC/README.md explains each one and links to an exhaustive search showing they are the only Etheria-like contracts from before v0.9 that still exist.

Old build mechanics: etheria_web_v0pt9/, etheria_web_v1pt0/, etheria_web_v1pt1/

Etheria's original build mechanics had players farm bricks, then color and stack them, with every placement checked for gravity, collisions and tile boundaries. That proved too expensive in gas, so in 2021 it was replaced: each tile's build is now a compressed voxel image stored in the tile's name field, and that is what etheria.world renders.

These three folders are standalone copies of the original website that render tiles with the old mechanics, so anyone can see how the old builds looked without taking anyone's word for it. There is one folder per version because the build mechanics differed slightly between versions. There is no v1.2 folder: v1.2's mechanics are identical to v1.1's, including the same brick definitions (BlockDefinitionStorage 0xd4e6…), so the v1.1 folder renders v1.2 tiles too. Each folder's _README.txt explains how to run it.