Table of Contents
A standard interface for canary contracts.
The following standard allows the implementation of canaries within contracts. This standard provides basic functionality to check if a canary is alive, keeping the canary alive and optionally manage feeders.
The canary can e.g. be used as a warrant canary. A standard interface allows other applications to easily interface with canaries on Ethereum - e.g. for visualizing the state, automated alarms, applications to feed the canary or contracts (e.g. insurance) that use the state.
Returns if the canary was fed properly to signal e.g. that no warrant was received.
function isAlive() constant returns (bool alive)
Returns the block the canary died. Throws if the canary is alive.
function getBlockOfDeath() constant returns (uint256 block)
Returns the type of the canary:
1= Simple (just the pure interface as defined in this ERC)
2= Single feeder (as defined in ERC-TBD)
3= Single feeder with bad food (as defined in ERC-TBD)
4= Multiple feeders (as defined in ERC-TBD)
5= Multiple mandatory feeders (as defined in ERC-TBD)
6= IOT (as defined in ERC-TBD)
1 might also be used for a special purpose contract that does not need a special type but still wants to expose the functions and provide events as defined in this ERC.
function getType() constant returns (uint8 type)
MUST trigger when the contract is called the first time after the canary died.
Copyright and related rights waived via CC0.
Please cite this document as:
ligi, "EIP-801: Canary Standard," Ethereum Improvement Proposals, no. 801, December 2017. [Online serial]. Available: https://eips.ethereum.org/EIPS/eip-801.