@xyo-network/witness-evm-abstract 3.18.10 → 4.0.1

package/dist/browser/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\n\nconst allowIpfsIoRepair = true\n\n/**\n * Returns the equivalent IPFS gateway URL for the supplied URL.\n * @param urlToCheck The URL to check\n * @returns If the supplied URL is an IPFS URL, it converts the URL to the\n * equivalent IPFS gateway URL. Otherwise, returns the original URL.\n */\nexport const checkIpfsUrl = (urlToCheck: string, ipfsGateway?: string): string => {\n  try {\n    const url = new URL(urlToCheck)\n    let protocol = url.protocol\n    let host = url.host\n    let path = url.pathname\n    const query = url.search\n    if (protocol === 'ipfs:') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      path = url.host === 'ipfs' ? `ipfs${path}` : `ipfs/${url.host}${path}`\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else if (allowIpfsIoRepair && protocol === 'https' && host === 'ipfs.io') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      const pathParts = path.split('/')\n      if (pathParts[0] === 'ipfs') {\n        pathParts.shift()\n      }\n      path = pathParts.join('/')\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else {\n      return urlToCheck\n    }\n  } catch {\n    // const error = ex as Error\n    // console.error(`${error.name}:${error.message} [${urlToCheck}]`)\n    // console.log(error.stack)\n    return urlToCheck\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { isString, isUndefined } from '@xylabs/typeof'\nimport type { Provider } from 'ethers'\nimport {\n  InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider,\n  WebSocketProvider,\n} from 'ethers'\n\nexport type ProviderSource = 'infura' | 'quicknode'\nexport type ProviderType = 'rpc' | 'wss'\n\nexport interface GetProvidersFromEnvOptions {\n  providerSource?: ProviderSource\n  providerType?: ProviderType\n}\n\nconst createInfuraRpc = (chainId: number) => {\n  return (isString(process.env.INFURA_PROJECT_ID) && isString(process.env.INFURA_PROJECT_SECRET))\n    ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID, process.env.INFURA_PROJECT_SECRET)\n    : undefined\n}\n\nconst createInfuraWss = (chainId: number) => {\n  return isString(process.env.INFURA_PROJECT_ID) ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  return isString(quickNodeWSSUri) ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  return isString(quickNodeHttpsUri) ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n\n  const quicknodeCases = () => {\n    switch (providerType) {\n      case 'rpc': {\n        provider = createQuicknodeRpc(chainId)\n        break\n      }\n      case 'wss': {\n        provider = createQuicknodeWss(chainId)\n        break\n      }\n    }\n  }\n\n  const infuraCases = () => {\n    switch (providerType) {\n      case 'wss': {\n        provider = createInfuraWss(chainId)\n        break\n      }\n      case 'rpc': {\n        provider = createInfuraRpc(chainId)\n        break\n      }\n    }\n  }\n\n  switch (providerSource ?? 'infura') {\n    case 'quicknode': {\n      quicknodeCases()\n      break\n    }\n    case 'infura': {\n      infuraCases()\n      break\n    }\n  }\n  if (isUndefined(provider)) {\n    provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId)\n  }\n  return assertEx(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`)\n}\n\nconst providers: Record<string, Provider> = {}\n\nexport const getSharedProviderFromEnv = (\n  chainId: number = 0x01,\n  options?: { providerSource?: ProviderSource; providerType?: ProviderType },\n): Provider => {\n  const key = `${chainId}:${options ? JSON.stringify(options) : 'default'}`\n  providers[key] = providers[key] ?? getProviderFromEnv(chainId, options)\n  return providers[key]\n}\n\nexport const getProvidersFromEnv = (count: number = 1, chainId: number = 0x01, options: GetProvidersFromEnvOptions = {}): Provider[] => {\n  const result: Provider[] = []\n  for (let i = 0; i < count; i++) {\n    result.push(getProviderFromEnv(chainId, options))\n  }\n  return result\n}\n","import type { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address' as const\nexport type EvmAddressSchema = typeof EvmAddressSchema\n\nexport type EvmAddress = Payload<\n  {\n    address?: string\n    blockTag?: string | number\n    chainId?: number\n  },\n  EvmAddressSchema\n>\n","import type { EmptyObject, WithAdditional } from '@xylabs/object'\nimport type { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport type { AnyConfigSchema } from '@xyo-network/module-model'\nimport { creatableModule } from '@xyo-network/module-model'\nimport type { Payload, Schema } from '@xyo-network/payload-model'\nimport type {\n  CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams,\n} from '@xyo-network/witness-model'\nimport type { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness' as const\nexport type EvmWitnessConfigSchema = typeof EvmWitnessConfigSchema\n\nexport type EvmWitnessConfig<TAdditional extends EmptyObject | Payload | void = void, TSchema extends string | void = void> = WitnessConfig<\n  TAdditional,\n  TSchema extends void ?\n    TAdditional extends Payload ?\n      TAdditional['schema']\n      : EvmWitnessConfigSchema\n    : TSchema\n>\n\nexport type AdditionalEvmWitnessParams = {\n  providers: Provider[]\n}\n\nexport type EvmWitnessParams<\n  TConfig extends AnyConfigSchema<EvmWitnessConfig> = EvmWitnessConfig,\n  TAdditionalParams extends EmptyObject | void = void,\n> = WitnessParams<\n  TConfig,\n  WithAdditional<\n    {\n      providers: () => Promisable<Provider[]>\n    },\n    TAdditionalParams\n  >\n>\n\ncreatableModule()\nexport abstract class AbstractEvmWitness<\n  TParams extends EvmWitnessParams<AnyConfigSchema<EvmWitnessConfig>> = EvmWitnessParams,\n  TIn extends Payload = Payload,\n  TOut extends Payload = Payload,\n  TEventData extends WitnessModuleEventData<WitnessInstance<TParams, TIn, TOut>, TIn, TOut> = WitnessModuleEventData<\n    WitnessInstance<TParams, TIn, TOut>,\n    TIn,\n    TOut\n  >,\n>\n  extends AbstractWitness<TParams, TIn, TOut, TEventData>\n  implements CustomWitnessInstance<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, EvmWitnessConfigSchema]\n  static override readonly defaultConfigSchema: Schema = EvmWitnessConfigSchema\n  private _providers: Provider[] | undefined = undefined\n\n  async getProvider(cache?: boolean): Promise<Provider | undefined>\n  async getProvider(cache: boolean, error: string | true): Promise<Provider>\n  async getProvider(cache = false, error?: string | boolean): Promise<Provider | undefined> {\n    const providers = await this.getProviders(cache)\n    if (providers.length === 0) {\n      if (error) {\n        throw new Error(typeof error === 'string' ? error : 'No providers available')\n      }\n      return undefined\n    }\n    return providers[Date.now() % providers.length] // pick a random provider\n  }\n\n  async getProviders(cache = false): Promise<Provider[]> {\n    const cachedProviders = cache ? this._providers : undefined\n    this._providers = cachedProviders ?? (await this.params.providers())\n    return this._providers\n  }\n\n  protected abstract override observeHandler(payloads?: TIn[]): Promisable<TOut[]>\n}\n"],"mappings":"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","names":["assertEx","providers"]}
+{"version":3,"sources":["../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\n\nconst allowIpfsIoRepair = true\n\n/**\n * Returns the equivalent IPFS gateway URL for the supplied URL.\n * @param urlToCheck The URL to check\n * @returns If the supplied URL is an IPFS URL, it converts the URL to the\n * equivalent IPFS gateway URL. Otherwise, returns the original URL.\n */\nexport const checkIpfsUrl = (urlToCheck: string, ipfsGateway?: string): string => {\n  try {\n    const url = new URL(urlToCheck)\n    let protocol = url.protocol\n    let host = url.host\n    let path = url.pathname\n    const query = url.search\n    if (protocol === 'ipfs:') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      path = url.host === 'ipfs' ? `ipfs${path}` : `ipfs/${url.host}${path}`\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else if (allowIpfsIoRepair && protocol === 'https' && host === 'ipfs.io') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      const pathParts = path.split('/')\n      if (pathParts[0] === 'ipfs') {\n        pathParts.shift()\n      }\n      path = pathParts.join('/')\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else {\n      return urlToCheck\n    }\n  } catch {\n    // const error = ex as Error\n    // console.error(`${error.name}:${error.message} [${urlToCheck}]`)\n    // console.log(error.stack)\n    return urlToCheck\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { isString, isUndefined } from '@xylabs/typeof'\nimport type { Provider } from 'ethers'\nimport {\n  InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider,\n  WebSocketProvider,\n} from 'ethers'\n\nexport type ProviderSource = 'infura' | 'quicknode'\nexport type ProviderType = 'rpc' | 'wss'\n\nexport interface GetProvidersFromEnvOptions {\n  providerSource?: ProviderSource\n  providerType?: ProviderType\n}\n\nconst createInfuraRpc = (chainId: number) => {\n  return (isString(process.env.INFURA_PROJECT_ID) && isString(process.env.INFURA_PROJECT_SECRET))\n    ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID, process.env.INFURA_PROJECT_SECRET)\n    : undefined\n}\n\nconst createInfuraWss = (chainId: number) => {\n  return isString(process.env.INFURA_PROJECT_ID) ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  return isString(quickNodeWSSUri) ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  return isString(quickNodeHttpsUri) ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n\n  const quicknodeCases = () => {\n    switch (providerType) {\n      case 'rpc': {\n        provider = createQuicknodeRpc(chainId)\n        break\n      }\n      case 'wss': {\n        provider = createQuicknodeWss(chainId)\n        break\n      }\n    }\n  }\n\n  const infuraCases = () => {\n    switch (providerType) {\n      case 'wss': {\n        provider = createInfuraWss(chainId)\n        break\n      }\n      case 'rpc': {\n        provider = createInfuraRpc(chainId)\n        break\n      }\n    }\n  }\n\n  switch (providerSource ?? 'infura') {\n    case 'quicknode': {\n      quicknodeCases()\n      break\n    }\n    case 'infura': {\n      infuraCases()\n      break\n    }\n  }\n  if (isUndefined(provider)) {\n    provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId)\n  }\n  return assertEx(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`)\n}\n\nconst providers: Record<string, Provider> = {}\n\nexport const getSharedProviderFromEnv = (\n  chainId: number = 0x01,\n  options?: { providerSource?: ProviderSource; providerType?: ProviderType },\n): Provider => {\n  const key = `${chainId}:${options ? JSON.stringify(options) : 'default'}`\n  providers[key] = providers[key] ?? getProviderFromEnv(chainId, options)\n  return providers[key]\n}\n\nexport const getProvidersFromEnv = (count: number = 1, chainId: number = 0x01, options: GetProvidersFromEnvOptions = {}): Provider[] => {\n  const result: Provider[] = []\n  for (let i = 0; i < count; i++) {\n    result.push(getProviderFromEnv(chainId, options))\n  }\n  return result\n}\n","import type { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address' as const\nexport type EvmAddressSchema = typeof EvmAddressSchema\n\nexport type EvmAddress = Payload<\n  {\n    address?: string\n    blockTag?: string | number\n    chainId?: number\n  },\n  EvmAddressSchema\n>\n","import type { EmptyObject } from '@xylabs/object'\nimport type { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport type { AnyConfigSchema } from '@xyo-network/module-model'\nimport { creatableModule } from '@xyo-network/module-model'\nimport type { Payload, Schema } from '@xyo-network/payload-model'\nimport type {\n  CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams,\n} from '@xyo-network/witness-model'\nimport type { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness' as const\nexport type EvmWitnessConfigSchema = typeof EvmWitnessConfigSchema\n\nexport type EvmWitnessConfig<TAdditional extends EmptyObject | Payload | void = void, TSchema extends string | void = void> = WitnessConfig<\n  TAdditional,\n  TSchema extends void\n    ? TAdditional extends Payload\n      ? TAdditional['schema']\n      : EvmWitnessConfigSchema\n    : TSchema\n>\n\nexport type AdditionalEvmWitnessParams = {\n  providers: Provider[]\n}\n\nexport interface EvmWitnessParams<\n  TConfig extends AnyConfigSchema<EvmWitnessConfig> = EvmWitnessConfig,\n> extends WitnessParams<TConfig>\n{\n  providers: () => Promisable<Provider[]>\n}\n\ncreatableModule()\nexport abstract class AbstractEvmWitness<\n  TParams extends EvmWitnessParams<AnyConfigSchema<EvmWitnessConfig>> = EvmWitnessParams,\n  TIn extends Payload = Payload,\n  TOut extends Payload = Payload,\n  TEventData extends WitnessModuleEventData<WitnessInstance<TParams, TIn, TOut>, TIn, TOut> = WitnessModuleEventData<\n    WitnessInstance<TParams, TIn, TOut>,\n    TIn,\n    TOut\n  >,\n>\n  extends AbstractWitness<TParams, TIn, TOut, TEventData>\n  implements CustomWitnessInstance<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, EvmWitnessConfigSchema]\n  static override readonly defaultConfigSchema: Schema = EvmWitnessConfigSchema\n  private _providers: Provider[] | undefined = undefined\n\n  async getProvider(cache?: boolean): Promise<Provider | undefined>\n  async getProvider(cache: boolean, error: string | true): Promise<Provider>\n  async getProvider(cache = false, error?: string | boolean): Promise<Provider | undefined> {\n    const providers = await this.getProviders(cache)\n    if (providers.length === 0) {\n      if (error) {\n        throw new Error(typeof error === 'string' ? error : 'No providers available')\n      }\n      return undefined\n    }\n    return providers[Date.now() % providers.length] // pick a random provider\n  }\n\n  async getProviders(cache = false): Promise<Provider[]> {\n    const cachedProviders = cache ? this._providers : undefined\n    this._providers = cachedProviders ?? (await this.params.providers())\n    return this._providers\n  }\n\n  protected abstract override observeHandler(payloads?: TIn[]): Promisable<TOut[]>\n}\n"],"mappings":"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","names":["assertEx","providers"]}

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\n\nconst allowIpfsIoRepair = true\n\n/**\n * Returns the equivalent IPFS gateway URL for the supplied URL.\n * @param urlToCheck The URL to check\n * @returns If the supplied URL is an IPFS URL, it converts the URL to the\n * equivalent IPFS gateway URL. Otherwise, returns the original URL.\n */\nexport const checkIpfsUrl = (urlToCheck: string, ipfsGateway?: string): string => {\n  try {\n    const url = new URL(urlToCheck)\n    let protocol = url.protocol\n    let host = url.host\n    let path = url.pathname\n    const query = url.search\n    if (protocol === 'ipfs:') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      path = url.host === 'ipfs' ? `ipfs${path}` : `ipfs/${url.host}${path}`\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else if (allowIpfsIoRepair && protocol === 'https' && host === 'ipfs.io') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      const pathParts = path.split('/')\n      if (pathParts[0] === 'ipfs') {\n        pathParts.shift()\n      }\n      path = pathParts.join('/')\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else {\n      return urlToCheck\n    }\n  } catch {\n    // const error = ex as Error\n    // console.error(`${error.name}:${error.message} [${urlToCheck}]`)\n    // console.log(error.stack)\n    return urlToCheck\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { isString, isUndefined } from '@xylabs/typeof'\nimport type { Provider } from 'ethers'\nimport {\n  InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider,\n  WebSocketProvider,\n} from 'ethers'\n\nexport type ProviderSource = 'infura' | 'quicknode'\nexport type ProviderType = 'rpc' | 'wss'\n\nexport interface GetProvidersFromEnvOptions {\n  providerSource?: ProviderSource\n  providerType?: ProviderType\n}\n\nconst createInfuraRpc = (chainId: number) => {\n  return (isString(process.env.INFURA_PROJECT_ID) && isString(process.env.INFURA_PROJECT_SECRET))\n    ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID, process.env.INFURA_PROJECT_SECRET)\n    : undefined\n}\n\nconst createInfuraWss = (chainId: number) => {\n  return isString(process.env.INFURA_PROJECT_ID) ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  return isString(quickNodeWSSUri) ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  return isString(quickNodeHttpsUri) ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n\n  const quicknodeCases = () => {\n    switch (providerType) {\n      case 'rpc': {\n        provider = createQuicknodeRpc(chainId)\n        break\n      }\n      case 'wss': {\n        provider = createQuicknodeWss(chainId)\n        break\n      }\n    }\n  }\n\n  const infuraCases = () => {\n    switch (providerType) {\n      case 'wss': {\n        provider = createInfuraWss(chainId)\n        break\n      }\n      case 'rpc': {\n        provider = createInfuraRpc(chainId)\n        break\n      }\n    }\n  }\n\n  switch (providerSource ?? 'infura') {\n    case 'quicknode': {\n      quicknodeCases()\n      break\n    }\n    case 'infura': {\n      infuraCases()\n      break\n    }\n  }\n  if (isUndefined(provider)) {\n    provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId)\n  }\n  return assertEx(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`)\n}\n\nconst providers: Record<string, Provider> = {}\n\nexport const getSharedProviderFromEnv = (\n  chainId: number = 0x01,\n  options?: { providerSource?: ProviderSource; providerType?: ProviderType },\n): Provider => {\n  const key = `${chainId}:${options ? JSON.stringify(options) : 'default'}`\n  providers[key] = providers[key] ?? getProviderFromEnv(chainId, options)\n  return providers[key]\n}\n\nexport const getProvidersFromEnv = (count: number = 1, chainId: number = 0x01, options: GetProvidersFromEnvOptions = {}): Provider[] => {\n  const result: Provider[] = []\n  for (let i = 0; i < count; i++) {\n    result.push(getProviderFromEnv(chainId, options))\n  }\n  return result\n}\n","import type { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address' as const\nexport type EvmAddressSchema = typeof EvmAddressSchema\n\nexport type EvmAddress = Payload<\n  {\n    address?: string\n    blockTag?: string | number\n    chainId?: number\n  },\n  EvmAddressSchema\n>\n","import type { EmptyObject, WithAdditional } from '@xylabs/object'\nimport type { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport type { AnyConfigSchema } from '@xyo-network/module-model'\nimport { creatableModule } from '@xyo-network/module-model'\nimport type { Payload, Schema } from '@xyo-network/payload-model'\nimport type {\n  CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams,\n} from '@xyo-network/witness-model'\nimport type { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness' as const\nexport type EvmWitnessConfigSchema = typeof EvmWitnessConfigSchema\n\nexport type EvmWitnessConfig<TAdditional extends EmptyObject | Payload | void = void, TSchema extends string | void = void> = WitnessConfig<\n  TAdditional,\n  TSchema extends void ?\n    TAdditional extends Payload ?\n      TAdditional['schema']\n      : EvmWitnessConfigSchema\n    : TSchema\n>\n\nexport type AdditionalEvmWitnessParams = {\n  providers: Provider[]\n}\n\nexport type EvmWitnessParams<\n  TConfig extends AnyConfigSchema<EvmWitnessConfig> = EvmWitnessConfig,\n  TAdditionalParams extends EmptyObject | void = void,\n> = WitnessParams<\n  TConfig,\n  WithAdditional<\n    {\n      providers: () => Promisable<Provider[]>\n    },\n    TAdditionalParams\n  >\n>\n\ncreatableModule()\nexport abstract class AbstractEvmWitness<\n  TParams extends EvmWitnessParams<AnyConfigSchema<EvmWitnessConfig>> = EvmWitnessParams,\n  TIn extends Payload = Payload,\n  TOut extends Payload = Payload,\n  TEventData extends WitnessModuleEventData<WitnessInstance<TParams, TIn, TOut>, TIn, TOut> = WitnessModuleEventData<\n    WitnessInstance<TParams, TIn, TOut>,\n    TIn,\n    TOut\n  >,\n>\n  extends AbstractWitness<TParams, TIn, TOut, TEventData>\n  implements CustomWitnessInstance<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, EvmWitnessConfigSchema]\n  static override readonly defaultConfigSchema: Schema = EvmWitnessConfigSchema\n  private _providers: Provider[] | undefined = undefined\n\n  async getProvider(cache?: boolean): Promise<Provider | undefined>\n  async getProvider(cache: boolean, error: string | true): Promise<Provider>\n  async getProvider(cache = false, error?: string | boolean): Promise<Provider | undefined> {\n    const providers = await this.getProviders(cache)\n    if (providers.length === 0) {\n      if (error) {\n        throw new Error(typeof error === 'string' ? error : 'No providers available')\n      }\n      return undefined\n    }\n    return providers[Date.now() % providers.length] // pick a random provider\n  }\n\n  async getProviders(cache = false): Promise<Provider[]> {\n    const cachedProviders = cache ? this._providers : undefined\n    this._providers = cachedProviders ?? (await this.params.providers())\n    return this._providers\n  }\n\n  protected abstract override observeHandler(payloads?: TIn[]): Promisable<TOut[]>\n}\n"],"mappings":"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","names":["assertEx","providers"]}
+{"version":3,"sources":["../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\n\nconst allowIpfsIoRepair = true\n\n/**\n * Returns the equivalent IPFS gateway URL for the supplied URL.\n * @param urlToCheck The URL to check\n * @returns If the supplied URL is an IPFS URL, it converts the URL to the\n * equivalent IPFS gateway URL. Otherwise, returns the original URL.\n */\nexport const checkIpfsUrl = (urlToCheck: string, ipfsGateway?: string): string => {\n  try {\n    const url = new URL(urlToCheck)\n    let protocol = url.protocol\n    let host = url.host\n    let path = url.pathname\n    const query = url.search\n    if (protocol === 'ipfs:') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      path = url.host === 'ipfs' ? `ipfs${path}` : `ipfs/${url.host}${path}`\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else if (allowIpfsIoRepair && protocol === 'https' && host === 'ipfs.io') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      const pathParts = path.split('/')\n      if (pathParts[0] === 'ipfs') {\n        pathParts.shift()\n      }\n      path = pathParts.join('/')\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else {\n      return urlToCheck\n    }\n  } catch {\n    // const error = ex as Error\n    // console.error(`${error.name}:${error.message} [${urlToCheck}]`)\n    // console.log(error.stack)\n    return urlToCheck\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { isString, isUndefined } from '@xylabs/typeof'\nimport type { Provider } from 'ethers'\nimport {\n  InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider,\n  WebSocketProvider,\n} from 'ethers'\n\nexport type ProviderSource = 'infura' | 'quicknode'\nexport type ProviderType = 'rpc' | 'wss'\n\nexport interface GetProvidersFromEnvOptions {\n  providerSource?: ProviderSource\n  providerType?: ProviderType\n}\n\nconst createInfuraRpc = (chainId: number) => {\n  return (isString(process.env.INFURA_PROJECT_ID) && isString(process.env.INFURA_PROJECT_SECRET))\n    ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID, process.env.INFURA_PROJECT_SECRET)\n    : undefined\n}\n\nconst createInfuraWss = (chainId: number) => {\n  return isString(process.env.INFURA_PROJECT_ID) ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  return isString(quickNodeWSSUri) ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  return isString(quickNodeHttpsUri) ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n\n  const quicknodeCases = () => {\n    switch (providerType) {\n      case 'rpc': {\n        provider = createQuicknodeRpc(chainId)\n        break\n      }\n      case 'wss': {\n        provider = createQuicknodeWss(chainId)\n        break\n      }\n    }\n  }\n\n  const infuraCases = () => {\n    switch (providerType) {\n      case 'wss': {\n        provider = createInfuraWss(chainId)\n        break\n      }\n      case 'rpc': {\n        provider = createInfuraRpc(chainId)\n        break\n      }\n    }\n  }\n\n  switch (providerSource ?? 'infura') {\n    case 'quicknode': {\n      quicknodeCases()\n      break\n    }\n    case 'infura': {\n      infuraCases()\n      break\n    }\n  }\n  if (isUndefined(provider)) {\n    provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId)\n  }\n  return assertEx(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`)\n}\n\nconst providers: Record<string, Provider> = {}\n\nexport const getSharedProviderFromEnv = (\n  chainId: number = 0x01,\n  options?: { providerSource?: ProviderSource; providerType?: ProviderType },\n): Provider => {\n  const key = `${chainId}:${options ? JSON.stringify(options) : 'default'}`\n  providers[key] = providers[key] ?? getProviderFromEnv(chainId, options)\n  return providers[key]\n}\n\nexport const getProvidersFromEnv = (count: number = 1, chainId: number = 0x01, options: GetProvidersFromEnvOptions = {}): Provider[] => {\n  const result: Provider[] = []\n  for (let i = 0; i < count; i++) {\n    result.push(getProviderFromEnv(chainId, options))\n  }\n  return result\n}\n","import type { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address' as const\nexport type EvmAddressSchema = typeof EvmAddressSchema\n\nexport type EvmAddress = Payload<\n  {\n    address?: string\n    blockTag?: string | number\n    chainId?: number\n  },\n  EvmAddressSchema\n>\n","import type { EmptyObject } from '@xylabs/object'\nimport type { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport type { AnyConfigSchema } from '@xyo-network/module-model'\nimport { creatableModule } from '@xyo-network/module-model'\nimport type { Payload, Schema } from '@xyo-network/payload-model'\nimport type {\n  CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams,\n} from '@xyo-network/witness-model'\nimport type { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness' as const\nexport type EvmWitnessConfigSchema = typeof EvmWitnessConfigSchema\n\nexport type EvmWitnessConfig<TAdditional extends EmptyObject | Payload | void = void, TSchema extends string | void = void> = WitnessConfig<\n  TAdditional,\n  TSchema extends void\n    ? TAdditional extends Payload\n      ? TAdditional['schema']\n      : EvmWitnessConfigSchema\n    : TSchema\n>\n\nexport type AdditionalEvmWitnessParams = {\n  providers: Provider[]\n}\n\nexport interface EvmWitnessParams<\n  TConfig extends AnyConfigSchema<EvmWitnessConfig> = EvmWitnessConfig,\n> extends WitnessParams<TConfig>\n{\n  providers: () => Promisable<Provider[]>\n}\n\ncreatableModule()\nexport abstract class AbstractEvmWitness<\n  TParams extends EvmWitnessParams<AnyConfigSchema<EvmWitnessConfig>> = EvmWitnessParams,\n  TIn extends Payload = Payload,\n  TOut extends Payload = Payload,\n  TEventData extends WitnessModuleEventData<WitnessInstance<TParams, TIn, TOut>, TIn, TOut> = WitnessModuleEventData<\n    WitnessInstance<TParams, TIn, TOut>,\n    TIn,\n    TOut\n  >,\n>\n  extends AbstractWitness<TParams, TIn, TOut, TEventData>\n  implements CustomWitnessInstance<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, EvmWitnessConfigSchema]\n  static override readonly defaultConfigSchema: Schema = EvmWitnessConfigSchema\n  private _providers: Provider[] | undefined = undefined\n\n  async getProvider(cache?: boolean): Promise<Provider | undefined>\n  async getProvider(cache: boolean, error: string | true): Promise<Provider>\n  async getProvider(cache = false, error?: string | boolean): Promise<Provider | undefined> {\n    const providers = await this.getProviders(cache)\n    if (providers.length === 0) {\n      if (error) {\n        throw new Error(typeof error === 'string' ? error : 'No providers available')\n      }\n      return undefined\n    }\n    return providers[Date.now() % providers.length] // pick a random provider\n  }\n\n  async getProviders(cache = false): Promise<Provider[]> {\n    const cachedProviders = cache ? this._providers : undefined\n    this._providers = cachedProviders ?? (await this.params.providers())\n    return this._providers\n  }\n\n  protected abstract override observeHandler(payloads?: TIn[]): Promisable<TOut[]>\n}\n"],"mappings":"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","names":["assertEx","providers"]}

package/dist/node/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\n\nconst allowIpfsIoRepair = true\n\n/**\n * Returns the equivalent IPFS gateway URL for the supplied URL.\n * @param urlToCheck The URL to check\n * @returns If the supplied URL is an IPFS URL, it converts the URL to the\n * equivalent IPFS gateway URL. Otherwise, returns the original URL.\n */\nexport const checkIpfsUrl = (urlToCheck: string, ipfsGateway?: string): string => {\n  try {\n    const url = new URL(urlToCheck)\n    let protocol = url.protocol\n    let host = url.host\n    let path = url.pathname\n    const query = url.search\n    if (protocol === 'ipfs:') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      path = url.host === 'ipfs' ? `ipfs${path}` : `ipfs/${url.host}${path}`\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else if (allowIpfsIoRepair && protocol === 'https' && host === 'ipfs.io') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      const pathParts = path.split('/')\n      if (pathParts[0] === 'ipfs') {\n        pathParts.shift()\n      }\n      path = pathParts.join('/')\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else {\n      return urlToCheck\n    }\n  } catch {\n    // const error = ex as Error\n    // console.error(`${error.name}:${error.message} [${urlToCheck}]`)\n    // console.log(error.stack)\n    return urlToCheck\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { isString, isUndefined } from '@xylabs/typeof'\nimport type { Provider } from 'ethers'\nimport {\n  InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider,\n  WebSocketProvider,\n} from 'ethers'\n\nexport type ProviderSource = 'infura' | 'quicknode'\nexport type ProviderType = 'rpc' | 'wss'\n\nexport interface GetProvidersFromEnvOptions {\n  providerSource?: ProviderSource\n  providerType?: ProviderType\n}\n\nconst createInfuraRpc = (chainId: number) => {\n  return (isString(process.env.INFURA_PROJECT_ID) && isString(process.env.INFURA_PROJECT_SECRET))\n    ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID, process.env.INFURA_PROJECT_SECRET)\n    : undefined\n}\n\nconst createInfuraWss = (chainId: number) => {\n  return isString(process.env.INFURA_PROJECT_ID) ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  return isString(quickNodeWSSUri) ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  return isString(quickNodeHttpsUri) ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n\n  const quicknodeCases = () => {\n    switch (providerType) {\n      case 'rpc': {\n        provider = createQuicknodeRpc(chainId)\n        break\n      }\n      case 'wss': {\n        provider = createQuicknodeWss(chainId)\n        break\n      }\n    }\n  }\n\n  const infuraCases = () => {\n    switch (providerType) {\n      case 'wss': {\n        provider = createInfuraWss(chainId)\n        break\n      }\n      case 'rpc': {\n        provider = createInfuraRpc(chainId)\n        break\n      }\n    }\n  }\n\n  switch (providerSource ?? 'infura') {\n    case 'quicknode': {\n      quicknodeCases()\n      break\n    }\n    case 'infura': {\n      infuraCases()\n      break\n    }\n  }\n  if (isUndefined(provider)) {\n    provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId)\n  }\n  return assertEx(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`)\n}\n\nconst providers: Record<string, Provider> = {}\n\nexport const getSharedProviderFromEnv = (\n  chainId: number = 0x01,\n  options?: { providerSource?: ProviderSource; providerType?: ProviderType },\n): Provider => {\n  const key = `${chainId}:${options ? JSON.stringify(options) : 'default'}`\n  providers[key] = providers[key] ?? getProviderFromEnv(chainId, options)\n  return providers[key]\n}\n\nexport const getProvidersFromEnv = (count: number = 1, chainId: number = 0x01, options: GetProvidersFromEnvOptions = {}): Provider[] => {\n  const result: Provider[] = []\n  for (let i = 0; i < count; i++) {\n    result.push(getProviderFromEnv(chainId, options))\n  }\n  return result\n}\n","import type { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address' as const\nexport type EvmAddressSchema = typeof EvmAddressSchema\n\nexport type EvmAddress = Payload<\n  {\n    address?: string\n    blockTag?: string | number\n    chainId?: number\n  },\n  EvmAddressSchema\n>\n","import type { EmptyObject, WithAdditional } from '@xylabs/object'\nimport type { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport type { AnyConfigSchema } from '@xyo-network/module-model'\nimport { creatableModule } from '@xyo-network/module-model'\nimport type { Payload, Schema } from '@xyo-network/payload-model'\nimport type {\n  CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams,\n} from '@xyo-network/witness-model'\nimport type { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness' as const\nexport type EvmWitnessConfigSchema = typeof EvmWitnessConfigSchema\n\nexport type EvmWitnessConfig<TAdditional extends EmptyObject | Payload | void = void, TSchema extends string | void = void> = WitnessConfig<\n  TAdditional,\n  TSchema extends void ?\n    TAdditional extends Payload ?\n      TAdditional['schema']\n      : EvmWitnessConfigSchema\n    : TSchema\n>\n\nexport type AdditionalEvmWitnessParams = {\n  providers: Provider[]\n}\n\nexport type EvmWitnessParams<\n  TConfig extends AnyConfigSchema<EvmWitnessConfig> = EvmWitnessConfig,\n  TAdditionalParams extends EmptyObject | void = void,\n> = WitnessParams<\n  TConfig,\n  WithAdditional<\n    {\n      providers: () => Promisable<Provider[]>\n    },\n    TAdditionalParams\n  >\n>\n\ncreatableModule()\nexport abstract class AbstractEvmWitness<\n  TParams extends EvmWitnessParams<AnyConfigSchema<EvmWitnessConfig>> = EvmWitnessParams,\n  TIn extends Payload = Payload,\n  TOut extends Payload = Payload,\n  TEventData extends WitnessModuleEventData<WitnessInstance<TParams, TIn, TOut>, TIn, TOut> = WitnessModuleEventData<\n    WitnessInstance<TParams, TIn, TOut>,\n    TIn,\n    TOut\n  >,\n>\n  extends AbstractWitness<TParams, TIn, TOut, TEventData>\n  implements CustomWitnessInstance<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, EvmWitnessConfigSchema]\n  static override readonly defaultConfigSchema: Schema = EvmWitnessConfigSchema\n  private _providers: Provider[] | undefined = undefined\n\n  async getProvider(cache?: boolean): Promise<Provider | undefined>\n  async getProvider(cache: boolean, error: string | true): Promise<Provider>\n  async getProvider(cache = false, error?: string | boolean): Promise<Provider | undefined> {\n    const providers = await this.getProviders(cache)\n    if (providers.length === 0) {\n      if (error) {\n        throw new Error(typeof error === 'string' ? error : 'No providers available')\n      }\n      return undefined\n    }\n    return providers[Date.now() % providers.length] // pick a random provider\n  }\n\n  async getProviders(cache = false): Promise<Provider[]> {\n    const cachedProviders = cache ? this._providers : undefined\n    this._providers = cachedProviders ?? (await this.params.providers())\n    return this._providers\n  }\n\n  protected abstract override observeHandler(payloads?: TIn[]): Promisable<TOut[]>\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAEzB,IAAM,oBAAoB;AAQnB,IAAM,eAAe,CAAC,YAAoB,gBAAiC;AAChF,MAAI;AACF,UAAM,MAAM,IAAI,IAAI,UAAU;AAC9B,QAAI,WAAW,IAAI;AACnB,QAAI,OAAO,IAAI;AACf,QAAI,OAAO,IAAI;AACf,UAAM,QAAQ,IAAI;AAClB,QAAI,aAAa,SAAS;AACxB,iBAAW;AACX,aAAO,SAAS,aAAa,MAAM,yBAAyB;AAC5D,aAAO,IAAI,SAAS,SAAS,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,GAAG,IAAI;AACpE,YAAM,OAAO,GAAG,QAAQ,KAAK,IAAI,IAAI,IAAI;AACzC,aAAO,OAAO,SAAS,IAAI,GAAG,IAAI,IAAI,KAAK,KAAK;AAAA,IAClD,WAAW,qBAAqB,aAAa,WAAW,SAAS,WAAW;AAC1E,iBAAW;AACX,aAAO,SAAS,aAAa,MAAM,yBAAyB;AAC5D,YAAM,YAAY,KAAK,MAAM,GAAG;AAChC,UAAI,UAAU,CAAC,MAAM,QAAQ;AAC3B,kBAAU,MAAM;AAAA,MAClB;AACA,aAAO,UAAU,KAAK,GAAG;AACzB,YAAM,OAAO,GAAG,QAAQ,KAAK,IAAI,IAAI,IAAI;AACzC,aAAO,OAAO,SAAS,IAAI,GAAG,IAAI,IAAI,KAAK,KAAK;AAAA,IAClD,OAAO;AACL,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAIN,WAAO;AAAA,EACT;AACF;;;AC1CA,SAAS,YAAAA,iBAAgB;AACzB,SAAS,UAAU,mBAAmB;AAEtC;AAAA,EACE;AAAA,EAAgB;AAAA,EAAyB;AAAA,EACzC;AAAA,OACK;AAUP,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAQ,SAAS,QAAQ,IAAI,iBAAiB,KAAK,SAAS,QAAQ,IAAI,qBAAqB,IACzF,IAAI,eAAe,SAAS,QAAQ,IAAI,mBAAmB,QAAQ,IAAI,qBAAqB,IAC5F;AACN;AAEA,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,SAAS,QAAQ,IAAI,iBAAiB,IAAI,IAAI,wBAAwB,SAAS,QAAQ,IAAI,iBAAiB,IAAI;AACzH;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,kBAAkB,QAAQ,IAAI;AACpC,SAAO,SAAS,eAAe,IAAI,IAAI,kBAAkB,iBAAiB,OAAO,IAAI;AACvF;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,oBAAoB,QAAQ,IAAI;AACtC,SAAO,SAAS,iBAAiB,IAAI,IAAI,gBAAgB,mBAAmB,OAAO,IAAI;AACzF;AAEO,IAAM,qBAAqB,CAChC,UAAkB,GAClB,EAAE,iBAAiB,UAAU,eAAe,MAAM,IAAgC,CAAC,MACtE;AACb,MAAI,WAAiC;AAErC,QAAM,iBAAiB,MAAM;AAC3B,YAAQ,cAAc;AAAA,MACpB,KAAK,OAAO;AACV,mBAAW,mBAAmB,OAAO;AACrC;AAAA,MACF;AAAA,MACA,KAAK,OAAO;AACV,mBAAW,mBAAmB,OAAO;AACrC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,cAAc,MAAM;AACxB,YAAQ,cAAc;AAAA,MACpB,KAAK,OAAO;AACV,mBAAW,gBAAgB,OAAO;AAClC;AAAA,MACF;AAAA,MACA,KAAK,OAAO;AACV,mBAAW,gBAAgB,OAAO;AAClC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,UAAQ,kBAAkB,UAAU;AAAA,IAClC,KAAK,aAAa;AAChB,qBAAe;AACf;AAAA,IACF;AAAA,IACA,KAAK,UAAU;AACb,kBAAY;AACZ;AAAA,IACF;AAAA,EACF;AACA,MAAI,YAAY,QAAQ,GAAG;AACzB,eAAW,gBAAgB,OAAO,KAAK,gBAAgB,OAAO,KAAK,mBAAmB,OAAO;AAAA,EAC/F;AACA,SAAOA,UAAS,UAAU,MAAM,8BAA8B,OAAO,MAAM,cAAc,IAAI,YAAY,EAAE;AAC7G;AAEA,IAAM,YAAsC,CAAC;AAEtC,IAAM,2BAA2B,CACtC,UAAkB,GAClB,YACa;AACb,QAAM,MAAM,GAAG,OAAO,IAAI,UAAU,KAAK,UAAU,OAAO,IAAI,SAAS;AACvE,YAAU,GAAG,IAAI,UAAU,GAAG,KAAK,mBAAmB,SAAS,OAAO;AACtE,SAAO,UAAU,GAAG;AACtB;AAEO,IAAM,sBAAsB,CAAC,QAAgB,GAAG,UAAkB,GAAM,UAAsC,CAAC,MAAkB;AACtI,QAAM,SAAqB,CAAC;AAC5B,WAAS,IAAI,GAAG,IAAI,OAAO,KAAK;AAC9B,WAAO,KAAK,mBAAmB,SAAS,OAAO,CAAC;AAAA,EAClD;AACA,SAAO;AACT;;;ACnGO,IAAM,mBAAmB;;;ACAhC,SAAS,uBAAuB;AAEhC,SAAS,uBAAuB;AAOzB,IAAM,yBAAyB;AA6BtC,gBAAgB;AACT,IAAe,qBAAf,cAUG,gBACyD;AAAA,EACjE,OAAyB,gBAA0B,CAAC,GAAG,MAAM,eAAe,sBAAsB;AAAA,EAClG,OAAyB,sBAA8B;AAAA,EAC/C,aAAqC;AAAA,EAI7C,MAAM,YAAY,QAAQ,OAAO,OAAyD;AACxF,UAAMC,aAAY,MAAM,KAAK,aAAa,KAAK;AAC/C,QAAIA,WAAU,WAAW,GAAG;AAC1B,UAAI,OAAO;AACT,cAAM,IAAI,MAAM,OAAO,UAAU,WAAW,QAAQ,wBAAwB;AAAA,MAC9E;AACA,aAAO;AAAA,IACT;AACA,WAAOA,WAAU,KAAK,IAAI,IAAIA,WAAU,MAAM;AAAA,EAChD;AAAA,EAEA,MAAM,aAAa,QAAQ,OAA4B;AACrD,UAAM,kBAAkB,QAAQ,KAAK,aAAa;AAClD,SAAK,aAAa,mBAAoB,MAAM,KAAK,OAAO,UAAU;AAClE,WAAO,KAAK;AAAA,EACd;AAGF;","names":["assertEx","providers"]}
+{"version":3,"sources":["../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\n\nconst allowIpfsIoRepair = true\n\n/**\n * Returns the equivalent IPFS gateway URL for the supplied URL.\n * @param urlToCheck The URL to check\n * @returns If the supplied URL is an IPFS URL, it converts the URL to the\n * equivalent IPFS gateway URL. Otherwise, returns the original URL.\n */\nexport const checkIpfsUrl = (urlToCheck: string, ipfsGateway?: string): string => {\n  try {\n    const url = new URL(urlToCheck)\n    let protocol = url.protocol\n    let host = url.host\n    let path = url.pathname\n    const query = url.search\n    if (protocol === 'ipfs:') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      path = url.host === 'ipfs' ? `ipfs${path}` : `ipfs/${url.host}${path}`\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else if (allowIpfsIoRepair && protocol === 'https' && host === 'ipfs.io') {\n      protocol = 'https:'\n      host = assertEx(ipfsGateway, () => 'No ipfsGateway provided')\n      const pathParts = path.split('/')\n      if (pathParts[0] === 'ipfs') {\n        pathParts.shift()\n      }\n      path = pathParts.join('/')\n      const root = `${protocol}//${host}/${path}`\n      return query?.length > 0 ? `${root}?${query}` : root\n    } else {\n      return urlToCheck\n    }\n  } catch {\n    // const error = ex as Error\n    // console.error(`${error.name}:${error.message} [${urlToCheck}]`)\n    // console.log(error.stack)\n    return urlToCheck\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { isString, isUndefined } from '@xylabs/typeof'\nimport type { Provider } from 'ethers'\nimport {\n  InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider,\n  WebSocketProvider,\n} from 'ethers'\n\nexport type ProviderSource = 'infura' | 'quicknode'\nexport type ProviderType = 'rpc' | 'wss'\n\nexport interface GetProvidersFromEnvOptions {\n  providerSource?: ProviderSource\n  providerType?: ProviderType\n}\n\nconst createInfuraRpc = (chainId: number) => {\n  return (isString(process.env.INFURA_PROJECT_ID) && isString(process.env.INFURA_PROJECT_SECRET))\n    ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID, process.env.INFURA_PROJECT_SECRET)\n    : undefined\n}\n\nconst createInfuraWss = (chainId: number) => {\n  return isString(process.env.INFURA_PROJECT_ID) ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  return isString(quickNodeWSSUri) ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  return isString(quickNodeHttpsUri) ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n\n  const quicknodeCases = () => {\n    switch (providerType) {\n      case 'rpc': {\n        provider = createQuicknodeRpc(chainId)\n        break\n      }\n      case 'wss': {\n        provider = createQuicknodeWss(chainId)\n        break\n      }\n    }\n  }\n\n  const infuraCases = () => {\n    switch (providerType) {\n      case 'wss': {\n        provider = createInfuraWss(chainId)\n        break\n      }\n      case 'rpc': {\n        provider = createInfuraRpc(chainId)\n        break\n      }\n    }\n  }\n\n  switch (providerSource ?? 'infura') {\n    case 'quicknode': {\n      quicknodeCases()\n      break\n    }\n    case 'infura': {\n      infuraCases()\n      break\n    }\n  }\n  if (isUndefined(provider)) {\n    provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId)\n  }\n  return assertEx(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`)\n}\n\nconst providers: Record<string, Provider> = {}\n\nexport const getSharedProviderFromEnv = (\n  chainId: number = 0x01,\n  options?: { providerSource?: ProviderSource; providerType?: ProviderType },\n): Provider => {\n  const key = `${chainId}:${options ? JSON.stringify(options) : 'default'}`\n  providers[key] = providers[key] ?? getProviderFromEnv(chainId, options)\n  return providers[key]\n}\n\nexport const getProvidersFromEnv = (count: number = 1, chainId: number = 0x01, options: GetProvidersFromEnvOptions = {}): Provider[] => {\n  const result: Provider[] = []\n  for (let i = 0; i < count; i++) {\n    result.push(getProviderFromEnv(chainId, options))\n  }\n  return result\n}\n","import type { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address' as const\nexport type EvmAddressSchema = typeof EvmAddressSchema\n\nexport type EvmAddress = Payload<\n  {\n    address?: string\n    blockTag?: string | number\n    chainId?: number\n  },\n  EvmAddressSchema\n>\n","import type { EmptyObject } from '@xylabs/object'\nimport type { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport type { AnyConfigSchema } from '@xyo-network/module-model'\nimport { creatableModule } from '@xyo-network/module-model'\nimport type { Payload, Schema } from '@xyo-network/payload-model'\nimport type {\n  CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams,\n} from '@xyo-network/witness-model'\nimport type { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness' as const\nexport type EvmWitnessConfigSchema = typeof EvmWitnessConfigSchema\n\nexport type EvmWitnessConfig<TAdditional extends EmptyObject | Payload | void = void, TSchema extends string | void = void> = WitnessConfig<\n  TAdditional,\n  TSchema extends void\n    ? TAdditional extends Payload\n      ? TAdditional['schema']\n      : EvmWitnessConfigSchema\n    : TSchema\n>\n\nexport type AdditionalEvmWitnessParams = {\n  providers: Provider[]\n}\n\nexport interface EvmWitnessParams<\n  TConfig extends AnyConfigSchema<EvmWitnessConfig> = EvmWitnessConfig,\n> extends WitnessParams<TConfig>\n{\n  providers: () => Promisable<Provider[]>\n}\n\ncreatableModule()\nexport abstract class AbstractEvmWitness<\n  TParams extends EvmWitnessParams<AnyConfigSchema<EvmWitnessConfig>> = EvmWitnessParams,\n  TIn extends Payload = Payload,\n  TOut extends Payload = Payload,\n  TEventData extends WitnessModuleEventData<WitnessInstance<TParams, TIn, TOut>, TIn, TOut> = WitnessModuleEventData<\n    WitnessInstance<TParams, TIn, TOut>,\n    TIn,\n    TOut\n  >,\n>\n  extends AbstractWitness<TParams, TIn, TOut, TEventData>\n  implements CustomWitnessInstance<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, EvmWitnessConfigSchema]\n  static override readonly defaultConfigSchema: Schema = EvmWitnessConfigSchema\n  private _providers: Provider[] | undefined = undefined\n\n  async getProvider(cache?: boolean): Promise<Provider | undefined>\n  async getProvider(cache: boolean, error: string | true): Promise<Provider>\n  async getProvider(cache = false, error?: string | boolean): Promise<Provider | undefined> {\n    const providers = await this.getProviders(cache)\n    if (providers.length === 0) {\n      if (error) {\n        throw new Error(typeof error === 'string' ? error : 'No providers available')\n      }\n      return undefined\n    }\n    return providers[Date.now() % providers.length] // pick a random provider\n  }\n\n  async getProviders(cache = false): Promise<Provider[]> {\n    const cachedProviders = cache ? this._providers : undefined\n    this._providers = cachedProviders ?? (await this.params.providers())\n    return this._providers\n  }\n\n  protected abstract override observeHandler(payloads?: TIn[]): Promisable<TOut[]>\n}\n"],"mappings":"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","names":["assertEx","providers"]}

package/dist/types/Witness.d.ts

@@ -1,4 +1,4 @@
-import type { EmptyObject, WithAdditional } from '@xylabs/object';
+import type { EmptyObject } from '@xylabs/object';
 import type { Promisable } from '@xylabs/promise';
 import { AbstractWitness } from '@xyo-network/abstract-witness';
 import type { AnyConfigSchema } from '@xyo-network/module-model';
@@ -11,9 +11,9 @@ export type EvmWitnessConfig<TAdditional extends EmptyObject | Payload | void =
 export type AdditionalEvmWitnessParams = {
     providers: Provider[];
 };
-export type EvmWitnessParams<TConfig extends AnyConfigSchema<EvmWitnessConfig> = EvmWitnessConfig, TAdditionalParams extends EmptyObject | void = void> = WitnessParams<TConfig, WithAdditional<{
+export interface EvmWitnessParams<TConfig extends AnyConfigSchema<EvmWitnessConfig> = EvmWitnessConfig> extends WitnessParams<TConfig> {
     providers: () => Promisable<Provider[]>;
-}, TAdditionalParams>>;
+}
 export declare abstract class AbstractEvmWitness<TParams extends EvmWitnessParams<AnyConfigSchema<EvmWitnessConfig>> = EvmWitnessParams, TIn extends Payload = Payload, TOut extends Payload = Payload, TEventData extends WitnessModuleEventData<WitnessInstance<TParams, TIn, TOut>, TIn, TOut> = WitnessModuleEventData<WitnessInstance<TParams, TIn, TOut>, TIn, TOut>> extends AbstractWitness<TParams, TIn, TOut, TEventData> implements CustomWitnessInstance<TParams, TIn, TOut, TEventData> {
     static readonly configSchemas: Schema[];
     static readonly defaultConfigSchema: Schema;

package/dist/types/Witness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Witness.d.ts","sourceRoot":"","sources":["../../src/Witness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EACV,qBAAqB,EAAE,aAAa,EAAE,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAC7F,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEtC,eAAO,MAAM,sBAAsB,EAAG,yBAAkC,CAAA;AACxE,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAA;AAElE,MAAM,MAAM,gBAAgB,CAAC,WAAW,SAAS,WAAW,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,MAAM,GAAG,IAAI,GAAG,IAAI,IAAI,aAAa,CACzI,WAAW,EACX,OAAO,SAAS,IAAI,GAClB,WAAW,SAAS,OAAO,GACzB,WAAW,CAAC,QAAQ,CAAC,GACnB,sBAAsB,GACxB,OAAO,CACZ,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,QAAQ,EAAE,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAC1B,OAAO,SAAS,eAAe,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,EACpE,iBAAiB,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,IACjD,aAAa,CACf,OAAO,EACP,cAAc,CACZ;IACE,SAAS,EAAE,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;CACxC,EACD,iBAAiB,CAClB,CACF,CAAA;AAGD,8BAAsB,kBAAkB,CACtC,OAAO,SAAS,gBAAgB,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,GAAG,gBAAgB,EACtF,GAAG,SAAS,OAAO,GAAG,OAAO,EAC7B,IAAI,SAAS,OAAO,GAAG,OAAO,EAC9B,UAAU,SAAS,sBAAsB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,sBAAsB,CAChH,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EACnC,GAAG,EACH,IAAI,CACL,CAED,SAAQ,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,CACtD,YAAW,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC;IAChE,gBAAyB,aAAa,EAAE,MAAM,EAAE,CAAmD;IACnG,gBAAyB,mBAAmB,EAAE,MAAM,CAAyB;IAC7E,OAAO,CAAC,UAAU,CAAoC;IAEhD,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC3D,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYpE,YAAY,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;uBAM1B,cAAc,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;CACjF"}
+{"version":3,"file":"Witness.d.ts","sourceRoot":"","sources":["../../src/Witness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EACV,qBAAqB,EAAE,aAAa,EAAE,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAC7F,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEtC,eAAO,MAAM,sBAAsB,EAAG,yBAAkC,CAAA;AACxE,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAA;AAElE,MAAM,MAAM,gBAAgB,CAAC,WAAW,SAAS,WAAW,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,MAAM,GAAG,IAAI,GAAG,IAAI,IAAI,aAAa,CACzI,WAAW,EACX,OAAO,SAAS,IAAI,GAChB,WAAW,SAAS,OAAO,GACzB,WAAW,CAAC,QAAQ,CAAC,GACrB,sBAAsB,GACxB,OAAO,CACZ,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,QAAQ,EAAE,CAAA;CACtB,CAAA;AAED,MAAM,WAAW,gBAAgB,CAC/B,OAAO,SAAS,eAAe,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CACpE,SAAQ,aAAa,CAAC,OAAO,CAAC;IAE9B,SAAS,EAAE,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;CACxC;AAGD,8BAAsB,kBAAkB,CACtC,OAAO,SAAS,gBAAgB,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,GAAG,gBAAgB,EACtF,GAAG,SAAS,OAAO,GAAG,OAAO,EAC7B,IAAI,SAAS,OAAO,GAAG,OAAO,EAC9B,UAAU,SAAS,sBAAsB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,sBAAsB,CAChH,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EACnC,GAAG,EACH,IAAI,CACL,CAED,SAAQ,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,CACtD,YAAW,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC;IAChE,gBAAyB,aAAa,EAAE,MAAM,EAAE,CAAmD;IACnG,gBAAyB,mBAAmB,EAAE,MAAM,CAAyB;IAC7E,OAAO,CAAC,UAAU,CAAoC;IAEhD,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC3D,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYpE,YAAY,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;uBAM1B,cAAc,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;CACjF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/witness-evm-abstract",
-  "version": "3.18.10",
+  "version": "4.0.1",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -29,19 +29,19 @@
   "module": "dist/neutral/index.mjs",
   "types": "dist/types/index.d.ts",
   "dependencies": {
-    "@xylabs/assert": "^4.11.21",
-    "@xylabs/object": "^4.11.21",
-    "@xylabs/promise": "^4.11.21",
-    "@xylabs/typeof": "^4.11.21",
-    "@xyo-network/abstract-witness": "^3.18.10",
-    "@xyo-network/module-model": "^3.18.10",
-    "@xyo-network/payload-model": "^3.18.10",
-    "@xyo-network/witness-model": "^3.18.10",
-    "ethers": "^6.14.4"
+    "@xylabs/assert": "^4.12.30",
+    "@xylabs/object": "^4.12.30",
+    "@xylabs/promise": "^4.12.30",
+    "@xylabs/typeof": "^4.12.30",
+    "@xyo-network/abstract-witness": "^4.0.1",
+    "@xyo-network/module-model": "^4.0.1",
+    "@xyo-network/payload-model": "^4.0.1",
+    "@xyo-network/witness-model": "^4.0.1",
+    "ethers": "^6.15.0"
   },
   "devDependencies": {
-    "@xylabs/ts-scripts-yarn3": "^6.5.8",
-    "@xylabs/tsconfig": "^6.5.8",
+    "@xylabs/ts-scripts-yarn3": "^6.5.12",
+    "@xylabs/tsconfig": "^6.5.12",
     "typescript": "^5.8.3"
   },
   "publishConfig": {

package/src/Witness.ts

@@ -1,4 +1,4 @@
-import type { EmptyObject, WithAdditional } from '@xylabs/object'
+import type { EmptyObject } from '@xylabs/object'
 import type { Promisable } from '@xylabs/promise'
 import { AbstractWitness } from '@xyo-network/abstract-witness'
 import type { AnyConfigSchema } from '@xyo-network/module-model'
@@ -14,9 +14,9 @@ export type EvmWitnessConfigSchema = typeof EvmWitnessConfigSchema
 
 export type EvmWitnessConfig<TAdditional extends EmptyObject | Payload | void = void, TSchema extends string | void = void> = WitnessConfig<
   TAdditional,
-  TSchema extends void ?
-    TAdditional extends Payload ?
-      TAdditional['schema']
+  TSchema extends void
+    ? TAdditional extends Payload
+      ? TAdditional['schema']
       : EvmWitnessConfigSchema
     : TSchema
 >
@@ -25,18 +25,12 @@ export type AdditionalEvmWitnessParams = {
   providers: Provider[]
 }
 
-export type EvmWitnessParams<
+export interface EvmWitnessParams<
   TConfig extends AnyConfigSchema<EvmWitnessConfig> = EvmWitnessConfig,
-  TAdditionalParams extends EmptyObject | void = void,
-> = WitnessParams<
-  TConfig,
-  WithAdditional<
-    {
-      providers: () => Promisable<Provider[]>
-    },
-    TAdditionalParams
-  >
->
+> extends WitnessParams<TConfig>
+{
+  providers: () => Promisable<Provider[]>
+}
 
 creatableModule()
 export abstract class AbstractEvmWitness<