HandsOnChain

信託報酬と解約価額の画面を作る

作るもの

このレッスンを終えると、運用会社のページの「純資産を入れる」の欄に、差し引く信託報酬と差し引いた後の純資産が出ます。
欄に額を入れるだけで、取引を送る前に基準価額まで確かめられます。
投資家のページでは、約定した日の基準価額と解約価額が並び、解約の代金の式も解約価額で出ます。
「解約する」の欄には、今日の約定日に注文した解約の合計と100万口の上限が並びます。

100万口のファンドで3月6日の金曜の純資産に1,002,000円を入れると、信託報酬の27円を差し引いた1,001,973円から基準価額の10,019円が出ます。
その日の解約価額は9,988円で、300,000口の解約の代金は299,640円になります。

背景

投資信託の基準価額は、運用会社 (委託会社) が毎営業日に計算します。
その日の値段でファンドの株や債券を評価し、その日の分の信託報酬などの費用を差し引いてから口数で割ります。
受託会社の信託銀行も同じ基準価額を別に計算し、運用会社は2つの値が合うことを確かめてから公表します。
基準価額は締め切りの後に計算するので、投資家はブラインド方式でその日の基準価額を知らずに注文します。

投資家は、販売会社や運用会社のウェブサイトで毎日の基準価額を見て、販売会社に申込と解約を注文します。
解約が約定すると、販売会社は約定日の解約価額と口数と代金と受渡日を投資家に知らせます。
解約価額は基準価額から信託財産留保額を引いた値段で、代金は受渡日に販売会社を通して払われます。
信託報酬の年率と信託財産留保額の率は目論見書に書かれ、大口の解約に制限を設ける場合があることも書かれています。

このコースでは、運用会社の画面がファンドのコントラクトのtrustFeeForとnavForを読み、純資産を入れる前に信託報酬と基準価額を出します。
setNavも同じ2つの関数で計算するので、取引を送る前に見た値と入れた後の値は同じになります。
受託会社が別に計算して突き合わせなくても、入れた純資産から誰でも同じ値を計算し直せます。
投資家の画面は、約定日の基準価額から解約価額を出し、上限の残りをコントラクトのredeemedOnから読みます。

ページ 欄 出す値
運用会社 上の欄の「信託報酬」 TRUST_FEE_BPSの年率。
100で年1.00%
運用会社 受け取った信託報酬の累計 trustFeeTotal。
これまでの約定日に差し引いた信託報酬の合計
運用会社 「純資産を入れる」の信託報酬 trustFeeForが返す、前に純資産を入れた約定日からの日数分の信託報酬
運用会社 差し引いた純資産 入れようとする額から信託報酬を引いた額
運用会社 基準価額 (1万口あたり) 差し引いた純資産をnavForに渡して返る額
運用会社 「解約の代金を入れる」の解約価額 約定日の基準価額から出した解約価額
投資家 「約定した注文」の解約価額 運用会社のページと同じく、約定日の基準価額から出した解約価額
投資家 今日の約定日の解約の合計 redeemedOnが返す今の注文が入る約定日の解約の合計と、REDEEM_LIMITの上限

次の値は、3月5日の木曜に投資家Aが1,000,000円を申し込み、基準価額10,000円で100万口を受け取った後の金曜の値です。
3月5日は最初に純資産を入れる約定日なので、信託報酬は差し引きません。

値 計算 結果
信託報酬 1,002,000 × 1.00% × 1 / 365 = 27.45… 27円
差し引いた純資産 1,002,000 − 27 1,001,973円
基準価額 1,001,973 ÷ 100万口 × 1万口 = 10,019.73… 10,019円
解約価額 10,019 × (1 − 0.3%) = 9,988.94… 9,988円
300,000口の解約の代金 300,000口 × 9,988円 ÷ 1万口 299,640円

運用会社のページは、欄に入れた額から次の順に値を読みます。

純資産を入れる前に信託報酬と基準価額を読む
画面に出る値信託報酬27円差し引いた純資産1,001,973円基準価額10,019円運用会社のページManagerViewファンドのコントラクトTokenizedFund11223344trustFeeFor(3/6, 1,002,000)trustFeeFor(3/6, 1,002,000)27円27円navFor(1,001,973)navFor(1,001,973)10,019円10,019円setNav(3/6, 1,002,000)1,002,000 − 271,002,000 − 27

「今日の約定日」は、今の時刻に注文すると入る約定日です。
15時を過ぎると次の営業日の約定日に変わるので、合計もその日の分を0口から数えます。
上限は約定日ごとに100万口なので、金曜の15時を過ぎた後は月曜の約定日の分として100万口まで注文できます。

実装

解約価額を画面で出す

starter/app/src/lib/price.tsを新しく作ります。

// 解約価額を、ファンドのコントラクトの redemptionPrice と同じ決まりで出す

// 信託財産留保額の率 (1万分率。30で0.3%)。コントラクトの RETENTION_BPS と同じ値
export const RETENTION_BPS = 30n;

// 1万口あたりの基準価額から信託財産留保額0.3%を引き、1円未満を切り捨てた解約価額
export function redemptionPrice(nav: bigint): bigint {
  return (nav * (10_000n - RETENTION_BPS)) / 10_000n;
}
コード 意味
RETENTION_BPS = 30n コントラクトのRETENTION_BPSと同じ0.3%を、bigintの1万分率で持つ
10_000n - RETENTION_BPS 9,970を表し、基準価額の99.7%を残す
/ 10_000n 掛けてから最後に1回だけ割る。
bigintの割り算は小数を捨てるので、1円未満を切り捨てる

コントラクトのredemptionPriceはpureなので、チェーンを読まずに渡した基準価額だけから計算します。
画面に同じ式を置くと、約定日の行ごとにチェーンを読み直さずに解約価額を出せます。
基準価額が10,019円なら、99,889,430を1万で割った9,988円になります。

信託報酬と解約の上限を読む

starter/app/src/components/use-fund.tsで、最初にまとめて読む値の末尾に3つを足します。

      orderDays: { ...fund, functionName: "orderDays" },
      dayCursor: { ...fund, functionName: "dayCursor" },
      trustFeeBps: { ...fund, functionName: "TRUST_FEE_BPS" },
      trustFeeTotal: { ...fund, functionName: "trustFeeTotal" },
      redeemLimit: { ...fund, functionName: "REDEEM_LIMIT" },
    },
    enabled,
  );

今の注文が入る約定日の値を読む所には、その日に注文した解約の口数を足します。

  // 今の注文が入る約定日の受渡日と、その日に注文した解約の口数を読む
  const trade = useNamedReads(
    {
      delivery: { ...fund, functionName: "deliveryAt", args: [tradeDay ?? 0n] },
      redeemed: { ...fund, functionName: "redeemedOn", args: [tradeDay ?? 0n, me] },
    },
    enabled && tradeDay !== undefined,
  );

返す値の末尾に、読んだ4つを足します。

    tradeDelivery: trade.delivery as bigint | undefined,
    trustFeeBps: base.trustFeeBps as bigint | undefined,
    trustFeeTotal: base.trustFeeTotal as bigint | undefined,
    redeemLimit: base.redeemLimit as bigint | undefined,
    redeemedToday: trade.redeemed as bigint | undefined,
  };
}
コード 意味
TRUST_FEE_BPS 信託報酬の年率。
1万分率で100なので年1.00%
trustFeeTotal 運用会社の受け取った信託報酬の累計
REDEEM_LIMIT 1人の投資家が1つの約定日に解約できる口数の上限。
100万口
redeemedOn tradeDayの約定日に、選んだアカウントが注文した解約の口数の合計。
取り消した分は含まない
redeemedToday 「解約する」の欄に出す、今日の約定日の解約の合計

tradeDayは今の時刻の注文が入る約定日なので、15時を過ぎると次の営業日に変わります。
そのためredeemedOnも、15時を過ぎると次の営業日の合計を読みます。

純資産を入れる前に信託報酬を出す

starter/app/src/components/manager-view.tsxで、formatPercentとredemptionPriceを読み込みます。
formatPercentは雛形のlib/format.tsに最初からあり、1万分率を1.00%の形にします。

import { formatCount, formatDay, formatDayAt, formatMonthDay, formatPercent, formatTime, formatUnitsCount, formatWholeYen, parseAmount, parseCount, shortAddress, YEN } from "@/lib/format";
import { redemptionPrice } from "@/lib/price";

「純資産を入れる」の枠の説明に、信託報酬を差し引くことを書き足します。

const navNote = "運用会社の役を持つアカウントが、締め切りの後に約定日の純資産の総額を入れます。信託報酬を差し引いてから口数で割り、1万口あたりの基準価額を出します。";

前のレッスンまでは、入れようとする額をそのままnavForに渡して基準価額を出していました。
その前にtrustFeeForで信託報酬を読み、差し引いた額をnavForに渡すように書き換えます。

  // 入れる純資産から前の約定日からの日数分の信託報酬を差し引き、残りを口数で割った基準価額をコントラクトの navFor で出す
  const fee = useReadContract({
    address: contracts.fund,
    abi: tokenizedFundAbi,
    functionName: "trustFeeFor",
    args: [navDay ?? 0n, netValue ?? 0n],
    chainId,
    query: { enabled: netValue !== undefined && navDay !== undefined && !entered },
  });
  const feeValue = netValue !== undefined && !entered ? fee.data : undefined;
  const netAfterFee = netValue !== undefined && feeValue !== undefined ? netValue - feeValue : undefined;
  const preview = useReadContract({
    address: contracts.fund,
    abi: tokenizedFundAbi,
    functionName: "navFor",
    args: [netAfterFee ?? 0n],
    chainId,
    query: { enabled: netAfterFee !== undefined },
  });
  const previewNav = netAfterFee !== undefined ? preview.data : undefined;
  const feeDays = navDay !== undefined && navDay > lastNavDay ? navDay - lastNavDay : 0n;
  const feeLabel =
    lastNavDay > 0n ? `信託報酬 (${formatMonthDay(lastNavDay)}から${feeDays}日 年${formatPercent(state.trustFeeBps)})` : "信託報酬 (最初の約定日は差し引かない)";
コード 意味
trustFeeForとargs: [navDay ?? 0n, netValue ?? 0n] 入れようとする約定日と額を渡し、setNavが差し引くのと同じ信託報酬を読む
!entered その約定日の純資産をもう入れた時は読まない。
入れた後のtrustFeeForは前の約定日がその日になり、0円を返すため
netAfterFee 入れようとする額から信託報酬を引いた額。
信託報酬を読めるまではundefinedにする
navForとargs: [netAfterFee ?? 0n] 差し引いた額を渡して基準価額を読む。
setNavも差し引いた額でnavForを呼ぶ
enabled: netAfterFee !== undefined 信託報酬を読み終えてから基準価額を読む
feeDays 前に純資産を入れた約定日から、入れようとする約定日までの日数。
土日を挟むと3日になる
feeLabel 信託報酬の行の名前。
前の約定日と日数と年率を添え、最初の約定日は差し引かないことを書く

setNavに渡す額は書き換えません。
入れた額から信託報酬を差し引くのはコントラクトなので、画面は信託報酬を引く前の額を渡します。

ページの上の欄には、信託報酬の年率と受け取った信託報酬の累計を足します。

          <li>
            <span>信託報酬</span>
            <span className="mono">年{formatPercent(state.trustFeeBps)}</span>
          </li>
          <li>
            <span>受け取った信託報酬の累計</span>
            <span className="mono">{formatWholeYen(state.trustFeeTotal)}</span>
          </li>

「純資産を入れる」の枠の値の並びには、基準価額の前に信託報酬と差し引いた純資産を足します。

          <dl className="facts">
            <div>
              <dt>{feeLabel}</dt>
              <dd>{formatWholeYen(feeValue)}</dd>
            </div>
            <div>
              <dt>差し引いた純資産</dt>
              <dd>{formatWholeYen(netAfterFee)}</dd>
            </div>
            <div>
              <dt>基準価額 (1万口あたり)</dt>
              <dd>{formatWholeYen(previewNav)}</dd>
            </div>
          </dl>

「解約の代金を入れる」の表は、基準価額の列を解約価額の列に書き換えます。
代金の列のproceedsDueは、コントラクトが解約価額で決めた代金の合計です。

                <th className="num">解約の口数</th>
                <th className="num">解約価額</th>
                <th className="num">代金</th>
                  <td className="num">{formatUnitsCount(units)}</td>
                  <td className="num">{formatWholeYen(redemptionPrice(day.nav))}</td>
                  <td className="num">{formatWholeYen(day.proceedsDue)}</td>

投資家のページに解約価額と上限の残りを出す

starter/app/src/components/investor-view.tsxでも、redemptionPriceを読み込みます。

import { redemptionPrice } from "@/lib/price";

「解約する」と「約定した注文」の枠の説明を、解約価額で代金が決まる文に書き換えます。

const redeemNote = "持分の口数で解約します。代金は約定日の解約価額で決まり、3営業日後の受渡日から受け取れます。";
const settledNote = "基準価額は1万口あたりの額です。解約価額は、基準価額から信託財産留保額0.3%を引いて1円未満を切り捨てた額です。";

「解約の代金を受け取る」の枠は、代金の式にclaimPriceを出します。
前のレッスンまではclaimDay?.navで基準価額を出していましたが、コントラクトは解約価額で代金を決めています。
基準価額のままでは、式の口数と値段を掛けた額が代金と合いません。

  const claimYen = claimOrders.reduce((sum, order) => sum + order.yen, 0n);
  const claimPrice = claimDay ? redemptionPrice(claimDay.nav) : undefined;

「解約する」の枠の値の並びには、受渡日の前に今日の約定日の解約の合計と上限を足します。

          <dl className="facts">
            <div>
              <dt>今日の約定日の解約の合計</dt>
              <dd>
                {formatUnitsCount(state.redeemedToday)} / {formatUnitsCount(state.redeemLimit)}
              </dd>
            </div>
            <div>
              <dt>受渡日</dt>
              <dd>{formatDayAt(state.tradeDelivery)}</dd>
            </div>
          </dl>

「約定した注文」の枠では、基準価額の次に解約価額を並べます。

              <div>
                <dt>基準価額</dt>
                <dd>{formatWholeYen(settledDay.nav)}</dd>
              </div>
              <div>
                <dt>解約価額</dt>
                <dd>{formatWholeYen(redemptionPrice(settledDay.nav))}</dd>
              </div>
コード 意味
redemptionPrice(claimDay.nav) 受け取る代金の約定日の解約価額。
代金の式の「口数 × 解約価額 ÷ 1万口」に出す
state.redeemedToday redeemedOnから読んだ、今日の約定日にこのアカウントが注文した解約の合計
state.redeemLimit REDEEM_LIMITから読んだ上限の100万口
redemptionPrice(settledDay.nav) 約定した注文の約定日の解約価額。
基準価額と並べて、0.3%の差を見られる

上限を超えた時の文を足す

最後に、starter/app/src/lib/format.tsのreasonsに、上限を超えた解約を断られた時の文を足します。

  NothingToClaim: "この約定日に受け取る代金はありません",
  OverRedeemLimit: "同じ約定日の解約の合計が100万口を超えます",
};

画面は取引を送る前にsimulateContractで試すので、コントラクトがOverRedeemLimitで断ると、この文が出ます。
コントラクトは口数を預かる前に上限を確かめるので、持っている口数が足りない時も、合計が上限を超えればこの文になります。

確かめる

starter/appのディレクトリでpnpm devを実行し直し、ブラウザでページを開きます。

初めに、3月5日の木曜の注文を約定して、投資家Aに100万口を持たせます。
右上で「投資家A」を選び、「申し込む額」に1000000を入れて「申し込む」を押します。
帯の「締め切りの後へ進める」を押してから上の「運用会社」のページへ移り、右上で「運用会社」を選びます。
最初の約定日なので、「純資産を入れる」の信託報酬の行は「信託報酬 (最初の約定日は差し引かない)」と出ます。

まだ口数がないので、純資産の総額に0を入れて「入れる」を押し、続けて「約定する」を押します。
投資家Aは基準価額10,000円で、1,000,000円分の100万口を受け取ります。
帯の「次の営業日へ進める」を押すと、チェーンの日付が3月6日の金曜の9時になります。

投資家のページで「投資家A」を選び、「解約する口数」に300000を入れて「解約する」を押します。
「今日の約定日の解約の合計」は「300,000口 / 1,000,000口」になります。
帯の「締め切りの後へ進める」を押し、運用会社のページで「運用会社」を選んで、純資産の総額に1002000を入れます。
信託報酬の行は「信託報酬 (3/5から1日 年1.00%)」になり、27円と出ます。

差し引いた純資産は1,001,973円で、基準価額は10,019円です。
まだ入れていないので、上の欄の「受け取った信託報酬の累計」は0円のままです。

運用会社のページで3/6の純資産1,002,000円を入れる前に、信託報酬27円と差し引いた純資産1,001,973円と基準価額10,019円が出たところ
運用会社のページで3/6の純資産1,002,000円を入れる前に、信託報酬27円と差し引いた純資産1,001,973円と基準価額10,019円が出たところ

「入れる」を押すと、上の欄の「受け取った信託報酬の累計」が27円になります。
続けて「約定する」を押すと、「解約の代金を入れる」の表に3月6日の行が出て、解約価額の列に9,988円が並びます。
投資家のページで「投資家A」を選ぶと、「約定した注文 2026-03-06 (金)」の枠に基準価額10,019円と解約価額9,988円が並びます。
「解約の代金を受け取る」の代金は「300,000口 × 9,988円 ÷ 1万口」の式で、299,640円と出ます。

締め切りの後なので、「今日の約定日の解約の合計」は3月9日の月曜の分になり、0口に戻っています。
「解約する口数」に200000を入れて「解約する」を押すと、注文は月曜の約定日に入ります。
合計は「200,000口 / 1,000,000口」になり、注文の表の行には「15時を過ぎたため次の営業日」と出ます。

投資家Aの3/6の解約が解約価額9,988円で約定して代金299,640円が決まり、次の約定日の3/9に200,000口を解約したところ
投資家Aの3/6の解約が解約価額9,988円で約定して代金299,640円が決まり、次の約定日の3/9に200,000口を解約したところ

合計が100万口を超える口数を入れて「解約する」を押すと、「同じ約定日の解約の合計が100万口を超えます」と出て、注文は入りません。
次のレッスンで、ファンドのコントラクトをテストネットのFujiへデプロイします。