@xyo-network/witness-blockchain-abstract 2.79.3 → 2.79.5

package/dist/node/index.d.ts

@@ -1,3 +1,4 @@
 export * from './lib';
+export * from './model';
 export * from './Witness';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA"}

package/dist/node/index.js

@@ -23,84 +23,57 @@ var checkIpfsUrl = (urlToCheck, ipfsGateway) => {
   }
 };
 
-// src/lib/getErc1967Status.ts
-import { BigNumber } from "@xylabs/bignumber";
-import { UpgradeableBeacon__factory } from "@xyo-network/open-zeppelin-typechain";
-var ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
-var ERC1967_PROXY_BEACON_STORAGE_SLOT = "0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50";
-var ERC1967_PROXY_ADMIN_STORAGE_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
-var ERC1967_PROXY_ROLLBACK_STORAGE_SLOT = "0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143";
-var hexBytesOnlyOnly = (value) => {
-  return value.startsWith("0x") ? value.substring(2) : value;
-};
-var addressFromHex = (value) => {
-  return `0x${hexBytesOnlyOnly(value).substring(24)}`;
-};
-var isHexZero = (value) => {
-  return new BigNumber(hexBytesOnlyOnly(value), "hex").eqn(0);
-};
-var readAddressFromSlot = async (provider, address, slot) => {
-  const slotValue = await provider.getStorageAt(address, slot);
-  return addressFromHex(slotValue);
-};
-var getErc1967Status = async (provider, address) => {
-  const proxy = {
-    admin: await readAddressFromSlot(provider, address, ERC1967_PROXY_ADMIN_STORAGE_SLOT),
-    beacon: await readAddressFromSlot(provider, address, ERC1967_PROXY_BEACON_STORAGE_SLOT),
-    implementation: await readAddressFromSlot(provider, address, ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT),
-    rollback: await readAddressFromSlot(provider, address, ERC1967_PROXY_ROLLBACK_STORAGE_SLOT)
-  };
-  if (!isHexZero(proxy.beacon)) {
-    const beacon = UpgradeableBeacon__factory.connect(proxy.beacon, provider);
-    try {
-      proxy.implementation = await beacon.callStatic.implementation();
-    } catch (ex) {
-      const error = ex;
-      console.log(error.message);
-    }
-  }
-  return {
-    address,
-    implementation: isHexZero(proxy.implementation) ? address : proxy.implementation,
-    proxy
-  };
-};
-
 // src/lib/getProviderFromEnv.ts
 import { InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, WebSocketProvider } from "@ethersproject/providers";
 import { assertEx } from "@xylabs/assert";
-var createInfuraRpc = (chainId) => {
-  return new InfuraProvider(chainId, {
+var enableConfigOverride = false;
+var configureConnection = (connection, { timeout = 1e3 } = {}) => {
+  if (connection && enableConfigOverride) {
+    connection.timeout = timeout;
+    connection.throttleCallback = async (attempt, url) => {
+      console.log(`throttleCallback[${attempt}]: ${url}`);
+      return await Promise.resolve(true);
+    };
+  }
+};
+var createInfuraRpc = (chainId, overrides) => {
+  const provider = process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET ? new InfuraProvider(chainId, {
     projectId: process.env.INFURA_PROJECT_ID,
     projectSecret: process.env.INFURA_PROJECT_SECRET
-  });
+  }) : void 0;
+  configureConnection(provider == null ? void 0 : provider.connection, overrides);
+  return provider;
 };
-var createInfuraWss = (chainId) => {
-  return new InfuraWebSocketProvider(chainId, {
+var createInfuraWss = (chainId, overrides) => {
+  const provider = process.env.INFURA_PROJECT_ID ? new InfuraWebSocketProvider(chainId, {
     projectId: process.env.INFURA_PROJECT_ID
-  });
+  }) : void 0;
+  configureConnection(provider == null ? void 0 : provider.connection, overrides);
+  return provider;
 };
-var createQuicknodeWss = (chainId) => {
+var createQuicknodeWss = (chainId, overrides) => {
   const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI;
-  return quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : void 0;
+  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : void 0;
+  configureConnection(provider == null ? void 0 : provider.connection, overrides);
+  return provider;
 };
-var createQuicknodeRpc = (chainId) => {
+var createQuicknodeRpc = (chainId, overrides) => {
   const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI;
-  return quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : void 0;
+  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : void 0;
+  configureConnection(provider == null ? void 0 : provider.connection, overrides);
+  return provider;
 };
-var getProviderFromEnv = (chainId = 1, options) => {
-  const { providerSource, providerType } = options ?? {};
+var getProviderFromEnv = (chainId = 1, { providerSource = "infura", providerType = "rpc", overrides } = {}) => {
   let provider = void 0;
   switch (providerSource) {
     case "quicknode": {
       switch (providerType) {
         case "rpc": {
-          provider = createQuicknodeRpc(chainId);
+          provider = createQuicknodeRpc(chainId, overrides);
           break;
         }
-        case "wss":
-        default: {
-          provider = createQuicknodeWss(chainId);
+        case "wss": {
+          provider = createQuicknodeWss(chainId, overrides);
           break;
         }
       }
@@ -109,13 +82,12 @@ var getProviderFromEnv = (chainId = 1, options) => {
     default:
     case "infura": {
       switch (providerType) {
-        case "rpc": {
-          provider = createInfuraRpc(chainId);
+        case "wss": {
+          provider = createInfuraWss(chainId, overrides);
           break;
         }
-        case "wss":
-        default: {
-          provider = createInfuraWss(chainId);
+        case "rpc": {
+          provider = createInfuraRpc(chainId, overrides);
           break;
         }
       }
@@ -125,7 +97,7 @@ var getProviderFromEnv = (chainId = 1, options) => {
   if (!provider) {
     provider = createInfuraWss(chainId) ?? createInfuraRpc(chainId) ?? createQuicknodeRpc(chainId);
   }
-  return assertEx(provider, `Unable to create provider [${chainId}]: ${options ? JSON.stringify(options) : "default"}`);
+  return assertEx(provider, `Unable to create provider [${chainId}]: ${providerSource}|${providerType}`);
 };
 var providers = {};
 var getSharedProviderFromEnv = (chainId = 1, options) => {
@@ -133,27 +105,45 @@ var getSharedProviderFromEnv = (chainId = 1, options) => {
   providers[key] = providers[key] ?? getProviderFromEnv(chainId, options);
   return providers[key];
 };
+var getProvidersFromEnv = (count = 1, chainId = 1, options = {}) => {
+  const result = [];
+  for (let i = 0; i < count; i++) {
+    result.push(getProviderFromEnv(chainId, options));
+  }
+  return result;
+};
+
+// src/model.ts
+var BlockchainAddressSchema = "network.xyo.blockchain.address";
 
 // src/Witness.ts
 import { AbstractWitness } from "@xyo-network/abstract-witness";
 var BlockchainWitnessConfigSchema = "network.xyo.blockchain.witness";
 var AbstractBlockchainWitness = class extends AbstractWitness {
-  get provider() {
-    const { providers: providers2 } = this.params;
+  _providers = void 0;
+  async getProvider(cache = false, error) {
+    const providers2 = await this.getProviders(cache);
+    if (providers2.length === 0) {
+      if (error) {
+        throw Error(typeof error === "string" ? error : "No providers available");
+      }
+      return void 0;
+    }
     return providers2[Date.now() % providers2.length];
   }
+  async getProviders(cache = false) {
+    const cachedProviders = cache ? this._providers : void 0;
+    this._providers = cachedProviders ?? await this.params.providers();
+    return this._providers;
+  }
 };
 export {
   AbstractBlockchainWitness,
+  BlockchainAddressSchema,
   BlockchainWitnessConfigSchema,
-  ERC1967_PROXY_ADMIN_STORAGE_SLOT,
-  ERC1967_PROXY_BEACON_STORAGE_SLOT,
-  ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT,
-  ERC1967_PROXY_ROLLBACK_STORAGE_SLOT,
   checkIpfsUrl,
-  getErc1967Status,
   getProviderFromEnv,
-  getSharedProviderFromEnv,
-  readAddressFromSlot
+  getProvidersFromEnv,
+  getSharedProviderFromEnv
 };
 //# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/checkIpfsUrl.ts","../../src/lib/getErc1967Status.ts","../../src/lib/getProviderFromEnv.ts","../../src/Witness.ts"],"sourcesContent":["/**\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) => {\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 = ipfsGateway\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 {\n      return urlToCheck\n    }\n  } catch (ex) {\n    const error = ex as Error\n    console.error(`${error.name}:${error.message} [${urlToCheck}]`)\n    console.log(error.stack)\n    return undefined\n  }\n}\n","import { BaseProvider } from '@ethersproject/providers'\nimport { BigNumber } from '@xylabs/bignumber'\nimport { UpgradeableBeacon__factory } from '@xyo-network/open-zeppelin-typechain'\n\nexport const ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT = '0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc'\nexport const ERC1967_PROXY_BEACON_STORAGE_SLOT = '0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50'\nexport const ERC1967_PROXY_ADMIN_STORAGE_SLOT = '0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103'\nexport const ERC1967_PROXY_ROLLBACK_STORAGE_SLOT = '0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143'\n\nexport interface Erc1967DataSlots {\n  admin: string\n  beacon: string\n  implementation: string\n  rollback: string\n}\n\nexport interface Erc1967Status {\n  address: string\n  implementation: string\n  proxy: Erc1967DataSlots\n}\n\nconst hexBytesOnlyOnly = (value: string) => {\n  return value.startsWith('0x') ? value.substring(2) : value\n}\n\nconst addressFromHex = (value: string) => {\n  return `0x${hexBytesOnlyOnly(value).substring(24)}`\n}\n\nconst isHexZero = (value: string) => {\n  return new BigNumber(hexBytesOnlyOnly(value), 'hex').eqn(0)\n}\n\nexport const readAddressFromSlot = async (provider: BaseProvider, address: string, slot: string) => {\n  const slotValue = await provider.getStorageAt(address, slot)\n  return addressFromHex(slotValue)\n}\n\nexport const getErc1967Status = async (provider: BaseProvider, address: string): Promise<Erc1967Status> => {\n  const proxy: Erc1967DataSlots = {\n    admin: await readAddressFromSlot(provider, address, ERC1967_PROXY_ADMIN_STORAGE_SLOT),\n    beacon: await readAddressFromSlot(provider, address, ERC1967_PROXY_BEACON_STORAGE_SLOT),\n    implementation: await readAddressFromSlot(provider, address, ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT),\n    rollback: await readAddressFromSlot(provider, address, ERC1967_PROXY_ROLLBACK_STORAGE_SLOT),\n  }\n\n  if (!isHexZero(proxy.beacon)) {\n    const beacon = UpgradeableBeacon__factory.connect(proxy.beacon, provider)\n    try {\n      proxy.implementation = await beacon.callStatic.implementation()\n    } catch (ex) {\n      const error = ex as Error\n      console.log(error.message)\n    }\n  }\n\n  return {\n    address,\n    implementation: isHexZero(proxy.implementation) ? address : proxy.implementation,\n    proxy,\n  }\n}\n","import { BaseProvider, InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, WebSocketProvider } from '@ethersproject/providers'\nimport { assertEx } from '@xylabs/assert'\n\nexport type ProviderSource = 'infura' | 'quicknode'\nexport type ProviderType = 'rpc' | 'wss'\n\nconst createInfuraRpc = (chainId: number) => {\n  return new InfuraProvider(chainId, {\n    projectId: process.env.INFURA_PROJECT_ID,\n    projectSecret: process.env.INFURA_PROJECT_SECRET,\n  })\n}\n\nconst createInfuraWss = (chainId: number) => {\n  return new InfuraWebSocketProvider(chainId, {\n    projectId: process.env.INFURA_PROJECT_ID,\n  })\n}\n\nconst createQuicknodeWss = (chainId: number) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  return quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n}\n\nconst createQuicknodeRpc = (chainId: number) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  return quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  options?: { providerSource?: ProviderSource; providerType?: ProviderType },\n): BaseProvider => {\n  const { providerSource, providerType } = options ?? {}\n  let provider: BaseProvider | 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        default: {\n          provider = createQuicknodeWss(chainId)\n          break\n        }\n      }\n      break\n    }\n    default:\n    case 'infura': {\n      switch (providerType) {\n        case 'rpc': {\n          provider = createInfuraRpc(chainId)\n          break\n        }\n        case 'wss':\n        default: {\n          provider = createInfuraWss(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}]: ${options ? JSON.stringify(options) : 'default'}`)\n}\n\nconst providers: Record<string, BaseProvider> = {}\n\nexport const getSharedProviderFromEnv = (\n  chainId: number = 0x01,\n  options?: { providerSource?: ProviderSource; providerType?: ProviderType },\n): BaseProvider => {\n  const key = `${chainId}:${options ? JSON.stringify(options) : 'default'}`\n  providers[key] = providers[key] ?? getProviderFromEnv(chainId, options)\n  return providers[key]\n}\n","import { BaseProvider } from '@ethersproject/providers'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyObject, WithAdditional } from '@xyo-network/object'\nimport { Payload } from '@xyo-network/payload-model'\nimport { WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\n\nexport const BlockchainWitnessConfigSchema = 'network.xyo.blockchain.witness'\nexport type BlockchainWitnessConfigSchema = typeof BlockchainWitnessConfigSchema\n\nexport type BlockchainWitnessConfig<TAdditional extends Omit<Payload, 'schema'> | void = void, TSchema extends string | void = void> = WitnessConfig<\n  TAdditional & { schema: TSchema extends void ? (TAdditional extends void ? string : BlockchainWitnessConfigSchema) : TSchema }\n>\n\nexport type AdditionalBlockchainWitnessParams = {\n  providers: BaseProvider[]\n}\n\nexport type BlockchainWitnessParams<\n  TConfig extends BlockchainWitnessConfig = BlockchainWitnessConfig,\n  TAdditionalParams extends AnyObject | void = void,\n> = WitnessParams<\n  TConfig,\n  WithAdditional<\n    {\n      providers: BaseProvider[]\n    },\n    TAdditionalParams\n  >\n>\n\nexport abstract class AbstractBlockchainWitness<\n  TParams extends BlockchainWitnessParams = BlockchainWitnessParams,\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> extends AbstractWitness<TParams, TIn, TOut, TEventData> {\n  get provider() {\n    const { providers } = this.params\n    return providers[Date.now() % providers.length] //pick a random provider\n  }\n}\n"],"mappings":"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","names":["providers"]}
+{"version":3,"sources":["../../src/lib/checkIpfsUrl.ts","../../src/lib/getProviderFromEnv.ts","../../src/model.ts","../../src/Witness.ts"],"sourcesContent":["/**\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) => {\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 = ipfsGateway\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 {\n      return urlToCheck\n    }\n  } catch (ex) {\n    const error = ex as Error\n    console.error(`${error.name}:${error.message} [${urlToCheck}]`)\n    console.log(error.stack)\n    return undefined\n  }\n}\n","import { BaseProvider, InfuraProvider, InfuraWebSocketProvider, JsonRpcProvider, WebSocketProvider } from '@ethersproject/providers'\nimport { ConnectionInfo } from '@ethersproject/web'\nimport { assertEx } from '@xylabs/assert'\n\nexport type ProviderSource = 'infura' | 'quicknode'\nexport type ProviderType = 'rpc' | 'wss'\n\nexport interface GetProvidersFromEnvOptions {\n  overrides?: Partial<ConnectionInfo>\n  providerSource?: ProviderSource\n  providerType?: ProviderType\n}\n\nconst enableConfigOverride = false\n\nconst configureConnection = (connection?: ConnectionInfo, { timeout = 1000 }: Partial<ConnectionInfo> = {}) => {\n  if (connection && enableConfigOverride) {\n    connection.timeout = timeout\n    connection.throttleCallback = async (attempt, url) => {\n      console.log(`throttleCallback[${attempt}]: ${url}`)\n      return await Promise.resolve(true)\n    }\n  }\n}\n\nconst createInfuraRpc = (chainId: number, overrides?: Partial<ConnectionInfo>) => {\n  const provider =\n    process.env.INFURA_PROJECT_ID && process.env.INFURA_PROJECT_SECRET\n      ? new InfuraProvider(chainId, {\n          projectId: process.env.INFURA_PROJECT_ID,\n          projectSecret: process.env.INFURA_PROJECT_SECRET,\n        })\n      : undefined\n  configureConnection(provider?.connection, overrides)\n  return provider\n}\n\nconst createInfuraWss = (chainId: number, overrides?: Partial<ConnectionInfo>) => {\n  const provider = process.env.INFURA_PROJECT_ID\n    ? new InfuraWebSocketProvider(chainId, {\n        projectId: process.env.INFURA_PROJECT_ID,\n      })\n    : undefined\n  configureConnection(provider?.connection, overrides)\n  return provider\n}\n\nconst createQuicknodeWss = (chainId: number, overrides?: Partial<ConnectionInfo>) => {\n  const quickNodeWSSUri = process.env.QUICKNODE_WSS_URI\n  const provider = quickNodeWSSUri ? new WebSocketProvider(quickNodeWSSUri, chainId) : undefined\n  configureConnection(provider?.connection, overrides)\n  return provider\n}\n\nconst createQuicknodeRpc = (chainId: number, overrides?: Partial<ConnectionInfo>) => {\n  const quickNodeHttpsUri = process.env.QUICKNODE_HTTPS_URI\n  const provider = quickNodeHttpsUri ? new JsonRpcProvider(quickNodeHttpsUri, chainId) : undefined\n  configureConnection(provider?.connection, overrides)\n  return provider\n}\n\nexport const getProviderFromEnv = (\n  chainId: number = 0x01,\n  { providerSource = 'infura', providerType = 'rpc', overrides }: GetProvidersFromEnvOptions = {},\n): BaseProvider => {\n  let provider: BaseProvider | undefined = undefined\n  switch (providerSource) {\n    case 'quicknode': {\n      switch (providerType) {\n        case 'rpc': {\n          provider = createQuicknodeRpc(chainId, overrides)\n          break\n        }\n        case 'wss': {\n          provider = createQuicknodeWss(chainId, overrides)\n          break\n        }\n      }\n      break\n    }\n    default:\n    case 'infura': {\n      switch (providerType) {\n        case 'wss': {\n          provider = createInfuraWss(chainId, overrides)\n          break\n        }\n        case 'rpc': {\n          provider = createInfuraRpc(chainId, overrides)\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, BaseProvider> = {}\n\nexport const getSharedProviderFromEnv = (\n  chainId: number = 0x01,\n  options?: { providerSource?: ProviderSource; providerType?: ProviderType },\n): BaseProvider => {\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 = {}): BaseProvider[] => {\n  const result: BaseProvider[] = []\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 BlockchainAddressSchema = 'network.xyo.blockchain.address'\nexport type BlockchainAddressSchema = typeof BlockchainAddressSchema\n\nexport type BlockchainAddress = Payload<\n  {\n    address?: string\n    blockTag?: string | number\n    chainId?: number\n  },\n  BlockchainAddressSchema\n>\n","import { BaseProvider } from '@ethersproject/providers'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractWitness } from '@xyo-network/abstract-witness'\nimport { AnyObject, WithAdditional } from '@xyo-network/object'\nimport { Payload } from '@xyo-network/payload-model'\nimport { WitnessConfig, WitnessInstance, WitnessModuleEventData, WitnessParams } from '@xyo-network/witness-model'\n\nexport const BlockchainWitnessConfigSchema = 'network.xyo.blockchain.witness'\nexport type BlockchainWitnessConfigSchema = typeof BlockchainWitnessConfigSchema\n\nexport type BlockchainWitnessConfig<TAdditional extends Omit<Payload, 'schema'> | void = void, TSchema extends string | void = void> = WitnessConfig<\n  TAdditional & { schema: TSchema extends void ? (TAdditional extends void ? string : BlockchainWitnessConfigSchema) : TSchema }\n>\n\nexport type AdditionalBlockchainWitnessParams = {\n  providers: BaseProvider[]\n}\n\nexport type BlockchainWitnessParams<\n  TConfig extends BlockchainWitnessConfig = BlockchainWitnessConfig,\n  TAdditionalParams extends AnyObject | void = void,\n> = WitnessParams<\n  TConfig,\n  WithAdditional<\n    {\n      providers: () => Promisable<BaseProvider[]>\n    },\n    TAdditionalParams\n  >\n>\n\nexport abstract class AbstractBlockchainWitness<\n  TParams extends BlockchainWitnessParams = BlockchainWitnessParams,\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> extends AbstractWitness<TParams, TIn, TOut, TEventData> {\n  private _providers: BaseProvider[] | undefined = undefined\n\n  async getProvider(cache?: boolean): Promise<BaseProvider | undefined>\n  async getProvider(cache: boolean, error: string | true): Promise<BaseProvider>\n  async getProvider(cache = false, error?: string | boolean): Promise<BaseProvider | undefined> {\n    const providers = await this.getProviders(cache)\n    if (providers.length === 0) {\n      if (error) {\n        throw 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<BaseProvider[]> {\n    const cachedProviders = cache ? this._providers : undefined\n    this._providers = cachedProviders ?? (await this.params.providers())\n    return this._providers\n  }\n}\n"],"mappings":";AAMO,IAAM,eAAe,CAAC,YAAoB,gBAAwB;AACvE,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;AACP,aAAO,IAAI,SAAS,SAAS,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,GAAG,IAAI;AACpE,YAAM,OAAO,GAAG,QAAQ,KAAK,IAAI,IAAI,IAAI;AACzC,cAAO,+BAAO,UAAS,IAAI,GAAG,IAAI,IAAI,KAAK,KAAK;AAAA,IAClD,OAAO;AACL,aAAO;AAAA,IACT;AAAA,EACF,SAAS,IAAI;AACX,UAAM,QAAQ;AACd,YAAQ,MAAM,GAAG,MAAM,IAAI,IAAI,MAAM,OAAO,KAAK,UAAU,GAAG;AAC9D,YAAQ,IAAI,MAAM,KAAK;AACvB,WAAO;AAAA,EACT;AACF;;;AC5BA,SAAuB,gBAAgB,yBAAyB,iBAAiB,yBAAyB;AAE1G,SAAS,gBAAgB;AAWzB,IAAM,uBAAuB;AAE7B,IAAM,sBAAsB,CAAC,YAA6B,EAAE,UAAU,IAAK,IAA6B,CAAC,MAAM;AAC7G,MAAI,cAAc,sBAAsB;AACtC,eAAW,UAAU;AACrB,eAAW,mBAAmB,OAAO,SAAS,QAAQ;AACpD,cAAQ,IAAI,oBAAoB,OAAO,MAAM,GAAG,EAAE;AAClD,aAAO,MAAM,QAAQ,QAAQ,IAAI;AAAA,IACnC;AAAA,EACF;AACF;AAEA,IAAM,kBAAkB,CAAC,SAAiB,cAAwC;AAChF,QAAM,WACJ,QAAQ,IAAI,qBAAqB,QAAQ,IAAI,wBACzC,IAAI,eAAe,SAAS;AAAA,IAC1B,WAAW,QAAQ,IAAI;AAAA,IACvB,eAAe,QAAQ,IAAI;AAAA,EAC7B,CAAC,IACD;AACN,sBAAoB,qCAAU,YAAY,SAAS;AACnD,SAAO;AACT;AAEA,IAAM,kBAAkB,CAAC,SAAiB,cAAwC;AAChF,QAAM,WAAW,QAAQ,IAAI,oBACzB,IAAI,wBAAwB,SAAS;AAAA,IACnC,WAAW,QAAQ,IAAI;AAAA,EACzB,CAAC,IACD;AACJ,sBAAoB,qCAAU,YAAY,SAAS;AACnD,SAAO;AACT;AAEA,IAAM,qBAAqB,CAAC,SAAiB,cAAwC;AACnF,QAAM,kBAAkB,QAAQ,IAAI;AACpC,QAAM,WAAW,kBAAkB,IAAI,kBAAkB,iBAAiB,OAAO,IAAI;AACrF,sBAAoB,qCAAU,YAAY,SAAS;AACnD,SAAO;AACT;AAEA,IAAM,qBAAqB,CAAC,SAAiB,cAAwC;AACnF,QAAM,oBAAoB,QAAQ,IAAI;AACtC,QAAM,WAAW,oBAAoB,IAAI,gBAAgB,mBAAmB,OAAO,IAAI;AACvF,sBAAoB,qCAAU,YAAY,SAAS;AACnD,SAAO;AACT;AAEO,IAAM,qBAAqB,CAChC,UAAkB,GAClB,EAAE,iBAAiB,UAAU,eAAe,OAAO,UAAU,IAAgC,CAAC,MAC7E;AACjB,MAAI,WAAqC;AACzC,UAAQ,gBAAgB;AAAA,IACtB,KAAK,aAAa;AAChB,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,mBAAmB,SAAS,SAAS;AAChD;AAAA,QACF;AAAA,QACA,KAAK,OAAO;AACV,qBAAW,mBAAmB,SAAS,SAAS;AAChD;AAAA,QACF;AAAA,MACF;AACA;AAAA,IACF;AAAA,IACA;AAAA,IACA,KAAK,UAAU;AACb,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,gBAAgB,SAAS,SAAS;AAC7C;AAAA,QACF;AAAA,QACA,KAAK,OAAO;AACV,qBAAW,gBAAgB,SAAS,SAAS;AAC7C;AAAA,QACF;AAAA,MACF;AACA;AAAA,IACF;AAAA,EACF;AACA,MAAI,CAAC,UAAU;AACb,eAAW,gBAAgB,OAAO,KAAK,gBAAgB,OAAO,KAAK,mBAAmB,OAAO;AAAA,EAC/F;AACA,SAAO,SAAS,UAAU,8BAA8B,OAAO,MAAM,cAAc,IAAI,YAAY,EAAE;AACvG;AAEA,IAAM,YAA0C,CAAC;AAE1C,IAAM,2BAA2B,CACtC,UAAkB,GAClB,YACiB;AACjB,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,MAAsB;AAC1I,QAAM,SAAyB,CAAC;AAChC,WAAS,IAAI,GAAG,IAAI,OAAO,KAAK;AAC9B,WAAO,KAAK,mBAAmB,SAAS,OAAO,CAAC;AAAA,EAClD;AACA,SAAO;AACT;;;ACpHO,IAAM,0BAA0B;;;ACAvC,SAAS,uBAAuB;AAKzB,IAAM,gCAAgC;AAwBtC,IAAe,4BAAf,cASG,gBAAgD;AAAA,EAChD,aAAyC;AAAA,EAIjD,MAAM,YAAY,QAAQ,OAAO,OAA6D;AAC5F,UAAMA,aAAY,MAAM,KAAK,aAAa,KAAK;AAC/C,QAAIA,WAAU,WAAW,GAAG;AAC1B,UAAI,OAAO;AACT,cAAM,MAAM,OAAO,UAAU,WAAW,QAAQ,wBAAwB;AAAA,MAC1E;AACA,aAAO;AAAA,IACT;AACA,WAAOA,WAAU,KAAK,IAAI,IAAIA,WAAU,MAAM;AAAA,EAChD;AAAA,EAEA,MAAM,aAAa,QAAQ,OAAgC;AACzD,UAAM,kBAAkB,QAAQ,KAAK,aAAa;AAClD,SAAK,aAAa,mBAAoB,MAAM,KAAK,OAAO,UAAU;AAClE,WAAO,KAAK;AAAA,EACd;AACF;","names":["providers"]}

package/dist/node/lib/getProviderFromEnv.d.cts

@@ -1,12 +1,16 @@
 import { BaseProvider } from '@ethersproject/providers';
+import { ConnectionInfo } from '@ethersproject/web';
 export type ProviderSource = 'infura' | 'quicknode';
 export type ProviderType = 'rpc' | 'wss';
-export declare const getProviderFromEnv: (chainId?: number, options?: {
+export interface GetProvidersFromEnvOptions {
+    overrides?: Partial<ConnectionInfo>;
     providerSource?: ProviderSource;
     providerType?: ProviderType;
-}) => BaseProvider;
+}
+export declare const getProviderFromEnv: (chainId?: number, { providerSource, providerType, overrides }?: GetProvidersFromEnvOptions) => BaseProvider;
 export declare const getSharedProviderFromEnv: (chainId?: number, options?: {
     providerSource?: ProviderSource;
     providerType?: ProviderType;
 }) => BaseProvider;
+export declare const getProvidersFromEnv: (count?: number, chainId?: number, options?: GetProvidersFromEnvOptions) => BaseProvider[];
 //# sourceMappingURL=getProviderFromEnv.d.ts.map

package/dist/node/lib/getProviderFromEnv.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"getProviderFromEnv.d.ts","sourceRoot":"","sources":["../../../src/lib/getProviderFromEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA+E,MAAM,0BAA0B,CAAA;AAGpI,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAA;AACnD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAA;AAyBxC,eAAO,MAAM,kBAAkB,aACpB,MAAM,YACL;IAAE,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,KACzE,YAsCF,CAAA;AAID,eAAO,MAAM,wBAAwB,aAC1B,MAAM,YACL;IAAE,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,KACzE,YAIF,CAAA"}
+{"version":3,"file":"getProviderFromEnv.d.ts","sourceRoot":"","sources":["../../../src/lib/getProviderFromEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA+E,MAAM,0BAA0B,CAAA;AACpI,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAA;AACnD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAA;AAExC,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAkDD,eAAO,MAAM,kBAAkB,aACpB,MAAM,gDACiD,0BAA0B,KACzF,YAmCF,CAAA;AAID,eAAO,MAAM,wBAAwB,aAC1B,MAAM,YACL;IAAE,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,KACzE,YAIF,CAAA;AAED,eAAO,MAAM,mBAAmB,WAAW,MAAM,YAAe,MAAM,YAAkB,0BAA0B,KAAQ,YAAY,EAMrI,CAAA"}

package/dist/node/lib/getProviderFromEnv.d.mts

@@ -1,12 +1,16 @@
 import { BaseProvider } from '@ethersproject/providers';
+import { ConnectionInfo } from '@ethersproject/web';
 export type ProviderSource = 'infura' | 'quicknode';
 export type ProviderType = 'rpc' | 'wss';
-export declare const getProviderFromEnv: (chainId?: number, options?: {
+export interface GetProvidersFromEnvOptions {
+    overrides?: Partial<ConnectionInfo>;
     providerSource?: ProviderSource;
     providerType?: ProviderType;
-}) => BaseProvider;
+}
+export declare const getProviderFromEnv: (chainId?: number, { providerSource, providerType, overrides }?: GetProvidersFromEnvOptions) => BaseProvider;
 export declare const getSharedProviderFromEnv: (chainId?: number, options?: {
     providerSource?: ProviderSource;
     providerType?: ProviderType;
 }) => BaseProvider;
+export declare const getProvidersFromEnv: (count?: number, chainId?: number, options?: GetProvidersFromEnvOptions) => BaseProvider[];
 //# sourceMappingURL=getProviderFromEnv.d.ts.map

package/dist/node/lib/getProviderFromEnv.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"getProviderFromEnv.d.ts","sourceRoot":"","sources":["../../../src/lib/getProviderFromEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA+E,MAAM,0BAA0B,CAAA;AAGpI,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAA;AACnD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAA;AAyBxC,eAAO,MAAM,kBAAkB,aACpB,MAAM,YACL;IAAE,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,KACzE,YAsCF,CAAA;AAID,eAAO,MAAM,wBAAwB,aAC1B,MAAM,YACL;IAAE,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,KACzE,YAIF,CAAA"}
+{"version":3,"file":"getProviderFromEnv.d.ts","sourceRoot":"","sources":["../../../src/lib/getProviderFromEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA+E,MAAM,0BAA0B,CAAA;AACpI,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAA;AACnD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAA;AAExC,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAkDD,eAAO,MAAM,kBAAkB,aACpB,MAAM,gDACiD,0BAA0B,KACzF,YAmCF,CAAA;AAID,eAAO,MAAM,wBAAwB,aAC1B,MAAM,YACL;IAAE,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,KACzE,YAIF,CAAA;AAED,eAAO,MAAM,mBAAmB,WAAW,MAAM,YAAe,MAAM,YAAkB,0BAA0B,KAAQ,YAAY,EAMrI,CAAA"}

package/dist/node/lib/getProviderFromEnv.d.ts

@@ -1,12 +1,16 @@
 import { BaseProvider } from '@ethersproject/providers';
+import { ConnectionInfo } from '@ethersproject/web';
 export type ProviderSource = 'infura' | 'quicknode';
 export type ProviderType = 'rpc' | 'wss';
-export declare const getProviderFromEnv: (chainId?: number, options?: {
+export interface GetProvidersFromEnvOptions {
+    overrides?: Partial<ConnectionInfo>;
     providerSource?: ProviderSource;
     providerType?: ProviderType;
-}) => BaseProvider;
+}
+export declare const getProviderFromEnv: (chainId?: number, { providerSource, providerType, overrides }?: GetProvidersFromEnvOptions) => BaseProvider;
 export declare const getSharedProviderFromEnv: (chainId?: number, options?: {
     providerSource?: ProviderSource;
     providerType?: ProviderType;
 }) => BaseProvider;
+export declare const getProvidersFromEnv: (count?: number, chainId?: number, options?: GetProvidersFromEnvOptions) => BaseProvider[];
 //# sourceMappingURL=getProviderFromEnv.d.ts.map

package/dist/node/lib/getProviderFromEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getProviderFromEnv.d.ts","sourceRoot":"","sources":["../../../src/lib/getProviderFromEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA+E,MAAM,0BAA0B,CAAA;AAGpI,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAA;AACnD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAA;AAyBxC,eAAO,MAAM,kBAAkB,aACpB,MAAM,YACL;IAAE,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,KACzE,YAsCF,CAAA;AAID,eAAO,MAAM,wBAAwB,aAC1B,MAAM,YACL;IAAE,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,KACzE,YAIF,CAAA"}
+{"version":3,"file":"getProviderFromEnv.d.ts","sourceRoot":"","sources":["../../../src/lib/getProviderFromEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA+E,MAAM,0BAA0B,CAAA;AACpI,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAA;AACnD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAA;AAExC,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAkDD,eAAO,MAAM,kBAAkB,aACpB,MAAM,gDACiD,0BAA0B,KACzF,YAmCF,CAAA;AAID,eAAO,MAAM,wBAAwB,aAC1B,MAAM,YACL;IAAE,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,KACzE,YAIF,CAAA;AAED,eAAO,MAAM,mBAAmB,WAAW,MAAM,YAAe,MAAM,YAAkB,0BAA0B,KAAQ,YAAY,EAMrI,CAAA"}

package/dist/node/lib/index.d.cts

@@ -1,4 +1,3 @@
 export * from './checkIpfsUrl';
-export * from './getErc1967Status';
 export * from './getProviderFromEnv';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/lib/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA"}

package/dist/node/lib/index.d.mts

@@ -1,4 +1,3 @@
 export * from './checkIpfsUrl';
-export * from './getErc1967Status';
 export * from './getProviderFromEnv';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/lib/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA"}

package/dist/node/lib/index.d.ts

@@ -1,4 +1,3 @@
 export * from './checkIpfsUrl';
-export * from './getErc1967Status';
 export * from './getProviderFromEnv';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA"}

package/dist/node/model.d.cts

@@ -0,0 +1,9 @@
+import { Payload } from '@xyo-network/payload-model';
+export declare const BlockchainAddressSchema = "network.xyo.blockchain.address";
+export type BlockchainAddressSchema = typeof BlockchainAddressSchema;
+export type BlockchainAddress = Payload<{
+    address?: string;
+    blockTag?: string | number;
+    chainId?: number;
+}, BlockchainAddressSchema>;
+//# sourceMappingURL=model.d.ts.map

package/dist/node/model.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,eAAO,MAAM,uBAAuB,mCAAmC,CAAA;AACvE,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAEpE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,uBAAuB,CACxB,CAAA"}

package/dist/node/model.d.mts

@@ -0,0 +1,9 @@
+import { Payload } from '@xyo-network/payload-model';
+export declare const BlockchainAddressSchema = "network.xyo.blockchain.address";
+export type BlockchainAddressSchema = typeof BlockchainAddressSchema;
+export type BlockchainAddress = Payload<{
+    address?: string;
+    blockTag?: string | number;
+    chainId?: number;
+}, BlockchainAddressSchema>;
+//# sourceMappingURL=model.d.ts.map

package/dist/node/model.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,eAAO,MAAM,uBAAuB,mCAAmC,CAAA;AACvE,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAEpE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,uBAAuB,CACxB,CAAA"}

package/dist/node/model.d.ts

@@ -0,0 +1,9 @@
+import { Payload } from '@xyo-network/payload-model';
+export declare const BlockchainAddressSchema = "network.xyo.blockchain.address";
+export type BlockchainAddressSchema = typeof BlockchainAddressSchema;
+export type BlockchainAddress = Payload<{
+    address?: string;
+    blockTag?: string | number;
+    chainId?: number;
+}, BlockchainAddressSchema>;
+//# sourceMappingURL=model.d.ts.map

package/dist/node/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,eAAO,MAAM,uBAAuB,mCAAmC,CAAA;AACvE,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAEpE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,uBAAuB,CACxB,CAAA"}

package/package.json

@@ -10,15 +10,17 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues"
   },
   "dependencies": {
-    "@xylabs/assert": "^2.13.3",
-    "@xyo-network/abstract-witness": "~2.79.3",
-    "@xyo-network/object": "~2.79.3",
-    "@xyo-network/payload-model": "~2.79.3",
-    "@xyo-network/witness-model": "~2.79.3"
+    "@ethersproject/web": "^5.7.1",
+    "@xylabs/assert": "^2.13.8",
+    "@xylabs/promise": "^2.13.8",
+    "@xyo-network/abstract-witness": "~2.79.5",
+    "@xyo-network/object": "~2.79.5",
+    "@xyo-network/payload-model": "~2.79.5",
+    "@xyo-network/witness-model": "~2.79.5"
   },
   "devDependencies": {
     "@ethersproject/providers": "^5.7.2",
-    "@xylabs/jest-helpers": "^2.13.3",
+    "@xylabs/jest-helpers": "^2.13.8",
     "@xylabs/ts-scripts-yarn3": "^3.1.21",
     "@xylabs/tsconfig": "^3.1.21",
     "ethers": "^5.7.2",
@@ -64,6 +66,6 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js.git"
   },
   "sideEffects": false,
-  "version": "2.79.3",
+  "version": "2.79.5",
   "type": "module"
 }

package/src/Witness.ts

@@ -1,4 +1,5 @@
 import { BaseProvider } from '@ethersproject/providers'
+import { Promisable } from '@xylabs/promise'
 import { AbstractWitness } from '@xyo-network/abstract-witness'
 import { AnyObject, WithAdditional } from '@xyo-network/object'
 import { Payload } from '@xyo-network/payload-model'
@@ -22,7 +23,7 @@ export type BlockchainWitnessParams<
   TConfig,
   WithAdditional<
     {
-      providers: BaseProvider[]
+      providers: () => Promisable<BaseProvider[]>
     },
     TAdditionalParams
   >
@@ -38,8 +39,24 @@ export abstract class AbstractBlockchainWitness<
     TOut
   >,
 > extends AbstractWitness<TParams, TIn, TOut, TEventData> {
-  get provider() {
-    const { providers } = this.params
+  private _providers: BaseProvider[] | undefined = undefined
+
+  async getProvider(cache?: boolean): Promise<BaseProvider | undefined>
+  async getProvider(cache: boolean, error: string | true): Promise<BaseProvider>
+  async getProvider(cache = false, error?: string | boolean): Promise<BaseProvider | undefined> {
+    const providers = await this.getProviders(cache)
+    if (providers.length === 0) {
+      if (error) {
+        throw Error(typeof error === 'string' ? error : 'No providers available')
+      }
+      return undefined
+    }
     return providers[Date.now() % providers.length] //pick a random provider
   }
+
+  async getProviders(cache = false): Promise<BaseProvider[]> {
+    const cachedProviders = cache ? this._providers : undefined
+    this._providers = cachedProviders ?? (await this.params.providers())
+    return this._providers
+  }
 }

package/src/index.ts

@@ -1,2 +1,3 @@
 export * from './lib'
+export * from './model'
 export * from './Witness'