Возможности кошелька
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 при поступлении.