開発者向け：Notional V3 移行ガイド
Notional Finance | Jeff Wu
Notionalの各コンテンツはこちらからフォローできます。
Notional V3は、現在のNotional V2プロキシコントラクトのインプレースアップグレードとして機能する予定です。ほとんどのユーザーやスマートコントラクトでは、何もする必要はありません。
しかし、以下に概説する注意点がいくつかあります。質問がある場合は、Discordでチームに連絡してください。コードはこちらでご覧になれますし、仕様書もお読みいただけます。
アップグレードは2023年6月下旬に予定されており、2023年6月21日の次の四半期ロール後に行われる可能性があります。
アカウントの移行
Notional上のすべてのアカウントは、移行前と移行後の残高を維持します。Notionalで保有する資産は、自動的に「Prime Cash」の等価値に変換されます。fCashとnTokenの残高もシームレスに移行します。
満期を迎えたfCashポジション（貸出/借入）を持つアカウントは、アップグレード前にポジションを決済し、現金に変換されます。決済中に満期を迎えた貸出ポジションを持つアカウントにはペナルティはありません。満期を迎えた借入ポジションを持つアカウントは、既に決済されています。
注意：10ドル以下の価値を持つ微量（ダスト）貸出ポジションを持つアカウントがいくつか存在します。各アカウントは、メインネットのガス代を考えた場合に経済的に実行不可能であるため、決済されることはありません。ダストの残高があり、引き出しを希望するアカウントは、アップグレード前に引き出す必要があります。
スマートコントラクトの統合
Notional V3は、スマートコントラクトの統合のための既存のABIに変更を加えるものではありません。大半のスマートコントラクト統合は、主に基礎となるトークンを扱っているため、混乱はほとんどないはずですが、注意すべきいくつかの重要な変更点があります：
- dDepositAssetTokenとBatchActionメソッドによるアセットトークンのデポジットは、引き続きcTokenでサポートされますが、すぐに原資に償還されます。これらのメソッドを使用し続けることは推奨されませんが、後方互換性のために存在します。この修正で導入された変更によって、実際のcTokensは、非金利のラップトークンであることに注意してください。
- batchAction と withdraw メソッドの redeemToUnderlying は、非ETHトークンに対して true に設定する必要があります。Notional v3はCompound V2との依存関係を完全に解消し、アカウントは撤退時にcTokensを受け取ることができなくなります。
- ETHに対してredeemToUnderlyingがfalseに設定されている場合、アカウントはcETHの代わりにWETHを受け取ることになります。
- calculateNTokensToMintは、「アセットトークン」ではなく「ベーストークン」での金額を受け取るようになりました。Notionalは新たに上場した通貨の「アセットトークン」を受け付けなくなったため、このビュー関数のレガシー機能をサポートし続けることは意味を成しません。
- ビューメソッドgetCurrency、getCurrencyAndRates、getRateStorage、getCashGroupAndAssetRateは、引き続き「アセットトークン」「アセットレート」値を返します。
- アセットトークンは、アップグレード前の通貨については、非推奨のアセットトークンとして返されます（存在する場合）。v3アップグレード後の通貨は、アセットトークンがaddress(0)となります。今後、統合するコントラクトは、ベーストークンのみに依存することが推奨されます。
- アセットレートは、現在のプライムキャッシュ評価と一致する修正されたアセットレートを返すので、キャッシュ評価を得るためにアセットレートに依存しているコントラクトは、引き続き動作します。ただし、これは新規上場トークンには対応しません。統合するコントラクトは、代わりにconvertCashBalanceToExternalを使用するように移行することが推奨されます。
- 清算人は、清算中に「アセットトークン」を預けることができなくなり、代わりにベーストークンを預ける必要があります。これによって、ガス代が削減されます。
- レバレッジドボールトの清算人は、deleverageVaultAccountと関連するビュー関数にABIの変更を見ることになります。リクイデーターは、Notional V3コントラクト全体の変更を確認して、それに応じてコードを更新する必要があります。
ラッピングfCash
mintViaAssetとredeemViaAssetはWrapped fCashでは非推奨となり、呼び出されると元に戻るようになります。これはERC4626のどのメソッドにも影響せず、mintViaUnderlyingにも影響しません。
オフチェーンデータ
Notional V3 は、Notional V3 で発行される特注のイベントセットから、より標準的な ERC20 Transfer および ERC1155 TransferSingle と TransferBatch イベントに移行して、オフチェーンの残高変化をトラッキングします。これによって、Notional V3 はサードパーティの分析ツールと適切に統合され、Notional V3 アセットの可視性が大幅に向上します。
その結果、既存のNotional Finance V2 サブグラフは、Notional V3 への移行後、更新されなくなります。新しいNotional V3サブグラフを立ち上げ、イベントスキーマとサブグラフスキーマの変更について、次のブログ記事で説明します。
ソフトウェアライセンス
Notional V3は、ビジネスソースライセンス（BSL-1.1）でリリースされ、変更日は2027年3月27日（発行から4年）となっています。Notional V2は、GPL-v3ライセンスでリリースされました。Notional V3の構築に費やされた多大な労力を考えると、プロトコルの長期的な成功を保証するための正しい方向性だと考えています。
