@xyo-network/witness-blockchain-abstract 2.106.0 → 2.107.1

package/dist/node/index.js.map

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

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

@@ -1,8 +1,2 @@
-/**
- * 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;
 //# sourceMappingURL=checkIpfsUrl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,gBAAgB,MAAM,KAAG,MAgCvE,CAAA"}
+{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY,eAAgB,MAAM,gBAAgB,MAAM,KAAG,MAgCvE,CAAA"}

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

@@ -1,8 +1,2 @@
-/**
- * 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;
 //# sourceMappingURL=checkIpfsUrl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,gBAAgB,MAAM,KAAG,MAgCvE,CAAA"}
+{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY,eAAgB,MAAM,gBAAgB,MAAM,KAAG,MAgCvE,CAAA"}

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

@@ -1,8 +1,2 @@
-/**
- * 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;
 //# sourceMappingURL=checkIpfsUrl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,gBAAgB,MAAM,KAAG,MAgCvE,CAAA"}
+{"version":3,"file":"checkIpfsUrl.d.ts","sourceRoot":"","sources":["../../../src/lib/checkIpfsUrl.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY,eAAgB,MAAM,gBAAgB,MAAM,KAAG,MAgCvE,CAAA"}

package/dist/node/model.d.cts

@@ -1,9 +1,6 @@
 import { Payload } from '@xyo-network/payload-model';
-/** @deprecated use EvmAddressSchema version instead */
 export declare const BlockchainAddressSchema: "network.xyo.blockchain.address";
-/** @deprecated use EvmAddressSchema version instead */
 export type BlockchainAddressSchema = typeof BlockchainAddressSchema;
-/** @deprecated use EvmAddress version instead */
 export type BlockchainAddress = Payload<{
     address?: string;
     blockTag?: string | number;

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

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,uDAAuD;AACvD,eAAO,MAAM,uBAAuB,kCAA4C,CAAA;AAEhF,uDAAuD;AACvD,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAEpE,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,uBAAuB,CACxB,CAAA"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAGpD,eAAO,MAAM,uBAAuB,kCAA4C,CAAA;AAGhF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAGpE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,uBAAuB,CACxB,CAAA"}

package/dist/node/model.d.mts

@@ -1,9 +1,6 @@
 import { Payload } from '@xyo-network/payload-model';
-/** @deprecated use EvmAddressSchema version instead */
 export declare const BlockchainAddressSchema: "network.xyo.blockchain.address";
-/** @deprecated use EvmAddressSchema version instead */
 export type BlockchainAddressSchema = typeof BlockchainAddressSchema;
-/** @deprecated use EvmAddress version instead */
 export type BlockchainAddress = Payload<{
     address?: string;
     blockTag?: string | number;

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

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,uDAAuD;AACvD,eAAO,MAAM,uBAAuB,kCAA4C,CAAA;AAEhF,uDAAuD;AACvD,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAEpE,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,uBAAuB,CACxB,CAAA"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAGpD,eAAO,MAAM,uBAAuB,kCAA4C,CAAA;AAGhF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAGpE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,uBAAuB,CACxB,CAAA"}

package/dist/node/model.d.ts

@@ -1,9 +1,6 @@
 import { Payload } from '@xyo-network/payload-model';
-/** @deprecated use EvmAddressSchema version instead */
 export declare const BlockchainAddressSchema: "network.xyo.blockchain.address";
-/** @deprecated use EvmAddressSchema version instead */
 export type BlockchainAddressSchema = typeof BlockchainAddressSchema;
-/** @deprecated use EvmAddress version instead */
 export type BlockchainAddress = Payload<{
     address?: string;
     blockTag?: string | number;

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

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEpD,uDAAuD;AACvD,eAAO,MAAM,uBAAuB,kCAA4C,CAAA;AAEhF,uDAAuD;AACvD,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAEpE,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,uBAAuB,CACxB,CAAA"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAGpD,eAAO,MAAM,uBAAuB,kCAA4C,CAAA;AAGhF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAGpE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC;IACE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,uBAAuB,CACxB,CAAA"}

package/package.json

@@ -13,19 +13,19 @@
     "@xylabs/assert": "^3.5.1",
     "@xylabs/object": "^3.5.1",
     "@xylabs/promise": "^3.5.1",
-    "@xyo-network/abstract-witness": "~2.106.0",
-    "@xyo-network/module-model": "~2.106.0",
-    "@xyo-network/payload-model": "~2.106.0",
-    "@xyo-network/witness-model": "~2.106.0",
-    "ethers": "6.13.0"
+    "@xyo-network/abstract-witness": "~2.107.1",
+    "@xyo-network/module-model": "~2.107.1",
+    "@xyo-network/payload-model": "~2.107.1",
+    "@xyo-network/witness-model": "~2.107.1",
+    "ethers": "6.13.1"
   },
   "devDependencies": {
     "@xylabs/jest-helpers": "^3.5.1",
-    "@xylabs/ts-scripts-yarn3": "^3.11.2",
-    "@xylabs/tsconfig": "^3.11.2",
-    "ethers": "6.13.0",
+    "@xylabs/ts-scripts-yarn3": "^3.11.9",
+    "@xylabs/tsconfig": "^3.11.9",
+    "ethers": "6.13.1",
     "jest": "^29.7.0",
-    "typescript": "^5.4.5"
+    "typescript": "^5.5.2"
   },
   "description": "Primary SDK for using XYO Protocol 2.0",
   "types": "dist/node/index.d.mts",
@@ -66,6 +66,6 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js.git"
   },
   "sideEffects": false,
-  "version": "2.106.0",
+  "version": "2.107.1",
   "type": "module"
 }

package/src/Witness.ts

@@ -1,4 +1,3 @@
-/* eslint-disable deprecation/deprecation */
 import { EmptyObject, WithAdditional } from '@xylabs/object'
 import { Promisable } from '@xylabs/promise'
 import { AbstractWitness } from '@xyo-network/abstract-witness'

package/src/model.ts

@@ -1,4 +1,3 @@
-/* eslint-disable deprecation/deprecation */
 import { Payload } from '@xyo-network/payload-model'
 
 /** @deprecated use EvmAddressSchema version instead */