API仕様

API機能詳細

シリアル番号生成API

パス	メソッド	説明
/request_serial_number	POST	ランダムなシリアル番号を生成し、ブロックチェーンへ登録を行う

入力データ

なし

レスポンス

{ 
    "serialNumber":<シリアル番号> 
}

パラメータ	型	説明
serialNumber	string	シリアル番号

トークン作成API

パス	メソッド	説明
/create_tokens	POST	シリアル番号とデータからトークンを作成する

入力データ

{ 
    "serialNumber":<シリアル番号>, 
    "x":<データ> 
}

パラメーター	型	説明
serialNumber	string	シリアル番号
x	string	生データ

レスポンス

{
    "localToken":<ローカルトークン>, 
    "globalToken":<グローバルトークン>, 
    "r":<乱数>, 
    "comm":<コミットメント> 
}

パラメータ	型	説明
localToken	string	ローカルトークン
globalToken	string	グローバルトークン
r	string	乱数
comm	string	コミットメント

所有者署名付与API

パス	メソッド	説明
/create_gsign	POST	所有者の署名を作成する

入力データ

{
    "localToken":<ローカルトークン>, 
    "globalToken":<グローバルトークン>, 
    "x":<データ> 
}

パラメーター	型	説明
localToken	string	ローカルトークン
globalToken	string	グローバルトークン
x	string	生データ

レスポンス

{
    "gsign":<所有者による署名> 
}

パラメータ	型	説明
gsign	string	所有者による署名

所有者公開鍵取得API

パス	メソッド	説明
/get_okey	GET	署名の検証に必要な所有者の公開鍵を取得する

レスポンス

{ 
    "okey":<所有者の公開鍵>
}

パラメーター	型	説明
okey	string	所有者の公開鍵

発行者署名付与API

パス	メソッド	説明
/create_owner_signature	POST	所有者による署名を検証し、発行者による署名を作成する

入力データ

{ 
    "globalToken":<グローバルトークン>, 
    "gsign":<所有者による署名>, 
    "okey":<所有者の公開鍵> 
}

パラメーター	型	説明
globalToken	string	グローバルトークン
gsign	string	所有者による署名
okey	string	所有者の公開鍵

レスポンス

{ 
    "globalToken":<グローバルトークン>, 
    "evidence":<エビデンス> 
}

パラメータ	型	説明
globalToken	string	グローバルトークン
evidence	string	エビデンス（所有者による公開鍵、所有者による署名、発行者の公開鍵、発行者による署名）

アセット登録API

パス	メソッド	説明
/register_assets	POST	グローバルトークンとエビデンスをブロックチェーンに登録する

入力データ

{
    "serialNumber":<シリアル番号>, 
    "globalToken":<グローバルトークン>, 
    "evidence":<エビデンス> 
}

パラメーター	型	説明
serialNumber	string	シリアル番号
globalToken	string	グローバルトークン
evidence	string	エビデンス（所有者による公開鍵、所有者による署名、発行者の公開鍵、発行者による署名）

レスポンス

{
    "serialNumber":<シリアル番号>, 
    "globalToken":<グローバルトークン>, 
    "evidence":<エビデンス> 
}

パラメーター	型	説明
serialNumber	string	シリアル番号
globalToken	string	グローバルトークン
evidence	string	エビデンス（所有者による公開鍵、所有者による署名、発行者の公開鍵、発行者による署名）

アセット取得API

パス	メソッド	説明
/get_asset	POST	シリアル番号からブロックチェーンに記録されたアセットを取得する

入力データ

{
    "serialNumber":<シリアル番号>
}

パラメーター	型	説明
serialNumber	string	シリアル番号

レスポンス

{
    "serialNumber":<シリアル番号>, 
    "globalToken":<グローバルトークン>, 
    "evidence":<エビデンス> 
}

パラメーター	型	説明
serialNumber	string	シリアル番号
globalToken	string	グローバルトークン
evidence	string	エビデンス（所有者による公開鍵、所有者による署名、発行者の公開鍵、発行者による署名）

ゼロ知識証明作成API

パス	メソッド	説明
/create_proof	POST	ゼロ知識証明の作成を行う

入力データ

{ 
    "x":<生データ>, 
    "r":<乱数>, 
    "comm":<コミットメント>
}

パラメーター	型	説明
x	string	生データ
r	string	乱数
comm	string	コミットメント（生データxを乱数rの下で秘匿化したもの）

レスポンス

{
    "proof":<証明>
}

パラメーター	型	説明
proof	string	証明

検証鍵取得API

パス	メソッド	説明
/client/get_zkp_verification_key	GET	ゼロ知識証明検証鍵の取得

レスポンス

{ 
    "verificationKey":<検証鍵>
}

パラメーター	型	説明
verificationKey	string	検証鍵

ゼロ知識証明検証API

パス	メソッド	説明
/verify_proof	POST	ゼロ知識証明の検証を行う

入力データ

{ 
    "verificationKey":<検証鍵>, 
    "comm":<コミットメント>, 
    "x":<生データ>, 
    "proof":<ゼロ知識証明文> 
}

パラメーター	型	説明
verificationKey	string	検証鍵
comm	string	コミットメント（生データxを乱数rの下で秘匿化したもの）
x	string	生データ
proof	string	ゼロ知識証明文

レスポンス

{ 
    "result":<検証結果> 
}

パラメーター	型	説明
result	string	検証結果

APIのお試しはこちら技術の説明はこちら