@xyo-network/witness-evm-abstract 2.88.3 → 2.89.0-rc.10

package/dist/browser/index.cjs

@@ -120,7 +120,7 @@ var getProviderFromEnv = /* @__PURE__ */ __name((chainId = 1, { providerSource =
   if (!provider) {
     provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId);
   }
-  return (0, import_assert2.assertEx)(provider, `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`);
+  return (0, import_assert2.assertEx)(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`);
 }, "getProviderFromEnv");
 var providers = {};
 var getSharedProviderFromEnv = /* @__PURE__ */ __name((chainId = 1, options) => {

package/dist/browser/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["export * from './lib'\nexport * from './model'\nexport * from './Witness'\n","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 { InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, Provider, WebSocketProvider } 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  const provider =\n    process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createInfuraWss = (chainId: number) => {\n  const provider = process.env.INFURA_PROJECT_ID ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n\n  return provider\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n  return provider\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n  switch (providerSource) {\n    case 'quicknode': {\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      break\n    }\n    default:\n    case 'infura': {\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      break\n    }\n  }\n  if (!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 { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address'\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 { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyConfigSchema, creatableModule } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\nimport { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness'\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 ? (TAdditional extends Payload ? TAdditional['schema'] : EvmWitnessConfigSchema) : 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{\n  static override readonly configSchemas: string[] = [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":["allowIpfsIoRepair","checkIpfsUrl","urlToCheck","ipfsGateway","url","URL","protocol","host","path","pathname","query","search","assertEx","root","length","pathParts","split","shift","join","import_assert","createInfuraRpc","chainId","provider","process","env","INFURA_PROJECT_ID","INFURA_PROJECT_SECRET","InfuraProvider","undefined","createInfuraWss","InfuraWebSocketProvider","createQuicknodeWss","quickNodeWSSUri","QUICKNODE_WSS_URI","WebSocketProvider","createQuicknodeRpc","quickNodeHttpsUri","QUICKNODE_HTTPS_URI","JsonRpcProvider","getProviderFromEnv","providerSource","providerType","assertEx","providers","getSharedProviderFromEnv","options","key","JSON","stringify","getProvidersFromEnv","count","result","i","push","EvmAddressSchema","EvmWitnessConfigSchema","creatableModule","AbstractEvmWitness","AbstractWitness","configSchemas","_providers","undefined","getProvider","cache","error","providers","getProviders","length","Error","Date","now","cachedProviders","params"]}
+{"version":3,"sources":["../../src/index.ts","../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["export * from './lib'\nexport * from './model'\nexport * from './Witness'\n","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 { InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, Provider, WebSocketProvider } 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  const provider =\n    process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createInfuraWss = (chainId: number) => {\n  const provider = process.env.INFURA_PROJECT_ID ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n\n  return provider\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n  return provider\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n  switch (providerSource) {\n    case 'quicknode': {\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      break\n    }\n    default:\n    case 'infura': {\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      break\n    }\n  }\n  if (!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 { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address'\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 { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyConfigSchema, creatableModule } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\nimport { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness'\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 ? (TAdditional extends Payload ? TAdditional['schema'] : EvmWitnessConfigSchema) : 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{\n  static override readonly configSchemas: string[] = [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":["allowIpfsIoRepair","checkIpfsUrl","urlToCheck","ipfsGateway","url","URL","protocol","host","path","pathname","query","search","assertEx","root","length","pathParts","split","shift","join","import_assert","createInfuraRpc","chainId","provider","process","env","INFURA_PROJECT_ID","INFURA_PROJECT_SECRET","InfuraProvider","undefined","createInfuraWss","InfuraWebSocketProvider","createQuicknodeWss","quickNodeWSSUri","QUICKNODE_WSS_URI","WebSocketProvider","createQuicknodeRpc","quickNodeHttpsUri","QUICKNODE_HTTPS_URI","JsonRpcProvider","getProviderFromEnv","providerSource","providerType","assertEx","providers","getSharedProviderFromEnv","options","key","JSON","stringify","getProvidersFromEnv","count","result","i","push","EvmAddressSchema","EvmWitnessConfigSchema","creatableModule","AbstractEvmWitness","AbstractWitness","configSchemas","_providers","undefined","getProvider","cache","error","providers","getProviders","length","Error","Date","now","cachedProviders","params"]}

package/dist/browser/index.js

@@ -90,7 +90,7 @@ var getProviderFromEnv = /* @__PURE__ */ __name((chainId = 1, { providerSource =
   if (!provider) {
     provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId);
   }
-  return assertEx2(provider, `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`);
+  return assertEx2(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`);
 }, "getProviderFromEnv");
 var providers = {};
 var getSharedProviderFromEnv = /* @__PURE__ */ __name((chainId = 1, options) => {

package/dist/browser/index.js.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 { InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, Provider, WebSocketProvider } 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  const provider =\n    process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createInfuraWss = (chainId: number) => {\n  const provider = process.env.INFURA_PROJECT_ID ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n\n  return provider\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n  return provider\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n  switch (providerSource) {\n    case 'quicknode': {\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      break\n    }\n    default:\n    case 'infura': {\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      break\n    }\n  }\n  if (!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 { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address'\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 { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyConfigSchema, creatableModule } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\nimport { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness'\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 ? (TAdditional extends Payload ? TAdditional['schema'] : EvmWitnessConfigSchema) : 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{\n  static override readonly configSchemas: string[] = [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","allowIpfsIoRepair","checkIpfsUrl","urlToCheck","ipfsGateway","url","URL","protocol","host","path","pathname","query","search","assertEx","root","length","pathParts","split","shift","join","assertEx","InfuraProvider","InfuraWebSocketProvider","JsonRpcProvider","WebSocketProvider","createInfuraRpc","chainId","provider","process","env","INFURA_PROJECT_ID","INFURA_PROJECT_SECRET","InfuraProvider","undefined","createInfuraWss","InfuraWebSocketProvider","createQuicknodeWss","quickNodeWSSUri","QUICKNODE_WSS_URI","WebSocketProvider","createQuicknodeRpc","quickNodeHttpsUri","QUICKNODE_HTTPS_URI","JsonRpcProvider","getProviderFromEnv","providerSource","providerType","assertEx","providers","getSharedProviderFromEnv","options","key","JSON","stringify","getProvidersFromEnv","count","result","i","push","EvmAddressSchema","AbstractWitness","creatableModule","EvmWitnessConfigSchema","creatableModule","AbstractEvmWitness","AbstractWitness","configSchemas","_providers","undefined","getProvider","cache","error","providers","getProviders","length","Error","Date","now","cachedProviders","params"]}
+{"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 { InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, Provider, WebSocketProvider } 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  const provider =\n    process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createInfuraWss = (chainId: number) => {\n  const provider = process.env.INFURA_PROJECT_ID ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n\n  return provider\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n  return provider\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n  switch (providerSource) {\n    case 'quicknode': {\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      break\n    }\n    default:\n    case 'infura': {\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      break\n    }\n  }\n  if (!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 { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address'\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 { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyConfigSchema, creatableModule } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\nimport { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness'\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 ? (TAdditional extends Payload ? TAdditional['schema'] : EvmWitnessConfigSchema) : 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{\n  static override readonly configSchemas: string[] = [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","allowIpfsIoRepair","checkIpfsUrl","urlToCheck","ipfsGateway","url","URL","protocol","host","path","pathname","query","search","assertEx","root","length","pathParts","split","shift","join","assertEx","InfuraProvider","InfuraWebSocketProvider","JsonRpcProvider","WebSocketProvider","createInfuraRpc","chainId","provider","process","env","INFURA_PROJECT_ID","INFURA_PROJECT_SECRET","InfuraProvider","undefined","createInfuraWss","InfuraWebSocketProvider","createQuicknodeWss","quickNodeWSSUri","QUICKNODE_WSS_URI","WebSocketProvider","createQuicknodeRpc","quickNodeHttpsUri","QUICKNODE_HTTPS_URI","JsonRpcProvider","getProviderFromEnv","providerSource","providerType","assertEx","providers","getSharedProviderFromEnv","options","key","JSON","stringify","getProvidersFromEnv","count","result","i","push","EvmAddressSchema","AbstractWitness","creatableModule","EvmWitnessConfigSchema","creatableModule","AbstractEvmWitness","AbstractWitness","configSchemas","_providers","undefined","getProvider","cache","error","providers","getProviders","length","Error","Date","now","cachedProviders","params"]}

package/dist/node/index.cjs

@@ -125,7 +125,7 @@ var getProviderFromEnv = /* @__PURE__ */ __name((chainId = 1, { providerSource =
   if (!provider) {
     provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId);
   }
-  return (0, import_assert2.assertEx)(provider, `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`);
+  return (0, import_assert2.assertEx)(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`);
 }, "getProviderFromEnv");
 var providers = {};
 var getSharedProviderFromEnv = /* @__PURE__ */ __name((chainId = 1, options) => {

package/dist/node/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["export * from './lib'\nexport * from './model'\nexport * from './Witness'\n","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 { InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, Provider, WebSocketProvider } 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  const provider =\n    process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createInfuraWss = (chainId: number) => {\n  const provider = process.env.INFURA_PROJECT_ID ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n\n  return provider\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n  return provider\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n  switch (providerSource) {\n    case 'quicknode': {\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      break\n    }\n    default:\n    case 'infura': {\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      break\n    }\n  }\n  if (!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 { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address'\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 { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyConfigSchema, creatableModule } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\nimport { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness'\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 ? (TAdditional extends Payload ? TAdditional['schema'] : EvmWitnessConfigSchema) : 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{\n  static override readonly configSchemas: string[] = [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;;;;;;;;;;;;;ACAA,oBAAyB;AAEzB,IAAMA,oBAAoB;AAQnB,IAAMC,eAAe,wBAACC,YAAoBC,gBAAAA;AAC/C,MAAI;AACF,UAAMC,MAAM,IAAIC,IAAIH,UAAAA;AACpB,QAAII,WAAWF,IAAIE;AACnB,QAAIC,OAAOH,IAAIG;AACf,QAAIC,OAAOJ,IAAIK;AACf,UAAMC,QAAQN,IAAIO;AAClB,QAAIL,aAAa,SAAS;AACxBA,iBAAW;AACXC,iBAAOK,wBAAST,aAAa,yBAAA;AAC7BK,aAAOJ,IAAIG,SAAS,SAAS,OAAOC,IAAAA,KAAS,QAAQJ,IAAIG,IAAI,GAAGC,IAAAA;AAChE,YAAMK,OAAO,GAAGP,QAAAA,KAAaC,IAAAA,IAAQC,IAAAA;AACrC,cAAOE,+BAAOI,UAAS,IAAI,GAAGD,IAAAA,IAAQH,KAAAA,KAAUG;IAClD,WAAWb,qBAAqBM,aAAa,WAAWC,SAAS,WAAW;AAC1ED,iBAAW;AACXC,iBAAOK,wBAAST,aAAa,yBAAA;AAC7B,YAAMY,YAAYP,KAAKQ,MAAM,GAAA;AAC7B,UAAID,UAAU,CAAA,MAAO,QAAQ;AAC3BA,kBAAUE,MAAK;MACjB;AACAT,aAAOO,UAAUG,KAAK,GAAA;AACtB,YAAML,OAAO,GAAGP,QAAAA,KAAaC,IAAAA,IAAQC,IAAAA;AACrC,cAAOE,+BAAOI,UAAS,IAAI,GAAGD,IAAAA,IAAQH,KAAAA,KAAUG;IAClD,OAAO;AACL,aAAOX;IACT;EACF,QAAQ;AAIN,WAAOA;EACT;AACF,GAhC4B;;;ACV5B,IAAAiB,iBAAyB;AACzB,oBAAsG;AAUtG,IAAMC,kBAAkB,wBAACC,YAAAA;AACvB,QAAMC,WACJC,QAAQC,IAAIC,qBAAqBF,QAAQC,IAAIE,wBAAwB,IAAIC,6BAAeN,SAASE,QAAQC,IAAIC,iBAAiB,IAAIG;AACpI,SAAON;AACT,GAJwB;AAMxB,IAAMO,kBAAkB,wBAACR,YAAAA;AACvB,QAAMC,WAAWC,QAAQC,IAAIC,oBAAoB,IAAIK,sCAAwBT,SAASE,QAAQC,IAAIC,iBAAiB,IAAIG;AACvH,SAAON;AACT,GAHwB;AAKxB,IAAMS,qBAAqB,wBAACV,YAAAA;AAC1B,QAAMW,kBAAkBT,QAAQC,IAAIS;AACpC,QAAMX,WAAWU,kBAAkB,IAAIE,gCAAkBF,iBAAiBX,OAAAA,IAAWO;AAErF,SAAON;AACT,GAL2B;AAO3B,IAAMa,qBAAqB,wBAACd,YAAAA;AAC1B,QAAMe,oBAAoBb,QAAQC,IAAIa;AACtC,QAAMf,WAAWc,oBAAoB,IAAIE,8BAAgBF,mBAAmBf,OAAAA,IAAWO;AACvF,SAAON;AACT,GAJ2B;AAMpB,IAAMiB,qBAAqB,wBAChClB,UAAkB,GAClB,EAAEmB,iBAAiB,UAAUC,eAAe,MAAK,IAAiC,CAAC,MAAC;AAEpF,MAAInB,WAAiCM;AACrC,UAAQY,gBAAAA;IACN,KAAK,aAAa;AAChB,cAAQC,cAAAA;QACN,KAAK,OAAO;AACVnB,qBAAWa,mBAAmBd,OAAAA;AAC9B;QACF;QACA,KAAK,OAAO;AACVC,qBAAWS,mBAAmBV,OAAAA;AAC9B;QACF;MACF;AACA;IACF;IACA;IACA,KAAK,UAAU;AACb,cAAQoB,cAAAA;QACN,KAAK,OAAO;AACVnB,qBAAWO,gBAAgBR,OAAAA;AAC3B;QACF;QACA,KAAK,OAAO;AACVC,qBAAWF,gBAAgBC,OAAAA;AAC3B;QACF;MACF;AACA;IACF;EACF;AACA,MAAI,CAACC,UAAU;AACbA,eAAWO,gBAAgBR,OAAAA,KAAYD,gBAAgBC,OAAAA,KAAYc,mBAAmBd,OAAAA;EACxF;AACA,aAAOqB,yBAASpB,UAAU,8BAA8BD,OAAAA,MAAamB,cAAAA,IAAkBC,YAAAA,EAAc;AACvG,GAtCkC;AAwClC,IAAME,YAAsC,CAAC;AAEtC,IAAMC,2BAA2B,wBACtCvB,UAAkB,GAClBwB,YAAAA;AAEA,QAAMC,MAAM,GAAGzB,OAAAA,IAAWwB,UAAUE,KAAKC,UAAUH,OAAAA,IAAW,SAAA;AAC9DF,YAAUG,GAAAA,IAAOH,UAAUG,GAAAA,KAAQP,mBAAmBlB,SAASwB,OAAAA;AAC/D,SAAOF,UAAUG,GAAAA;AACnB,GAPwC;AASjC,IAAMG,sBAAsB,wBAACC,QAAgB,GAAG7B,UAAkB,GAAMwB,UAAsC,CAAC,MAAC;AACrH,QAAMM,SAAqB,CAAA;AAC3B,WAASC,IAAI,GAAGA,IAAIF,OAAOE,KAAK;AAC9BD,WAAOE,KAAKd,mBAAmBlB,SAASwB,OAAAA,CAAAA;EAC1C;AACA,SAAOM;AACT,GANmC;;;ACpF5B,IAAMG,mBAAmB;;;ACAhC,8BAAgC;AAChC,0BAAiD;AAK1C,IAAMC,yBAAyB;IAyBtCC,qCAAAA;AACO,IAAeC,sBAAf,MAAeA,4BAUZC,wCAAAA;EAIAC,aAAqCC;EAI7C,MAAMC,YAAYC,QAAQ,OAAOC,OAAyD;AACxF,UAAMC,aAAY,MAAM,KAAKC,aAAaH,KAAAA;AAC1C,QAAIE,WAAUE,WAAW,GAAG;AAC1B,UAAIH,OAAO;AACT,cAAM,IAAII,MAAM,OAAOJ,UAAU,WAAWA,QAAQ,wBAAA;MACtD;AACA,aAAOH;IACT;AACA,WAAOI,WAAUI,KAAKC,IAAG,IAAKL,WAAUE,MAAM;EAChD;EAEA,MAAMD,aAAaH,QAAQ,OAA4B;AACrD,UAAMQ,kBAAkBR,QAAQ,KAAKH,aAAaC;AAClD,SAAKD,aAAaW,mBAAoB,MAAM,KAAKC,OAAOP,UAAS;AACjE,WAAO,KAAKL;EACd;AAGF;AA1BUD;AAGR,cAboBD,qBAaKe,iBAA0B;EAACjB;;AAb/C,IAAeE,qBAAf;","names":["allowIpfsIoRepair","checkIpfsUrl","urlToCheck","ipfsGateway","url","URL","protocol","host","path","pathname","query","search","assertEx","root","length","pathParts","split","shift","join","import_assert","createInfuraRpc","chainId","provider","process","env","INFURA_PROJECT_ID","INFURA_PROJECT_SECRET","InfuraProvider","undefined","createInfuraWss","InfuraWebSocketProvider","createQuicknodeWss","quickNodeWSSUri","QUICKNODE_WSS_URI","WebSocketProvider","createQuicknodeRpc","quickNodeHttpsUri","QUICKNODE_HTTPS_URI","JsonRpcProvider","getProviderFromEnv","providerSource","providerType","assertEx","providers","getSharedProviderFromEnv","options","key","JSON","stringify","getProvidersFromEnv","count","result","i","push","EvmAddressSchema","EvmWitnessConfigSchema","creatableModule","AbstractEvmWitness","AbstractWitness","_providers","undefined","getProvider","cache","error","providers","getProviders","length","Error","Date","now","cachedProviders","params","configSchemas"]}
+{"version":3,"sources":["../../src/index.ts","../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["export * from './lib'\nexport * from './model'\nexport * from './Witness'\n","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 { InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, Provider, WebSocketProvider } 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  const provider =\n    process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createInfuraWss = (chainId: number) => {\n  const provider = process.env.INFURA_PROJECT_ID ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n\n  return provider\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n  return provider\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n  switch (providerSource) {\n    case 'quicknode': {\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      break\n    }\n    default:\n    case 'infura': {\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      break\n    }\n  }\n  if (!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 { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address'\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 { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyConfigSchema, creatableModule } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\nimport { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness'\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 ? (TAdditional extends Payload ? TAdditional['schema'] : EvmWitnessConfigSchema) : 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{\n  static override readonly configSchemas: string[] = [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":["allowIpfsIoRepair","checkIpfsUrl","urlToCheck","ipfsGateway","url","URL","protocol","host","path","pathname","query","search","assertEx","root","length","pathParts","split","shift","join","import_assert","createInfuraRpc","chainId","provider","process","env","INFURA_PROJECT_ID","INFURA_PROJECT_SECRET","InfuraProvider","undefined","createInfuraWss","InfuraWebSocketProvider","createQuicknodeWss","quickNodeWSSUri","QUICKNODE_WSS_URI","WebSocketProvider","createQuicknodeRpc","quickNodeHttpsUri","QUICKNODE_HTTPS_URI","JsonRpcProvider","getProviderFromEnv","providerSource","providerType","assertEx","providers","getSharedProviderFromEnv","options","key","JSON","stringify","getProvidersFromEnv","count","result","i","push","EvmAddressSchema","EvmWitnessConfigSchema","creatableModule","AbstractEvmWitness","AbstractWitness","_providers","undefined","getProvider","cache","error","providers","getProviders","length","Error","Date","now","cachedProviders","params","configSchemas"]}

package/dist/node/index.js

@@ -95,7 +95,7 @@ var getProviderFromEnv = /* @__PURE__ */ __name((chainId = 1, { providerSource =
   if (!provider) {
     provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId);
   }
-  return assertEx2(provider, `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`);
+  return assertEx2(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`);
 }, "getProviderFromEnv");
 var providers = {};
 var getSharedProviderFromEnv = /* @__PURE__ */ __name((chainId = 1, options) => {

package/dist/node/index.js.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 { InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, Provider, WebSocketProvider } 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  const provider =\n    process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createInfuraWss = (chainId: number) => {\n  const provider = process.env.INFURA_PROJECT_ID ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n\n  return provider\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n  return provider\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n  switch (providerSource) {\n    case 'quicknode': {\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      break\n    }\n    default:\n    case 'infura': {\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      break\n    }\n  }\n  if (!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 { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address'\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 { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyConfigSchema, creatableModule } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\nimport { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness'\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 ? (TAdditional extends Payload ? TAdditional['schema'] : EvmWitnessConfigSchema) : 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{\n  static override readonly configSchemas: string[] = [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","allowIpfsIoRepair","checkIpfsUrl","urlToCheck","ipfsGateway","url","URL","protocol","host","path","pathname","query","search","assertEx","root","length","pathParts","split","shift","join","assertEx","InfuraProvider","InfuraWebSocketProvider","JsonRpcProvider","WebSocketProvider","createInfuraRpc","chainId","provider","process","env","INFURA_PROJECT_ID","INFURA_PROJECT_SECRET","InfuraProvider","undefined","createInfuraWss","InfuraWebSocketProvider","createQuicknodeWss","quickNodeWSSUri","QUICKNODE_WSS_URI","WebSocketProvider","createQuicknodeRpc","quickNodeHttpsUri","QUICKNODE_HTTPS_URI","JsonRpcProvider","getProviderFromEnv","providerSource","providerType","assertEx","providers","getSharedProviderFromEnv","options","key","JSON","stringify","getProvidersFromEnv","count","result","i","push","EvmAddressSchema","AbstractWitness","creatableModule","EvmWitnessConfigSchema","creatableModule","AbstractEvmWitness","AbstractWitness","_providers","undefined","getProvider","cache","error","providers","getProviders","length","Error","Date","now","cachedProviders","params","configSchemas"]}
+{"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 { InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, Provider, WebSocketProvider } 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  const provider =\n    process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET ? new InfuraProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createInfuraWss = (chainId: number) => {\n  const provider = process.env.INFURA_PROJECT_ID ? new InfuraWebSocketProvider(chainId, process.env.INFURA_PROJECT_ID) : undefined\n  return provider\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n\n  return provider\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n  return provider\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc' }: GetProvidersFromEnvOptions = {},\n): Provider => {\n  let provider: Provider | undefined = undefined\n  switch (providerSource) {\n    case 'quicknode': {\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      break\n    }\n    default:\n    case 'infura': {\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      break\n    }\n  }\n  if (!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 { Payload } from '@xyo-network/payload-model'\n\nexport const EvmAddressSchema = 'network.xyo.evm.address'\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 { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyConfigSchema, creatableModule } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { CustomWitnessInstance, WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\nimport { Provider } from 'ethers'\n\nexport const EvmWitnessConfigSchema = 'network.xyo.evm.witness'\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 ? (TAdditional extends Payload ? TAdditional['schema'] : EvmWitnessConfigSchema) : 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{\n  static override readonly configSchemas: string[] = [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","allowIpfsIoRepair","checkIpfsUrl","urlToCheck","ipfsGateway","url","URL","protocol","host","path","pathname","query","search","assertEx","root","length","pathParts","split","shift","join","assertEx","InfuraProvider","InfuraWebSocketProvider","JsonRpcProvider","WebSocketProvider","createInfuraRpc","chainId","provider","process","env","INFURA_PROJECT_ID","INFURA_PROJECT_SECRET","InfuraProvider","undefined","createInfuraWss","InfuraWebSocketProvider","createQuicknodeWss","quickNodeWSSUri","QUICKNODE_WSS_URI","WebSocketProvider","createQuicknodeRpc","quickNodeHttpsUri","QUICKNODE_HTTPS_URI","JsonRpcProvider","getProviderFromEnv","providerSource","providerType","assertEx","providers","getSharedProviderFromEnv","options","key","JSON","stringify","getProvidersFromEnv","count","result","i","push","EvmAddressSchema","AbstractWitness","creatableModule","EvmWitnessConfigSchema","creatableModule","AbstractEvmWitness","AbstractWitness","_providers","undefined","getProvider","cache","error","providers","getProviders","length","Error","Date","now","cachedProviders","params","configSchemas"]}

package/package.json

@@ -10,17 +10,17 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues"
   },
   "dependencies": {
-    "@xylabs/assert": "^2.13.29",
-    "@xylabs/object": "^2.88.5",
-    "@xylabs/promise": "^2.13.29",
-    "@xyo-network/abstract-witness": "~2.88.3",
-    "@xyo-network/module-model": "~2.88.3",
-    "@xyo-network/payload-model": "~2.88.3",
-    "@xyo-network/witness-model": "~2.88.3",
+    "@xylabs/assert": "^2.14.0",
+    "@xylabs/object": "^2.89.0",
+    "@xylabs/promise": "^2.14.0",
+    "@xyo-network/abstract-witness": "~2.89.0-rc.10",
+    "@xyo-network/module-model": "~2.89.0-rc.10",
+    "@xyo-network/payload-model": "~2.89.0-rc.10",
+    "@xyo-network/witness-model": "~2.89.0-rc.10",
     "ethers": "^6.10.0"
   },
   "devDependencies": {
-    "@xylabs/jest-helpers": "^2.13.29",
+    "@xylabs/jest-helpers": "^2.14.0",
     "@xylabs/ts-scripts-yarn3": "^3.2.42",
     "@xylabs/tsconfig": "^3.2.42",
     "ethers": "^6.10.0",
@@ -66,6 +66,7 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js.git"
   },
   "sideEffects": false,
-  "version": "2.88.3",
-  "type": "module"
+  "version": "2.89.0-rc.10",
+  "type": "module",
+  "stableVersion": "2.88.3"
 }

package/src/lib/getProviderFromEnv.ts

@@ -70,7 +70,7 @@ export const getProviderFromEnv = (
   if (!provider) {
     provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId)
   }
-  return assertEx(provider, `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`)
+  return assertEx(provider, () => `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`)
 }
 
 const providers: Record<string, Provider> = {}