Recibos de transacción

El contenido explica la generación de recibos de transacción para transacciones exitosas y fallidas.

Recibos de transacción: Las transacciones devuelven recibos que indican éxito o fallo. Los recibos fallidos se generan sin ejecutar la transacción.

Respuesta de transacción exitosa: Una transacción exitosa proporciona un SentTransactionResponse. Siempre verifique esta respuesta con el type guard isSentTransactionResponse antes de acceder al hash de la transacción.

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);
}

Entendiendo los detalles de la transacción

Campos en las respuestas de transacción:

• txHash: El hash de la transacción enviada a la red.
• receipt.logs: Logs emitidos durante la transacción.
• receipt.status: Indica si la transacción fue EXITOSA o FALLIDA.
• receipt.revertReason: Explica por qué una transacción fue revertida, si aplica.

{
  "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": [ ... ]
  }
}

​

Respuesta de transacción fallida

Un el In-Game Wallet anticipa transacciones fallidas simulándolas en la red antes de enviarlas realmente. Si la simulación falla, la transacción no se envía y se devuelve un 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
      }
    ]
  }
}