物理資産・在庫

システム構成と役割

1. 01

   資産管理画面

   設備情報、契約、割当先と数量を表示します。

   Web UI
2. 02

   業務API・資産台帳

   資産IDとトークンの対応、操作権限、処理の受付IDを管理します。

   Application API / DB
3. 03

   権利の発行・移転

   発行上限と保有残高を管理し、許可された移転を実行します。

   FlexibleTokenHelper
4. 04

   履歴の同期

   確定した取引を台帳に反映し、稼働や点検の記録と紐づけます。

   Transaction receipts / Events

データモデル例

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

処理の流れ

1. 1

   設備と権利を登録する

   A-001と契約AGR-2027-001を台帳に登録します。設備1台につき1コントラクトを使う構成なら、トークンの保有数をその設備に関する権利の数量として扱えます。

   Application DB: assetId → agreementId → tokenAddress
2. 2

   トークンを初期化する

   FlexibleTokenを発行上限1,000、小数桁0で用意します。発行者にMINTER_ROLEを付与し、譲渡可否や必要なホワイトリストを設定します。

   FlexibleTokenHelper.deploy / attach
3. 3

   取引先に10単位を割り当てる

   割当申請を保存してからmintを呼び出します。確定したreceiptのハッシュを申請に紐づけ、残高を取得します。発行済みの単位を渡す場合は、保有者の署名でtransferを使用します。

   mint(recipient, amount) → balanceOf(recipient)
4. 4

   保有者の一覧を更新する

   Transferイベントを取り込み、chainId・transactionHash・logIndexを一意キーにして反映します。画面表示用のDBと、チェーンの残高を定期的に照合します。

   Transfer events / balanceOf
5. 5

   運用記録を重ねる

   稼働時間、点検、故障などはassetIdで台帳に紐づけます。権利の移転と設備の引渡しは別の状態として記録し、現物の確認が必要な処理は業務側で管理します。

   Application DB: operating_records.assetId

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

• 初期化済みFlexibleTokenのアドレスと、対象チェーンに接続した発行者のSignerを用意します。
• この例では発行上限1,000・小数桁0を使用します。unitsには表示上の数量を文字列で渡します。
• 発行者のMINTER_ROLE、Pauseの状態、割当先に必要な参加条件を確認します。

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

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

設備IDを残して、10単位を割り当てる

allocateAssetへassetId、tokenAddress、recipient、units: "10"、issuerを渡します。DBへの保存処理は返された値を使用して、業務API側に組み込めます。

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

import { FlexibleTokenHelper } from '@hazbase/kit';
import { parseUnits } from 'ethers';
type Signer = Parameters<typeof FlexibleTokenHelper.deploy>[1];

export async function allocateAsset(input: {
  assetId: string;
  tokenAddress: string;
  recipient: string;
  units: string;
  issuer: Signer;
}) {
  if (!input.issuer.provider) throw new Error('A connected signer is required.');
  // Requires an initialized token and a signer with MINTER_ROLE.
  const token = FlexibleTokenHelper.attach(input.tokenAddress, input.issuer);
  const amount = parseUnits(input.units, await token.decimals());
  if (amount <= 0n) throw new Error('Units must be positive.');

  const receipt = await token.mint(input.recipient, amount);
  const balance = await token.balanceOf(input.recipient);
  const network = await input.issuer.provider.getNetwork();

  // Persist this mapping in your asset register after confirmation.
  return {
    assetId: input.assetId,
    chainId: network.chainId.toString(),
    tokenAddress: input.tokenAddress,
    holder: input.recipient,
    allocatedAtomic: amount.toString(),
    balanceAtomic: balance.toString(),
    transactionHash: receipt.hash,
    blockNumber: receipt.blockNumber,
  };
}

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

用途に合わせた拡張

関連するAPI・SDK仕様