ERC725/735の仕組み 1

はじめに

概要

Claimとは

• Claim（申し立て）: 私は、訓練を受け、認定されたドライバーです。
• Claim issuer : 東京都公安委員会
• Verifiable Claim（検証可能なClaim）: 運転免許証
• Verifier（検証者）: 警察官

仕組み

ER725とは

pragma solidity ^0.4.19;

contract ERC725 {
    enum PURPOSES {
        MANAGEMENT_KEY,
        ACTION_KEY,
        CLAIM_SIGNER_KEY,
        ENCRYPTION_KEY
    }

    struct Key {
        uint256[] purposes; //e.g., MANAGEMENT_KEY = 1, ACTION_KEY = 2, etc.
        uint256 keyType; // e.g. 1 = ECDSA, 2 = RSA, etc.
        bytes32 key;
    }

    struct Execution {
        address to;
        uint256 value;
        bytes data;
        bool approved;
        bool executed;
    }

    // Events
    event KeyAdded(bytes32 indexed key, uint256[] purposes, uint256 indexed keyType);
    event KeyRemoved(bytes32 indexed key, uint256[] purposes, uint256 indexed keyType);
    event ExecutionRequested(uint256 indexed executionId, address indexed to, uint256 indexed value, bytes data);
    event Executed(uint256 indexed executionId, address indexed to, uint256 indexed value, bytes data);
    event Approved(uint256 indexed executionId, bool approved);

    // Setters
    function addKey(bytes32 _key, uint256[] _purposes, uint256 _type) external returns (bool success);
    function approve(uint256 _id, bool _approve) public returns (bool success);
    function execute(address _to, uint256 _value, bytes _data) public returns (uint256 executionId);
    function removeKey(bytes32 _key) external returns (bool success);
    // Getters
    function getKey(bytes32 _key) public view returns (uint256[] purposes, uint256 keyType, bytes32 key);
    function getKeyPurposes(bytes32 _key) public view returns (uint256[] purposes);
    function getKeysByPurpose(uint256 _purpose) public view returns (bytes32[] keys);
}

• MANAGEMENT_KEY
• ACTION_KEY
• CLAIM_SIGNER_KEY
• ENCRYPTION_KEY

• 鍵の用途（MANAGEMENT_KEYやACTION_KEYなど）
• 鍵の技術的種類（ECDSAやRSAなど）
• 鍵自体の情報のバイト列

• addKey（…） : 鍵の追加
• removeKey（…）: 鍵の削除
• getKey（…） : 鍵のデータを渡すことで、鍵の用途や鍵の技術的な種類を取得できる。
• getKeyPurposes（…）: 鍵用途だけ取得できる。
• getKeysByPurpose（…）: 特定の用途の鍵の情報を取得できる。

• execute（…）
• approve（…）

ERC735とは

pragma solidity ^0.4.18;

contract ERC735 {

    event ClaimRequested(uint256 indexed claimRequestId, uint256 indexed topic, uint256 scheme, address indexed issuer, bytes signature, bytes data, string uri);
    event ClaimAdded(bytes32 indexed claimId, uint256 indexed topic, uint256 scheme, address indexed issuer, bytes signature, bytes data, string uri);
    event ClaimRemoved(bytes32 indexed claimId, uint256 indexed topic, uint256 scheme, address indexed issuer, bytes signature, bytes data, string uri);
    event ClaimChanged(bytes32 indexed claimId, uint256 indexed topic, uint256 scheme, address indexed issuer, bytes signature, bytes data, string uri);

    struct Claim {
        uint256 topic;
        uint256 scheme;
        address issuer; // msg.sender
        bytes signature; // this.address + topic + data
        bytes data;
        string uri;
    }

    function getClaim(bytes32 _claimId) public constant returns(uint256 topic, uint256 scheme, address issuer, bytes signature, bytes data, string uri);
    function getClaimIdsByTopic(uint256 _ topic) public constant returns(bytes32[] claimIds);
    function addClaim(uint256 _topic, uint256 _scheme, address _issuer, bytes _signature, bytes _data, string _uri) public returns (uint256 claimRequestId);
    changeClaim(bytes32 _claimId, uint256 _topic, uint256 _scheme, address _issuer, bytes _signature, bytes _data, string _uri) returns (bool success);
    function removeClaim(bytes32 _claimId) public returns (bool success);
}

• topic : 「生体認証」や「居住地」などこのclaimが表す大まかな内容についてです。
• scheme : このclaimの処理や検証に使用するスキームです。例えばECDSA、RSA、コントラクト検証などがあります。
• issuer : 発行者IDコントラクトアドレスまたはschemeに署名するアドレスです。
• signature : この署名は、claim発行者がこのtopicのclaimを発行した証拠です。
• data : 別の場所にあるクレームデータのハッシュなどです。
• uri : クレームが保存されている場所のリンクです。

• getClaim(…) : 保有されているclaimを参照できます。主にサービスプロバイダーが、この機能を利用してユーザーのclaim（例えば運転が許可されているかどうか）を参照する用途が想定されます。
• getClaimIdsByTopic（…）: topicを指定してclaimを参照できます。つまり認証の種類によって呼び出すということです。
• addClaim(…) : オフチェーン上作成されてclaimを追加できます。引数に作成されたClaim情報として、「_claimType」・「_scheme」「issuer」・「_signature」・「_data」・「_uri」を渡します。「_signature」は、作成者がオフチェーン上で署名したデータです。
• removeClaim（..）: claimを削除できます。

免責事項

ブロックチェーン学習に最適の書籍の紹介

会社紹介