SenditBank

Модель

• Аккаунты. Аккаунт - это адрес кошелька (или любой контракт, действующий как собственный аккаунт). Балансы хранятся в balanceOf[account][asset] и никогда не привязаны к ключу.
• Активы. pUSD, ETH как address(0) и токены лаунчера, который добавил оператор (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: так та же идея называется в банке Arcade.

Доказательство ключа

Ключ соглашается обслуживать аккаунт, подписывая дайджест:

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

Доказательство - это подпись EIP-191 этих 32 байт ключом ("\x19Ethereum Signed Message:\n32" || digest): 65 байт, low 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 } });

Эпохи: добавить или заменить

Доказательство проверяется по одной из двух пар эпох, и от того, по какой, зависит результат:

• Текущие эпохи: ADD. Ключ присоединяется к действующим ключам аккаунта; все остальные ключи остаются действующими (один ключ на устройство).
• keyEpoch + 1: REPLACE. Банк сначала отзывает ключи (эпоха сдвигается, все ключи прекращают действие, KeyRevoked), затем регистрирует ключ под новой эпохой.

revokeKey() прекращает действие всех ключей аккаунта; rotateKey(newKey, proof) отзывает и регистрирует в одной транзакции, с доказательством под новой эпохой. invalidateAllKeys() сдвигает globalEpoch и прекращает действие всех ключей в банке. keyOf(account) - это лишь последний зарегистрированный ключ, тот, куда идёт газ депозита.

Лимиты

Исходящие потоки pUSD и ETH ключа третьим сторонам (send, refuel и списания площадкой с лимитом, которой сегодня является спот-роутер) учитываются в дневных лимитах аккаунта в фиксированном 24-часовом окне от первого учтённого исходящего потока. Бессрочные контракты, хранилище и копирование без лимитов, запущенные токены тоже, а вызовы с подписью кошелька никогда не учитываются. По умолчанию в контракте 10,000 pUSD и 5 ETH в день; при развёртывании в тестовой сети их отключили (UNCAPPED, читайте defaultCaps()). Аккаунт задаёт свои лимиты через setKeyCaps со своего кошелька: 0 означает значение по умолчанию.

Пауза

setPaused(true) останавливает pull и move площадок, а также подписанные ключом send и refuel. Она никогда не останавливает withdraw, withdrawTo, push (поэтому позиции по-прежнему закрываются и выплаты приходят), депозиты, регистрацию и отзыв ключей и собственный send кошелька или контракта (копи-счёт платит копирующему через send). Обменник pUSD соблюдает паузу банка для обоих своих входов.

Площадки и 24-часовая задержка

Площадка может списать с любого аккаунта через передаваемого ею отправителя, поэтому площадки являются корнем доверия банка. Добавление площадки - это proposeVenue, затем activateVenue после VENUE_DELAY (24 часа): событие VenueProposed даёт каждому аккаунту сутки, чтобы сначала вывести средства. listVenueNow пропускает ожидание только до самого первого зачисления в банк. removeVenue действует немедленно, и удалённая площадка по-прежнему может делать push.

Функции и события