HandsOnChain

持分を口数で数える

作るもの

このレッスンを終えると、投資信託の持分を口数で数えるファンドのトークンができます。
1口を最小単位にし、1口より小さく分けることはできません。
持分を移せる先は1作目の円トークンの許可リストにいる人だけで、許可リストにいない人への移転を拒めることをFoundryのテストで確かめられます。

背景

投資信託の持分は、口数で数えます。
1口が最も小さい単位で、投資家は何口を持っているかで持分の大きさを表します。
1口の値段は小さいため、日本の多くの投資信託は基準価額を1万口あたりの額で示します。
1口を1円として運用を始めるファンドでは、始めた時の基準価額が1万口あたり10,000円になります。

申し込む投資家は、円の額を決めて申し込むことが多く、何口を受け取るかはその日の基準価額で決まります。
手数料を考えなければ、1万口あたり10,000円の日に100万円で申し込むと、100万口を受け取ります。
解約は口数で申し出ることができ、代金はその日の基準価額で決まります。
このコースでは、申込を円の額で、解約を口数で受け付けます。

値 このコースの決まり
口数の最小単位 1口。
トークンの小数の桁を0にする
基準価額の単位 1万口あたりの円
始めの基準価額 1万口あたり10,000円
持てる人 円トークンの許可リストにいて、凍結されていない人

投資家ごとの持分は、証券保管振替機構と販売会社が帳簿に電子的に記録しています。
販売会社は、取引を始める前に犯罪収益移転防止法の本人確認を行います。
取引所で売り買いするETFを除き、投資信託の持分は他の投資家へ売るのではなく、解約してお金に戻します。
相続のように持分を別の人へ移す時も、販売会社を通して移す先の人を確かめます。

このコースでは、持分をERC-20のトークンにし、小数の桁を0にして1トークンを1口にします。
トークンは誰にでも送れる形のままにせず、移す先を確かめます。
移す先が円トークンの許可リストにいない人か凍結された人なら、移転そのものを断ります。

本人確認の名簿は円トークンの1か所だけに置き、ファンドはその名簿を読みます。
ファンドが自分の名簿を持つと、円トークンの名簿と食い違うおそれがあるためです。
発行体が投資家を許可リストから外すと、その投資家は円も持分も受け取れなくなります。

持分を移す先を確かめる
チェーンに残る値投資家Aの口数1,000口900口投資家Bの口数0口100口名簿にない人の口数0口投資家A1,000口を持つファンドTokenizedFund円トークン本人確認の名簿投資家B許可リストにいる名簿にない人許可リストにいない1122transfer(名簿にない人, 100)transfer(名簿にない人, 100)isAllowed と isFrozenisAllowed と isFrozen載っていない載っていないtransfer(投資家B, 100)100口NotAllowed で断るNotAllowed で断る

実装

starter/contracts/contracts/TokenizedFund.solを新しく作ります。
まず、OpenZeppelin ContractsのERC-20を継承し、円トークンと運用会社のアドレスを持たせます。

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

import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import {JpyToken} from "@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.sol";

/// @title トークン化ファンド
/// @notice 投資信託の持分を、1口を最小単位にした口数で数えるトークン。
///         持てるのは1作目の円トークンの許可リストにいる人だけにする。額は全て円で数え、円トークンを送る時に18桁の最小単位へ直す
contract TokenizedFund is ERC20 {
    /// @notice 申込と解約に使う1作目の円トークン
    JpyToken public immutable jpy;
    /// @notice ファンドを運用する運用会社。約定の時に申込の円を受け取る
    address public immutable manager;

    error NotAllowed(address account);

    constructor(JpyToken jpy_, address manager_) ERC20("HandsOn Fund", "HOF") {
        jpy = jpy_;
        manager = manager_;
    }
行 意味
import {JpyToken} from "@handsonchain/..." 前のレッスンでリンクした1作目の完成版から、円トークンのコントラクトを読み込む
contract TokenizedFund is ERC20 残高と送金の関数をERC-20の形で持つ。
持分の口数をトークンの残高で表す
jpy 申込に払う円と、解約の代金に使う円トークン。
許可リストもここから読む
manager 運用会社のアドレス。
後の節で、約定の時に申込の円を受け取る
NotAllowed 許可リストにいない人か、凍結された人へ移そうとした。
断った相手のアドレスを残す
ERC20("HandsOn Fund", "HOF") トークンの名前と、画面やウォレットに出る短い記号を決める

jpyとmanagerはimmutableにし、デプロイした後は書き換えられないようにします。
ファンドが読む許可リストを後から別のトークンに差し替えられると、本人確認の決まりが崩れるためです。

続けて、小数の桁を0にする関数を足します。

    /// @notice 1口を最小単位にするため、小数の桁を持たない
    function decimals() public pure override returns (uint8) {
        return 0;
    }
行 意味
override ERC-20のdecimalsは18を返すため、上書きして0を返す
return 0 残高の1が1口になる。
円トークンのように18桁の単位へ直さずに、口数をそのまま数える

decimalsは、画面やウォレットが残高を何桁で区切って見せるかを決める値です。
0にすると、トークンの残高1000はそのまま1,000口と表示されます。

最後に、移す先を確かめる関数を足して、コントラクトを閉じます。

    // 円トークンの許可リストにいて、凍結されていないかを確かめる
    function _checkInvestor(address account) private view {
        if (!jpy.isAllowed(account) || jpy.isFrozen(account)) revert NotAllowed(account);
    }

    /// @dev 持分を移す先は、円トークンの許可リストにいる人に限る。消す時は確かめない
    function _update(address from, address to, uint256 value) internal override {
        if (to != address(0)) _checkInvestor(to);
        super._update(from, to, value);
    }
}
行 意味
jpy.isAllowed(account) 1作目の円トークンの許可リストを読む。
載っていない人をNotAllowedで断る
jpy.isFrozen(account) 円トークンで凍結された人も、許可リストにいない人と同じに断る
_update OpenZeppelinのERC-20で、送金と発行と消す操作が全て通る関数。
ここを上書きすると、どの経路で口数が動いても確かめられる
to != address(0) 移す先がaddress(0)の時は、口数を消す操作。
解約で口数を消す時は確かめない
super._update(from, to, value) 確かめが通った時だけ、元のERC-20の手順で残高を動かす

transferとtransferFromだけでなく、後の節で約定の時に口数を発行する_mintも_updateを通ります。
そのため、許可リストにいない人は、移転でも発行でも口数を受け取れません。

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

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

import {Test} from "forge-std/Test.sol";

import {JpyToken} from "@handsonchain/jpy-stablecoin-contracts/contracts/JpyToken.sol";
import {TokenizedFund} from "../contracts/TokenizedFund.sol";

// テストの準備で、約定を通さずに投資家へ口数を渡せるようにしたファンド
contract FundHarness is TokenizedFund {
    constructor(JpyToken jpy_, address manager_) TokenizedFund(jpy_, manager_) {}

    function mintForTest(address to, uint256 units) external {
        _mint(to, units);
    }
}
コード 意味
FundHarness is TokenizedFund テストの中だけで使う、ファンドを継承したコントラクト。
デプロイするファンドには入らない
mintForTest 申込と約定の仕組みを作る前でも、投資家へ口数を渡せるようにする。
_mintも_updateを通るので、許可リストの確かめは効いたまま

同じファイルの続きに、テストの土台を書きます。

// 円トークンを置いて投資家2人と運用会社を許可リストに載せ、ファンドを置く。
// 時計は2026-03-05 (木) の10時 (日本時間) から始める
contract TokenizedFundTest is Test {
    uint256 internal constant YEN = 1e18;
    // 2026-03-05 (木) の日の通し番号と、その日が始まる時刻 (日本時間の0時)
    uint256 internal constant THU = 20517;
    uint256 internal constant THU_START = 1772636400;

    JpyToken internal jpy;
    FundHarness internal fund;

    address internal manager = makeAddr("manager");
    address internal alice = makeAddr("alice");
    address internal bob = makeAddr("bob");
    address internal carol = makeAddr("carol");

    function setUp() public {
        vm.warp(THU_START + 10 hours);
        jpy = new JpyToken(address(this));
        fund = new FundHarness(jpy, manager);
        // 円トークンの許可リストに載せるのは投資家2人と運用会社とファンド。carolは載せない
        address[4] memory allowed = [alice, bob, manager, address(fund)];
        for (uint256 i = 0; i < allowed.length; i++) jpy.setAllowed(allowed[i], true);
        jpy.issue(alice, 5_000_000 * YEN, keccak256("alice"));
        jpy.issue(bob, 5_000_000 * YEN, keccak256("bob"));
        jpy.issue(manager, 50_000_000 * YEN, keccak256("manager"));
        address[3] memory payers = [alice, bob, manager];
        for (uint256 i = 0; i < payers.length; i++) {
            vm.prank(payers[i]);
            jpy.approve(address(fund), type(uint256).max);
        }
    }

    // 木曜から数えてdays日後の、日本時間のhour時minute分
    function _at(uint256 days_, uint256 hour, uint256 minute) internal pure returns (uint256) {
        return THU_START + days_ * 1 days + hour * 1 hours + minute * 1 minutes;
    }
コード 意味
THU_START 2026-03-05 (木) の0時 (日本時間) のUnix時刻
THU 2026-03-05を1970-01-01からの日の通し番号で表した値。
次のレッスンで約定日の番号に使う
vm.warp(THU_START + 10 hours) テストのチェーンの時刻を、木曜の10時にする。
後の節で15時の締め切りの前から始めるため
new JpyToken(address(this)) テストのコントラクトを円トークンの発行体にする。
vm.prankなしでsetAllowedとissueを呼べる
allowed 投資家のaliceとbob、運用会社、ファンドを許可リストに載せる。
carolは載せない
jpy.issue(...) 投資家2人に500万円ずつ、運用会社に5,000万円を発行する。
申込と解約の代金を試す後の節で使う
jpy.approve(address(fund), ...) 3人の円をファンドに任せておく。
後の節で、申込の円と解約の代金をファンドが動かす
_at(days_, hour, minute) 木曜から数えた日と時刻を作る手助けの関数。
次のレッスンから使う

ファンドのコントラクトも許可リストに載せるのは、後の節で申込の円と解約の口数を預かるためです。
円トークンも持分のトークンも、受け取る側が許可リストにいないと断ります。

続けて、テストの本体を書いて閉じます。

    function test_UnitsHaveNoDecimals() public view {
        assertEq(fund.decimals(), 0);
    }

    function test_RevertWhen_TransferToNotAllowed() public {
        fund.mintForTest(alice, 1_000);
        vm.prank(alice);
        vm.expectRevert(abi.encodeWithSelector(TokenizedFund.NotAllowed.selector, carol));
        fund.transfer(carol, 100);
        // 許可リストにいる人へは移せる
        vm.prank(alice);
        fund.transfer(bob, 100);
        assertEq(fund.balanceOf(bob), 100);
        assertEq(fund.balanceOf(carol), 0);
    }
}
コード 意味
fund.mintForTest(alice, 1_000) aliceに1,000口を渡す。
aliceは許可リストにいるので発行が通る
vm.prank(alice) 次の1回の呼び出しだけを、aliceのアカウントから送る
vm.expectRevert(...) 次の呼び出しが、carolのアドレスを持つNotAllowedで断られることを確かめる
fund.transfer(bob, 100) 許可リストにいるbobへ100口を移す
テスト 確かめること
test_UnitsHaveNoDecimals 小数の桁が0で、残高の1が1口になる
test_RevertWhen_TransferToNotAllowed 1,000口を持つaliceからcarolへの100口は断られ、bobへの100口は移る。
bobは100口、carolは0口になる

carolへの移転は断られたので、carolの残高は0口のままです。
bobへの移転だけが通り、aliceの1,000口のうち100口がbobへ移ります。

確かめる

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

forge test --match-contract TokenizedFundTest

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

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

移す先の確かめが効いていることも確かめます。
_updateの中の次の行を消して、テストを実行します。

        if (to != address(0)) _checkInvestor(to);

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

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

許可リストにいないcarolへの100口が、断られずに移ったことを示します。
この形のままだと、本人確認をしていない人へも持分を渡せてしまいます。
確かめたら、消した行を戻しておきます。