+
+
+
+```javascript
+import { stringToHex, encodeFunctionData, erc20Abi, zeroHash } from "viem";
+
+async function handle_advance(data) {
+ console.log("Received advance request data " + JSON.stringify(data));
+ const sender = data["metadata"]["msg_sender"];
+ const erc20Token = "0x784f0c076CC55EAD0a585a9A13e57c467c91Dc3a"; // Sample ERC20 token address
+
+ const call = encodeFunctionData({
+ abi: erc20Abi,
+ functionName: "transfer",
+ args: [sender, BigInt(10)],
+ });
+
+ let voucher = {
+ destination: erc20Token,
+ payload: call,
+ value: zeroHash,
+ };
+
+ await emitVoucher(voucher);
+ return "accept";
+}
+
+
+const emitVoucher = async (voucher) => {
+ try {
+ await fetch(rollup_server + "/voucher", {
+ method: "POST",
+ headers: {
+ "Content-Type": "application/json",
+ },
+ body: JSON.stringify(voucher),
+ });
+ } catch (error) {
+ //Do something when there is an error
+ }
+};
+
+```
+
+
+
+
+
+
+
+```python
+# Voucher creation process
+import requests
+import json
+from os import environ
+from eth_utils import function_signature_to_4byte_selector
+from eth_abi import decode, encode
+
+rollup_server = environ["ROLLUP_HTTP_SERVER_URL"]
+
+def emit_voucher(function_signature, destination, types, values):
+ selector = function_signature_to_4byte_selector(function_signature)
+ encoded_params = encode(types, values)
+ payload = "0x" + (selector + encoded_params).hex()
+ response = requests.post(rollup_server + "/voucher", json={"payload": payload, "destination": destination, "value": '0x' + encode(["uint256"], [0]).hex()})
+ if response.status_code == 200 or response.status_code == 201:
+ logger.info(f"Voucher emitted successfully with data: {payload}")
+ else:
+ logger.error(f"Failed to emit Voucher with data: {payload}. Status code: {response.status_code}")
+
+
+emit_voucher("mint(address)", "0x784f0c076CC55EAD0a585a9A13e57c467c91Dc3a", ["address"], [data["metadata"]["msg_sender"]])
+```
+
+
+
+
+
:::note create a voucher
[Refer to the documentation here](../../development/asset-handling.md) for asset handling and creating vouchers in your dApp.
:::
-## Epoch configuration
+## DELEGATECALL Vouchers
+
+:::danger Security Considerations
+DELEGATECALL Vouchers are a powerful feature that should be used with extreme caution. Incorrect implementation can lead to serious security vulnerabilities as the target contract's code has full access to the Application contract's storage and funds.
+:::
+
+DELEGATECALL Vouchers are an extension of vouchers that enables advanced smart contract interactions through the [`DELEGATECALL`](https://www.evm.codes/?fork=cancun#f4) opcode.
+
+Unlike regular vouchers, DELEGATECALL vouchers allow dApps to separate their execution logic from their storage context. When using DELEGATECALL voucher, the Application contract always maintains the storage, context, and funds (both ETH and tokens), while the target contract provides only the execution logic. This separation enables more flexible and reusable smart contract patterns while keeping all state changes and assets within the Application contract.
+
+When a DELEGATECALL voucher is executed through the Application contract, the code at the target address is executed with the following characteristics:
+
+- All storage operations occur in the Application contract's storage space
+- All funds (ETH and tokens) remain in and are managed by the Application contract
+- The msg.sender and msg.value from the original transaction are preserved
+- The execution logic comes from the target contract, but operates on the Application contract's state and funds
+
+This mechanism, where the Application contract maintains the state and funds while borrowing logic from other contracts, enables powerful patterns such as:
+
+- **Paid Vouchers**: Vouchers that provide payment to the user who executes them.
+
+- **Future Vouchers**: Vouchers that are time-locked and can only be executed after a specific timestamp.
+
+- **Expirable Vouchers**: Vouchers that have an expiration timestamp, after which they can no longer be executed.
+
+- **Targeted Vouchers**: Vouchers that are restricted to execution by specific addresses or a list of authorized addresses.
+
+- **Atomic Vouchers**: A sequence of message calls that must be executed in order, ensuring atomicity of the operations.
+
+- **Re-executable Vouchers**: Vouchers that can be executed multiple times, unlike standard vouchers which can only be executed once.
+
+- **Ordered Vouchers**: Vouchers that must be executed in a specific sequence. For example, voucher A can only be executed after voucher B has been executed.
+
+
+
+
+
+```javascript
+import { encodeFunctionData } from "viem";
+
+const abi = [
+ "function safeTransfer(address,address,uint256)"
+];
+
+async function emitSafeERC20Transfer(token, to, amount) {
+ const call = encodeFunctionData({
+ abi,
+ functionName: "safeTransfer",
+ args: [token, to, amount],
+ });
+
+ const voucher = {
+ destination: "0xfafafafafafafafafafafafafafafafafafafafa", // address of the contract containing the logic
+ payload: call,
+ };
+
+ await fetch(rollup_server + "/delegate-call-voucher", {
+ method: "POST",
+ headers: { "Content-Type": "application/json" },
+ body: JSON.stringify(voucher),
+ });
+}
+```
+
+
+
+
+
+
+
+```python
+from eth_utils import function_signature_to_4byte_selector, to_checksum_address
+from eth_abi import encode
+import requests
+
+def emit_safe_erc20_transfer(token, to, amount):
+ selector = function_signature_to_4byte_selector("safeTransfer(address,address,uint256)")
+ encoded_params = encode(["address", "address", "uint256"], [to_checksum_address(token), to_checksum_address(to), amount])
+ payload = "0x" + (selector + encoded_params).hex()
+ voucher = {
+ "destination": "0xfafafafafafafafafafafafafafafafafafafafa", # endereço do contrato
+ "payload": payload,
+ }
+ response = requests.post(rollup_server + "/delegate-call-voucher", json=voucher)
+ return response
+```
+
+
+
+
+
+
+
+```go
+package main
+
+import (
+ "bytes"
+ "encoding/json"
+ "fmt"
+ "net/http"
+ "strings"
+
+ "github.com/ethereum/go-ethereum/accounts/abi"
+ "github.com/ethereum/go-ethereum/common"
+)
+
+func emitSafeERC20Transfer(token, to common.Address, amount *big.Int) error {
+ abiJSON := `[{
+ "type":"function",
+ "name":"safeTransfer",
+ "inputs":[
+ {"type":"address"},
+ {"type":"address"},
+ {"type":"uint256"}
+ ]
+ }]`
+
+ abiInterface, err := abi.JSON(strings.NewReader(abiJSON))
+ if err != nil {
+ return fmt.Errorf("failed to parse ABI: %w", err)
+ }
+
+ payload, err := abiInterface.Pack("safeTransfer", token, to, amount)
+ if err != nil {
+ return fmt.Errorf("failed to pack ABI: %w", err)
+ }
+
+ voucher := map[string]interface{}{
+ "destination": "0xfafafafafafafafafafafafafafafafafafafafa",
+ "payload": common.Bytes2Hex(payload),
+ }
+
+ voucherJSON, err := json.Marshal(voucher)
+ if err != nil {
+ return fmt.Errorf("failed to marshal voucher: %w", err)
+ }
+
+ _, err = http.Post(rollupServer+"/delegate-call-voucher", "application/json", bytes.NewBuffer(voucherJSON))
+ if err != nil {
+ return fmt.Errorf("failed to send voucher: %w", err)
+ }
+
+ return nil
+}
+```
+
+
+
+
+
+### Implementation Considerations
+
+When implementing DELEGATECALL vouchers, consider the following:
+
+1. **Storage Layout**: Since all storage operations happen in the Application contract, the storage layout of the target contract must be compatible with the Application contract's layout to prevent unintended storage collisions.
+
+2. **Security**: Since DELEGATECALL operations execute code in the context of the Application contract, careful validation of the target contract and its code is essential to prevent malicious modifications to the Application's state.
+
+3. **State Management**: All state changes occur in the Application contract's storage, making it the single source of truth for the application's state.
+
+### Execution Context
+
+In a DELEGATECALL voucher execution:
+
+- The Application contract provides the execution context and storage
+- The target contract provides only the logic to be executed
+- All storage operations affect the Application contract's state
+- msg.sender and msg.value from the original transaction are preserved
+
+This architecture, where the Application contract maintains all state while being able to execute logic from other contracts, makes DELEGATECALL vouchers particularly useful for customizable logics while keeping all application state centralized in the Application contract.
+
+## Epoch Configuration
An epoch refers to a specific period during which a batch of updates is processed off-chain, and upon agreement by validators, the finalized state is recorded on-chain.
Epoch Length is the number of blocks that make up an epoch. It determines how long each epoch lasts in terms of block counts. For instance, if an epoch length is set to 7200 blocks, the epoch will end once 7200 blocks have been processed. This length directly influences how frequently updates are finalized and recorded on the blockchain.
-One everyday use of vouchers in Cartesi dApps is to withdraw assets. Users initiate asset withdrawals by generating vouchers, which are then executed on the blockchain upon the closure of the corresponding epoch.
+Vouchers and DELEGATECALL vouchers are executed on the blockchain upon the closure of the corresponding epoch. This ensures that all state changes and logic executions are properly validated and recorded in the blockchain.
+
+One common use of vouchers in Cartesi dApps is to withdraw assets. Users initiate asset withdrawals by generating vouchers, which are then executed on the blockchain upon the closure of the corresponding epoch.
You can manually set the epoch length to facilitate quicker asset deposits and withdrawals.
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/contracts/application-factory.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/contracts/application-factory.md
index b91520c5..e9ca2fef 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/contracts/application-factory.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/contracts/application-factory.md
@@ -6,7 +6,11 @@ resources:
title: Application Factory contract
---
-The **ApplicationFactory** contract allows anyone to reliably deploy a new [`IApplication`](https://github.com/cartesi/rollups-contracts/blob/v2.0.0/src/dapp/IApplication.sol) contract.
+The **ApplicationFactory** contract is a tool for reliably deploying new instances of the [`Application`](../contracts/application.md) contract with or without a specified salt value for address derivation.
+
+Additionally, it provides a function to calculate the address of a potential new `CartesiDApp` contract based on input parameters.
+
+This contract ensures efficient and secure deployment of `Application` contracts within the Cartesi Rollups framework.
## Functions
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/inputs/_category_.yml b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/inputs/_category_.yml
deleted file mode 100644
index 9faf3ac0..00000000
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/inputs/_category_.yml
+++ /dev/null
@@ -1,2 +0,0 @@
-label: Inputs
-link: null
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/inputs/input-filter.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/inputs/input-filter.md
deleted file mode 100644
index 8193e1c0..00000000
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/inputs/input-filter.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-id: input-filter
-title: InputFilter
-hide_table_of_contents: false
----
-
-
-Filter object to restrict results depending on input properties
-
-```graphql
-input InputFilter {
- indexLowerThan: Int
- indexGreaterThan: Int
-}
-```
-
-
-## Fields
-
-| Name | Type | Description |
-| ---- |------| ------|
-| `indexLowerThan` | [`Int`](../../scalars/int) | Filter only inputs with index lower than a given value |
-| `indexGreaterThan` | [`Int`](../../scalars/int) | Filter only inputs with index greater than a given value |
-
-
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input-connection.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input-connection.md
index f0920851..cabf1f83 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input-connection.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input-connection.md
@@ -4,12 +4,15 @@ title: InputConnection
hide_table_of_contents: false
---
-
-Represents a paginated connection of Inputs.
+Represents a paginated list of inputs.
```graphql
type InputConnection {
+ "Total number of entries that match the query"
+ totalCount: Int!
+ "List of edges in the connection"
edges: [InputEdge!]!
+ "Information about the current page"
pageInfo: PageInfo!
}
```
@@ -17,10 +20,33 @@ type InputConnection {
## Fields
| Name | Type | Description |
-| ---- |------| ------|
-| `edges`| [`InputEdge`](../../objects/input-edge) | A list of `InputEdge` objects. Each edge contains an `Input` object and a cursor for pagination. |
-| `pageInfo`| [`PageInfo`](../../objects/page-info) | Metadata about the pagination. |
-
-
+| ---- |------| ----------- |
+| `totalCount` | [`Int!`](../../scalars/int) | Total number of entries that match the query. |
+| `edges` | [`[InputEdge!]!`](../../objects/input-edge) | List of edges in the connection. |
+| `pageInfo` | [`PageInfo!`](../../objects/page-info) | Information about the current page. |
+## Example Query
+```graphql
+query {
+ inputs(first: 10) {
+ totalCount
+ edges {
+ node {
+ id
+ index
+ status
+ msgSender
+ payload
+ }
+ cursor
+ }
+ pageInfo {
+ hasNextPage
+ hasPreviousPage
+ startCursor
+ endCursor
+ }
+ }
+}
+```
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input-edge.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input-edge.md
index c757528a..2f500b71 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input-edge.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input-edge.md
@@ -4,24 +4,39 @@ title: InputEdge
hide_table_of_contents: false
---
-
-Pagination entry.
+Represents a single input in a paginated list.
```graphql
type InputEdge {
+ "The input at this edge"
node: Input!
+ "A cursor for use in pagination"
cursor: String!
}
```
-
## Fields
| Name | Type | Description |
-| ---- | ---- | ----------- |
-| `node` | [`Input!`](../../objects/input) | The Input object. |
-| `cursor` | [`String!`](../../scalars/string) | A string that serves as a pagination cursor for this particular edge. |
-
-
+| ---- |------| ----------- |
+| `node` | [`Input!`](../../objects/input) | The input at this edge. |
+| `cursor` | [`String!`](../../scalars/string) | A cursor for use in pagination. |
+## Example Query
+```graphql
+query {
+ inputs(first: 10) {
+ edges {
+ node {
+ id
+ index
+ status
+ msgSender
+ payload
+ }
+ cursor
+ }
+ }
+}
+```
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input.md
index 49e0ac9b..a04ba1cf 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/input.md
@@ -4,36 +4,119 @@ title: Input
hide_table_of_contents: false
---
-
-Request submitted to the application to advance its state
+Request submitted to the application to advance its state.
```graphql
type Input {
+ "id of the input"
+ id: String!
+ "Input index starting from genesis"
index: Int!
+ "Status of the input"
status: CompletionStatus!
- timestamp: DateTime!
+ "Address responsible for submitting the input"
msgSender: String!
- blockNumber: Int!
+ "Timestamp associated with the input submission, as defined by the base layer's block in which it was recorded"
+ timestamp: BigInt! @deprecated(reason: "Use `blockTimestamp` instead")
+ "Number of the base layer block in which the input was recorded"
+ blockNumber: BigInt!
+ "Input payload in Ethereum hex binary format, starting with '0x'"
payload: String!
- notices: NoticeConnection!
- vouchers: VoucherConnection!
- reports: ReportConnection!
+ "Get vouchers from this particular input with support for pagination"
+ vouchers(first: Int, last: Int, after: String, before: String): VoucherConnection!
+ "Get DELEGATECALL vouchers from this particular input with support for pagination"
+ delegateCallVouchers(first: Int, last: Int, after: String, before: String): DelegateCallVoucherConnection!
+ "Get notices from this particular input with support for pagination"
+ notices(first: Int, last: Int, after: String, before: String): NoticeConnection!
+ "Get reports from this particular input with support for pagination"
+ reports(first: Int, last: Int, after: String, before: String): ReportConnection!
+ "Timestamp associated with the Espresso input submission"
+ espressoTimestamp: String @deprecated(reason: "Will be removed")
+ "Number of the Espresso block in which the input was recorded"
+ espressoBlockNumber: String @deprecated(reason: "Will be removed")
+ "Input index in the Input Box"
+ inputBoxIndex: String
+ "Block timestamp"
+ blockTimestamp: BigInt
+ "Previous RANDAO value"
+ prevRandao: String
+ "The application that produced the input"
+ application: Application!
}
```
-### Fields
+## Fields
| Name | Type | Description |
-| ---- | ---- | ----------- |
-| `index` | [`Int!`](../../scalars/int) | Unique identifier for the input. |
-| `status` | [`CompletionStatus!`](../../objects/completion-status) | Current status of the input processing. |
-| `timestamp` | [`DateTime!`](../../scalars/date-time) | Timestamp associated with the input submission. |
-| `msgSender` | [`String!`](../../scalars/string) | Address of the account that submitted the input. |
-| `blockNumber` | [`Int!`](../../scalars/int) | Number of the base layer block in which the input was recorded. |
-| `payload` | [`String!`](../../scalars/string) | The actual data/content of the input. |
-| `notices` | [`NoticeConnection!`](../../objects/notice-connection) | List of notices associated with this input. |
-| `vouchers` | [`VoucherConnection!`](../../objects/voucher-connection) | List of vouchers associated with this input. |
-| `reports` | [`ReportConnection!`](../../objects/report-connection) | List of reports associated with this input. |
-
+| ---- |------| ----------- |
+| `id` | [`String!`](../../scalars/string) | ID of the input. |
+| `index` | [`Int!`](../../scalars/int) | Input index starting from genesis. |
+| `status` | [`CompletionStatus!`](../../enums/completion-status) | Status of the input. |
+| `msgSender` | [`String!`](../../scalars/string) | Address responsible for submitting the input. |
+| `timestamp` | [`BigInt!`](../../scalars/bigint) | Timestamp associated with the input submission, as defined by the base layer's block in which it was recorded. |
+| `blockNumber` | [`BigInt!`](../../scalars/bigint) | Number of the base layer block in which the input was recorded. |
+| `payload` | [`String!`](../../scalars/string) | Input payload in Ethereum hex binary format, starting with '0x'. |
+| `vouchers` | [`VoucherConnection!`](../../objects/voucher-connection) | Get vouchers from this particular input with support for pagination. |
+| `delegateCallVouchers` | [`DelegateCallVoucherConnection!`](../../objects/delegate-call-voucher-connection) | Get DELEGATECALL vouchers from this particular input with support for pagination. |
+| `notices` | [`NoticeConnection!`](../../objects/notice-connection) | Get notices from this particular input with support for pagination. |
+| `reports` | [`ReportConnection!`](../../objects/report-connection) | Get reports from this particular input with support for pagination. |
+| `espressoTimestamp` | [`String`](../../scalars/string) | Timestamp associated with the Espresso input submission. |
+| `espressoBlockNumber` | [`String`](../../scalars/string) | Number of the Espresso block in which the input was recorded. |
+| `inputBoxIndex` | [`String`](../../scalars/string) | Input index in the Input Box. |
+| `blockTimestamp` | [`BigInt`](../../scalars/bigint) | Block timestamp. |
+| `prevRandao` | [`String`](../../scalars/string) | Previous RANDAO value. |
+| `application` | [`Application!`](../../objects/application) | The application that produced the input. |
+## Example Query
+```graphql
+query {
+ input(outputIndex: 1) {
+ id
+ index
+ status
+ msgSender
+ timestamp
+ blockNumber
+ payload
+ vouchers(first: 10) {
+ edges {
+ node {
+ index
+ destination
+ payload
+ }
+ }
+ }
+ delegateCallVouchers(first: 10) {
+ edges {
+ node {
+ index
+ destination
+ payload
+ }
+ }
+ }
+ notices(first: 10) {
+ edges {
+ node {
+ index
+ payload
+ }
+ }
+ }
+ reports(first: 10) {
+ edges {
+ node {
+ index
+ payload
+ }
+ }
+ }
+ application {
+ address
+ name
+ }
+ }
+}
+```
\ No newline at end of file
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice-connection.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice-connection.md
index 7bdf6b88..4e6117cd 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice-connection.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice-connection.md
@@ -4,12 +4,15 @@ title: NoticeConnection
hide_table_of_contents: false
---
-
-Represents a paginated connection of Notices.
+Represents a paginated list of notices.
```graphql
type NoticeConnection {
+ "Total number of entries that match the query"
+ totalCount: Int!
+ "List of edges in the connection"
edges: [NoticeEdge!]!
+ "Information about the current page"
pageInfo: PageInfo!
}
```
@@ -17,11 +20,34 @@ type NoticeConnection {
## Fields
| Name | Type | Description |
-| ---- |------| ------|
-| `edges`| [`NoticeEdge`](../../objects/notice-edge) | A list of `Notice` objects. Each edge contains a `Notice` object and a cursor for pagination. |
-| `pageInfo`| [`PageInfo`](../../objects/page-info) | Metadata about the pagination. |
-
-
-
+| ---- |------| ----------- |
+| `totalCount` | [`Int!`](../../scalars/int) | Total number of entries that match the query. |
+| `edges` | [`[NoticeEdge!]!`](../../objects/notice-edge) | List of edges in the connection. |
+| `pageInfo` | [`PageInfo!`](../../objects/page-info) | Information about the current page. |
+## Example Query
+```graphql
+query {
+ notices(first: 10) {
+ totalCount
+ edges {
+ node {
+ index
+ payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ }
+ cursor
+ }
+ pageInfo {
+ hasNextPage
+ hasPreviousPage
+ startCursor
+ endCursor
+ }
+ }
+}
+```
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice-edge.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice-edge.md
index 09af6d6a..63188fb6 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice-edge.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice-edge.md
@@ -4,12 +4,13 @@ title: NoticeEdge
hide_table_of_contents: false
---
-
-Pagination entry
+Represents a single notice in a paginated list.
```graphql
type NoticeEdge {
+ "The notice at this edge"
node: Notice!
+ "A cursor for use in pagination"
cursor: String!
}
```
@@ -17,11 +18,26 @@ type NoticeEdge {
## Fields
| Name | Type | Description |
-| ---- | ---- | ----------- |
-| `node` | [`Notice!`](../../objects/notice) | The Notice object. |
-| `cursor` | [`String!`](../../scalars/string) | A string that serves as a pagination cursor for this particular edge. |
-
-
-
+| ---- |------| ----------- |
+| `node` | [`Notice!`](../../objects/notice) | The notice at this edge. |
+| `cursor` | [`String!`](../../scalars/string) | A cursor for use in pagination. |
+## Example Query
+```graphql
+query {
+ notices(first: 10) {
+ edges {
+ node {
+ index
+ payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ }
+ cursor
+ }
+ }
+}
+```
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice.md
index 1bc7bf07..165b9566 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/notice.md
@@ -4,30 +4,51 @@ title: Notice
hide_table_of_contents: false
---
-
Informational statement that can be validated in the base layer blockchain.
```graphql
type Notice {
+ "Notice index within the context of the input that produced it"
index: Int!
+ "Input whose processing produced the notice"
input: Input!
+ "Notice data as a payload in Ethereum hex binary format, starting with '0x'"
payload: String!
+ "Proof object that allows this notice to be validated by the base layer blockchain"
proof: Proof
+ "The application that produced the notice"
+ application: Application!
}
```
-
## Fields
| Name | Type | Description |
| ---- |------| ----------- |
-| `index`| [`Int!`](../../scalars/int) | Unique identifier for the notice. |
-| `input`| [`Input!`](../../objects/input) | The input associated with this notice. |
-| `payload`| [`String!`](../../scalars/string) |The actual data/content of the notice. |
-| `proof`| [`Proof`](../../objects/proof) | Proof of the notice's validity (if available). |
-
-
-
-
+| `index` | [`Int!`](../../scalars/int) | Notice index within the context of the input that produced it. |
+| `input` | [`Input!`](../../objects/input) | Input whose processing produced the notice. |
+| `payload` | [`String!`](../../scalars/string) | Notice data as a payload in Ethereum hex binary format, starting with '0x'. |
+| `proof` | [`Proof`](../../objects/proof) | Proof object that allows this notice to be validated by the base layer blockchain. |
+| `application` | [`Application!`](../../objects/application) | The application that produced the notice. |
+## Example Query
+```graphql
+query {
+ notice(outputIndex: 1) {
+ index
+ input {
+ index
+ }
+ payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ application {
+ address
+ name
+ }
+ }
+}
+```
\ No newline at end of file
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/proof.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/proof.md
index 2f96f7dd..57f3f671 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/proof.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/proof.md
@@ -4,24 +4,33 @@ title: Proof
hide_table_of_contents: false
---
-Represents the proof of validity for a notice or voucher.
+Data that can be used as proof to validate notices and execute vouchers on the base layer blockchain.
```graphql
type Proof {
- validity: OutputValidityProof!
- context: String!
+ "Index of the output in the output box"
+ outputIndex: BigInt!
+ "Array of sibling hashes in the output box merkle tree"
+ outputHashesSiblings: [String]!
}
```
-
## Fields
| Name | Type | Description |
| ---- |------| ----------- |
-| `validity`| [`OutputValidityProof!`](../../objects/output-validity-proof) | Validity proof for an output. |
-| `context`| [`String!`](../../scalars/string) | Data that allows the validity proof to be contextualized within submitted claims, given as a payload in Ethereum hex binary format, starting with '0x'. |
-
-
-
+| `outputIndex` | [`BigInt!`](../../scalars/bigint) | Index of the output in the output box. |
+| `outputHashesSiblings` | [`[String]!`](../../scalars/string) | Array of sibling hashes in the output box merkle tree. |
+## Example Query
+```graphql
+query {
+ voucher(outputIndex: 1) {
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ }
+}
+```
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report-connection.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report-connection.md
index a79b44fc..c7c90c0c 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report-connection.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report-connection.md
@@ -4,26 +4,46 @@ title: ReportConnection
hide_table_of_contents: false
---
-
-Represents a paginated connection of Reports.
+Represents a paginated list of reports.
```graphql
type ReportConnection {
+ "Total number of entries that match the query"
+ totalCount: Int!
+ "List of edges in the connection"
edges: [ReportEdge!]!
+ "Information about the current page"
pageInfo: PageInfo!
}
```
-
## Fields
| Name | Type | Description |
-| ---- |------| ------|
-| `edges`| [`ReportEdge`](../../objects/report-edge) | A list of `ReportEdge` objects. Each edge contains an `Input` object and a cursor for pagination. |
-| `pageInfo`| [`PageInfo`](../../objects/page-info) | Metadata about the pagination. |
-
-
-
-
+| ---- |------| ----------- |
+| `totalCount` | [`Int!`](../../scalars/int) | Total number of entries that match the query. |
+| `edges` | [`[ReportEdge!]!`](../../objects/report-edge) | List of edges in the connection. |
+| `pageInfo` | [`PageInfo!`](../../objects/page-info) | Information about the current page. |
+## Example Query
+```graphql
+query {
+ reports(first: 10) {
+ totalCount
+ edges {
+ node {
+ index
+ payload
+ }
+ cursor
+ }
+ pageInfo {
+ hasNextPage
+ hasPreviousPage
+ startCursor
+ endCursor
+ }
+ }
+}
+```
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report-edge.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report-edge.md
index a6fba549..91959d2f 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report-edge.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report-edge.md
@@ -4,26 +4,36 @@ title: ReportEdge
hide_table_of_contents: false
---
-
-Pagination entry
+Represents a single report in a paginated list.
```graphql
type ReportEdge {
+ "The report at this edge"
node: Report!
+ "A cursor for use in pagination"
cursor: String!
}
```
-
-### Fields
-
+## Fields
| Name | Type | Description |
-| ---- | ---- | ----------- |
-| `node` | [`Report!`](../../objects/report) | The Report object. |
-| `cursor` | [`String!`](../../scalars/string) | A string that serves as a pagination cursor for this particular edge. |
-
-
-
+| ---- |------| ----------- |
+| `node` | [`Report!`](../../objects/report) | The report at this edge. |
+| `cursor` | [`String!`](../../scalars/string) | A cursor for use in pagination. |
+## Example Query
+```graphql
+query {
+ reports(first: 10) {
+ edges {
+ node {
+ index
+ payload
+ }
+ cursor
+ }
+ }
+}
+```
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report.md
index ba904c27..8d8fd8f5 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/report.md
@@ -4,28 +4,44 @@ title: Report
hide_table_of_contents: false
---
-
-Represents application log or diagnostic information.
+Application log or diagnostic information.
```graphql
type Report {
+ "Report index within the context of the input that produced it"
index: Int!
+ "Input whose processing produced the report"
input: Input!
+ "Report data as a payload in Ethereum hex binary format, starting with '0x'"
payload: String!
+ "The application that produced the report"
+ application: Application!
}
```
-
## Fields
| Name | Type | Description |
| ---- |------| ----------- |
-| `index`| [`Int!`](../../scalars/int) | Unique identifier for the report. |
-| `input`| [`Input!`](../../objects/input) | The input associated with this report. |
-| `payload`| [`String!`](../../scalars/string) | The actual data/content of the report. |
-
-
-
-
+| `index` | [`Int!`](../../scalars/int) | Report index within the context of the input that produced it. |
+| `input` | [`Input!`](../../objects/input) | Input whose processing produced the report. |
+| `payload` | [`String!`](../../scalars/string) | Report data as a payload in Ethereum hex binary format, starting with '0x'. |
+| `application` | [`Application!`](../../objects/application) | The application that produced the report. |
+## Example Query
+```graphql
+query {
+ report(reportIndex: 1) {
+ index
+ input {
+ index
+ }
+ payload
+ application {
+ address
+ name
+ }
+ }
+}
+```
\ No newline at end of file
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher-connection.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher-connection.md
index 02c05225..1f7eaec2 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher-connection.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher-connection.md
@@ -4,26 +4,50 @@ title: VoucherConnection
hide_table_of_contents: false
---
-
-Represents a paginated connection of Vouchers.
+Represents a paginated list of vouchers.
```graphql
type VoucherConnection {
+ "Total number of entries that match the query"
+ totalCount: Int!
+ "List of edges in the connection"
edges: [VoucherEdge!]!
+ "Information about the current page"
pageInfo: PageInfo!
}
```
-
## Fields
| Name | Type | Description |
-| ---- | ---- | ----------- |
-| `edges` | [`[VoucherEdge!]!`](../../objects/voucher-edge) | A list of `VoucherEdge` objects. Each edge contains a `Voucher` object and a cursor for pagination. |
-| `pageInfo` | [`PageInfo!`](../../objects/page-info) | Pagination metadata. |
-
-
-
-
+| ---- |------| ----------- |
+| `totalCount` | [`Int!`](../../scalars/int) | Total number of entries that match the query. |
+| `edges` | [`[VoucherEdge!]!`](../../objects/voucher-edge) | List of edges in the connection. |
+| `pageInfo` | [`PageInfo!`](../../objects/page-info) | Information about the current page. |
+## Example Query
+```graphql
+query {
+ vouchers(first: 10) {
+ totalCount
+ edges {
+ node {
+ index
+ destination
+ payload
+ value
+ executed
+ transactionHash
+ }
+ cursor
+ }
+ pageInfo {
+ hasNextPage
+ hasPreviousPage
+ startCursor
+ endCursor
+ }
+ }
+}
+```
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher-edge.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher-edge.md
index 99d42d30..0e5a8e8a 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher-edge.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher-edge.md
@@ -4,26 +4,40 @@ title: VoucherEdge
hide_table_of_contents: false
---
-
-Pagination entry.
+Represents a single voucher in a paginated list.
```graphql
type VoucherEdge {
+ "The voucher at this edge"
node: Voucher!
+ "A cursor for use in pagination"
cursor: String!
}
```
-
## Fields
| Name | Type | Description |
-| ---- | ---- | ----------- |
-| `node` | [`Voucher!`](../../objects/voucher) | The `Voucher` object. |
-| `cursor` | [`String!`](../../scalars/string) | A string that serves as a pagination cursor for this particular edge. |
-
-
-
-
+| ---- |------| ----------- |
+| `node` | [`Voucher!`](../../objects/voucher) | The voucher at this edge. |
+| `cursor` | [`String!`](../../scalars/string) | A cursor for use in pagination. |
+## Example Query
+```graphql
+query {
+ vouchers(first: 10) {
+ edges {
+ node {
+ index
+ destination
+ payload
+ value
+ executed
+ transactionHash
+ }
+ cursor
+ }
+ }
+}
+```
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher.md
index 6713e671..b2959d38 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/objects/voucher.md
@@ -4,30 +4,67 @@ title: Voucher
hide_table_of_contents: false
---
-
Representation of a transaction that can be carried out on the base layer blockchain, such as a transfer of assets.
```graphql
type Voucher {
+ "Voucher index within the context of the input that produced it"
index: Int!
+ "Input whose processing produced the voucher"
input: Input!
+ "Transaction destination address in Ethereum hex binary format (20 bytes), starting with '0x'"
destination: String!
+ "Transaction payload in Ethereum hex binary format, starting with '0x'"
payload: String!
+ "Proof object that allows this voucher to be validated and executed on the base layer blockchain"
proof: Proof
+ "Value to be sent with the transaction"
+ value: BigInt
+ "Indicates whether the voucher has been executed on the base layer blockchain"
+ executed: Boolean
+ "The hash of executed transaction"
+ transactionHash: String
+ "The application that produced the voucher"
+ application: Application!
}
```
-
## Fields
| Name | Type | Description |
| ---- |------| ----------- |
-| `index`| [`Int!`](../../scalars/int) | Unique identifier for the voucher. |
-| `input`| [`Input!`](../../objects/input) | The input associated with this voucher. |
-| `destination`| [`String!`](../../scalars/string) | The address or identifier of the voucher's destination. |
-| `payload`| [`String!`](../../scalars/string) | The actual data/content of the voucher. |
-| `proof`| [`Proof`](../../objects/proof) | Proof object that allows this voucher to be validated and executed on the base layer blockchain(if available). |
-
-
+| `index` | [`Int!`](../../scalars/int) | Voucher index within the context of the input that produced it. |
+| `input` | [`Input!`](../../objects/input) | Input whose processing produced the voucher. |
+| `destination` | [`String!`](../../scalars/string) | Transaction destination address in Ethereum hex binary format (20 bytes), starting with '0x'. |
+| `payload` | [`String!`](../../scalars/string) | Transaction payload in Ethereum hex binary format, starting with '0x'. |
+| `proof` | [`Proof`](../../objects/proof) | Proof object that allows this voucher to be validated and executed on the base layer blockchain. |
+| `value` | [`BigInt`](../../scalars/bigint) | Value to be sent with the transaction. |
+| `executed` | [`Boolean`](../../scalars/boolean) | Indicates whether the voucher has been executed on the base layer blockchain. |
+| `transactionHash` | [`String`](../../scalars/string) | The hash of executed transaction. |
+| `application` | [`Application!`](../../objects/application) | The application that produced the voucher. |
+## Example Query
+```graphql
+query {
+ voucher(address: "0x123...") {
+ index
+ input {
+ index
+ }
+ destination
+ payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ value
+ executed
+ transactionHash
+ application {
+ address
+ name
+ }
+ }
+}
+```
\ No newline at end of file
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/queries/notices.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/queries/notices.md
index 92c5749a..abc5c2c8 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/queries/notices.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/queries/notices.md
@@ -11,28 +11,32 @@ Notices are informational statements that can be validated in the base layer blo
Retrieve a specific notice based on its index and associated input index.
```graphql
-query notice($noticeIndex: Int!, $inputIndex: Int!) {
- notice(noticeIndex: $noticeIndex, inputIndex: $inputIndex) {
+query notice($outputIndex: Int!) {
+ notice(outputIndex: $outputIndex) {
index
input {
+ id
index
- timestamp
+ status
msgSender
+ blockTimestamp
blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
}
payload
proof {
- validity {
- inputIndexWithinEpoch
- outputIndexWithinInput
- outputHashesRootHash
- vouchersEpochRootHash
- noticesEpochRootHash
- machineStateHash
- outputHashInOutputHashesSiblings
- outputHashesInEpochSiblings
- }
- context
+ outputIndex
+ outputHashesSiblings
+ }
+ application {
+ address
+ name
}
}
}
@@ -42,10 +46,9 @@ For notices, the API provides access to proof data that can be used for validati
### Arguments
-| Name | Type | Description |
-| ------------- | --------------------------- | ---------------------------------------------- |
-| `noticeIndex` | [`Int!`](../../scalars/int) | Index of the notice to retrieve. |
-| `inputIndex` | [`Int!`](../../scalars/int) | Index of the input associated with the notice. |
+| Name | Type | Description |
+| ------------ | --------------------------- | ---------------------------------------------- |
+| `outputIndex` | [`Int!`](../../scalars/int) | Index of the notice to retrieve. |
### Response Type
@@ -62,13 +65,35 @@ query notices {
node {
index
input {
+ id
index
- timestamp
+ status
msgSender
+ blockTimestamp
blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
}
payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ application {
+ address
+ name
+ }
}
+ cursor
+ }
+ pageInfo {
+ hasNextPage
+ endCursor
}
}
}
@@ -93,14 +118,21 @@ query noticesByInput($inputIndex: Int!) {
edges {
node {
index
- input {
- index
- timestamp
- msgSender
- blockNumber
- }
payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ application {
+ address
+ name
+ }
}
+ cursor
+ }
+ pageInfo {
+ hasNextPage
+ endCursor
}
}
}
@@ -124,15 +156,31 @@ query noticesByInput($inputIndex: Int!) {
```graphql
query {
- notice(noticeIndex: 3, inputIndex: 2) {
+ notice(outputIndex: 1) {
index
+ input {
+ id
+ index
+ status
+ msgSender
+ blockTimestamp
+ blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
+ }
payload
proof {
- validity {
- inputIndexWithinEpoch
- outputIndexWithinInput
- }
- context
+ outputIndex
+ outputHashesSiblings
+ }
+ application {
+ address
+ name
}
}
}
@@ -147,10 +195,29 @@ query {
node {
index
input {
+ id
index
- timestamp
+ status
+ msgSender
+ blockTimestamp
+ blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
}
payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ application {
+ address
+ name
+ }
}
cursor
}
@@ -172,6 +239,14 @@ query {
node {
index
payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ application {
+ address
+ name
+ }
}
cursor
}
@@ -183,3 +258,80 @@ query {
}
}
```
+
+4. Listing notices with proof data and application information:
+
+```graphql
+query {
+ notices(first: 10) {
+ edges {
+ node {
+ index
+ input {
+ id
+ index
+ status
+ msgSender
+ blockTimestamp
+ blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
+ }
+ payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ application {
+ address
+ name
+ }
+ }
+ cursor
+ }
+ pageInfo {
+ hasNextPage
+ endCursor
+ }
+ }
+}
+```
+
+5. Fetching a specific notice by output index:
+
+```graphql
+query {
+ notice(outputIndex: 1) {
+ index
+ input {
+ id
+ index
+ status
+ msgSender
+ blockTimestamp
+ blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
+ }
+ payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ application {
+ address
+ name
+ }
+ }
+}
+```
\ No newline at end of file
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/queries/vouchers.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/queries/vouchers.md
index 9e4e2560..c5bbf344 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/queries/vouchers.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/graphql/queries/vouchers.md
@@ -12,29 +12,36 @@ Vouchers represent transactions that can be carried out on the base layer blockc
Retrieve a specific voucher based on its index and associated input index.
```graphql
-query voucher($voucherIndex: Int!, $inputIndex: Int!) {
- voucher(voucherIndex: $voucherIndex, inputIndex: $inputIndex) {
+query voucher($outputIndex: Int!) {
+ voucher(outputIndex: $outputIndex) {
index
input {
+ id
index
- timestamp
+ status
msgSender
+ blockTimestamp
blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
}
destination
payload
proof {
- validity {
- inputIndexWithinEpoch
- outputIndexWithinInput
- outputHashesRootHash
- vouchersEpochRootHash
- noticesEpochRootHash
- machineStateHash
- outputHashInOutputHashesSiblings
- outputHashesInEpochSiblings
- }
- context
+ outputIndex
+ outputHashesSiblings
+ }
+ value
+ executed
+ transactionHash
+ application {
+ address
+ name
}
}
}
@@ -45,8 +52,7 @@ For vouchers, the API provides access to proof data that can be used for validat
| Name | Type | Description |
| ---- | ---- | ----------- |
-| `voucherIndex` | [`Int!`](../../scalars/int) | The index of the voucher to retrieve. |
-| `inputIndex` | [`Int!`](../../scalars/int) | The index of the associated input. |
+| `outputIndex` | [`Int!`](../../scalars/int) | The index of the voucher to retrieve. |
@@ -66,13 +72,33 @@ query vouchers($first: Int, $after: String) {
node {
index
input {
+ id
index
- timestamp
+ status
msgSender
+ blockTimestamp
blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
}
destination
payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ value
+ executed
+ transactionHash
+ application {
+ address
+ name
+ }
}
cursor
}
@@ -110,6 +136,17 @@ query vouchersByInput($inputIndex: Int!, $first: Int, $after: String) {
index
destination
payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ value
+ executed
+ transactionHash
+ application {
+ address
+ name
+ }
}
cursor
}
@@ -141,20 +178,39 @@ query vouchersByInput($inputIndex: Int!, $first: Int, $after: String) {
1. Fetching a specific voucher:
```graphql
- query {
- voucher(voucherIndex: 3, inputIndex: 2) {
+ query {
+ voucher(outputIndex: 1) {
+ index
+ input {
+ id
index
- destination
+ status
+ msgSender
+ blockTimestamp
+ blockNumber
payload
- proof {
- validity {
- inputIndexWithinEpoch
- outputIndexWithinInput
- }
- context
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
}
}
+ destination
+ payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ value
+ executed
+ transactionHash
+ application {
+ address
+ name
+ }
}
+ }
```
2. Listing earlier(first 5) vouchers:
@@ -166,11 +222,33 @@ query vouchersByInput($inputIndex: Int!, $first: Int, $after: String) {
node {
index
input {
+ id
index
- timestamp
+ status
+ msgSender
+ blockTimestamp
+ blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
}
destination
payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ value
+ executed
+ transactionHash
+ application {
+ address
+ name
+ }
}
cursor
}
@@ -193,6 +271,17 @@ query vouchersByInput($inputIndex: Int!, $first: Int, $after: String) {
index
destination
payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ value
+ executed
+ transactionHash
+ application {
+ address
+ name
+ }
}
cursor
}
@@ -203,4 +292,88 @@ query vouchersByInput($inputIndex: Int!, $first: Int, $after: String) {
}
}
}
+ ```
+
+4. Listing all vouchers with proof data:
+
+ ```graphql
+ query {
+ vouchers(first: 10) {
+ edges {
+ node {
+ index
+ input {
+ id
+ index
+ status
+ msgSender
+ blockTimestamp
+ blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
+ }
+ destination
+ payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ value
+ executed
+ transactionHash
+ application {
+ address
+ name
+ }
+ }
+ }
+ pageInfo {
+ hasNextPage
+ endCursor
+ }
+ }
+ }
+ ```
+
+5. Fetching a specific voucher by output index:
+
+ ```graphql
+ query {
+ voucher(outputIndex: 1) {
+ index
+ input {
+ id
+ index
+ status
+ msgSender
+ blockTimestamp
+ blockNumber
+ payload
+ inputBoxIndex
+ prevRandao
+ application {
+ address
+ name
+ }
+ }
+ destination
+ payload
+ proof {
+ outputIndex
+ outputHashesSiblings
+ }
+ value
+ executed
+ transactionHash
+ application {
+ address
+ name
+ }
+ }
+ }
```
\ No newline at end of file
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/index.md b/cartesi-rollups_versioned_docs/version-2.0/api-reference/index.md
index f4f4a67d..21839187 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/index.md
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/index.md
@@ -12,7 +12,7 @@ resources:
In a Cartesi dApp, the frontend and backend components communicate through the Rollups framework using HTTP and GraphQL APIs.
-When designing the APIs for this communication with the framework, we wanted to ensure developers could create their applications without worrying too much about the low-level components of Cartesi Rollups.
+When designing the APIs for this communication framework, we aimed to ensure that developers could create their applications without excessive concern about the low-level components of Cartesi Rollups.
## Backend APIs
@@ -20,30 +20,29 @@ In a typical Cartesi dApp, the backend contains the application's state and veri
The dApp's backend interacts with the Cartesi Rollups framework by retrieving processing requests and submitting corresponding outputs.
-This is accomplished by calling a set of HTTP endpoints, as illustrated by the figure below:
+This interaction occurs through a set of HTTP endpoints, as illustrated in the figure below:
-You can send two requests to an application depending on whether you want to change or read the state.
+You can send two types of requests to an application depending on whether you want to change or read the state:
-- **Advance**: In this request, any input data changes the state of the dApp.
-
-- **Inspect**: This involves making an external HTTP API call to the Cartesi Node to read the dApp state without changing it.
+- **Advance**: With this request, input data changes the state of the dApp.
+- **Inspect**: This involves making an external HTTP API call to the Cartesi Node to read the dApp state without modifying it.
## Base Layer Contracts
The frontend component of the dApp needs to access the Cartesi Rollups framework to submit user requests and retrieve the corresponding outputs produced by the backend.
-The figure below details some of the main use cases for these interactions:
+The figure below illustrates the main use cases for these interactions:
-- [`addInput()`](./json-rpc/input-box.md/#addinput) — This function submits input data to the InputBox smart contract on the base layer as a regular JSON-RPC blockchain transaction. When that transaction is mined and executed, an event containing the submitted input’s index is emitted, which the frontend can later use to query associated outputs.
+- [`addInput()`](./contracts/input-box/#addinput) — This function submits input data to the InputBox smart contract on the base layer as a regular JSON-RPC blockchain transaction. When the transaction is mined and executed, it emits an event containing the submitted input's index, which the frontend can later use to query associated outputs.
-- [`executeVoucher()`](./json-rpc/application.md/#executevoucher) — Submits a JSON-RPC blockchain transaction to request that a given voucher or notice be executed by the [`CartesiDApp`](./json-rpc/application.md) smart contract on the base layer. Vouchers can only be executed when an epoch is closed.
+- [`executeOutput()`](./contracts/application/#executeoutput) — Submits a JSON-RPC blockchain transaction to request the execution of a given voucher or notice by the [`Application`](./contracts/application.md) smart contract on the base layer. Vouchers can only be executed when an epoch is closed.
-- Query outputs — You can submit a query to a Cartesi node to retrieve vouchers, notices, and reports, as specified by the Cartesi Rollups GraphQL schema.
+- Query outputs — You can submit a query to a Cartesi node to retrieve vouchers, notices, and reports as specified by the Cartesi Rollups GraphQL schema.
- Inspect state — You can make an HTTP call to the Cartesi node to retrieve arbitrary dApp-specific application state.
diff --git a/cartesi-rollups_versioned_docs/version-2.0/api-reference/inspect/inspect-state-http-api-for-cartesi-rollups.info.mdx b/cartesi-rollups_versioned_docs/version-2.0/api-reference/inspect/inspect-state-http-api-for-cartesi-rollups.info.mdx
index 74658efc..f8b37435 100644
--- a/cartesi-rollups_versioned_docs/version-2.0/api-reference/inspect/inspect-state-http-api-for-cartesi-rollups.info.mdx
+++ b/cartesi-rollups_versioned_docs/version-2.0/api-reference/inspect/inspect-state-http-api-for-cartesi-rollups.info.mdx
@@ -9,18 +9,40 @@ custom_edit_url: null
---
import ApiLogo from "@theme/ApiLogo";
+import Heading from "@theme/Heading";
import SchemaTabs from "@theme/SchemaTabs";
import TabItem from "@theme/TabItem";
-import Export from "@theme/ApiDemoPanel/Export";
+import Export from "@theme/ApiExplorer/Export";
-