FlashBank

FlashBank

資金は実際に使われる瞬間までご自身のウォレットに留まります。ノンカストディアルなオンチェーンレンディングです。 FlashBank はこの原則を共有する、相互に補完する 2 つのプロダクトです。

プロダクト	概要	コントラクト	ページ
Flash Loans	アービトラージ、清算、MEV 向けのアトミックな同一トランザクション内流動性です。貸し手は自身のウォレットから WETH を承認してコミットします。預け入れは不要で、ローンごとに手数料を得られます。	flashloans/ · FlashBankRouter.sol	/
P2P Term Loans	2 人の間で直接合意する、担保付きの固定期間ローンです。利息の代わりに一律の手数料を設定し、期限のみを基準に決済されます。プールも価格オラクルもなく、清算を監視する必要もありません。	loans/ · FlashBankP2PLoan.sol	/p2p

ブランド表記のルール：「flashbank」は常に動詞としてのみ使用します（ローンを flashbank する）。FlashBank は銀行ではなく、預金を預からず、金融機関として資産を保管することもありません。

ウェブサイト：flashbank.net · ソース：github.com/Rotwang9000/flashbank-net

---

Flash Loans（ルーター）

FlashBankRouter は、流動性プロバイダーが資産の保管権を保持する、複数プロバイダー対応のフラッシュローンプールです。

• 預け入れ不要。 プロバイダーはルーターを承認し、setCommitment(token, limit, expiry, paused) を呼び出します。WETH はウォレットに留まり、フラッシュローンの数マイクロ秒間だけ引き出されます。
• アトミックに実行。さもなければ失敗。 借り手は IL2FlashLoan を実装し、同じトランザクション内で principal + fee を返済する必要があります。そうでなければ、処理全体が取り消されます。
• 設定可能で上限付きの手数料。 トークンごとの feeBps（1～100 bps）に加え、個別に設定するオーナー取り分（ownerFeeBps）と、プールに対するトランザクションごとの最大借入割合（maxBorrowBps）を設定できます。
• デュアルコントロール管理。 トークン設定、所有権、利益の引き出しといった重要な変更には、owner と別の admin による提案後に実行するフローを採用しています。docs/security/DUAL_CONTROL.md を参照してください。

プロバイダーのフロー（WETH）：

await weth.deposit({ value: ethers.parseEther("5") });        // wrap ETH (stays in your wallet)
await weth.approve(routerAddress, ethers.MaxUint256);         // approve once
await router.setCommitment(wethAddress, ethers.parseEther("3"), 0, false); // lend up to 3 WETH
// pause/resume any time — just flip the paused flag or drop the limit to 0

借り手のフロー（MEV／アービトラージボット）：

await router.flashLoan(
  wethAddress,
  ethers.parseEther("100"),
  true,            // receive native ETH (router unwraps WETH for you)
  strategyCalldata // forwarded to IL2FlashLoan.executeFlashLoan
);

flashloans/ にあります。cd flashloans && npx hardhat run scripts/deploy-router.js --network <network> でデプロイします （リポジトリルートの .env で ADMIN_ADDRESS／TESTNET_ADMIN_ADDRESS を設定してください）。ネットワークごとのアドレスは、ウェブサイトによって NEXT_PUBLIC_* 環境変数から読み込まれます。

P2P タームローン

FlashBankP2PLoan は、2 者間で固定期間・担保付きローンを flashbank するための中立的なエスクローです。

• 時間のみで決済します。 maturity + grace までに principal + a flat fee を返済するか、貸し手が担保を請求します。オンチェーンで価格を設定しないため、オラクルは不要です。
• 余剰分の返還は任意です（オラクル不要）。 オファーでは合意レート（settlementValue として保存される値。組成時点で、担保全体をいくらとみなすかを固定します）を設定できます。債務不履行時、借り手は principal + fee を超える担保を回収できます。担保の差し入れと没収のみを希望する場合は 0 にします。オラクルを使わずに Lorrow の余剰返還に関するガードレールを遵守できます。詳しくは docs/design/LORROW_COMPATIBILITY.md を参照してください。
• 編集可能なオファーで、フロントランニングを防止します。 オファーが公開中であれば、作成者は既存のブーストを失うことなく、オファーの価格を再設定したり、エスクロー以外の条件をその場で変更したり（updateOffer）、注目枠の掲載を追加購入したり（boostOffer）できます。編集のたびに version が更新されます。借り手は takeChecked(id, version) を呼び出して、確認した条件を正確に指定できます。
• 利息ではなく、定額手数料です。 時間の経過に応じて発生する利息ではなく、単一の固定手数料を採用しています。これは リバ（riba）を避ける信仰に基づく金融との親和性を高めます（シャリーア認証を主張するものではありません）。
• 任意で設定できる、初期状態では無効の手数料が 3 種類あります。
  • 任意で有効化するインターフェース手数料（貸し手が負担。flashbank 経由で掲載されたオファーにのみ適用されます。導入時は 0%）。
  • 支出額に応じてマーケットプレイスの注目枠に掲載される任意のブースト（利息ではなく広告であり、返金不可です）。
  • 任意のアドレスに支払う、オファーごとのサービス手数料（保険／第三者向け）。 コントラクトを直接利用すれば、手数料はゼロです。
• トークンは通常の ERC-20 です。 メインネット／L2 では、エスクローが実際の資産（WETH、USDC など）を使用します。テストネットのプレイグラウンドでは、fpETH／fpUSD は価値のない無料のフォーセットトークンです。

loans/ にあります。設計の全容は docs/design/P2P_LENDING_DESIGN.md を参照してください。

メインネットで稼働中（Ethereum + Base）

FlashBankP2PLoan はメインネットにデプロイされ、検証済みです。セルフ監査で堅牢と判断され、ETH のガス代が安い時期にリリースされました。各チェーンで同じバイトコードを使用します。Ownable、手数料の受取先は Vultisig vault、導入時の手数料は 0 bps（掲載手数料は listed を通じて任意で有効化されたオファーにのみ適用され、オンチェーンで上限 1% に制限されています）。 外部監査はありません。実資産の利用は自己責任です。

チェーン	FlashBankP2PLoan（検証済み）
Ethereum	0x131C…18A0
Base	0x86Fb…FcbB

メインネット UI では、実際の WETH／USDC を使用します。（Arbitrum は保留中です。デプロイヤーの残高がまだ少なく、デプロイできていません。後で MAX_FEE_GWEI を低く固定して追加します。）チェーンごとの記録は loans/deployments/*-p2p.json にあります。

現時点でメインネットのインターフェースは ETH と USDC に制限されています。カスタムトークンの入力はテストネットのみです。そのため、フロントエンドが未知のトークンや偽トークンを案内することはありません（コントラクト自体は、直接呼び出すユーザーには引き続きパーミッションレスです）。

v2 — Sepolia のプレイグラウンドで稼働中です。 FlashBankP2PLoanV2 では、オンチェーンのトークン妥当性検証、段階的なクーリングオフ・リベート（定額手数料は 10% の最低額から段階的に確定するため、即時に近い返済なら安価になります。偽トークンによる手数料稼ぎを防ぎつつ、掲載枠の利用は無料にならず、同一ブロック内のガードでフラッシュローンを無料にすることも防ぎます）、および引き出し方式の支払いフォールバックを追加しました。これにより、ブロックリストに登録された受取人が、相手側の返済や債務不履行時の請求を決して妨げられないようにします。敵対的レビューとユニットテスト（22 ケース）を完了し、Sepolia にデプロイ済み（検証済み、初期資金投入済み）です。そこで 2 エージェントによるライフサイクルのライブ検証にも合格しています。メインネットでは、v2 が成熟するまでは v1 を使用します。落とし穴の詳細な分析は docs/design/P2P_V2_COOLING_OFF.md を参照してください。

Sepolia で利用可能（プレイグラウンド — テストネット専用、実際の価値はありません）

誰でも一連の流れを最初から最後まで試せるよう、セルフサービス型のプレイグラウンドを Sepolia にデプロイしています。ここでは v2 エスクローが稼働しているため、クーリングオフ時のリベートとプル型払い出しをいち早く利用できます。ソースコードはすべて Etherscan で検証済みです。キー情報のみ、追跡対象外の .env に保存されています。未監査のデモです。実際の資産は絶対に送らないでください。

コントラクト	アドレス（検証済み）
FlashBankP2PLoanV2（クーリングオフ時のリベート＋トークンチェック＋プル型払い出し）	0x536f…1E76
PlaygroundToken fpUSD（6 桁）	0x4aBb…760c
PlaygroundToken fpETH（18 桁）	0xB9CC…96F5

試してみるには、/p2p を開き（デフォルトでは Ethereum メインネットが選択されています）、Sepolia に切り替えて、フォーセットからテストトークンを発行します。その後、オファーを出すか引き受けてください（ランキングを確認できるブースト付きのものや、作成者が設定した 2 日間のクーリング期間があるものなど、いくつかのオファーが事前に登録されています）。再デプロイする場合は、cd loans && npx hardhat run scripts/deploy-playground-v2.js --network sepolia を実行します（アドレスは loans/deployments/sepolia-playground-v2.json に記録されています。旧 v1 プレイグラウンド 0x3Ce4…1017 は引き続きオンチェーンに残ります）。

---

AI エージェント向け（MCP）

npx -y @flashbank/mcp     # zero-config read-only MCP server, any MCP client

このリポジトリには、自己完結型の Model Context Protocol サーバー（mcp/、@flashbank/mcp として公開され、公式 MCP Registry および Glama に掲載されています）が含まれており、エージェントも FlashBank を利用できます。公開中の P2P オファーの閲覧、見積もりの取得、フラッシュローンの流動性と手数料の確認に加え、使い捨てキーを明示的に設定すれば、ローンの出し手・引き受け・返済や Sepolia フォーセットの利用も可能です。読み取りには設定は不要です。メインネットへの書き込みは、FLASHBANK_MCP_PRIVATE_KEY と FLASHBANK_MCP_ALLOW_MAINNET=true の両方を設定しないと実行できません。引き受け時には、確認済みの正確な条件が常にオンチェーンに固定されます。また、v2 対応チェーンでは、権利確定済みの手数料を見積もり、クーリングオフ時のリベートを報告します。一連のライフサイクルは、Sepolia 上で実際の MCP サーバーを 2 つ起動して、フォーセット → 作成 → 引き受け → 早期返済（リベートを検証）→ キャンセルの順に実行する 2 エージェント間のライブドリル（npm run drill）で検証済みです。詳細とツール一覧については、mcp/README.md を参照してください。

---

リポジトリの構成

各機能は自己完結型の Hardhat プロジェクトです。一方の Solidity コードをもう一方からインポートすることはないため、このリポジトリをフォークして不要な機能を削除しても、もう一方は引き続きコンパイル、テスト、デプロイできます。

flashloans/           Flash-loan router feature — own contracts/, test/, scripts/, test-scripts/, hardhat.config.js
loans/                P2P term-loan feature — own contracts/, test/, scripts/, deployments/, hardhat.config.js
common/               Shared toolchain (hardhat.base.js) inherited by both features — do not delete
website/              Next.js front end (static export, deployed to flashbank.net) — showcases both features
mcp/                  Model Context Protocol server so AI agents can browse/quote/transact (see mcp/README.md)
docs/                 Documentation (see docs/README.md) — architecture, security, deployment, design
package.json          Thin root: installs the shared dependencies and runs both features' scripts

一方の機能だけを使いたい場合は、 もう一方のトップレベルディレクトリを削除してください。

rm -rf flashloans   # keep just the P2P term loans
# ...or...
rm -rf loans        # keep just the flash-loan router

common/ は両方で共有しているため、残しておく必要があります。website/ は両方をまとめたサイトです。機能を削除する場合は、対応するページ（フラッシュローンの場合は website/src/pages/index.tsx、P2P の場合は website/src/pages/p2p.tsx）と、website/src/components/Nav.tsx にあるリンクも削除してください。

以前のデポジット型設計 FlashBankRevolutionary は、デポジット不要の Router より前のものです。そのコントラクトとメモは、歴史的な参考情報として flashloans/ にあります。現在の製品は Router と P2P エスクローです。

---

クイックスタート

npm install            # installs the shared toolchain both features build against
npm run compile        # compile both features
npm test               # run both features' test suites

# work inside a single feature
cd flashloans && npx hardhat test
cd loans && npx hardhat test

# website
npm run website:dev    # local dev server on http://localhost:3000
npm run website:build  # static export

依存関係はリポジトリのルートで一度だけインストールします。各機能はそこから Hardhat、プラグイン、OpenZeppelin を参照するため、機能ごとの npm install は不要です。

テスト

Solidity のテストスイートでは、ルーター（フラッシュローンのフロー、オーナー手数料の発生、デュアルコントロール、検証）と P2P エスクロー（ライフサイクル、時間ベースのデフォルト、3 段階の手数料モデルとブースト、リエントランシー、 ランダム化された資金保全のファズテスト）をカバーしています。

npm test                            # both features
npm run test:flashloans             # router suite only
npm run test:loans                  # P2P suite only

---

ドキュメント

全ドキュメントは docs/ をご覧ください。

• アーキテクチャ — 概要、プールの仕組み、ガス分析
• P2P 設計 — P2P_LENDING_DESIGN.md、Lorrow との互換性
• セキュリティ — 公開中の正直な監査ページ（両機能について、信頼の前提、テスト内容、既知の制限を率直に記載）、およびルーターの監査メモ、リエントランシー分析、デュアルコントロールの運用手順書
• デプロイ — ガイド、ウェブサイト、稼働中のネットワーク

脆弱性の報告：SECURITY.md · 貢献：CONTRIBUTING.md · 変更履歴：CHANGELOG.md

---

免責事項

実験段階で、監査を受けていない DeFi ソフトウェアです。スマートコントラクトにはバグがある可能性があります。ローン期間中に担保価値が変動する可能性があり、フラッシュローンの収益性は市場機会によって異なります。ご自身の責任で使用し、ご自身で調査してください。

ライセンス

MIT。