Перейти к содержимому
Anon Wallet

Возможности кошелька

wallet_getCapabilities (EIP-5792, версия 2.0.0) сообщает сайту, что он может запросить в wallet_sendCalls в каждой сети. Anon сообщает о трёх возможностях: atomic, paymasterService и auxiliaryFunds. Сначала подключитесь; см. Интеграция DApp.

Запрос

const provider = window.anon;
const [account] = await provider.request({ method: "eth_requestAccounts" });
const capabilities = await provider.request({
  method: "wallet_getCapabilities",
  params: [account],
});
  • Расширение отвечает для подключения сайта. Оно не читает адрес и необязательный список ID сетей в params, поэтому ответ одинаков с ними и без них.
  • Оно никогда не открывает кошелёк.
  • Сайт, который не подключён, получает {}, а не ошибку.

Ответ

Объект, ключами которого служат ID сетей в hex. В нём по одной записи для каждой сети, которую может использовать сайт: сети, включённые в кошельке на момент подключения сайта, и каждая сеть, на которую сайт переключился после этого. У сети без дополнительных возможностей пустой объект. Записи 0x0 для всех сетей нет.

Для сайта, подключённого с публичным адресом кошелька, две из записей выглядят так:

{
  "0x1": {
    "atomic": { "status": "supported" },
    "auxiliaryFunds": { "supported": true },
    "paymasterService": { "supported": true }
  },
  "0xa": {}
}

Прежнее имя atomicBatch из EIP-5792 не сообщается.

По сетям

Сеть chainId atomic paymasterService и auxiliaryFunds
Ethereum 0x1 Да Да
Arbitrum 0xa4b1 Да Да
BNB Chain 0x38 Да Да
Polygon 0x89 Да Да
Base 0x2105 Да Да
Optimism, HyperEVM, Robinhood Chain, HyperEVM Testnet, Arbitrum Sepolia 0xa, 0x3e7, 0x1237, 0x3e6, 0x66eee Нет Нет

В Anon сеть принимает несколько вызовов в одном wallet_sendCalls ровно тогда, когда в её записи есть atomic с любым статусом. В сети без пеймастера сайт, подключённый со стелс-аккаунтом, не может отправить ни транзакцию, ни пакет (4200).

По аккаунтам

Одни и те же сети сообщают одни и те же возможности для любого аккаунта. От аккаунта, который подключил пользователь, зависит только статус atomic.

Аккаунт atomic.status Что принимает Anon
Публичный адрес кошелька "supported" Пакеты, которые выполняются по принципу «всё или ничего» или шаг за шагом, в зависимости от выбора пользователя в отношении комиссии
Стелс-аккаунт "unsupported" Пакеты из нескольких вызовов только без atomicRequired: true; с ним запрос завершается ошибкой 5760
Кошелёк на Ledger (публичный адрес) "supported" Пакеты, за которые аккаунт платит сам, по принципу «всё или ничего». Пеймастер не предлагается

Поскольку статус различается, сайт может в сети, которая сообщает atomic, определить, является ли подключённый аккаунт стелс-аккаунтом.

atomic

Возможность из EIP-5792 версии 2.0.0. "supported" означает, что пакет из нескольких вызовов может выполняться по принципу «всё или ничего»: если один вызов завершается ошибкой, ни один вызов не вступает в силу. Это верно, только когда аккаунт сам оплачивает свою сетевую комиссию. Когда платит пеймастер, вызовы выполняются шаг за шагом: вызов, завершившийся ошибкой, пропускается, а остальные всё равно вступают в силу. wallet_getCallsStatus сообщает в atomic, как выполнялся каждый пакет.

  • Сайт, которому нужно «всё или ничего», отправляет atomicRequired: true. См. Пакетные транзакции.
  • "unsupported" для стелс-аккаунта означает, что Anon не принимает atomicRequired: true для пакета из нескольких вызовов с него. Аккаунт по-прежнему может отправлять пакеты без этого поля.
  • Anon никогда не сообщает "ready": он не предлагает обновить аккаунт.

paymasterService

{ "supported": true } означает, что собственный пеймастер Anon может отправить пакет в этой сети и оплатить его газ. Пользователь возвращает пеймастеру оплату комиссией в токене, с аккаунта или из приватного баланса, и видит комиссию до подтверждения. См. Сетевые комиссии и пеймастер.

  • Сайт не может спонсировать газ. Anon не обращается к URL пеймастера, который присылает сайт (ERC-7677). Указание paymasterService в wallet_sendCalls лишь заставляет кошелёк проверить, что в этой сети есть пеймастер.
  • Эта возможность сообщается для каждого аккаунта, но кошелёк на Ledger не использует пеймастер для запросов сайтов.

auxiliaryFunds

{ "supported": true } (ERC-7682) сообщает сайту, что не нужно отклонять пакет только потому, что баланс нативного токена на аккаунте выглядит слишком низким для газа: газ может оплатить пеймастер. Эта возможность появляется ровно там, где появляется paymasterService.

Это не означает, что Anon переводит средства из приватного баланса на аккаунт. Значение value вызова и токены, которые тратит вызов, берутся из собственного публичного баланса подключённого аккаунта. eth_getBalance и eth_call возвращают то, что возвращает сеть.

Проверка перед отправкой

const provider = window.anon;
const [account] = await provider.request({ method: "eth_requestAccounts" });
const chainId = await provider.request({ method: "eth_chainId" });
const all = await provider.request({ method: "wallet_getCapabilities", params: [account, [chainId]] });
const here = all[chainId] ?? {};
console.log({
  severalCalls: here.atomic !== undefined,
  allOrNothing: here.atomic?.status === "supported",
  paymaster: here.paymasterService?.supported === true,
});

Ключи записаны строчным hex, как их возвращает eth_chainId.

Мобильное приложение

Через WalletConnect ответ имеет ту же форму, со следующими отличиями:

  • Адрес в params должен быть аккаунтом сессии (иначе 4100), а список ID сетей ограничивает ответ теми из них, которые входят в сети сессии.
  • Записи охватывают сети сессии.
  • Стелс-аккаунт сообщает "atomic": { "status": "supported" }, потому что он может сам оплатить свою комиссию, когда у него есть нативный токен. Пакет, который он не может оплатить таким образом, отклоняется с ошибкой 5760 при поступлении.