HandsOnChain

評価会社が社債の価格を入れる

作るもの

このレッスンを終えると、評価会社の役割を持つアカウントだけが社債1口の価格を入れられる、価格のコントラクトができます。
価格は入れた時刻と一緒にチェーンに残り、次のレッスンで作るローンのコントラクトは、この価格で担保の評価額を出します。
役割の決まりと、まだ価格がない時に断ることは、Foundryのテストで確かめられます。

背景

担保の評価額は、預けた社債の口数に1口の価格を掛けた額です。
株は取引所で毎日売り買いされ、終値で時価が分かります。
社債の多くは取引所でなく証券会社どうしの相対で売り買いされるため、その日の価格が誰にでも見える形では出てきません。
そこで金融機関は、日本証券業協会が毎営業日に発表する公社債店頭売買参考統計値や、時価を計算して知らせる評価会社の価格で担保を評価します。

チェーンの上のコントラクトは、チェーンの外の値を自分で読みに行けません。
そのため、チェーンの外で決まった価格は、誰かが取引を送ってチェーンへ書き込みます。
チェーンの外の値をチェーンへ入れる仕組みは、オラクルと呼ばれます。
このコースでは、評価会社のアカウントが社債1口の価格を入れるコントラクトを、オラクルとして置きます。

誰でも価格を書き換えられると、借り手が担保の価格を高く書いて、借りられる額を増やせてしまいます。
そこで価格を入れられるのは、評価会社の役割を持つアカウントだけにします。
役割を渡し直せるのは、管理の役割を持つデプロイのアカウントだけです。

役割 持つアカウント できること
DEFAULT_ADMIN_ROLE デプロイのアカウント 評価会社の役割を渡し、取り上げる
VALUER_ROLE 評価会社 社債1口の価格を入れる

価格と一緒に、価格を入れた時刻も残します。
価格は時間が経つほど今の値からずれていくため、古い価格をいつまでも使うと、下がった担保を高いまま評価してしまいます。
入れた時刻を持っておけば、何日前の価格かを数えられます。
古い価格を断る仕組みは、価格と担保維持率の節で足します。

評価会社が入れた価格をローンが読む
チェーンに残る値1口の価格100,000円入れた時刻2026-01-15評価会社VALUER_ROLE を持つほかの人役割を持たない価格のコントラクトCollateralPriceローンのコントラクト次のレッスンで作る112233setPrice(100,000)setPrice(100,000)setPrice(1)setPrice(1)currentPrice()100,000円AccessControlUnauthorizedAccount で断るAccessControlUnauthorizedAccount で断る

実装

starter/contracts/contracts/CollateralPrice.solを新しく作ります。
まず、AccessControlを継承し、評価会社の役割と価格と時刻の値を並べます。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

import {AccessControl} from "@openzeppelin/contracts/access/AccessControl.sol";
import {SafeCast} from "@openzeppelin/contracts/utils/math/SafeCast.sol";

/// @title 担保の社債の価格
/// @notice 評価会社の役を持つアカウントが、社債1口の価格 (円) を入れる。
///         入れた時刻を一緒に残し、ローンのコントラクトは最新の価格で担保の評価額を出す
contract CollateralPrice is AccessControl {
    /// @notice 価格を入れる評価会社の役
    bytes32 public constant VALUER_ROLE = keccak256("VALUER_ROLE");

    /// @notice 社債1口の価格 (円)
    uint256 public price;
    /// @notice 最後に価格を入れた時刻。まだ入れていない時は0
    uint64 public updatedAt;

    event PriceSet(uint256 price, uint64 updatedAt);

    error NoPrice();

    constructor(address admin, address valuer) {
        _grantRole(DEFAULT_ADMIN_ROLE, admin);
        _grantRole(VALUER_ROLE, valuer);
    }
行 意味
VALUER_ROLE 価格を入れる評価会社の役割の名前
price 社債1口の価格。
円トークンの18桁の単位ではなく、円の整数 (100,000) で持つ
updatedAt 最後に価格を入れた時刻のUnix時刻。
0の間は、まだ一度も価格を入れていない
PriceSet 価格を入れた時に、価格と時刻をイベントとして残す。
画面や外の仕組みが価格の移り変わりを追える
NoPrice まだ価格がないのに、価格を読もうとした
_grantRole(DEFAULT_ADMIN_ROLE, admin) デプロイのアカウントに、役割を渡し直す管理の役割を持たせる
_grantRole(VALUER_ROLE, valuer) 評価会社のアカウントに、価格を入れる役割を渡す

続けて、価格を入れる関数と、ローンのコントラクトが読む関数を足します。

    /// @notice 評価会社が社債1口の価格を入れる。入れた時刻はブロックの時刻で残る
    function setPrice(uint256 price_) external onlyRole(VALUER_ROLE) {
        price = price_;
        updatedAt = SafeCast.toUint64(block.timestamp);
        emit PriceSet(price_, updatedAt);
    }

    /// @notice ローンのコントラクトが使う価格。まだ価格のない時は断る
    function currentPrice() external view returns (uint256) {
        if (updatedAt == 0) revert NoPrice();
        return price;
    }
}
行 意味
onlyRole(VALUER_ROLE) 評価会社の役割を持たないアカウントが呼ぶと、AccessControlがAccessControlUnauthorizedAccountのエラーで断る
price = price_ 新しい価格で上書きする。
0円も入れられる。
社債の発行体が払えなくなった時に、評価会社が0円を入れるためです
SafeCast.toUint64(block.timestamp) ブロックの時刻はuint256なので、uint64に縮めて残す。
収まらない値の時は縮めずに断る
if (updatedAt == 0) revert NoPrice() まだ一度も価格を入れていない時に、0円の価格として読まれないように断る

priceはpublicなので、誰でもそのまま読めます。
ローンのコントラクトはpriceではなくcurrentPrice()を読みます。
価格を入れる前の0円と、評価会社が入れた0円を見分けるためです。

次に、starter/contracts/test/CollateralPrice.t.solを新しく作り、価格のテストを書きます。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;

import {Test} from "forge-std/Test.sol";
import {IAccessControl} from "@openzeppelin/contracts/access/IAccessControl.sol";

import {CollateralPrice} from "../contracts/CollateralPrice.sol";

contract CollateralPriceTest is Test {
    uint64 internal constant ISSUE_DATE = 1768402800; // 2026-01-15

    CollateralPrice internal price;
    address internal admin = makeAddr("admin");
    address internal valuer = makeAddr("valuer");
    address internal stranger = makeAddr("stranger");

    function setUp() public {
        vm.warp(ISSUE_DATE);
        price = new CollateralPrice(admin, valuer);
    }

    function test_PriceRoleSetsPrice() public {
        vm.expectEmit(address(price));
        emit CollateralPrice.PriceSet(100_000, ISSUE_DATE);
        vm.prank(valuer);
        price.setPrice(100_000);
        // 価格と入れた時刻が一緒に残り、ローンのコントラクトはこの価格を使う
        assertEq(price.price(), 100_000);
        assertEq(price.updatedAt(), ISSUE_DATE);
        assertEq(price.currentPrice(), 100_000);
    }

    function test_RevertWhen_PriceSetWithoutRole() public {
        vm.expectRevert(
            abi.encodeWithSelector(IAccessControl.AccessControlUnauthorizedAccount.selector, stranger, price.VALUER_ROLE())
        );
        vm.prank(stranger);
        price.setPrice(1);
        // 断った後も価格は入っていない
        assertEq(price.updatedAt(), 0);
        vm.expectRevert(CollateralPrice.NoPrice.selector);
        price.currentPrice();
    }
}
コード 意味
vm.warp(ISSUE_DATE) テストのチェーンの時刻を、社債の払込日の2026-01-15にする
makeAddr("valuer") 名前から決まるテストのアドレスを作る。
valuerを評価会社にする
vm.expectEmit(address(price)) 次の呼び出しが、続けて書いたPriceSetと同じイベントを出すことを確かめる
vm.prank(valuer) 次の1回の呼び出しだけを、評価会社のアカウントから送る
vm.expectRevert(...) 次の呼び出しが、渡したエラーで断られることを確かめる
price.VALUER_ROLE() エラーに入る役割の名前を読む。
vm.prankより前に書き、strangerの名義を使わせない
テスト 確かめること
test_PriceRoleSetsPrice 評価会社が入れた100,000円と、入れた時刻の2026-01-15がそのまま読める
test_RevertWhen_PriceSetWithoutRole 役割のないstrangerの価格は断られ、その後も価格がないままNoPriceで断られる

確かめる

starter/contractsのディレクトリでテストを実行します。

forge test --match-contract CollateralPriceTest

次の行が出れば、テストは通っています。

[PASS] test_PriceRoleSetsPrice()
[PASS] test_RevertWhen_PriceSetWithoutRole()
Suite result: ok. 2 passed; 0 failed; 0 skipped

役割の決まりが効いていることも確かめます。
setPriceの行からonlyRole(VALUER_ROLE)を消して、テストを実行します。

    function setPrice(uint256 price_) external {

test_RevertWhen_PriceSetWithoutRoleが失敗し、次の行が出ます。

[FAIL: next call did not revert as expected] test_RevertWhen_PriceSetWithoutRole()

役割を持たないstrangerの価格が断られずに入ったことを示します。
この形のままローンにつなぐと、誰でも担保の価格を書き換えて、借りられる額を増やせます。
確かめたら、onlyRole(VALUER_ROLE)を戻しておきます。