トランザクションレシート： トランザクションは、成功または失敗を示すレシートを返します。失敗した場合は、トランザクションの実行なしにレシートが生成されます。

成功したトランザクションのレスポンス： 成功したトランザクションはSentTransactionResponseを返します。トランザクションハッシュにアクセスする前に、必ず**isSentTransactionResponse**型ガードでこのレスポンスを確認してください。

import { Sequence, isSentTransactionResponse } from "@0xsequence/waas";

const waas = new SequenceWaaS(
  {
    projectAccessKey: `${process.env.PROJECT_ACCESS_KEY}`,
    waasConfigKey: `${process.env.WAAS_CONFIG_KEY}`,
    network: "arbitrum-nova",
  }
);

await waas.signIn({ idToken }, "Session name");

const tx = await waas.sendTransaction({
  chainId: 42161,
  transactions: [
    {
      to: "0xD72C236Be524Ec24F72329317e2785E687105B69",
      value: "0",
    },
  ],
});

if (isSentTransactionResponse(tx)) {
  console.log(tx);
}

トランザクション詳細の理解

トランザクションレスポンスの各フィールド：

  • txHash：ネットワークに送信されたトランザクションのハッシュ。
  • receipt.logs：トランザクション中に発行されたログ。
  • receipt.status：トランザクションが成功したか失敗したかを示します。
  • receipt.revertReason：該当する場合、トランザクションがリバートされた理由を説明します。
{
  "code": "transactionReceipt",
  "data": {
    "txHash": "0xf2e9f728abd65089f25efda5852e605ced377f4e2c89dbf143b124623ed09b2c",
    "metaTxHash": "acc36ed4ef40db74137266e48d863083a5c7e85e2735d69adafcb5b362b6cfc0",
    "nativeReceipt": { ... },
    "receipt": {
      "id": "acc36ed4ef40db74137266e48d863083a5c7e85e2735d69adafcb5b362b6cfc0",
      "index": 0,
      "logs": [
        {
          "address": "0x4d4EE1b8583e31fe789eAF2e1b6e011C220c10B6",
          "data": "0x0000000000000000000000001119e72b4af230becebd933d0e07f0eec51d8c2a0000000000000000000000000000000000000000000000000000000000000001",
          "topics": [
            "0x1f180c27086c7a39ea2a7b25239d1ab92348f07ca7bb59d1438fcf527568f881"
          ]
        },
        {
          "address": "0x4d4EE1b8583e31fe789eAF2e1b6e011C220c10B6",
          "data": "0x0000000000000000000000000000000000000000000000000000000000000000",
          "topics": [
            "0x5c4eeb02dabf8976016ab414d617f9a162936dcace3cdef8c69ef6e262ad5ae7",
            "0xacc36ed4ef40db74137266e48d863083a5c7e85e2735d69adafcb5b362b6cfc0"
          ]
        }
      ],
      "receipts": [ ... ],
      "revertReason": null,
      "status": "SUCCEEDED"
    },
    "request": { ... },
    "simulations": [ ... ]
  }
}

​
失敗したトランザクションのレスポンス

インゲームウォレットは、トランザクションを実際に送信する前にネットワーク上でシミュレーションすることで、失敗するトランザクションを事前に防ぎます。シミュレーションに失敗した場合、トランザクションは送信されず、FailedTransactionResponse が返されます。

import { Sequence, isSentTransactionResponse } from "@0xsequence/waas";

const waas = new SequenceWaaS(
  {
    projectAccessKey: `${process.env.PROJECT_ACCESS_KEY}`,
    waasConfigKey: `${process.env.WAAS_CONFIG_KEY}`,
    network: "arbitrum-nova",
  }
);

await waas.signIn({ idToken }, "Session name");

const tx = await waas.sendTransaction({
  chainId: 137,
  transactions: [
    {
      // This address always fails on Polygon, give it a try :D
      to: "0x839eE023B21f4Ffe2294025DE0AC30Ba7278D6Fd",
      value: "0",
    },
  ],
});

if (isSentTransactionResponse(tx)) {
  // ... This will never be executed
} else {
  // tx can only be `SentTransactionResponse` or `FailedTransactionResponse`
  console.log(tx);
}
{
  "code": "transactionFailed",
  "data": {
    "error": "This is an error message",
    "request": {
      "code": "sendTransaction",
      "expires": 1699443005,
      "identifier": "ts-sdk-1699442705965-0x153824576D03629b264683B430bBF9AcEA1d0975",
      "issued": 1699442705,
      "network": "137",
      "transactions": [
        {
          "data": "0x",
          "to": "0x839eE023B21f4Ffe2294025DE0AC30Ba7278D6Fd",
          "type": "transaction",
          "value": "0x00"
        }
      ],
      "wallet": "0x4d4EE1b8583e31fe789eAF2e1b6e011C220c10B6"
    },
    "simulations": [
      {
        "executed": true,
        "gasLimit": 7908,
        "gasUsed": 5931,
        "reason": "This is an error message :)",
        "result": null,
        "succeeded": false
      }
    ]
  }
}