envio 3.5.0-alpha.1 → 3.5.0-alpha.3

package/src/sources/HyperSync.resi

@@ -34,7 +34,7 @@ module GetLogs: {
     ~toBlock: option<int>,
     ~maxNumLogs: option<int>,
     ~registrationIndexes: array<int>,
-    ~addressesByContractName: dict<array<Address.t>>,
+    ~addressSet: AddressSet.t,
     ~clientFilteredContracts: option<array<string>>,
   ) => promise<logsQueryPage>
 }

package/src/sources/HyperSyncClient.res

@@ -302,9 +302,9 @@ module Registration = {
 }
 
 module EventItems = {
-  // The whole per-query input: block range, the partition's registration
-  // selection (by id), and its current addresses. Log selections, field
-  // selection, and the routing index are derived on the Rust side.
+  // The whole per-query input beside the partition's address set: block range
+  // and the registration selection (by id). Log selections, field selection,
+  // and the routing index are derived on the Rust side.
   type query = {
     fromBlock: int,
     // Inclusive; None queries to the end of available data.
@@ -312,7 +312,6 @@ module EventItems = {
     // Absent means no server-side cap on the number of logs returned.
     maxNumLogs?: int,
     registrationIndexes: array<int>,
-    addressesByContractName: dict<array<Address.t>>,
     // Contract names to fetch address-free even though their registrations
     // depend on addresses (client-side filtering). None/empty means
     // every address-dependent contract is filtered server-side.
@@ -345,7 +344,9 @@ module EventItems = {
   type response = {
     archiveHeight: option<int>,
     nextBlock: int,
-    // One header per block number referenced by `items`.
+    // One header per returned block number, including blocks no item
+    // references — reorg detection reads them all. The block store keeps only
+    // the ones items reference.
     blocks: array<blockHeader>,
     items: array<item>,
     rollbackGuard: option<ResponseTypes.rollbackGuard>,
@@ -358,16 +359,22 @@ type t = {
   // and blocks.
   getEventItems: (
     ~query: EventItems.query,
+    ~addressSet: AddressSet.t,
   ) => promise<(EventItems.response, TransactionStore.t, BlockStore.t)>,
   getHeight: unit => promise<int>,
 }
 
 @send
-external classNew: (Core.evmHyperSyncClientCtor, cfg, string, array<Registration.input>) => t =
-  "new"
+external classNew: (
+  Core.evmHyperSyncClientCtor,
+  cfg,
+  string,
+  array<Registration.input>,
+  AddressStore.t,
+) => t = "new"
 
-let makeWithAgent = (cfg, ~userAgent, ~eventRegistrations) =>
-  Core.getAddon().evmHyperSyncClient->classNew(cfg, userAgent, eventRegistrations)
+let makeWithAgent = (cfg, ~userAgent, ~eventRegistrations, ~addressStore) =>
+  Core.getAddon().evmHyperSyncClient->classNew(cfg, userAgent, eventRegistrations, addressStore)
 
 type logLevel = [#trace | #debug | #info | #warn | #error]
 let logLevelSchema: S.t<logLevel> = S.enum([#trace, #debug, #info, #warn, #error])
@@ -393,6 +400,7 @@ let make = (
   ~retryBackoffMs=?,
   ~retryCeilingMs=?,
   ~logLevel=#info,
+  ~addressStore,
 ) => {
   let envioVersion = Utils.EnvioPackage.value.version
   makeWithAgent(
@@ -412,5 +420,6 @@ let make = (
     },
     ~userAgent=`hyperindex/${envioVersion}`,
     ~eventRegistrations,
+    ~addressStore,
   )
 }

package/src/sources/HyperSyncClient.res.mjs

@@ -73,8 +73,8 @@ let Registration = {
 
 let EventItems = {};
 
-function makeWithAgent(cfg, userAgent, eventRegistrations) {
-  return Core.getAddon().EvmHyperSyncClient.new(cfg, userAgent, eventRegistrations);
+function makeWithAgent(cfg, userAgent, eventRegistrations, addressStore) {
+  return Core.getAddon().EvmHyperSyncClient.new(cfg, userAgent, eventRegistrations, addressStore);
 }
 
 let logLevelSchema = S$RescriptSchema.$$enum([
@@ -99,7 +99,7 @@ function logLevelToString(level) {
   }
 }
 
-function make(url, apiToken, httpReqTimeoutMillis, eventRegistrations, enableChecksumAddressesOpt, serializationFormat, enableQueryCaching, retryBaseMs, retryBackoffMs, retryCeilingMs, logLevelOpt) {
+function make(url, apiToken, httpReqTimeoutMillis, eventRegistrations, enableChecksumAddressesOpt, serializationFormat, enableQueryCaching, retryBaseMs, retryBackoffMs, retryCeilingMs, logLevelOpt, addressStore) {
   let enableChecksumAddresses = enableChecksumAddressesOpt !== undefined ? enableChecksumAddressesOpt : true;
   let logLevel = logLevelOpt !== undefined ? logLevelOpt : "info";
   let envioVersion = Utils.EnvioPackage.value.version;
@@ -115,7 +115,7 @@ function make(url, apiToken, httpReqTimeoutMillis, eventRegistrations, enableChe
     serializationFormat: serializationFormat,
     enableQueryCaching: enableQueryCaching,
     logLevel: logLevelToString(logLevel)
-  }, `hyperindex/` + envioVersion, eventRegistrations);
+  }, `hyperindex/` + envioVersion, eventRegistrations, addressStore);
 }
 
 export {

package/src/sources/RpcSource.res

@@ -617,6 +617,8 @@ type options = {
   // The chain's registrations, indexed by their sequential `index`.
   onEventRegistrations: array<Internal.evmOnEventRegistration>,
   lowercaseAddresses: bool,
+  // The chain's address index; the client reads it while routing.
+  addressStore: AddressStore.t,
   ws?: string,
   headers?: dict<string>,
 }
@@ -629,6 +631,7 @@ let make = (
     chain,
     onEventRegistrations,
     lowercaseAddresses,
+    addressStore,
     ?ws,
     ?headers,
   }: options,
@@ -650,6 +653,7 @@ let make = (
     ~checksumAddresses=!lowercaseAddresses,
     ~syncConfig,
     ~headers?,
+    ~addressStore,
   )
 
   // Requests are made from shared, memoized loaders, so they can't be
@@ -796,8 +800,7 @@ let make = (
   let getItemsOrThrow = async (
     ~fromBlock,
     ~toBlock,
-    ~addressesByContractName,
-    ~contractNameByAddress as _,
+    ~addressSet,
     ~knownHeight,
     ~partitionId,
     ~selection: FetchState.selection,
@@ -830,14 +833,16 @@ let make = (
       )
     }
 
-    let {items, toBlock: queriedToBlock, requestStats} = try await rpcClient.getNextPage({
-      fromBlock,
-      toBlockCeiling: toBlock,
-      partitionId,
-      registrationIndexes: selection.onEventRegistrations->Array.map(reg => reg.index),
-      addressesByContractName,
-      clientFilteredContracts: selection.clientFilteredContracts,
-    }) catch {
+    let {items, toBlock: queriedToBlock, requestStats} = try await rpcClient.getNextPage(
+      {
+        fromBlock,
+        toBlockCeiling: toBlock,
+        partitionId,
+        registrationIndexes: selection.onEventRegistrations->Array.map(reg => reg.index),
+        clientFilteredContracts: selection.clientFilteredContracts,
+      },
+      addressSet,
+    ) catch {
     | exn =>
       switch exn->parseGetNextPageRetryError {
       | Some((attemptedToBlock, retry, requestStats)) =>

package/src/sources/RpcSource.res.mjs

@@ -734,7 +734,7 @@ function make(param) {
   let urlHost = host !== undefined ? host : Stdlib_JsError.throwWithMessage(`The RPC url for chain ` + chain.toString() + ` is in incorrect format. The RPC url needs to start with either http:// or https://`);
   let name = `RPC (` + urlHost + `)`;
   let client = Rpc.makeClient(url, headers);
-  let rpcClient = EvmRpcClient.make(url, !lowercaseAddresses, syncConfig, undefined, headers, HyperSyncClient.Registration.fromOnEventRegistrations(onEventRegistrations));
+  let rpcClient = EvmRpcClient.make(url, !lowercaseAddresses, syncConfig, undefined, headers, HyperSyncClient.Registration.fromOnEventRegistrations(onEventRegistrations), param.addressStore);
   let pendingRequestStats = [];
   let recordRequest = (method, seconds) => {
     pendingRequestStats.push({
@@ -820,7 +820,7 @@ function make(param) {
       Error: new Error()
     };
   }, lowercaseAddresses);
-  let getItemsOrThrow = async (fromBlock, toBlock, addressesByContractName, param, knownHeight, partitionId, selection, param$1, retry, param$2) => {
+  let getItemsOrThrow = async (fromBlock, toBlock, addressSet, knownHeight, partitionId, selection, param, retry, param$1) => {
     let startFetchingBatchTimeRef = Performance.now();
     let toBlock$1 = toBlock !== undefined ? Primitive_int.min(toBlock, knownHeight) : knownHeight;
     let firstBlockParentPromise = fromBlock > 0 ? LazyLoader.get(blockLoader.contents, fromBlock - 1 | 0).then(json => parseBlockInfo(json)) : Promise.resolve(undefined);
@@ -841,9 +841,8 @@ function make(param) {
         toBlockCeiling: toBlock$1,
         partitionId: partitionId,
         registrationIndexes: selection.onEventRegistrations.map(reg => reg.index),
-        addressesByContractName: addressesByContractName,
         clientFilteredContracts: selection.clientFilteredContracts
-      });
+      }, addressSet);
     } catch (raw_exn) {
       let exn = Primitive_exceptions.internalToException(raw_exn);
       let match$1 = parseGetNextPageRetryError(exn);

package/src/sources/SimulateSource.res

@@ -18,8 +18,7 @@ let make = (~items: array<Internal.item>, ~endBlock: int, ~chain: ChainMap.Chain
     getItemsOrThrow: (
       ~fromBlock,
       ~toBlock,
-      ~addressesByContractName as _,
-      ~contractNameByAddress,
+      ~addressSet,
       ~knownHeight as _,
       ~partitionId as _,
       ~selection: FetchState.selection,
@@ -28,11 +27,11 @@ let make = (~items: array<Internal.item>, ~endBlock: int, ~chain: ChainMap.Chain
       ~logger as _,
     ) => {
       // Mirror a real backend: return only the items this query would match —
-      // in the block range, part of the selection, and (for non-wildcard events)
-      // emitted by an address the partition is querying. Wildcard events are
-      // over-fetched regardless of srcAddress, leaving the client-side address
-      // filter to gate them exactly as it does for a HyperSync response. Overlapping
-      // queries may return the same item more than once; the buffer dedups it.
+      // in the block range, part of the selection, and passing the same address
+      // gates a real source applies natively while routing (the emitter must be
+      // registered for the event's contract at or before the item's block, and
+      // any address-valued param filter must hold). Overlapping queries may
+      // return the same item more than once; the buffer dedups it.
       let toBlockQueried = switch toBlock {
       | Some(toBlock) => toBlock
       | None => reportedHeight
@@ -49,11 +48,27 @@ let make = (~items: array<Internal.item>, ~endBlock: int, ~chain: ChainMap.Chain
           false
         } else if !(selectionEventIds->Utils.Set.has(onEventRegistration.eventConfig.id)) {
           false
-        } else if onEventRegistration.isWildcard {
-          true
         } else {
-          let sa = eventItem.payload->Internal.getPayloadSrcAddress->Address.toString
-          contractNameByAddress->Utils.Dict.dangerouslyGetNonOption(sa)->Option.isSome
+          let contractName = onEventRegistration.eventConfig.contractName
+          let emitterAllowed =
+            onEventRegistration.isWildcard ||
+              addressSet->AddressSet.has(
+                eventItem.payload->Internal.getPayloadSrcAddress,
+                contractName,
+                blockNumber,
+              )
+          emitterAllowed &&
+          switch onEventRegistration.addressFilterParamGroups {
+          | None
+          | Some([]) => true
+          | Some(groups) =>
+            let params = eventItem.payload->Internal.getPayloadAddressParams
+            groups->Array.some(group =>
+              group->Array.every(name =>
+                addressSet->AddressSet.has(params->Dict.getUnsafe(name), contractName, blockNumber)
+              )
+            )
+          }
         }
       })
 

package/src/sources/SimulateSource.res.mjs

@@ -1,7 +1,6 @@
 // Generated by ReScript, PLEASE EDIT WITH CARE
 
 import * as Primitive_int from "@rescript/runtime/lib/es6/Primitive_int.js";
-import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
 
 function make(items, endBlock, chain) {
   let reportedHeight = Primitive_int.max(endBlock, 1);
@@ -22,7 +21,7 @@ function make(items, endBlock, chain) {
       height: reportedHeight,
       requestStats: []
     }),
-    getItemsOrThrow: (fromBlock, toBlock, param, contractNameByAddress, param$1, param$2, selection, param$3, param$4, param$5) => {
+    getItemsOrThrow: (fromBlock, toBlock, addressSet, param, param$1, selection, param$2, param$3, param$4) => {
       let toBlockQueried = toBlock !== undefined ? toBlock : reportedHeight;
       let selectionEventIds = new Set();
       selection.onEventRegistrations.forEach(reg => {
@@ -37,11 +36,20 @@ function make(items, endBlock, chain) {
         if (!selectionEventIds.has(onEventRegistration.eventConfig.id)) {
           return false;
         }
-        if (onEventRegistration.isWildcard) {
+        let contractName = onEventRegistration.eventConfig.contractName;
+        let emitterAllowed = onEventRegistration.isWildcard || addressSet.has(item.payload.srcAddress, contractName, blockNumber);
+        if (!emitterAllowed) {
+          return false;
+        }
+        let groups = onEventRegistration.addressFilterParamGroups;
+        if (groups === undefined) {
+          return true;
+        }
+        if (groups.length === 0) {
           return true;
         }
-        let sa = item.payload.srcAddress;
-        return Stdlib_Option.isSome(contractNameByAddress[sa]);
+        let params = item.payload.params;
+        return groups.some(group => group.every(name => addressSet.has(params[name], contractName, blockNumber)));
       });
       return Promise.resolve({
         knownHeight: reportedHeight,

package/src/sources/Source.res

@@ -73,8 +73,10 @@ type t = {
   getItemsOrThrow: (
     ~fromBlock: int,
     ~toBlock: option<int>,
-    ~addressesByContractName: dict<array<Address.t>>,
-    ~contractNameByAddress: dict<string>,
+    // The partition's slice of the chain's address index. The source hands it
+    // straight to its Rust client, which builds the query's address filter from
+    // it and gates every returned item against the chain-wide store.
+    ~addressSet: AddressSet.t,
     ~knownHeight: int,
     ~partitionId: string,
     ~selection: FetchState.selection,

package/src/sources/SourceManager.res

@@ -754,7 +754,7 @@ let executeQuery = async (
         "source": source.name,
         "fromBlock": query.fromBlock,
         "toBlock": toBlock,
-        "addresses": query.addressesByContractName->FetchState.addressesByContractNameCount,
+        "addresses": query.addresses->AddressSet.size,
         "retry": retry,
       },
     )
@@ -763,8 +763,7 @@ let executeQuery = async (
       let response = await source.getItemsOrThrow(
         ~fromBlock=query.fromBlock,
         ~toBlock,
-        ~addressesByContractName=query.addressesByContractName,
-        ~contractNameByAddress=query.addressesByContractName->FetchState.deriveContractNameByAddress,
+        ~addressSet=query.addresses,
         ~partitionId=query.partitionId,
         ~knownHeight,
         ~selection=query.selection,

package/src/sources/SourceManager.res.mjs

@@ -3,7 +3,6 @@
 import * as Utils from "../Utils.res.mjs";
 import * as Source from "./Source.res.mjs";
 import * as Logging from "../Logging.res.mjs";
-import * as FetchState from "../FetchState.res.mjs";
 import * as Performance from "../bindings/Performance.res.mjs";
 import * as ErrorHandling from "../ErrorHandling.res.mjs";
 import * as Primitive_int from "@rescript/runtime/lib/es6/Primitive_int.js";
@@ -597,11 +596,11 @@ async function executeQuery(sourceManager, query, knownHeight, isRealtime) {
       source: source.name,
       fromBlock: query.fromBlock,
       toBlock: toBlock,
-      addresses: FetchState.addressesByContractNameCount(query.addressesByContractName),
+      addresses: query.addresses.size(),
       retry: retry
     });
     try {
-      let response = await source.getItemsOrThrow(query.fromBlock, toBlock, query.addressesByContractName, FetchState.deriveContractNameByAddress(query.addressesByContractName), knownHeight, query.partitionId, query.selection, query.itemsTarget, retry, logger$2);
+      let response = await source.getItemsOrThrow(query.fromBlock, toBlock, query.addresses, knownHeight, query.partitionId, query.selection, query.itemsTarget, retry, logger$2);
       recordRequestStats(sourceState, response.requestStats);
       sourceState.lastFailedAt = undefined;
       if (response.knownHeight > sourceState.knownHeight) {

package/src/sources/Svm.res

@@ -100,8 +100,7 @@ let makeRPCSource = (~chain, ~rpc: string, ~sourceFor: Source.sourceFor=Sync): S
     getItemsOrThrow: (
       ~fromBlock as _,
       ~toBlock as _,
-      ~addressesByContractName as _,
-      ~contractNameByAddress as _,
+      ~addressSet as _,
       ~knownHeight as _,
       ~partitionId as _,
       ~selection as _,

package/src/sources/Svm.res.mjs

@@ -91,7 +91,7 @@ function makeRPCSource(chain, rpc, sourceForOpt) {
           }]
       };
     },
-    getItemsOrThrow: (param, param$1, param$2, param$3, param$4, param$5, param$6, param$7, param$8, param$9) => Stdlib_JsError.throwWithMessage("Svm does not support getting items")
+    getItemsOrThrow: (param, param$1, param$2, param$3, param$4, param$5, param$6, param$7, param$8) => Stdlib_JsError.throwWithMessage("Svm does not support getting items")
   };
 }
 

package/src/sources/SvmHyperSyncClient.res

@@ -191,7 +191,10 @@ module EventItems = {
     // Absent means no server-side cap on the number of instructions returned.
     maxNumInstructions?: int,
     registrationIndexes: array<int>,
-    addressesByContractName: dict<array<Address.t>>,
+    // Program names to fetch address-free even though their registrations
+    // depend on addresses (client-side filtering). None/empty means every
+    // address-dependent program is filtered server-side.
+    clientFilteredContracts: option<array<string>>,
   }
 
   type log = {
@@ -221,8 +224,10 @@ module EventItems = {
 
   type response = {
     nextSlot: int,
-    // One lean header per slot referenced by `items`; the full blocks live in
-    // the block store returned alongside.
+    // One lean header per returned slot, including slots no item references —
+    // reorg detection and the batch's latest timestamp read them all. The full
+    // blocks live in the block store returned alongside, which keeps only the
+    // slots items reference.
     blocks: array<ResponseTypes.block>,
     items: array<item>,
   }
@@ -240,6 +245,7 @@ type t = {
   // prep.
   getEventItems: (
     ~query: EventItems.query,
+    ~addressSet: AddressSet.t,
   ) => promise<(EventItems.response, TransactionStore.t, BlockStore.t)>,
 }
 
@@ -249,6 +255,7 @@ external classFromConfig: (
   cfg,
   string,
   array<Registration.input>,
+  AddressStore.t,
 ) => t = "fromConfig"
 
 let make = (
@@ -259,6 +266,7 @@ let make = (
   ~retryBaseMs=?,
   ~retryCeilingMs=?,
   ~eventRegistrations=[],
+  ~addressStore,
 ) => {
   let envioVersion = Utils.EnvioPackage.value.version
   Core.getAddon().svmHyperSyncClient->classFromConfig(
@@ -272,5 +280,6 @@ let make = (
     },
     `hyperindex/${envioVersion}`,
     eventRegistrations,
+    addressStore,
   )
 }

package/src/sources/SvmHyperSyncClient.res.mjs

@@ -45,7 +45,7 @@ let ResponseTypes = {};
 
 let EventItems = {};
 
-function make(url, apiToken, httpReqTimeoutMillis, maxNumRetries, retryBaseMs, retryCeilingMs, eventRegistrationsOpt) {
+function make(url, apiToken, httpReqTimeoutMillis, maxNumRetries, retryBaseMs, retryCeilingMs, eventRegistrationsOpt, addressStore) {
   let eventRegistrations = eventRegistrationsOpt !== undefined ? eventRegistrationsOpt : [];
   let envioVersion = Utils.EnvioPackage.value.version;
   return Core.getAddon().SvmHyperSyncClient.fromConfig({
@@ -55,7 +55,7 @@ function make(url, apiToken, httpReqTimeoutMillis, maxNumRetries, retryBaseMs, r
     maxNumRetries: maxNumRetries,
     retryBaseMs: retryBaseMs,
     retryCeilingMs: retryCeilingMs
-  }, `hyperindex/` + envioVersion, eventRegistrations);
+  }, `hyperindex/` + envioVersion, eventRegistrations, addressStore);
 }
 
 export {

package/src/sources/SvmHyperSyncSource.res

@@ -6,6 +6,8 @@ type options = {
   apiToken: option<string>,
   onEventRegistrations: array<Internal.svmOnEventRegistration>,
   clientTimeoutMillis: int,
+  // The chain's address index; the client reads it while routing.
+  addressStore: AddressStore.t,
 }
 
 // Synthesize a stable logIndex for an SVM instruction so the FetchState
@@ -66,7 +68,7 @@ let toSvmInstruction = (
 }
 
 let make = (
-  {chain, endpointUrl, apiToken, onEventRegistrations, clientTimeoutMillis}: options,
+  {chain, endpointUrl, apiToken, onEventRegistrations, clientTimeoutMillis, addressStore}: options,
 ): t => {
   let name = "SvmHyperSync"
 
@@ -80,13 +82,13 @@ let make = (
     ~eventRegistrations=SvmHyperSyncClient.Registration.fromOnEventRegistrations(
       onEventRegistrations,
     ),
+    ~addressStore,
   )
 
   let getItemsOrThrow = async (
     ~fromBlock,
     ~toBlock,
-    ~addressesByContractName,
-    ~contractNameByAddress as _,
+    ~addressSet,
     ~knownHeight,
     ~partitionId as _,
     ~selection: FetchState.selection,
@@ -102,10 +104,13 @@ let make = (
       toSlot: toBlock,
       maxNumInstructions: ?itemsTarget,
       registrationIndexes: selection.onEventRegistrations->Array.map(reg => reg.index),
-      addressesByContractName,
+      clientFilteredContracts: selection.clientFilteredContracts,
     }
 
-    let (resp, transactionStore, blockStore) = try await client.getEventItems(~query) catch {
+    let (resp, transactionStore, blockStore) = try await client.getEventItems(
+      ~query,
+      ~addressSet,
+    ) catch {
     | exn =>
       throw(
         Source.GetItemsError(

package/src/sources/SvmHyperSyncSource.res.mjs

@@ -58,21 +58,22 @@ function toSvmInstruction(item, programName, instructionName) {
 function make(param) {
   let onEventRegistrations = param.onEventRegistrations;
   let chain = param.chain;
-  let client = SvmHyperSyncClient.make(param.endpointUrl, param.apiToken, param.clientTimeoutMillis, undefined, undefined, undefined, SvmHyperSyncClient.Registration.fromOnEventRegistrations(onEventRegistrations));
-  let getItemsOrThrow = async (fromBlock, toBlock, addressesByContractName, param, knownHeight, param$1, selection, itemsTarget, retry, param$2) => {
+  let client = SvmHyperSyncClient.make(param.endpointUrl, param.apiToken, param.clientTimeoutMillis, undefined, undefined, undefined, SvmHyperSyncClient.Registration.fromOnEventRegistrations(onEventRegistrations), param.addressStore);
+  let getItemsOrThrow = async (fromBlock, toBlock, addressSet, knownHeight, param, selection, itemsTarget, retry, param$1) => {
     let totalTimeRef = Performance.now();
     let pageFetchRef = Performance.now();
     let query_registrationIndexes = selection.onEventRegistrations.map(reg => reg.index);
+    let query_clientFilteredContracts = selection.clientFilteredContracts;
     let query = {
       fromSlot: fromBlock,
       toSlot: toBlock,
       maxNumInstructions: itemsTarget,
       registrationIndexes: query_registrationIndexes,
-      addressesByContractName: addressesByContractName
+      clientFilteredContracts: query_clientFilteredContracts
     };
     let match;
     try {
-      match = await client.getEventItems(query);
+      match = await client.getEventItems(query, addressSet);
     } catch (raw_exn) {
       let exn = Primitive_exceptions.internalToException(raw_exn);
       throw {