債権・アセットファイナンス

システム構成と役割

1. 01

   契約・投資家管理

   契約原本、参加資格、支払予定を管理します。

   Application API / DB
2. 02

   債権の発行・保有

   classIdとnonceIdの組ごとに発行数・保有数を管理します。

   BondTokenHelper
3. 03

   支払い・請求

   銀行送金なら入金照合、対応トークンなら契約に応じた請求処理を接続します。

   Bank integration / DebtManagerHelper
4. 04

   運用・報告

   基準日時点の保有数と支払い結果を保存し、報告に利用します。

   Snapshots / Application ledger

データモデル例

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

処理の流れ

1. 1

   契約条件をclass・nonceへ対応づける

   契約FIN-001をclassId 20、発行回をnonceId 202709へ紐づけます。classとnonceを作成し、公開するメタデータだけをチェーンに設定します。

   createClass(classId, data) → createNonce(classId, nonceId, data)
2. 2

   参加資格と入金を確認して発行する

   本人確認や契約、払込条件は業務側で確認します。必要なホワイトリストを設定したうえで、投資家へ10口を発行します。トークンの発行だけで銀行入金が確認されるわけではありません。

   issue(investor, classId, nonceId, 10n)
3. 3

   基準日時点の保有数を確定する

   支払対象の口数は、支払時点の現在残高ではなく、契約で定めた基準日の記録に対応づけます。BondTokenのsnapshotは呼出時に作成するため、後から任意の日付の残高を作る用途ではありません。

   snapshot() → balanceOfAt(holder, classId, nonceId, snapshotId)
4. 4

   支払い経路を接続する

   銀行送金の場合は業務台帳で支払額と入金を照合します。DebtManagerを使う場合は対応するBondToken、元本・利払い用トークン、権限、支払日程を設定し、資金を用意してpayCouponを実行します。

   DebtManager: createTranche → addCouponSchedule → payCoupon → claimCoupon
5. 5

   償還と記録を整合させる

   元本返済の確認と口数の消込を対応づけます。BondTokenのredeemは口数をburnする操作です。資金払い戻しを連動させる場合は、DebtManagerなどの支払い処理を含めた構成を使用します。

   BondToken.redeem / DebtManager.redeemAtMaturity

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

• 初期化済みBondToken、作成済みclassId・nonceId、MINTER_ROLEを持つSignerが必要です。
• 口数はbigintで渡します。小数桁を使うERC-20の金額と、債権の口数を区別します。
• 参加資格・契約・払込を確認し、必要なホワイトリストへの登録を済ませてから呼び出します。

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

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

契約・発行回を指定して投資家へ割り当てる

classId: 20n、nonceId: 202709n、units: 10nを渡す例です。agreementIdは自社の契約IDで、戻り値を業務台帳に保存するために使用します。

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

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

export async function allocateBond(input: {
  agreementId: string;
  tokenAddress: string;
  classId: bigint;
  nonceId: bigint;
  investor: string;
  units: bigint;
  issuer: Signer;
}) {
  // The class and nonce must already exist; issuer needs MINTER_ROLE.
  if (input.units <= 0n) throw new Error('Units must be positive.');
  const bond = BondTokenHelper.attach(input.tokenAddress, input.issuer);
  const receipt = await bond.issue(
    input.investor, input.classId, input.nonceId, input.units,
  );
  const balance = await bond.balanceOf(
    input.investor, input.classId, input.nonceId,
  );

  return {
    agreementId: input.agreementId,
    classId: input.classId.toString(),
    nonceId: input.nonceId.toString(),
    investor: input.investor,
    issuedUnits: input.units.toString(),
    balance: balance.toString(),
    transactionHash: receipt.hash,
  };
}

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

用途に合わせた拡張

関連するAPI・SDK仕様