バッチトランザクション
サイトは、EIP-5792バージョン2.0.0の形式で、wallet_sendCallsを使って1回の承認で複数の呼び出しを送り、wallet_getCallsStatusでその状況を追います。各ネットワークが何を受け付けるかを知るために、最初にウォレットの機能をお読みください。トランザクションを1件ずつ送るサイトは、引き続きeth_sendTransactionを使えます。DApp 統合ガイドをご覧ください。
wallet_sendCalls
paramsは、1つのオブジェクトを持つ配列です。
| フィールド | Anonでの扱い |
|---|---|
calls |
必須。{ to, data, value }のオブジェクトを1個から32個。dataとvalueは16進数の文字列 |
chainId |
バッチを実行するネットワークの16進数のチェーンID。指定がない場合は、サイトの現在のネットワーク |
atomicRequired |
trueだけが効果を持ちます。その場合、複数の呼び出しはオール・オア・ナッシングで実行されなければなりません |
capabilities |
atomic、paymasterService、auxiliaryFundsの名前だけが、ネットワークの確認のために読み取られます。ほかの名前は、optionalがなくても無視されます |
from |
無視されます。バッチは常に、サイトの接続済みアカウントから実行されます |
version、id |
確認されません。version: "2.0.0"を送ってください。IDはAnonが独自に作ります |
結果は{ "id": "0x..." }です。IDは中身を解釈しない文字列として扱ってください。Anonがこれを返すのは、ユーザーが承認し、バッチがネットワークに送信された後であり、リクエストが開いたときではありません。ユーザーが拒否すると、リクエストは4001で失敗し、IDはありません。
バッチが実行される仕組み
アカウントが自分で手数料を支払う1つの呼び出しは、そのアカウントの通常のトランザクションです。複数の呼び出しと、ペイマスターが支払う呼び出しは、接続済みアカウントのEIP-7702デリゲーションを通じて1つのトランザクションとして実行されるため、呼び出しを行うのは接続済みアカウントです。ネットワーク手数料を誰が支払うかによって、呼び出しが失敗したときの動作が決まります。
| 手数料の支払者 | 複数の呼び出し | ステータスのatomic |
|---|---|---|
| アカウント。ネットワークのネイティブトークンで | オール・オア・ナッシング:1つの呼び出しが失敗すると、トランザクションがリバートし、どの呼び出しも反映されません | true |
| Anonのペイマスター。トークンの手数料で支払いを返します | 1つずつ順に:失敗した呼び出しはスキップされ、ほかの呼び出しは反映され、手数料は支払われます | false |
- ウォレットの公開アドレス:ユーザーは、リクエストで支払い方法を選びます。
atomicRequired: trueで複数の呼び出しがある場合、ペイマスターは提示されず、アカウントにガス代と呼び出しのvalueをまかなうネイティブトークンがなければ、ユーザーは承認できません。 - ステルスアカウント:ペイマスターのあるネットワークが必要です。
atomicRequired: trueで複数の呼び出しがある場合、リクエストはウォレットが開く前に5760で失敗します。 - Ledgerウォレット:アカウントが常に支払います。Ledgerが接続されている必要があり、ユーザーはデバイス上でバッチを確認します。
- ペイマスターがトランザクションを送信する場合、ペイマスター自身のアドレスから送るため、トランザクションの
fromは接続済みアカウントではありません。 - 呼び出しの
valueは、常に接続済みアカウント自身の残高から出ます。ペイマスターが支払うのは、ガス代だけです。
リクエストには、すべての呼び出し(Anonが読み取れるものはデコードされます)、ネットワーク、手数料の選択肢、そして呼び出しがオール・オア・ナッシングで実行されるか1つずつ順に実行されるかが表示されます。リクエストは、バッチの実行中も開いたままです。
wallet_sendCallsのエラー
| コード | 発生する場合 |
|---|---|
| 4100 | サイトが接続されていない |
| -32602 | callsがないか空である、または32個を超える呼び出しが含まれている |
| 4200 | atomicのないネットワークでの複数の呼び出し、またはatomic機能。もしくは、ペイマスターのないネットワークでのステルスアカウント、paymasterService、auxiliaryFunds |
| 5760 | ステルスアカウントからの複数の呼び出しにatomicRequired: trueを指定した場合 |
| 4001 | ユーザーがリクエストを拒否したか閉じた、またはタイムアウトした |
| -32603 | ユーザーは承認したが、ウォレットがバッチを実行できなかった |
wallet_getCallsStatus
paramsは[id]です。結果は次のとおりです。
{
"version": "2.0.0",
"id": "0x...",
"chainId": "0x1",
"status": 200,
"atomic": true,
"receipts": [
{
"logs": [],
"status": "0x1",
"blockHash": "0x...",
"blockNumber": "0x...",
"gasUsed": "0x...",
"transactionHash": "0x..."
}
]
}
status |
Anonでの意味 |
|---|---|
| 100 | 保留中:まだ確認されていない、または確認されたがレシートをまだ読み取れない |
| 200 | バッチのトランザクションがブロックに含まれ、リバートしなかった |
| 500 | トランザクションがリバートした、またはIDが返された後にバッチが失敗した |
- 拡張機能は、400と600を報告しません。1つずつ順に実行されたバッチ(
atomic: false)は、そのトランザクションが成功した場合、内部の呼び出しがスキップされていても200を報告します。結果に頼る前に、各呼び出しの効果をネットワーク上で確認してください。 chainIdは、バッチが実行されたネットワークです。receiptsには、バッチのトランザクションのレシートが、判明した時点で1つだけ入ります。そのlogsは常に空です。そのトランザクションにはウォレット自身のイベントも含まれるためです。ログはeth_getTransactionReceiptで読み取ってください。- Anonは、バッチのステータスを30分間保持し、ブラウザーを閉じると保持しません。それ以降は、自分が発行したIDに対して、100とレシートなしを、いつまでも返し続けます。ご自身で時間制限を決めて、ポーリングを止めてください。
- エラー:サイトが接続されていない場合、またはIDが別のサイトのものである場合は4100、このウォレットが発行していないIDに対しては5730(
Unknown bundle id.)です。wallet_showCallsStatusには対応していません(-32601)。
例
次のコードは、Ethereum上で、WETHへの2つの呼び出し(値なしのdeposit()とapprove(account, 0))を含む実際のトランザクションを送信します。ネットワーク手数料がかかります。
const provider = window.anon;
const [account] = await provider.request({ method: "eth_requestAccounts" });
await provider.request({ method: "wallet_switchEthereumChain", params: [{ chainId: "0x1" }] });
const weth = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2";
const word = (hex) => hex.replace(/^0x/, "").padStart(64, "0");
const { id } = await provider.request({
method: "wallet_sendCalls",
params: [{
version: "2.0.0",
chainId: "0x1",
from: account,
atomicRequired: false,
calls: [
{ to: weth, data: "0xd0e30db0", value: "0x0" },
{ to: weth, data: "0x095ea7b3" + word(account) + word("0x0"), value: "0x0" },
],
}],
});
let result;
for (let attempt = 0; attempt < 60; attempt++) {
result = await provider.request({ method: "wallet_getCallsStatus", params: [id] });
if (result.status !== 100) break;
await new Promise((resolve) => setTimeout(resolve, 5000));
}
console.log(result.status, result.atomic, result.receipts[0]?.transactionHash);
モバイルアプリ
WalletConnectでは、形は同じですが、次の点が異なります。
- バッチには1個から16個の呼び出しを含められます。それを超えると-32602で失敗します。
- ネイティブトークンを保有するステルスアカウントは、自分でガス代を支払えるため、バッチをオール・オア・ナッシングで実行することもできます。
atomicRequired: trueを指定したバッチで、アカウントがその方法では資金をまかなえないものは、5760で失敗します。 wallet_getCallsStatusは、何もネットワークに届く前に失敗したバッチについて、400を報告することもあります。