Update TranscationReceipt to include decoding of events

[peterbroadhurst]

See hyperledger/firefly-transaction-manager#123

Example usage to extract (only) ERC-20 / ERC-721 events from a transaction:

Example FFTM POST on /

Note the example here includes both ABI definitions, which actually have the same signature, but are incompatible due to one being indexed on the value and one not (great quirk of ERC-20/ERC-721 ABI event definitions 🫠 ). The code tries both, and finds the one that works.

{
    "headers": {
        "type": "TransactionReceipt"
    },
    "transactionHash": "0xba7cbb474a1c2c1c392ef612b20c8eff79d876f5b66a0d1a27178eb3ae262f84",
    "eventFilters": [
        {
            "event": {
                "anonymous": false,
                "inputs": [
                    {
                        "indexed": true,
                        "name": "from",
                        "type": "address"
                    },
                    {
                        "indexed": true,
                        "name": "to",
                        "type": "address"
                    },
                    {
                        "indexed": false,
                        "name": "value",
                        "type": "uint256"
                    }
                ],
                "name": "Transfer",
                "type": "event"
            }
        },
        {
            "event": {
                "anonymous": false,
                "inputs": [
                    {
                        "indexed": true,
                        "internalType": "address",
                        "name": "from",
                        "type": "address"
                    },
                    {
                        "indexed": true,
                        "internalType": "address",
                        "name": "to",
                        "type": "address"
                    },
                    {
                        "indexed": true,
                        "internalType": "uint256",
                        "name": "tokenId",
                        "type": "uint256"
                    }
                ],
                "name": "Transfer",
                "type": "event"
            }
        }
    ]
}

Example Response

{
    "blockNumber": "27",
    "transactionIndex": "0",
    "blockHash": "0x474497495a4657f2bb3bd998e7e0e22bc4e08e9d8f3da3405cd2be4ab9d66fa6",
    "success": true,
    "protocolId": "000000000027/000000",
    "extraInfo": {
        "contractAddress": null,
        "cumulativeGasUsed": "87154",
        "from": "0x4817ff50820c4f21cef657a00ac75033686b02c3",
        "to": "0x590a0fc9da219c67ff0818268c2e2d0d43a53637",
        "gasUsed": "87154",
        "status": "1",
        "errorMessage": null
    },
    "events": [
        {
            "address": "0x590a0fc9da219c67ff0818268c2e2d0d43a53637",
            "blockHash": "0x474497495a4657f2bb3bd998e7e0e22bc4e08e9d8f3da3405cd2be4ab9d66fa6",
            "blockNumber": "27",
            "data": {
                "from": "0x0000000000000000000000000000000000000000",
                "to": "0x4817ff50820c4f21cef657a00ac75033686b02c3",
                "tokenId": "22"
            },
            "inputSigner": "0x4817ff50820c4f21cef657a00ac75033686b02c3",
            "logIndex": "0",
            "removed": false,
            "signature": "Transfer(address,address,uint256)",
            "timestamp": "2024-06-11T14:23:06Z",
            "topics": [
                "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                "0x0000000000000000000000000000000000000000000000000000000000000000",
                "0x0000000000000000000000004817ff50820c4f21cef657a00ac75033686b02c3",
                "0x0000000000000000000000000000000000000000000000000000000000000016"
            ],
            "transactionHash": "0xba7cbb474a1c2c1c392ef612b20c8eff79d876f5b66a0d1a27178eb3ae262f84",
            "transactionIndex": "0"
        }
    ]
}

[peterbroadhurst]

FFTM can now be explicit about this

[peterbroadhurst]

Will hold of merging until I can refer to FFTM using a release