envio 3.0.0-alpha.0 → 3.0.0-alpha.10

package/README.md

@@ -14,11 +14,11 @@ HyperIndex is a fast, developer-friendly multichain indexer, optimized for both
 - **[Indexer auto-generation](https://docs.envio.dev/docs/HyperIndex/contract-import)** – Generate Indexers directly from smart contract addresses
 - **High performance** – Historical backfills at over 10,000+ events per second ([fastest in market](https://docs.envio.dev/blog/indexer-benchmarking-results))
 - **Local development** – Full-featured local environment with Docker
-- **[Multichain indexing](https://docs.envio.dev/docs/HyperIndex/multichain-indexing)** – Index any EVM-compatible blockchain and Fuel (simultaneously)
+- **[Multichain indexing](https://docs.envio.dev/docs/HyperIndex/multichain-indexing)** – Index any EVM-, SVM-, or Fuel-compatible blockchain
 - **Real-time indexing** – Instantly track blockchain events
 - **[Reorg support](https://docs.envio.dev/docs/HyperIndex/reorgs-support)** – Graceful handling of blockchain reorganizations
 - **GraphQL API** – Easy-to-query indexed data
-- **Flexible language support** – JavaScript, TypeScript, and ReScript
+- **Flexible language support** – TypeScript, JavaScript, and ReScript
 - **Factory contract support** – Index data from 1M+ dynamically registered contracts seamlessly
 - **On-chain & off-chain data integration** – Easily combine multiple data sources
 - **[Self-hosted & managed options](https://docs.envio.dev/docs/HyperIndex/hosted-service)** – Run your own setup or use HyperIndex hosted services

package/evm.schema.json

@@ -15,17 +15,6 @@
       "description": "Name of the project",
       "type": "string"
     },
-    "ecosystem": {
-      "description": "Ecosystem of the project.",
-      "anyOf": [
-        {
-          "$ref": "#/$defs/EcosystemTag"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
     "schema": {
       "description": "Custom path to schema.graphql file",
       "type": [
@@ -40,6 +29,33 @@
         "null"
       ]
     },
+    "handlers": {
+      "description": "Optional relative path to handlers directory for auto-loading. Defaults to 'src/handlers' if not specified.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "full_batch_size": {
+      "description": "Target number of events to be processed per batch. Set it to smaller number if you have many Effect API calls which are slow to resolve and can't be batched. (Default: 5000)",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0
+    },
+    "ecosystem": {
+      "description": "Ecosystem of the project.",
+      "anyOf": [
+        {
+          "$ref": "#/$defs/EcosystemTag"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
     "contracts": {
       "description": "Global contract definitions that must contain all definitions except addresses. You can share a single handler/abi/event definitions for contracts across multiple chains.",
       "type": [
@@ -50,25 +66,18 @@
         "$ref": "#/$defs/GlobalContract_for_ContractConfig"
       }
     },
-    "networks": {
-      "description": "Configuration of the blockchain networks that the project is deployed on.",
+    "chains": {
+      "description": "Configuration of the blockchain chains that the project is deployed on.",
       "type": "array",
       "items": {
-        "$ref": "#/$defs/Network"
+        "$ref": "#/$defs/Chain"
       }
     },
-    "unordered_multichain_mode": {
-      "description": "A flag to indicate if the indexer should use a single queue for all chains or a queue per chain (default: false)",
-      "type": [
-        "boolean",
-        "null"
-      ]
-    },
-    "event_decoder": {
-      "description": "The event decoder to use for the indexer (default: hypersync-client)",
+    "multichain": {
+      "description": "Multichain mode: 'ordered' processes events across chains in order, 'unordered' processes chain events in order, but non-deterministically relatively to other chains (default: unordered)",
       "anyOf": [
         {
-          "$ref": "#/$defs/EventDecoder"
+          "$ref": "#/$defs/Multichain"
         },
         {
           "type": "null"
@@ -107,13 +116,6 @@
         "null"
       ]
     },
-    "preload_handlers": {
-      "description": "Makes handlers run twice to enable preload optimisations. Removes handlerWithLoader API, since it's not needed. (recommended, default: false)",
-      "type": [
-        "boolean",
-        "null"
-      ]
-    },
     "address_format": {
       "description": "Address format for Ethereum addresses: 'checksum' or 'lowercase' (default: checksum)",
       "anyOf": [
@@ -124,19 +126,12 @@
           "type": "null"
         }
       ]
-    },
-    "handlers": {
-      "description": "Optional relative path to handlers directory for auto-loading. Defaults to 'src/handlers' if not specified.",
-      "type": [
-        "string",
-        "null"
-      ]
     }
   },
   "additionalProperties": false,
   "required": [
     "name",
-    "networks"
+    "chains"
   ],
   "$defs": {
     "EcosystemTag": {
@@ -262,7 +257,6 @@
         "root",
         "status",
         "yParity",
-        "chainId",
         "accessList",
         "maxFeePerBlobGas",
         "blobVersionedHashes",
@@ -304,17 +298,17 @@
         "mixHash"
       ]
     },
-    "Network": {
+    "Chain": {
       "type": "object",
       "properties": {
         "id": {
-          "description": "The public blockchain network ID.",
+          "description": "The public blockchain chain ID.",
           "type": "integer",
           "format": "uint64",
           "minimum": 0
         },
         "rpc_config": {
-          "description": "RPC configuration for utilizing as the network's data-source. Typically optional for chains with HyperSync support, which is highly recommended. HyperSync dramatically enhances performance, providing up to a 1000x speed boost over traditional RPC.",
+          "description": "RPC configuration for utilizing as the chain's data-source. Typically optional for chains with HyperSync support, which is highly recommended. HyperSync dramatically enhances performance, providing up to a 1000x speed boost over traditional RPC.",
           "anyOf": [
             {
               "$ref": "#/$defs/RpcConfig"
@@ -325,10 +319,10 @@
           ]
         },
         "rpc": {
-          "description": "RPC configuration for your indexer. If not specified otherwise, for networks supported by HyperSync, RPC serves as a fallback for added reliability. For others, it acts as the primary data-source. HyperSync offers significant performance improvements, up to a 1000x faster than traditional RPC.",
+          "description": "RPC configuration for your indexer. If not specified otherwise, for chains supported by HyperSync, RPC serves as a fallback for added reliability. For others, it acts as the primary data-source. HyperSync offers significant performance improvements, up to a 1000x faster than traditional RPC.",
           "anyOf": [
             {
-              "$ref": "#/$defs/NetworkRpc"
+              "$ref": "#/$defs/RpcSelection"
             },
             {
               "type": "null"
@@ -346,7 +340,7 @@
             }
           ]
         },
-        "confirmed_block_threshold": {
+        "max_reorg_depth": {
           "description": "The number of blocks from the head that the indexer should account for in case of reorgs.",
           "type": [
             "integer",
@@ -370,18 +364,20 @@
           "minimum": 0
         },
         "contracts": {
-          "description": "All the contracts that should be indexed on the given network",
-          "type": "array",
+          "description": "All the contracts that should be indexed on the given chain",
+          "type": [
+            "array",
+            "null"
+          ],
           "items": {
-            "$ref": "#/$defs/NetworkContract_for_ContractConfig"
+            "$ref": "#/$defs/ChainContract_for_ContractConfig"
           }
         }
       },
       "additionalProperties": false,
       "required": [
         "id",
-        "start_block",
-        "contracts"
+        "start_block"
       ]
     },
     "RpcConfig": {
@@ -469,7 +465,7 @@
         "url"
       ]
     },
-    "NetworkRpc": {
+    "RpcSelection": {
       "anyOf": [
         {
           "type": "string"
@@ -597,7 +593,7 @@
         "url"
       ]
     },
-    "NetworkContract_for_ContractConfig": {
+    "ChainContract_for_ContractConfig": {
       "type": "object",
       "properties": {
         "name": {
@@ -609,7 +605,7 @@
           "$ref": "#/$defs/Addresses"
         },
         "start_block": {
-          "description": "The block at which the indexer should start ingesting data for this specific contract. If not specified, uses the network start_block. Can be greater than the network start_block for more specific indexing.",
+          "description": "The block at which the indexer should start ingesting data for this specific contract. If not specified, uses the chain start_block. Can be greater than the chain start_block for more specific indexing.",
           "type": [
             "integer",
             "null"
@@ -675,11 +671,11 @@
         }
       ]
     },
-    "EventDecoder": {
+    "Multichain": {
       "type": "string",
       "enum": [
-        "viem",
-        "hypersync-client"
+        "ordered",
+        "unordered"
       ]
     },
     "AddressFormat": {

package/fuel.schema.json

@@ -15,10 +15,6 @@
       "description": "Name of the project",
       "type": "string"
     },
-    "ecosystem": {
-      "description": "Ecosystem of the project.",
-      "$ref": "#/$defs/EcosystemTag"
-    },
     "schema": {
       "description": "Custom path to schema.graphql file",
       "type": [
@@ -33,6 +29,26 @@
         "null"
       ]
     },
+    "handlers": {
+      "description": "Optional relative path to handlers directory for auto-loading. Defaults to 'src/handlers' if not specified.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "full_batch_size": {
+      "description": "Target number of events to be processed per batch. Set it to smaller number if you have many Effect API calls which are slow to resolve and can't be batched. (Default: 5000)",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0
+    },
+    "ecosystem": {
+      "description": "Ecosystem of the project.",
+      "$ref": "#/$defs/EcosystemTag"
+    },
     "contracts": {
       "description": "Global contract definitions that must contain all definitions except addresses. You can share a single handler/abi/event definitions for contracts across multiple chains.",
       "type": [
@@ -43,11 +59,11 @@
         "$ref": "#/$defs/GlobalContract_for_ContractConfig"
       }
     },
-    "networks": {
-      "description": "Configuration of the blockchain networks that the project is deployed on.",
+    "chains": {
+      "description": "Configuration of the blockchain chains that the project is deployed on.",
       "type": "array",
       "items": {
-        "$ref": "#/$defs/Network"
+        "$ref": "#/$defs/Chain"
       }
     },
     "raw_events": {
@@ -56,27 +72,13 @@
         "boolean",
         "null"
       ]
-    },
-    "preload_handlers": {
-      "description": "Makes handlers run twice to enable preload optimisations. Removes handlerWithLoader API, since it's not needed. (recommended, default: false)",
-      "type": [
-        "boolean",
-        "null"
-      ]
-    },
-    "handlers": {
-      "description": "Optional relative path to handlers directory for auto-loading. Defaults to 'src/handlers' if not specified.",
-      "type": [
-        "string",
-        "null"
-      ]
     }
   },
   "additionalProperties": false,
   "required": [
     "name",
     "ecosystem",
-    "networks"
+    "chains"
   ],
   "$defs": {
     "EcosystemTag": {
@@ -159,11 +161,11 @@
         "call"
       ]
     },
-    "Network": {
+    "Chain": {
       "type": "object",
       "properties": {
         "id": {
-          "description": "Public chain/network id",
+          "description": "Public chain id",
           "type": "integer",
           "format": "uint64",
           "minimum": 0
@@ -195,18 +197,20 @@
           ]
         },
         "contracts": {
-          "description": "All the contracts that should be indexed on the given network",
-          "type": "array",
+          "description": "All the contracts that should be indexed on the given chain",
+          "type": [
+            "array",
+            "null"
+          ],
           "items": {
-            "$ref": "#/$defs/NetworkContract_for_ContractConfig"
+            "$ref": "#/$defs/ChainContract_for_ContractConfig"
           }
         }
       },
       "additionalProperties": false,
       "required": [
         "id",
-        "start_block",
-        "contracts"
+        "start_block"
       ]
     },
     "HyperfuelConfig": {
@@ -222,7 +226,7 @@
         "url"
       ]
     },
-    "NetworkContract_for_ContractConfig": {
+    "ChainContract_for_ContractConfig": {
       "type": "object",
       "properties": {
         "name": {
@@ -234,7 +238,7 @@
           "$ref": "#/$defs/Addresses"
         },
         "start_block": {
-          "description": "The block at which the indexer should start ingesting data for this specific contract. If not specified, uses the network start_block. Can be greater than the network start_block for more specific indexing.",
+          "description": "The block at which the indexer should start ingesting data for this specific contract. If not specified, uses the chain start_block. Can be greater than the chain start_block for more specific indexing.",
           "type": [
             "integer",
             "null"