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

package/dist/browser/index.cjs

@@ -22,11 +22,86 @@ var src_exports = {};
 __export(src_exports, {
   AbstractBlockchainWitness: () => AbstractBlockchainWitness,
   BlockchainWitnessConfigSchema: () => BlockchainWitnessConfigSchema,
+  ERC1967_PROXY_ADMIN_STORAGE_SLOT: () => ERC1967_PROXY_ADMIN_STORAGE_SLOT,
+  ERC1967_PROXY_BEACON_STORAGE_SLOT: () => ERC1967_PROXY_BEACON_STORAGE_SLOT,
+  ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT: () => ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT,
+  ERC1967_PROXY_ROLLBACK_STORAGE_SLOT: () => ERC1967_PROXY_ROLLBACK_STORAGE_SLOT,
+  checkIpfsUrl: () => checkIpfsUrl,
+  getErc1967Status: () => getErc1967Status,
   getProviderFromEnv: () => getProviderFromEnv,
-  getSharedProviderFromEnv: () => getSharedProviderFromEnv
+  getSharedProviderFromEnv: () => getSharedProviderFromEnv,
+  readAddressFromSlot: () => readAddressFromSlot
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/lib/checkIpfsUrl.ts
+var checkIpfsUrl = (urlToCheck, ipfsGateway) => {
+  try {
+    const url = new URL(urlToCheck);
+    let protocol = url.protocol;
+    let host = url.host;
+    let path = url.pathname;
+    const query = url.search;
+    if (protocol === "ipfs:") {
+      protocol = "https:";
+      host = ipfsGateway;
+      path = url.host === "ipfs" ? `ipfs${path}` : `ipfs/${url.host}${path}`;
+      const root = `${protocol}//${host}/${path}`;
+      return query?.length > 0 ? `${root}?${query}` : root;
+    } else {
+      return urlToCheck;
+    }
+  } catch (ex) {
+    const error = ex;
+    console.error(`${error.name}:${error.message} [${urlToCheck}]`);
+    console.log(error.stack);
+    return void 0;
+  }
+};
+
+// src/lib/getErc1967Status.ts
+var import_bignumber = require("@xylabs/bignumber");
+var import_open_zeppelin_typechain = require("@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 import_bignumber.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 = import_open_zeppelin_typechain.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
 var import_providers = require("@ethersproject/providers");
 var import_assert = require("@xylabs/assert");

package/dist/browser/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/lib/getProviderFromEnv.ts","../../src/Witness.ts"],"sourcesContent":["export * from './lib'\nexport * from './Witness'\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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,uBAA0G;AAC1G,oBAAyB;AAKzB,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,gCAAe,SAAS;AAAA,IACjC,WAAW,QAAQ,IAAI;AAAA,IACvB,eAAe,QAAQ,IAAI;AAAA,EAC7B,CAAC;AACH;AAEA,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,yCAAwB,SAAS;AAAA,IAC1C,WAAW,QAAQ,IAAI;AAAA,EACzB,CAAC;AACH;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,kBAAkB,QAAQ,IAAI;AACpC,SAAO,kBAAkB,IAAI,mCAAkB,iBAAiB,OAAO,IAAI;AAC7E;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,oBAAoB,QAAQ,IAAI;AACtC,SAAO,oBAAoB,IAAI,iCAAgB,mBAAmB,OAAO,IAAI;AAC/E;AAEO,IAAM,qBAAqB,CAChC,UAAkB,GAClB,YACiB;AACjB,QAAM,EAAE,gBAAgB,aAAa,IAAI,WAAW,CAAC;AACrD,MAAI,WAAqC;AACzC,UAAQ,gBAAgB;AAAA,IACtB,KAAK,aAAa;AAChB,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,MACF;AACA;AAAA,IACF;AAAA,IACA;AAAA,IACA,KAAK,UAAU;AACb,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,gBAAgB,OAAO;AAClC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,gBAAgB,OAAO;AAClC;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,aAAO,wBAAS,UAAU,8BAA8B,OAAO,MAAM,UAAU,KAAK,UAAU,OAAO,IAAI,SAAS,EAAE;AACtH;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;;;AChFA,8BAAgC;AAKzB,IAAM,gCAAgC;AAwBtC,IAAe,4BAAf,cASG,wCAAgD;AAAA,EACxD,IAAI,WAAW;AACb,UAAM,EAAE,WAAAA,WAAU,IAAI,KAAK;AAC3B,WAAOA,WAAU,KAAK,IAAI,IAAIA,WAAU,MAAM;AAAA,EAChD;AACF;","names":["providers"]}
+{"version":3,"sources":["../../src/index.ts","../../src/lib/checkIpfsUrl.ts","../../src/lib/getErc1967Status.ts","../../src/lib/getProviderFromEnv.ts","../../src/Witness.ts"],"sourcesContent":["export * from './lib'\nexport * from './Witness'\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) => {\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"]}

package/dist/browser/index.js

@@ -1,3 +1,71 @@
+// src/lib/checkIpfsUrl.ts
+var checkIpfsUrl = (urlToCheck, ipfsGateway) => {
+  try {
+    const url = new URL(urlToCheck);
+    let protocol = url.protocol;
+    let host = url.host;
+    let path = url.pathname;
+    const query = url.search;
+    if (protocol === "ipfs:") {
+      protocol = "https:";
+      host = ipfsGateway;
+      path = url.host === "ipfs" ? `ipfs${path}` : `ipfs/${url.host}${path}`;
+      const root = `${protocol}//${host}/${path}`;
+      return query?.length > 0 ? `${root}?${query}` : root;
+    } else {
+      return urlToCheck;
+    }
+  } catch (ex) {
+    const error = ex;
+    console.error(`${error.name}:${error.message} [${urlToCheck}]`);
+    console.log(error.stack);
+    return void 0;
+  }
+};
+
+// 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";
@@ -78,7 +146,14 @@ var AbstractBlockchainWitness = class extends AbstractWitness {
 export {
   AbstractBlockchainWitness,
   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
+  getSharedProviderFromEnv,
+  readAddressFromSlot
 };
 //# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/getProviderFromEnv.ts","../../src/Witness.ts"],"sourcesContent":["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":";AAAA,SAAuB,gBAAgB,yBAAyB,iBAAiB,yBAAyB;AAC1G,SAAS,gBAAgB;AAKzB,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,eAAe,SAAS;AAAA,IACjC,WAAW,QAAQ,IAAI;AAAA,IACvB,eAAe,QAAQ,IAAI;AAAA,EAC7B,CAAC;AACH;AAEA,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,wBAAwB,SAAS;AAAA,IAC1C,WAAW,QAAQ,IAAI;AAAA,EACzB,CAAC;AACH;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,kBAAkB,QAAQ,IAAI;AACpC,SAAO,kBAAkB,IAAI,kBAAkB,iBAAiB,OAAO,IAAI;AAC7E;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,oBAAoB,QAAQ,IAAI;AACtC,SAAO,oBAAoB,IAAI,gBAAgB,mBAAmB,OAAO,IAAI;AAC/E;AAEO,IAAM,qBAAqB,CAChC,UAAkB,GAClB,YACiB;AACjB,QAAM,EAAE,gBAAgB,aAAa,IAAI,WAAW,CAAC;AACrD,MAAI,WAAqC;AACzC,UAAQ,gBAAgB;AAAA,IACtB,KAAK,aAAa;AAChB,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,MACF;AACA;AAAA,IACF;AAAA,IACA;AAAA,IACA,KAAK,UAAU;AACb,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,gBAAgB,OAAO;AAClC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,gBAAgB,OAAO;AAClC;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,UAAU,KAAK,UAAU,OAAO,IAAI,SAAS,EAAE;AACtH;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;;;AChFA,SAAS,uBAAuB;AAKzB,IAAM,gCAAgC;AAwBtC,IAAe,4BAAf,cASG,gBAAgD;AAAA,EACxD,IAAI,WAAW;AACb,UAAM,EAAE,WAAAA,WAAU,IAAI,KAAK;AAC3B,WAAOA,WAAU,KAAK,IAAI,IAAIA,WAAU,MAAM;AAAA,EAChD;AACF;","names":["providers"]}
+{"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"]}

package/dist/browser/lib/checkIpfsUrl.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Returns the equivalent IPFS gateway URL for the supplied URL.
+ * @param urlToCheck The URL to check
+ * @returns If the supplied URL is an IPFS URL, it converts the URL to the
+ * equivalent IPFS gateway URL. Otherwise, returns the original URL.
+ */
+export declare const checkIpfsUrl: (urlToCheck: string, ipfsGateway: string) => string | undefined;
+//# sourceMappingURL=checkIpfsUrl.d.ts.map

package/dist/browser/lib/checkIpfsUrl.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,eAAe,MAAM,uBAsBnE,CAAA"}

package/dist/browser/lib/checkIpfsUrl.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Returns the equivalent IPFS gateway URL for the supplied URL.
+ * @param urlToCheck The URL to check
+ * @returns If the supplied URL is an IPFS URL, it converts the URL to the
+ * equivalent IPFS gateway URL. Otherwise, returns the original URL.
+ */
+export declare const checkIpfsUrl: (urlToCheck: string, ipfsGateway: string) => string | undefined;
+//# sourceMappingURL=checkIpfsUrl.d.ts.map

package/dist/browser/lib/checkIpfsUrl.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,eAAe,MAAM,uBAsBnE,CAAA"}

package/dist/browser/lib/checkIpfsUrl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns the equivalent IPFS gateway URL for the supplied URL.
+ * @param urlToCheck The URL to check
+ * @returns If the supplied URL is an IPFS URL, it converts the URL to the
+ * equivalent IPFS gateway URL. Otherwise, returns the original URL.
+ */
+export declare const checkIpfsUrl: (urlToCheck: string, ipfsGateway: string) => string | undefined;
+//# sourceMappingURL=checkIpfsUrl.d.ts.map

package/dist/browser/lib/checkIpfsUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,eAAe,MAAM,uBAsBnE,CAAA"}

package/dist/browser/lib/getErc1967Status.d.cts

@@ -0,0 +1,19 @@
+import { BaseProvider } from '@ethersproject/providers';
+export declare const ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+export declare const ERC1967_PROXY_BEACON_STORAGE_SLOT = "0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50";
+export declare const ERC1967_PROXY_ADMIN_STORAGE_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+export declare const ERC1967_PROXY_ROLLBACK_STORAGE_SLOT = "0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143";
+export interface Erc1967DataSlots {
+    admin: string;
+    beacon: string;
+    implementation: string;
+    rollback: string;
+}
+export interface Erc1967Status {
+    address: string;
+    implementation: string;
+    proxy: Erc1967DataSlots;
+}
+export declare const readAddressFromSlot: (provider: BaseProvider, address: string, slot: string) => Promise<string>;
+export declare const getErc1967Status: (provider: BaseProvider, address: string) => Promise<Erc1967Status>;
+//# sourceMappingURL=getErc1967Status.d.ts.map

package/dist/browser/lib/getErc1967Status.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getErc1967Status.d.ts","sourceRoot":"","sources":["../../../src/lib/getErc1967Status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAIvD,eAAO,MAAM,yCAAyC,uEAAuE,CAAA;AAC7H,eAAO,MAAM,iCAAiC,uEAAuE,CAAA;AACrH,eAAO,MAAM,gCAAgC,uEAAuE,CAAA;AACpH,eAAO,MAAM,mCAAmC,uEAAuE,CAAA;AAEvH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,gBAAgB,CAAA;CACxB;AAcD,eAAO,MAAM,mBAAmB,aAAoB,YAAY,WAAW,MAAM,QAAQ,MAAM,oBAG9F,CAAA;AAED,eAAO,MAAM,gBAAgB,aAAoB,YAAY,WAAW,MAAM,KAAG,QAAQ,aAAa,CAuBrG,CAAA"}

package/dist/browser/lib/getErc1967Status.d.mts

@@ -0,0 +1,19 @@
+import { BaseProvider } from '@ethersproject/providers';
+export declare const ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+export declare const ERC1967_PROXY_BEACON_STORAGE_SLOT = "0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50";
+export declare const ERC1967_PROXY_ADMIN_STORAGE_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+export declare const ERC1967_PROXY_ROLLBACK_STORAGE_SLOT = "0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143";
+export interface Erc1967DataSlots {
+    admin: string;
+    beacon: string;
+    implementation: string;
+    rollback: string;
+}
+export interface Erc1967Status {
+    address: string;
+    implementation: string;
+    proxy: Erc1967DataSlots;
+}
+export declare const readAddressFromSlot: (provider: BaseProvider, address: string, slot: string) => Promise<string>;
+export declare const getErc1967Status: (provider: BaseProvider, address: string) => Promise<Erc1967Status>;
+//# sourceMappingURL=getErc1967Status.d.ts.map

package/dist/browser/lib/getErc1967Status.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getErc1967Status.d.ts","sourceRoot":"","sources":["../../../src/lib/getErc1967Status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAIvD,eAAO,MAAM,yCAAyC,uEAAuE,CAAA;AAC7H,eAAO,MAAM,iCAAiC,uEAAuE,CAAA;AACrH,eAAO,MAAM,gCAAgC,uEAAuE,CAAA;AACpH,eAAO,MAAM,mCAAmC,uEAAuE,CAAA;AAEvH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,gBAAgB,CAAA;CACxB;AAcD,eAAO,MAAM,mBAAmB,aAAoB,YAAY,WAAW,MAAM,QAAQ,MAAM,oBAG9F,CAAA;AAED,eAAO,MAAM,gBAAgB,aAAoB,YAAY,WAAW,MAAM,KAAG,QAAQ,aAAa,CAuBrG,CAAA"}

package/dist/browser/lib/getErc1967Status.d.ts

@@ -0,0 +1,19 @@
+import { BaseProvider } from '@ethersproject/providers';
+export declare const ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+export declare const ERC1967_PROXY_BEACON_STORAGE_SLOT = "0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50";
+export declare const ERC1967_PROXY_ADMIN_STORAGE_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+export declare const ERC1967_PROXY_ROLLBACK_STORAGE_SLOT = "0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143";
+export interface Erc1967DataSlots {
+    admin: string;
+    beacon: string;
+    implementation: string;
+    rollback: string;
+}
+export interface Erc1967Status {
+    address: string;
+    implementation: string;
+    proxy: Erc1967DataSlots;
+}
+export declare const readAddressFromSlot: (provider: BaseProvider, address: string, slot: string) => Promise<string>;
+export declare const getErc1967Status: (provider: BaseProvider, address: string) => Promise<Erc1967Status>;
+//# sourceMappingURL=getErc1967Status.d.ts.map

package/dist/browser/lib/getErc1967Status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getErc1967Status.d.ts","sourceRoot":"","sources":["../../../src/lib/getErc1967Status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAIvD,eAAO,MAAM,yCAAyC,uEAAuE,CAAA;AAC7H,eAAO,MAAM,iCAAiC,uEAAuE,CAAA;AACrH,eAAO,MAAM,gCAAgC,uEAAuE,CAAA;AACpH,eAAO,MAAM,mCAAmC,uEAAuE,CAAA;AAEvH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,gBAAgB,CAAA;CACxB;AAcD,eAAO,MAAM,mBAAmB,aAAoB,YAAY,WAAW,MAAM,QAAQ,MAAM,oBAG9F,CAAA;AAED,eAAO,MAAM,gBAAgB,aAAoB,YAAY,WAAW,MAAM,KAAG,QAAQ,aAAa,CAuBrG,CAAA"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}
+{"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"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}
+{"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"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}
+{"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"}

package/dist/node/index.cjs

@@ -22,11 +22,86 @@ var src_exports = {};
 __export(src_exports, {
   AbstractBlockchainWitness: () => AbstractBlockchainWitness,
   BlockchainWitnessConfigSchema: () => BlockchainWitnessConfigSchema,
+  ERC1967_PROXY_ADMIN_STORAGE_SLOT: () => ERC1967_PROXY_ADMIN_STORAGE_SLOT,
+  ERC1967_PROXY_BEACON_STORAGE_SLOT: () => ERC1967_PROXY_BEACON_STORAGE_SLOT,
+  ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT: () => ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT,
+  ERC1967_PROXY_ROLLBACK_STORAGE_SLOT: () => ERC1967_PROXY_ROLLBACK_STORAGE_SLOT,
+  checkIpfsUrl: () => checkIpfsUrl,
+  getErc1967Status: () => getErc1967Status,
   getProviderFromEnv: () => getProviderFromEnv,
-  getSharedProviderFromEnv: () => getSharedProviderFromEnv
+  getSharedProviderFromEnv: () => getSharedProviderFromEnv,
+  readAddressFromSlot: () => readAddressFromSlot
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/lib/checkIpfsUrl.ts
+var checkIpfsUrl = (urlToCheck, ipfsGateway) => {
+  try {
+    const url = new URL(urlToCheck);
+    let protocol = url.protocol;
+    let host = url.host;
+    let path = url.pathname;
+    const query = url.search;
+    if (protocol === "ipfs:") {
+      protocol = "https:";
+      host = ipfsGateway;
+      path = url.host === "ipfs" ? `ipfs${path}` : `ipfs/${url.host}${path}`;
+      const root = `${protocol}//${host}/${path}`;
+      return (query == null ? void 0 : query.length) > 0 ? `${root}?${query}` : root;
+    } else {
+      return urlToCheck;
+    }
+  } catch (ex) {
+    const error = ex;
+    console.error(`${error.name}:${error.message} [${urlToCheck}]`);
+    console.log(error.stack);
+    return void 0;
+  }
+};
+
+// src/lib/getErc1967Status.ts
+var import_bignumber = require("@xylabs/bignumber");
+var import_open_zeppelin_typechain = require("@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 import_bignumber.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 = import_open_zeppelin_typechain.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
 var import_providers = require("@ethersproject/providers");
 var import_assert = require("@xylabs/assert");
@@ -108,7 +183,14 @@ var AbstractBlockchainWitness = class extends import_abstract_witness.AbstractWi
 0 && (module.exports = {
   AbstractBlockchainWitness,
   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
+  getSharedProviderFromEnv,
+  readAddressFromSlot
 });
 //# sourceMappingURL=index.cjs.map

package/dist/node/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/lib/getProviderFromEnv.ts","../../src/Witness.ts"],"sourcesContent":["export * from './lib'\nexport * from './Witness'\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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,uBAA0G;AAC1G,oBAAyB;AAKzB,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,gCAAe,SAAS;AAAA,IACjC,WAAW,QAAQ,IAAI;AAAA,IACvB,eAAe,QAAQ,IAAI;AAAA,EAC7B,CAAC;AACH;AAEA,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,yCAAwB,SAAS;AAAA,IAC1C,WAAW,QAAQ,IAAI;AAAA,EACzB,CAAC;AACH;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,kBAAkB,QAAQ,IAAI;AACpC,SAAO,kBAAkB,IAAI,mCAAkB,iBAAiB,OAAO,IAAI;AAC7E;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,oBAAoB,QAAQ,IAAI;AACtC,SAAO,oBAAoB,IAAI,iCAAgB,mBAAmB,OAAO,IAAI;AAC/E;AAEO,IAAM,qBAAqB,CAChC,UAAkB,GAClB,YACiB;AACjB,QAAM,EAAE,gBAAgB,aAAa,IAAI,WAAW,CAAC;AACrD,MAAI,WAAqC;AACzC,UAAQ,gBAAgB;AAAA,IACtB,KAAK,aAAa;AAChB,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,MACF;AACA;AAAA,IACF;AAAA,IACA;AAAA,IACA,KAAK,UAAU;AACb,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,gBAAgB,OAAO;AAClC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,gBAAgB,OAAO;AAClC;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,aAAO,wBAAS,UAAU,8BAA8B,OAAO,MAAM,UAAU,KAAK,UAAU,OAAO,IAAI,SAAS,EAAE;AACtH;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;;;AChFA,8BAAgC;AAKzB,IAAM,gCAAgC;AAwBtC,IAAe,4BAAf,cASG,wCAAgD;AAAA,EACxD,IAAI,WAAW;AACb,UAAM,EAAE,WAAAA,WAAU,IAAI,KAAK;AAC3B,WAAOA,WAAU,KAAK,IAAI,IAAIA,WAAU,MAAM;AAAA,EAChD;AACF;","names":["providers"]}
+{"version":3,"sources":["../../src/index.ts","../../src/lib/checkIpfsUrl.ts","../../src/lib/getErc1967Status.ts","../../src/lib/getProviderFromEnv.ts","../../src/Witness.ts"],"sourcesContent":["export * from './lib'\nexport * from './Witness'\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) => {\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"]}

package/dist/node/index.js

@@ -1,3 +1,71 @@
+// src/lib/checkIpfsUrl.ts
+var checkIpfsUrl = (urlToCheck, ipfsGateway) => {
+  try {
+    const url = new URL(urlToCheck);
+    let protocol = url.protocol;
+    let host = url.host;
+    let path = url.pathname;
+    const query = url.search;
+    if (protocol === "ipfs:") {
+      protocol = "https:";
+      host = ipfsGateway;
+      path = url.host === "ipfs" ? `ipfs${path}` : `ipfs/${url.host}${path}`;
+      const root = `${protocol}//${host}/${path}`;
+      return (query == null ? void 0 : query.length) > 0 ? `${root}?${query}` : root;
+    } else {
+      return urlToCheck;
+    }
+  } catch (ex) {
+    const error = ex;
+    console.error(`${error.name}:${error.message} [${urlToCheck}]`);
+    console.log(error.stack);
+    return void 0;
+  }
+};
+
+// 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";
@@ -78,7 +146,14 @@ var AbstractBlockchainWitness = class extends AbstractWitness {
 export {
   AbstractBlockchainWitness,
   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
+  getSharedProviderFromEnv,
+  readAddressFromSlot
 };
 //# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/getProviderFromEnv.ts","../../src/Witness.ts"],"sourcesContent":["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":";AAAA,SAAuB,gBAAgB,yBAAyB,iBAAiB,yBAAyB;AAC1G,SAAS,gBAAgB;AAKzB,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,eAAe,SAAS;AAAA,IACjC,WAAW,QAAQ,IAAI;AAAA,IACvB,eAAe,QAAQ,IAAI;AAAA,EAC7B,CAAC;AACH;AAEA,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,wBAAwB,SAAS;AAAA,IAC1C,WAAW,QAAQ,IAAI;AAAA,EACzB,CAAC;AACH;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,kBAAkB,QAAQ,IAAI;AACpC,SAAO,kBAAkB,IAAI,kBAAkB,iBAAiB,OAAO,IAAI;AAC7E;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,oBAAoB,QAAQ,IAAI;AACtC,SAAO,oBAAoB,IAAI,gBAAgB,mBAAmB,OAAO,IAAI;AAC/E;AAEO,IAAM,qBAAqB,CAChC,UAAkB,GAClB,YACiB;AACjB,QAAM,EAAE,gBAAgB,aAAa,IAAI,WAAW,CAAC;AACrD,MAAI,WAAqC;AACzC,UAAQ,gBAAgB;AAAA,IACtB,KAAK,aAAa;AAChB,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,MACF;AACA;AAAA,IACF;AAAA,IACA;AAAA,IACA,KAAK,UAAU;AACb,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,gBAAgB,OAAO;AAClC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,gBAAgB,OAAO;AAClC;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,UAAU,KAAK,UAAU,OAAO,IAAI,SAAS,EAAE;AACtH;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;;;AChFA,SAAS,uBAAuB;AAKzB,IAAM,gCAAgC;AAwBtC,IAAe,4BAAf,cASG,gBAAgD;AAAA,EACxD,IAAI,WAAW;AACb,UAAM,EAAE,WAAAA,WAAU,IAAI,KAAK;AAC3B,WAAOA,WAAU,KAAK,IAAI,IAAIA,WAAU,MAAM;AAAA,EAChD;AACF;","names":["providers"]}
+{"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":";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;;;AC3BA,SAAS,iBAAiB;AAC1B,SAAS,kCAAkC;AAEpC,IAAM,4CAA4C;AAClD,IAAM,oCAAoC;AAC1C,IAAM,mCAAmC;AACzC,IAAM,sCAAsC;AAenD,IAAM,mBAAmB,CAAC,UAAkB;AAC1C,SAAO,MAAM,WAAW,IAAI,IAAI,MAAM,UAAU,CAAC,IAAI;AACvD;AAEA,IAAM,iBAAiB,CAAC,UAAkB;AACxC,SAAO,KAAK,iBAAiB,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD;AAEA,IAAM,YAAY,CAAC,UAAkB;AACnC,SAAO,IAAI,UAAU,iBAAiB,KAAK,GAAG,KAAK,EAAE,IAAI,CAAC;AAC5D;AAEO,IAAM,sBAAsB,OAAO,UAAwB,SAAiB,SAAiB;AAClG,QAAM,YAAY,MAAM,SAAS,aAAa,SAAS,IAAI;AAC3D,SAAO,eAAe,SAAS;AACjC;AAEO,IAAM,mBAAmB,OAAO,UAAwB,YAA4C;AACzG,QAAM,QAA0B;AAAA,IAC9B,OAAO,MAAM,oBAAoB,UAAU,SAAS,gCAAgC;AAAA,IACpF,QAAQ,MAAM,oBAAoB,UAAU,SAAS,iCAAiC;AAAA,IACtF,gBAAgB,MAAM,oBAAoB,UAAU,SAAS,yCAAyC;AAAA,IACtG,UAAU,MAAM,oBAAoB,UAAU,SAAS,mCAAmC;AAAA,EAC5F;AAEA,MAAI,CAAC,UAAU,MAAM,MAAM,GAAG;AAC5B,UAAM,SAAS,2BAA2B,QAAQ,MAAM,QAAQ,QAAQ;AACxE,QAAI;AACF,YAAM,iBAAiB,MAAM,OAAO,WAAW,eAAe;AAAA,IAChE,SAAS,IAAI;AACX,YAAM,QAAQ;AACd,cAAQ,IAAI,MAAM,OAAO;AAAA,IAC3B;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,UAAU,MAAM,cAAc,IAAI,UAAU,MAAM;AAAA,IAClE;AAAA,EACF;AACF;;;AC9DA,SAAuB,gBAAgB,yBAAyB,iBAAiB,yBAAyB;AAC1G,SAAS,gBAAgB;AAKzB,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,eAAe,SAAS;AAAA,IACjC,WAAW,QAAQ,IAAI;AAAA,IACvB,eAAe,QAAQ,IAAI;AAAA,EAC7B,CAAC;AACH;AAEA,IAAM,kBAAkB,CAAC,YAAoB;AAC3C,SAAO,IAAI,wBAAwB,SAAS;AAAA,IAC1C,WAAW,QAAQ,IAAI;AAAA,EACzB,CAAC;AACH;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,kBAAkB,QAAQ,IAAI;AACpC,SAAO,kBAAkB,IAAI,kBAAkB,iBAAiB,OAAO,IAAI;AAC7E;AAEA,IAAM,qBAAqB,CAAC,YAAoB;AAC9C,QAAM,oBAAoB,QAAQ,IAAI;AACtC,SAAO,oBAAoB,IAAI,gBAAgB,mBAAmB,OAAO,IAAI;AAC/E;AAEO,IAAM,qBAAqB,CAChC,UAAkB,GAClB,YACiB;AACjB,QAAM,EAAE,gBAAgB,aAAa,IAAI,WAAW,CAAC;AACrD,MAAI,WAAqC;AACzC,UAAQ,gBAAgB;AAAA,IACtB,KAAK,aAAa;AAChB,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,mBAAmB,OAAO;AACrC;AAAA,QACF;AAAA,MACF;AACA;AAAA,IACF;AAAA,IACA;AAAA,IACA,KAAK,UAAU;AACb,cAAQ,cAAc;AAAA,QACpB,KAAK,OAAO;AACV,qBAAW,gBAAgB,OAAO;AAClC;AAAA,QACF;AAAA,QACA,KAAK;AAAA,QACL,SAAS;AACP,qBAAW,gBAAgB,OAAO;AAClC;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,UAAU,KAAK,UAAU,OAAO,IAAI,SAAS,EAAE;AACtH;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;;;AChFA,SAAS,uBAAuB;AAKzB,IAAM,gCAAgC;AAwBtC,IAAe,4BAAf,cASG,gBAAgD;AAAA,EACxD,IAAI,WAAW;AACb,UAAM,EAAE,WAAAA,WAAU,IAAI,KAAK;AAC3B,WAAOA,WAAU,KAAK,IAAI,IAAIA,WAAU,MAAM;AAAA,EAChD;AACF;","names":["providers"]}

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

@@ -0,0 +1,8 @@
+/**
+ * Returns the equivalent IPFS gateway URL for the supplied URL.
+ * @param urlToCheck The URL to check
+ * @returns If the supplied URL is an IPFS URL, it converts the URL to the
+ * equivalent IPFS gateway URL. Otherwise, returns the original URL.
+ */
+export declare const checkIpfsUrl: (urlToCheck: string, ipfsGateway: string) => string | undefined;
+//# sourceMappingURL=checkIpfsUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,eAAe,MAAM,uBAsBnE,CAAA"}

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

@@ -0,0 +1,8 @@
+/**
+ * Returns the equivalent IPFS gateway URL for the supplied URL.
+ * @param urlToCheck The URL to check
+ * @returns If the supplied URL is an IPFS URL, it converts the URL to the
+ * equivalent IPFS gateway URL. Otherwise, returns the original URL.
+ */
+export declare const checkIpfsUrl: (urlToCheck: string, ipfsGateway: string) => string | undefined;
+//# sourceMappingURL=checkIpfsUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,eAAe,MAAM,uBAsBnE,CAAA"}

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

@@ -0,0 +1,8 @@
+/**
+ * Returns the equivalent IPFS gateway URL for the supplied URL.
+ * @param urlToCheck The URL to check
+ * @returns If the supplied URL is an IPFS URL, it converts the URL to the
+ * equivalent IPFS gateway URL. Otherwise, returns the original URL.
+ */
+export declare const checkIpfsUrl: (urlToCheck: string, ipfsGateway: string) => string | undefined;
+//# sourceMappingURL=checkIpfsUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,eAAe,MAAM,uBAsBnE,CAAA"}

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

@@ -0,0 +1,19 @@
+import { BaseProvider } from '@ethersproject/providers';
+export declare const ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+export declare const ERC1967_PROXY_BEACON_STORAGE_SLOT = "0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50";
+export declare const ERC1967_PROXY_ADMIN_STORAGE_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+export declare const ERC1967_PROXY_ROLLBACK_STORAGE_SLOT = "0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143";
+export interface Erc1967DataSlots {
+    admin: string;
+    beacon: string;
+    implementation: string;
+    rollback: string;
+}
+export interface Erc1967Status {
+    address: string;
+    implementation: string;
+    proxy: Erc1967DataSlots;
+}
+export declare const readAddressFromSlot: (provider: BaseProvider, address: string, slot: string) => Promise<string>;
+export declare const getErc1967Status: (provider: BaseProvider, address: string) => Promise<Erc1967Status>;
+//# sourceMappingURL=getErc1967Status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getErc1967Status.d.ts","sourceRoot":"","sources":["../../../src/lib/getErc1967Status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAIvD,eAAO,MAAM,yCAAyC,uEAAuE,CAAA;AAC7H,eAAO,MAAM,iCAAiC,uEAAuE,CAAA;AACrH,eAAO,MAAM,gCAAgC,uEAAuE,CAAA;AACpH,eAAO,MAAM,mCAAmC,uEAAuE,CAAA;AAEvH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,gBAAgB,CAAA;CACxB;AAcD,eAAO,MAAM,mBAAmB,aAAoB,YAAY,WAAW,MAAM,QAAQ,MAAM,oBAG9F,CAAA;AAED,eAAO,MAAM,gBAAgB,aAAoB,YAAY,WAAW,MAAM,KAAG,QAAQ,aAAa,CAuBrG,CAAA"}

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

@@ -0,0 +1,19 @@
+import { BaseProvider } from '@ethersproject/providers';
+export declare const ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+export declare const ERC1967_PROXY_BEACON_STORAGE_SLOT = "0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50";
+export declare const ERC1967_PROXY_ADMIN_STORAGE_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+export declare const ERC1967_PROXY_ROLLBACK_STORAGE_SLOT = "0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143";
+export interface Erc1967DataSlots {
+    admin: string;
+    beacon: string;
+    implementation: string;
+    rollback: string;
+}
+export interface Erc1967Status {
+    address: string;
+    implementation: string;
+    proxy: Erc1967DataSlots;
+}
+export declare const readAddressFromSlot: (provider: BaseProvider, address: string, slot: string) => Promise<string>;
+export declare const getErc1967Status: (provider: BaseProvider, address: string) => Promise<Erc1967Status>;
+//# sourceMappingURL=getErc1967Status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getErc1967Status.d.ts","sourceRoot":"","sources":["../../../src/lib/getErc1967Status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAIvD,eAAO,MAAM,yCAAyC,uEAAuE,CAAA;AAC7H,eAAO,MAAM,iCAAiC,uEAAuE,CAAA;AACrH,eAAO,MAAM,gCAAgC,uEAAuE,CAAA;AACpH,eAAO,MAAM,mCAAmC,uEAAuE,CAAA;AAEvH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,gBAAgB,CAAA;CACxB;AAcD,eAAO,MAAM,mBAAmB,aAAoB,YAAY,WAAW,MAAM,QAAQ,MAAM,oBAG9F,CAAA;AAED,eAAO,MAAM,gBAAgB,aAAoB,YAAY,WAAW,MAAM,KAAG,QAAQ,aAAa,CAuBrG,CAAA"}

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

@@ -0,0 +1,19 @@
+import { BaseProvider } from '@ethersproject/providers';
+export declare const ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+export declare const ERC1967_PROXY_BEACON_STORAGE_SLOT = "0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50";
+export declare const ERC1967_PROXY_ADMIN_STORAGE_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+export declare const ERC1967_PROXY_ROLLBACK_STORAGE_SLOT = "0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143";
+export interface Erc1967DataSlots {
+    admin: string;
+    beacon: string;
+    implementation: string;
+    rollback: string;
+}
+export interface Erc1967Status {
+    address: string;
+    implementation: string;
+    proxy: Erc1967DataSlots;
+}
+export declare const readAddressFromSlot: (provider: BaseProvider, address: string, slot: string) => Promise<string>;
+export declare const getErc1967Status: (provider: BaseProvider, address: string) => Promise<Erc1967Status>;
+//# sourceMappingURL=getErc1967Status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getErc1967Status.d.ts","sourceRoot":"","sources":["../../../src/lib/getErc1967Status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAIvD,eAAO,MAAM,yCAAyC,uEAAuE,CAAA;AAC7H,eAAO,MAAM,iCAAiC,uEAAuE,CAAA;AACrH,eAAO,MAAM,gCAAgC,uEAAuE,CAAA;AACpH,eAAO,MAAM,mCAAmC,uEAAuE,CAAA;AAEvH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,gBAAgB,CAAA;CACxB;AAcD,eAAO,MAAM,mBAAmB,aAAoB,YAAY,WAAW,MAAM,QAAQ,MAAM,oBAG9F,CAAA;AAED,eAAO,MAAM,gBAAgB,aAAoB,YAAY,WAAW,MAAM,KAAG,QAAQ,aAAa,CAuBrG,CAAA"}

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

@@ -1,2 +1,4 @@
+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,sBAAsB,CAAA"}
+{"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"}

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

@@ -1,2 +1,4 @@
+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,sBAAsB,CAAA"}
+{"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"}

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

@@ -1,2 +1,4 @@
+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,sBAAsB,CAAA"}
+{"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"}

package/package.json

@@ -11,10 +11,10 @@
   },
   "dependencies": {
     "@xylabs/assert": "^2.13.3",
-    "@xyo-network/abstract-witness": "~2.79.2",
-    "@xyo-network/object": "~2.79.2",
-    "@xyo-network/payload-model": "~2.79.2",
-    "@xyo-network/witness-model": "~2.79.2"
+    "@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"
   },
   "devDependencies": {
     "@ethersproject/providers": "^5.7.2",
@@ -64,6 +64,6 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js.git"
   },
   "sideEffects": false,
-  "version": "2.79.2",
+  "version": "2.79.3",
   "type": "module"
 }

package/src/lib/checkIpfsUrl.ts

@@ -0,0 +1,29 @@
+/**
+ * Returns the equivalent IPFS gateway URL for the supplied URL.
+ * @param urlToCheck The URL to check
+ * @returns If the supplied URL is an IPFS URL, it converts the URL to the
+ * equivalent IPFS gateway URL. Otherwise, returns the original URL.
+ */
+export const checkIpfsUrl = (urlToCheck: string, ipfsGateway: string) => {
+  try {
+    const url = new URL(urlToCheck)
+    let protocol = url.protocol
+    let host = url.host
+    let path = url.pathname
+    const query = url.search
+    if (protocol === 'ipfs:') {
+      protocol = 'https:'
+      host = ipfsGateway
+      path = url.host === 'ipfs' ? `ipfs${path}` : `ipfs/${url.host}${path}`
+      const root = `${protocol}//${host}/${path}`
+      return query?.length > 0 ? `${root}?${query}` : root
+    } else {
+      return urlToCheck
+    }
+  } catch (ex) {
+    const error = ex as Error
+    console.error(`${error.name}:${error.message} [${urlToCheck}]`)
+    console.log(error.stack)
+    return undefined
+  }
+}

package/src/lib/getErc1967Status.ts

@@ -0,0 +1,63 @@
+import { BaseProvider } from '@ethersproject/providers'
+import { BigNumber } from '@xylabs/bignumber'
+import { UpgradeableBeacon__factory } from '@xyo-network/open-zeppelin-typechain'
+
+export const ERC1967_PROXY_IMPLEMENTATION_STORAGE_SLOT = '0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc'
+export const ERC1967_PROXY_BEACON_STORAGE_SLOT = '0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50'
+export const ERC1967_PROXY_ADMIN_STORAGE_SLOT = '0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103'
+export const ERC1967_PROXY_ROLLBACK_STORAGE_SLOT = '0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143'
+
+export interface Erc1967DataSlots {
+  admin: string
+  beacon: string
+  implementation: string
+  rollback: string
+}
+
+export interface Erc1967Status {
+  address: string
+  implementation: string
+  proxy: Erc1967DataSlots
+}
+
+const hexBytesOnlyOnly = (value: string) => {
+  return value.startsWith('0x') ? value.substring(2) : value
+}
+
+const addressFromHex = (value: string) => {
+  return `0x${hexBytesOnlyOnly(value).substring(24)}`
+}
+
+const isHexZero = (value: string) => {
+  return new BigNumber(hexBytesOnlyOnly(value), 'hex').eqn(0)
+}
+
+export const readAddressFromSlot = async (provider: BaseProvider, address: string, slot: string) => {
+  const slotValue = await provider.getStorageAt(address, slot)
+  return addressFromHex(slotValue)
+}
+
+export const getErc1967Status = async (provider: BaseProvider, address: string): Promise<Erc1967Status> => {
+  const proxy: Erc1967DataSlots = {
+    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 as Error
+      console.log(error.message)
+    }
+  }
+
+  return {
+    address,
+    implementation: isHexZero(proxy.implementation) ? address : proxy.implementation,
+    proxy,
+  }
+}

package/src/lib/index.ts

@@ -1 +1,3 @@
+export * from './checkIpfsUrl'
+export * from './getErc1967Status'
 export * from './getProviderFromEnv'