SenditBank

モデル

• アカウント。アカウントはウォレットのアドレス（または自分自身のアカウントとして振る舞う任意のコントラクト）です。残高は balanceOf[account][asset] であり、キーで索引付けされることはありません。
• 資産。pUSD、address(0) としての ETH、そして運営者が追加したランチャーのトークン（isAsset）。それ以外のトークンは拒否されます。totalHeld[asset] はすべての残高の正確な合計であり、バンクが保有する額を超えることはありません。
• キー。アカウントが、そのキー自身が署名した証明とともに登録したアドレスです。キーはベニューでアカウントの残高を使い、送金し、アカウント自身のウォレットへ引き出し、自分のガスを補充し、無効化できます。キーの登録、上限の変更、別のアドレスへの withdrawTo はできません。
• ベニュー。アカウントから引き落とすことを許されたコントラクトです。エンジン、注文ブック、ボールト、コピーファクトリー、スポットルーター、pUSD エクスチェンジ。各ベニューは自分の呼び出し元を渡して bank.pull(msg.sender, asset, amount) を求めるので、ベニューが誰のお金を取るかを指定することはできません。すべての払い出しは bank.push(account, ...) で戻り、署名者に支払われることはありません。

receive() も、資金の一括回収も、残高の編集も、アップグレードも、手数料もありません。ETH が入ってくるのは deposit と push を通じてだけです。

アカウントと accountOf

accountOf(sender) は、送信者が代理で操作するアカウントです。sender がアカウントの現在の keyEpoch と現在の globalEpoch の下で登録されたキーであればそのオーナーを、そうでなければ sender 自身を返します。そのためウォレットは自分自身に解決され、すべてのベニューはウォレットの署名でも動きます。ポジション、ボールトの持ち分、コピーアカウント、そしてすべてのイベントが示すのはアカウントであり、キーではありません。

accountOf(keyOf(account)) != account のとき、キーは古くなっています。ここに playerOf はありません。それはアーケードのバンクで同じ考え方に付けられた名前です。

キーの証明

キーは、ダイジェストに署名することでアカウントに仕えることに同意します。

keyDigest(account, key) = keccak256(abi.encode(
  "SENDIT/key-proof/v1", block.chainid, address(bank), account, key,
  keyEpoch[account], globalEpoch))

証明は、その 32 バイトに対するキーの EIP-191 署名（"\x19Ethereum Signed Message:\n32" || digest）です。65 バイトで、s は小さい値、v は 27 または 28 です（0 と 1 も受け付けます）。ウォレットはそれを setKey(key, proof) で、または deposit(pusdAmount, gasToKey, key, proof) の中で送ります。後者は同じトランザクションでキーのガス代を入金することもできます。

import { encodeAbiParameters, parseAbiParameters, keccak256 } from "viem";
import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";

const key = privateKeyToAccount(generatePrivateKey()); // keep the private key safe

// ADD a key under the epochs in force: the bank computes the digest for you.
const digest = await client.readContract({
  address: bank, abi: bankAbi, functionName: "keyDigest", args: [account, key.address],
});
const proof = await key.signMessage({ message: { raw: digest } }); // EIP-191, 32 bytes

// REPLACE every key of the account: the same digest under keyEpoch + 1.
const [epoch, global] = await Promise.all([
  client.readContract({ address: bank, abi: bankAbi, functionName: "keyEpoch", args: [account] }),
  client.readContract({ address: bank, abi: bankAbi, functionName: "globalEpoch" }),
]);
const nextDigest = keccak256(encodeAbiParameters(
  parseAbiParameters("string, uint256, address, address, address, uint64, uint64"),
  ["SENDIT/key-proof/v1", 78270n, bank, account, key.address, epoch + 1n, global],
));
const replaceProof = await key.signMessage({ message: { raw: nextDigest } });

エポック：追加か置き換えか

証明は二つのエポックの組のどちらかに照らして検証され、どちらであるかによって何が起こるかが決まります。

• 現在のエポック：追加。キーはアカウントの有効なキーに加わり、ほかのキーもすべて有効なままです（デバイスごとに一つのキー）。
• keyEpoch + 1：置き換え。バンクはまず無効化し（エポックが進み、すべてのキーが終わり、KeyRevoked）、それから新しいエポックの下でキーを登録します。

revokeKey() はアカウントのすべてのキーを終わらせます。rotateKey(newKey, proof) は、新しいエポックの下での証明を使って、無効化と登録を一つのトランザクションで行います。invalidateAllKeys() は globalEpoch を進め、バンク上のすべてのキーを終わらせます。keyOf(account) は最後に登録されたキーにすぎず、入金のガスはそこに送られます。

上限

キーによる第三者への pUSD と ETH の流出（send、refuel、そして上限付きのベニューによる pull。現在それはスポットルーターです）は、アカウントごとの 1 日あたりの上限に対して数えられます。期間は、最初に計上された流出から始まる固定の 24 時間です。パーペチュアル、ボールト、コピーには上限がなく、ローンチされたトークンも同様で、ウォレットの署名による呼び出しが計上されることはありません。コントラクトの既定値は 1 日あたり 10,000 pUSD と 5 ETH ですが、テストネットのデプロイではオフにしています（UNCAPPED。defaultCaps() を読んでください）。アカウントは自分のウォレットから setKeyCaps で独自の上限を設定でき、0 は既定値を意味します。

一時停止

setPaused(true) は、ベニューの pull と move、そしてキーが署名する send と refuel を止めます。withdraw、withdrawTo、push（そのためポジションは引き続き決済され、払い出しも届きます）、入金、キーの登録と無効化、ウォレットやコントラクト自身の send（コピーアカウントは send を通じてコピーした人に支払います）は決して止めません。pUSD エクスチェンジは、その二つの入口の両方でバンクの一時停止に従います。

ベニューと 24 時間の遅延

ベニューは、自分が渡す送信者を通じて任意のアカウントから引き落とせるので、ベニューはバンクの信頼の根です。追加は proposeVenue を行い、VENUE_DELAY（24 時間）の後に activateVenue を行います。VenueProposed イベントにより、すべてのアカウントには先に引き出すための 1 日が与えられます。listVenueNow が待機を省けるのは、バンクの最初の入金より前だけです。removeVenue は即時で、削除されたベニューも push は引き続き行えます。

関数とイベント