SenditBank

Das Modell

• Konten. Ein Konto ist eine Wallet-Adresse (oder ein beliebiger Contract, der als sein eigenes Konto handelt). Guthaben sind balanceOf[account][asset], nie nach einem Schlüssel indiziert.
• Assets. pUSD, ETH als address(0) und Tokens eines Launchers, den der Betreiber hinzugefügt hat (isAsset). Jeder andere Token wird abgelehnt. totalHeld[asset] ist die exakte Summe aller Guthaben und nie mehr, als die Bank hält.
• Schlüssel. Adressen, die ein Konto mit einem vom Schlüssel signierten Nachweis registriert hat. Ein Schlüssel gibt das Guthaben des Kontos bei Venues aus, sendet, hebt an die eigene Wallet des Kontos ab, tankt sich selbst auf und widerruft. Er kann keine Schlüssel registrieren, keine Limits ändern und nicht per withdrawTo an eine andere Adresse abheben.
• Venues. Die Contracts, die Konten belasten dürfen: die Engine, das Orderbuch, der Vault, die Copy-Factory, der Spot-Router, die pUSD-Exchange. Jeder ruft bank.pull(msg.sender, asset, amount) mit seinem eigenen Aufrufer auf, sodass ein Venue nicht bestimmen kann, wessen Geld er nimmt. Jede Auszahlung kommt mit bank.push(account, ...) zurück, nie an den Signierenden.

Es gibt kein receive(), keinen Sweep, keine Guthabenbearbeitung, kein Upgrade und keine Gebühr. ETH kommt nur über deposit und push hinein.

Konten und accountOf

accountOf(sender) ist das Konto, für das ein Absender handelt: der Inhaber, solange sender ein Schlüssel ist, der unter der aktuellen keyEpoch des Kontos und der aktuellen globalEpoch registriert ist, und sonst sender selbst. Eine Wallet löst sich also auf sich selbst auf, und jeder Venue funktioniert auch per Wallet signiert. Positionen, Vault-Anteile, Copy-Konten und jedes Event nennen das Konto, nie den Schlüssel.

Ein Schlüssel ist veraltet, wenn accountOf(keyOf(account)) != account. Ein playerOf gibt es hier nicht: So heißt dieselbe Idee in der Arcade-Bank.

Der Schlüsselnachweis

Der Schlüssel willigt ein, dem Konto zu dienen, indem er einen Digest signiert:

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

Der Nachweis ist die EIP-191-Signatur des Schlüssels über diese 32 Bytes ("\x19Ethereum Signed Message:\n32" || digest): 65 Bytes, niedriges s, v 27 oder 28 (0 und 1 werden akzeptiert). Die Wallet sendet ihn dann mit setKey(key, proof) oder innerhalb von deposit(pusdAmount, gasToKey, key, proof), das in derselben Transaktion auch das Gas des Schlüssels finanzieren kann.

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 } });

Epochen: hinzufügen oder ersetzen

Ein Nachweis wird gegen eines von zwei Epochenpaaren geprüft, und welches es ist, entscheidet, was passiert:

• Aktuelle Epochen: ADD. Der Schlüssel kommt zu den aktiven Schlüsseln des Kontos hinzu; jeder andere Schlüssel bleibt aktiv (ein Schlüssel pro Gerät).
• keyEpoch + 1: REPLACE. Die Bank widerruft zuerst (die Epoche rückt vor, jeder Schlüssel endet, KeyRevoked) und registriert dann den Schlüssel unter der neuen Epoche.

revokeKey() beendet jeden Schlüssel des Kontos; rotateKey(newKey, proof) widerruft und registriert in einer Transaktion, mit einem Nachweis unter der neuen Epoche. invalidateAllKeys() verschiebt globalEpoch und beendet jeden Schlüssel der Bank. keyOf(account) ist nur der zuletzt registrierte Schlüssel, an den das Gas der Einzahlung geht.

Limits

Die pUSD- und ETH-Abflüsse eines Schlüssels an Dritte (send, refuel und Pulls durch einen begrenzten Venue, derzeit der Spot-Router) zählen gegen tägliche Limits pro Konto, über ein festes 24-Stunden-Fenster ab dem ersten angerechneten Abfluss. Perps, der Vault und Copy sind unbegrenzt, gestartete Tokens ebenso, und per Wallet signierte Aufrufe werden nie angerechnet. Die Standardwerte des Contracts sind 10.000 pUSD und 5 ETH pro Tag; das Testnet-Deployment hat sie ausgeschaltet (UNCAPPED, siehe defaultCaps()). Ein Konto setzt seine eigenen mit setKeyCaps von seiner Wallet aus: 0 bedeutet den Standardwert.

Pause

setPaused(true) stoppt pull und move der Venues sowie per Schlüssel signiertes send und refuel. Es stoppt nie withdraw, withdrawTo, push (Positionen schließen also weiterhin und Auszahlungen kommen an), Einzahlungen, Registrierung und Widerruf von Schlüsseln oder das eigene send einer Wallet oder eines Contracts (ein Copy-Konto zahlt seinen Kopierenden über send aus). Die pUSD-Exchange respektiert die Pause der Bank an beiden ihrer Türen.

Venues und die 24-Stunden-Frist

Ein Venue kann jedes Konto über den Absender belasten, den er übergibt; Venues sind daher die Vertrauensbasis der Bank. Einen hinzuzufügen heißt proposeVenue, dann activateVenue nach VENUE_DELAY (24 Stunden): Ein VenueProposed-Event gibt jedem Konto einen Tag, um vorher abzuheben. listVenueNow überspringt die Wartezeit nur vor der allerersten Gutschrift der Bank. removeVenue wirkt sofort, und ein entfernter Venue kann weiterhin push aufrufen.

Funktionen und Events