Invoice Transcript

Overview

This transcript serves as the official record of the computation’s cost and resource usage across the platform. Whether you are running Truebit Functions or API Tasks, it provides a verifiable breakdown of the fees and execution steps, ensuring that billing is as transparent as the computation itself.

Description

Function Invoice Transcript

{
    "executionId": "e7e444fa-96c5-45c9-9c65-dd9f8edfdafd",
    "taskId": "api_142456019dd5b351e82b6f679bf7b36af9e9a0fd523f30844a2c479d908b913e",
    "taskCreated_timeStamp": 1762441264136,
    "invoiceId": "4750340717624412641106",
    "byteGasPrice": 0.0002,
    "accounting_signature": {
        "v": 27,
        "r": "2cb73383f446dbaa2de9bfeec669bf159a72b7662ec15df9b391dcdf1267436b",
        "s": "3e245d19087c9c5c448fdf9a26d0a219c98eae8d9fb0fa360a63a94c252443e0"
    },
    "lineItem": [
        {
            "operation": "charge",
            "account": "0x************************************C8F7",
            "totalTransferredBytes": {
                "request": 0,
                "response": 0
            }
        }
    ]
}

API Invoice Transcript

{
    "executionId": "e7e444fa-96c5-45c9-9c65-dd9f8edfdafd",
    "taskId": "api_142456019dd5b351e82b6f679bf7b36af9e9a0fd523f30844a2c479d908b913e",
    "taskCreated_timeStamp": 1762441264136,
    "invoiceId": "4750340717624412641106",
    "byteGasPrice": 0.0002,
    "accounting_signature": {
        "v": 27,
        "r": "2cb73383f446dbaa2de9bfeec669bf159a72b7662ec15df9b391dcdf1267436b",
        "s": "3e245d19087c9c5c448fdf9a26d0a219c98eae8d9fb0fa360a63a94c252443e0"
    },
    "lineItem": [
        {
            "operation": "charge",
            "account": "0x************************************C8F7",
            "totalTransferredBytes": {
                "request": 0,
                "response": 0
            }
        }
    ]
}

Execution Lifecycle Messages

root message

The root message serves as the initial entry in the Function Invoice transcript. It includes critical details like the execution ID, taskId, and a list of liteItems, which capture all recorded operations on the invoice, such as "charge," "pay," and "penalty."

Property	Description	Values
executionId	Current execution ID	Text
taskId	Executed Function task	Text
taskCreated_timeStamp	Timestamp for task creation message	unixTimestamp
invoiceId	InvoiceId	Number
stepGasPrice / byteGasPrice	stepGasPrice: Amount of GAS paid for each execution step byteGasPrice: Amount of GAS paid for each transferred byte.	Number
accounting_signature	Truebit Verify Hub	v: Text r: Text s: Text
lineItem	List of all operations generated during the task execution.	Array

---

lineItem Function Task

For each participant in the Task execution, there is a lineItem representing an action applied to an "address".

• Charge: The Task requester is billed for the execution request.

• Pay: The Truebit Verify node is rewarded for executing and submitting the Task result.

• Penalty: The Truebit Verify node is penalized for submitting an incorrect response.

Property	Description	Values
operation	Operation Type	["charge","pay","penalty"]
account	If messageType is "charge", you will see the Task Requester Address If messageType is "pay" or "penalty", you will see the Truebit Verify Address*	Text
total_steps_computed	Total amount of steps executed by the Truebit Verify Node.	Text
peak_memory_used	Peak memory used by the Truebit Verify Node.	Text

lineItem API Task

The lineitem details the charge operation for the Task Requester.

Property	Description	Values
operation	Operation Type	charge
account	Task Requester Address	Text
totalTransferredBytes	Amount of bytes transferred during the API execution	request response