証明・情報開示

システム構成と役割

1. 01

   点検・原データ管理

   設備、点検者、点検日時、報告書の版を管理します。

   Inspection system / DB
2. 02

   文書の保存・共有

   原本を保存し、共有先に応じたアクセス制御を行います。

   Storage / Access control
3. 03

   証明値の記録

   指標ID、公開値、文書ハッシュ、有効期限を記録します。

   MultiTrustCredentialHelper
4. 04

   提示・照合

   原本のハッシュ、信頼する発行者、期限、対象を照合します。

   Verifier UI / Application policy

データモデル例

業務DBに保存する情報と、チェーンやAPIで管理する情報を対応づけます。フィールド名とサンプル値は、この構成で使うアプリケーション側の設計例です。

処理の流れ

1. 1

   指標と発行主体を設定する

   管理者がINSPECTION_PASS_V1という指標を登録し、書込用の役割を点検結果の発行者に付与します。この例は公開値なのでcommitmentはfalse、比較を使わない構成としてmaskは0にします。

   registerMetric(id, label, writerRole, false, 0) / grantRole
2. 2

   原本を保存してハッシュを計算する

   確定した報告書のバイト列を保存し、同じバイト列からkeccak256を計算します。署名入りURLの有効期限と、証明自体の有効期限は別々に管理します。

   Storage upload → keccak256(reportBytes)
3. 3

   証明先へ指標を記録する

   対象のウォレットにvalue 1、文書ハッシュ、期限をmintします。同じウォレット・同じ指標へ再度mintすると指標の更新になるため、過去の報告書は版と取引ハッシュで別途保存します。

   MultiTrustCredentialHelper.mint(subjectWallet, input)
4. 4

   提示先が記録を照合する

   提示先は信頼するコントラクトと発行者を確認し、報告書のハッシュ、指標、対象ウォレット、期限を照合します。MetricUpdatedの取引履歴も使い、訂正前の古い記録を現在有効なものと誤認しないようにします。

   queryMetricUpdated(fromBlock, toBlock) / application validity checks
5. 5

   訂正・再点検を管理する

   新しい版を保存して指標を更新し、旧版との対応を残します。過去の公開データを消すことはできないため、取消しや置換の表示は業務DBの履歴と組み合わせます。

   updateMetric / document version history

コードを利用する前の準備

• 初期化済みMultiTrustCredentialと、登録済み指標に対する書込権限を持つSignerを用意します。
• この例はINSPECTION_PASS_V1を公開値として扱います。subjectWalletと設備の対応を管理し、同じ指標を別設備の記録で上書きしない構成にします。
• reportBytesには確定した原本を渡します。metadataUriは公開可能なメタデータを指し、非公開原本の取得には別途アクセス制御を設けます。

npm install --save-exact @hazbase/kit@0.9.0 ethers@6.16.0

以下はアプリケーションから呼び出すTypeScriptの関数です。接続先・権限・対象データを引数として渡します。UI、DBへの保存、処理の再開は、上記の構成に沿って業務側へ組み込めます。

報告書のハッシュと点検合格を記録する

publishInspectionへ報告書のバイト列、証明先、期限、発行者を渡します。ここでは文書との対応づけを実装し、ZKによる条件証明は次の拡張として分けています。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

import { MultiTrustCredentialHelper } from '@hazbase/kit';
import { id, keccak256 } from 'ethers';
type Signer = Parameters<typeof MultiTrustCredentialHelper.deploy>[1];

const metricId = id('INSPECTION_PASS_V1');

export async function publishInspection(input: {
  credentialAddress: string;
  subjectWallet: string;
  reportBytes: Uint8Array;
  metadataUri: string;
  expiresAt: bigint;
  writer: Signer;
}) {
  // Register this metric and grant its writer role before calling.
  const credential = MultiTrustCredentialHelper.attach(input.credentialAddress, input.writer);
  const documentHash = keccak256(input.reportBytes);
  const receipt = await credential.mint(input.subjectWallet, {
    metricId,
    value: 1,
    anchorRoot: BigInt(documentHash),
    uri: input.metadataUri,
    expiresAt: input.expiresAt,
  });

  // This example anchors document bytes; it does not generate a ZK proof.
  return {
    subject: input.subjectWallet,
    metricId,
    documentHash,
    transactionHash: receipt.hash,
    blockNumber: receipt.blockNumber,
  };
}

実装で押さえておきたい点

用途に合わせた拡張

関連するAPI・SDK仕様