mirror of https://github.com/status-im/EIPs.git
50 lines
2.0 KiB
Markdown
50 lines
2.0 KiB
Markdown
---
|
|
eip: 1387
|
|
title: Merkle Tree Attestations with Privacy enabled
|
|
author: Weiwu Zhang <a@colourful.land>, James Sangalli <j.l.sangalli@gmail.com>
|
|
discussions-to: https://github.com/ethereum/EIPs/issues/1387
|
|
status: Draft
|
|
type: Standards Track
|
|
category: ERC
|
|
created: 2018-09-08
|
|
---
|
|
|
|
### Introduction
|
|
|
|
It's often needed that an Ethereum smart contract must verify a claim (I live in Australia) attested by a valid attester.
|
|
|
|
For example, an ICO contract might require that the participant, Alice, lives in Australia before she participates. Alice's claim of residency could come from a local Justice of the Peace who could attest that "Alice is a resident of Australia in NSW".
|
|
|
|
Unlike previous attempts, we assume that the attestation is signed and issued off the blockchain in a Merkle Tree format. Only a part of the Merkle tree is revealed by Alice at each use. Therefore we avoid the privacy problem often associated with issuing attestations on chain. We also assume that Alice has multiple signed Merkle Trees for the same factual claim to avoid her transactions being linkable.
|
|
|
|
## Purpose
|
|
This ERC provides an interface and reference implementation for smart contracts that need users to provide an attestation and validate it.
|
|
|
|
### Draft implementation
|
|
```
|
|
contract MerkleTreeAttestationInterface {
|
|
struct Attestation
|
|
{
|
|
bytes32[] merklePath;
|
|
bool valid;
|
|
uint8 v;
|
|
bytes32 r;
|
|
bytes32 s;
|
|
address attester;
|
|
address recipient;
|
|
bytes32 salt;
|
|
bytes32 key;
|
|
bytes32 val;
|
|
}
|
|
|
|
function validate(Attestation attestation) public returns(bool);
|
|
}
|
|
|
|
```
|
|
### Relevant implementation examples
|
|
[Here](https://github.com/alpha-wallet/blockchain-attestation/blob/master/ethereum/lib/MerkleTreeAttestation.sol) is an example implementation of the MerkleTreeAttestationInterface
|
|
[Here](https://github.com/alpha-wallet/blockchain-attestation/blob/master/ethereum/example-james-squire/james-squire.sol) is an example service which would use such a merkle tree attestation
|
|
|
|
### Related ERC's
|
|
#1388 #1386
|