@xyo-network/gas-price-plugin 4.2.0 → 5.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/gas-price-plugin",
-  "version": "4.2.0",
+  "version": "5.0.1",
   "description": "Typescript/Javascript Plugins for XYO Platform",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -28,34 +28,38 @@
   },
   "module": "dist/neutral/index.mjs",
   "types": "dist/neutral/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
   "dependencies": {
-    "@xylabs/exists": "^4.15.1",
-    "@xyo-network/blocknative-ethereum-gas-payload-plugin": "^4.2.0",
-    "@xyo-network/diviner-abstract": "^4.3.0",
-    "@xyo-network/diviner-model": "^4.3.0",
-    "@xyo-network/etherchain-gas-ethereum-blockchain-payload-plugins": "^4.2.0",
-    "@xyo-network/ethers-ethereum-gas-payload-plugin": "^4.2.0",
-    "@xyo-network/etherscan-ethereum-gas-payload-plugin": "^4.2.0",
-    "@xyo-network/ethgasstation-ethereum-gas-payload-plugin": "^4.2.0",
-    "@xyo-network/gas-price-payload-plugin": "^4.2.0",
-    "@xyo-network/module-model": "^4.3.0",
-    "@xyo-network/payload-builder": "^4.3.0",
-    "@xyo-network/payload-model": "^4.3.0",
-    "@xyo-network/payloadset-plugin": "^4.3.0",
-    "regression": "^2.0.1"
+    "@xylabs/exists": "~5.0.7",
+    "@xyo-network/blocknative-ethereum-gas-payload-plugin": "~5.0.1",
+    "@xyo-network/diviner-abstract": "~5.0.2",
+    "@xyo-network/diviner-model": "~5.0.2",
+    "@xyo-network/etherchain-gas-ethereum-blockchain-payload-plugins": "~5.0.1",
+    "@xyo-network/ethers-ethereum-gas-payload-plugin": "~5.0.1",
+    "@xyo-network/etherscan-ethereum-gas-payload-plugin": "~5.0.1",
+    "@xyo-network/ethgasstation-ethereum-gas-payload-plugin": "~5.0.1",
+    "@xyo-network/gas-price-payload-plugin": "~5.0.1",
+    "@xyo-network/module-model": "~5.0.2",
+    "@xyo-network/payload-builder": "~5.0.2",
+    "@xyo-network/payload-model": "~5.0.2",
+    "@xyo-network/payloadset-plugin": "~5.0.2",
+    "regression": "~2.0.1"
   },
   "devDependencies": {
-    "@types/regression": "^2.0.6",
-    "@xylabs/ts-scripts-yarn3": "^7.0.1",
-    "@xylabs/tsconfig": "^7.0.1",
-    "@xylabs/vitest-extended": "^4.15.1",
-    "@xyo-network/blocknative-ethereum-gas-plugin": "^4.2.0",
-    "@xyo-network/etherchain-gas-ethereum-blockchain-plugins": "^4.2.0",
-    "@xyo-network/ethers-ethereum-gas-plugin": "^4.2.0",
-    "@xyo-network/etherscan-ethereum-gas-plugin": "^4.2.0",
-    "@xyo-network/witness-blockchain-abstract": "^4.3.0",
-    "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
+    "@types/regression": "~2.0.6",
+    "@xylabs/ts-scripts-yarn3": "~7.1.0",
+    "@xylabs/tsconfig": "~7.1.0",
+    "@xylabs/vitest-extended": "~5.0.7",
+    "@xyo-network/blocknative-ethereum-gas-plugin": "~5.0.1",
+    "@xyo-network/etherchain-gas-ethereum-blockchain-plugins": "~5.0.1",
+    "@xyo-network/ethers-ethereum-gas-plugin": "~5.0.1",
+    "@xyo-network/etherscan-ethereum-gas-plugin": "~5.0.1",
+    "@xyo-network/witness-blockchain-abstract": "~5.0.2",
+    "typescript": "~5.9.2",
+    "vitest": "~3.2.4"
   },
   "publishConfig": {
     "access": "public"

package/src/lib/identities/spec/isXyoEthereumGasBlocknativePayload.spec.ts

@@ -0,0 +1,36 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect,
+  it,
+} from 'vitest'
+
+import { sampleBlocknativeGas } from '../../../test/index.ts'
+import { isEthereumGasBlocknativePayload } from '../isEthereumGasBlocknativePayload.ts'
+
+describe('isEthereumGasBlocknativePayload', () => {
+  describe('returns true', () => {
+    it('when payload schema is EthereumGasBlocknativeSchema', () => {
+      const result = isEthereumGasBlocknativePayload(sampleBlocknativeGas)
+      expect(result).toBeTrue()
+    })
+  })
+  describe('returns false', () => {
+    it('when payload schema is not EthereumGasBlocknativeSchema', () => {
+      const result = isEthereumGasBlocknativePayload({ schema: 'network.xyo.debug' })
+      expect(result).toBeFalse()
+    })
+    it('when payload is missing', () => {
+      const result = isEthereumGasBlocknativePayload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is undefined', () => {
+      const result = isEthereumGasBlocknativePayload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is null', () => {
+      const result = isEthereumGasBlocknativePayload(null)
+      expect(result).toBeFalse()
+    })
+  })
+})

package/src/lib/identities/spec/isXyoEthereumGasEtherchainV2Payload.spec.ts

@@ -0,0 +1,36 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect,
+  it,
+} from 'vitest'
+
+import { sampleEtherchainGasV2 } from '../../../test/index.ts'
+import { isEthereumGasEtherchainV2Payload } from '../isEthereumGasEtherchainV2Payload.ts'
+
+describe('isEthereumGasEtherchainV2Payload', () => {
+  describe('returns true', () => {
+    it('when payload schema is EthereumGasEtherchainV2Schema', () => {
+      const result = isEthereumGasEtherchainV2Payload(sampleEtherchainGasV2)
+      expect(result).toBeTrue()
+    })
+  })
+  describe('returns false', () => {
+    it('when payload schema is not EthereumGasEtherscanSchema', () => {
+      const result = isEthereumGasEtherchainV2Payload({ schema: 'network.xyo.debug' })
+      expect(result).toBeFalse()
+    })
+    it('when payload is missing', () => {
+      const result = isEthereumGasEtherchainV2Payload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is undefined', () => {
+      const result = isEthereumGasEtherchainV2Payload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is null', () => {
+      const result = isEthereumGasEtherchainV2Payload(null)
+      expect(result).toBeFalse()
+    })
+  })
+})

package/src/lib/identities/spec/isXyoEthereumGasEthersPayload.spec.ts

@@ -0,0 +1,36 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect,
+  it,
+} from 'vitest'
+
+import { sampleEthersGas } from '../../../test/index.ts'
+import { isEthereumGasEthersPayload } from '../isEthereumGasEthersPayload.ts'
+
+describe('isEthereumGasEthersPayload', () => {
+  describe('returns true', () => {
+    it('when payload schema is EthereumGasEthersSchema', () => {
+      const result = isEthereumGasEthersPayload(sampleEthersGas)
+      expect(result).toBeTrue()
+    })
+  })
+  describe('returns false', () => {
+    it('when payload schema is not EthereumGasEthersSchema', () => {
+      const result = isEthereumGasEthersPayload({ schema: 'network.xyo.debug' })
+      expect(result).toBeFalse()
+    })
+    it('when payload is missing', () => {
+      const result = isEthereumGasEthersPayload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is undefined', () => {
+      const result = isEthereumGasEthersPayload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is null', () => {
+      const result = isEthereumGasEthersPayload(null)
+      expect(result).toBeFalse()
+    })
+  })
+})

package/src/lib/identities/spec/isXyoEthereumGasEtherscanPayload.spec.ts

@@ -0,0 +1,36 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect,
+  it,
+} from 'vitest'
+
+import { sampleEtherscanGas } from '../../../test/index.ts'
+import { isEthereumGasEtherscanPayload } from '../isEthereumGasEtherscanPayload.ts'
+
+describe('isEthereumGasEtherscanPayload', () => {
+  describe('returns true', () => {
+    it('when payload schema is EthereumGasEtherscanSchema', () => {
+      const result = isEthereumGasEtherscanPayload(sampleEtherscanGas)
+      expect(result).toBeTrue()
+    })
+  })
+  describe('returns false', () => {
+    it('when payload schema is not EthereumGasEtherscanSchema', () => {
+      const result = isEthereumGasEtherscanPayload({ schema: 'network.xyo.debug' })
+      expect(result).toBeFalse()
+    })
+    it('when payload is missing', () => {
+      const result = isEthereumGasEtherscanPayload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is undefined', () => {
+      const result = isEthereumGasEtherscanPayload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is null', () => {
+      const result = isEthereumGasEtherscanPayload(null)
+      expect(result).toBeFalse()
+    })
+  })
+})

package/src/lib/identities/spec/isXyoEthereumGasEthgasstationPayload.spec.ts

@@ -0,0 +1,36 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect,
+  it,
+} from 'vitest'
+
+import { sampleEthgasstationGas } from '../../../test/index.ts'
+import { isEthereumGasEthgasstationPayload } from '../isEthereumGasEthgasstationPayload.ts'
+
+describe('isEthereumGasEthgasstationPayload', () => {
+  describe('returns true', () => {
+    it('when payload schema is EthereumGasEthgasstationSchema', () => {
+      const result = isEthereumGasEthgasstationPayload(sampleEthgasstationGas)
+      expect(result).toBeTrue()
+    })
+  })
+  describe('returns false', () => {
+    it('when payload schema is not EthereumGasEthgasstationSchema', () => {
+      const result = isEthereumGasEthgasstationPayload({ schema: 'network.xyo.debug' })
+      expect(result).toBeFalse()
+    })
+    it('when payload is missing', () => {
+      const result = isEthereumGasEthgasstationPayload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is undefined', () => {
+      const result = isEthereumGasEthgasstationPayload()
+      expect(result).toBeFalse()
+    })
+    it('when payload is null', () => {
+      const result = isEthereumGasEthgasstationPayload(null)
+      expect(result).toBeFalse()
+    })
+  })
+})

package/src/lib/spec/average.spec.ts

@@ -0,0 +1,61 @@
+import '@xylabs/vitest-extended'
+
+import type { FeeData } from '@xyo-network/gas-price-payload-plugin'
+import {
+  describe, expect,
+  it,
+} from 'vitest'
+
+import {
+  sampleBlocknativeGas, sampleEtherchainGasV2, sampleEtherscanGas, sampleEthgasstationGas,
+} from '../../test/index.ts'
+import { average } from '../average.ts'
+import {
+  transformGasFromBlocknative, transformGasFromEtherchainV2, transformGasFromEtherscan, transformGasFromEthgasstation,
+} from '../transforms/index.ts'
+
+const results: FeeData[] = [
+  transformGasFromBlocknative(sampleBlocknativeGas),
+  transformGasFromEtherchainV2(sampleEtherchainGasV2),
+  transformGasFromEtherscan(sampleEtherscanGas),
+  transformGasFromEthgasstation(sampleEthgasstationGas),
+]
+
+describe('average', () => {
+  it('averages payloads', () => {
+    const payloads = results
+    const result = average(payloads)
+    expect(result).toBeObject()
+    expect(result.baseFee).toBeNumber()
+    expect(result.feePerGas).toBeObject()
+    expect(result.feePerGas.low).toBeNumber()
+    expect(result.feePerGas.medium).toBeNumber()
+    expect(result.feePerGas.high).toBeNumber()
+    expect(result.feePerGas.veryHigh).toBeNumber()
+    expect(result.priorityFeePerGas).toBeObject()
+    expect(result.priorityFeePerGas.low).toBeNumber()
+    expect(result.priorityFeePerGas.medium).toBeNumber()
+    expect(result.priorityFeePerGas.high).toBeNumber()
+    expect(result.priorityFeePerGas.veryHigh).toBeNumber()
+  })
+  it('handles single payload', () => {
+    const payloads = [results[0]]
+    const result = average(payloads)
+    expect(result).toBeObject()
+  })
+  it('handles no values', () => {
+    const result = average()
+    expect(result).toBeObject()
+    expect(result.baseFee).toBeUndefined()
+    expect(result.feePerGas).toBeObject()
+    expect(result.feePerGas.low).toBeUndefined()
+    expect(result.feePerGas.medium).toBeUndefined()
+    expect(result.feePerGas.high).toBeUndefined()
+    expect(result.feePerGas.veryHigh).toBeUndefined()
+    expect(result.priorityFeePerGas).toBeObject()
+    expect(result.priorityFeePerGas.low).toBeUndefined()
+    expect(result.priorityFeePerGas.medium).toBeUndefined()
+    expect(result.priorityFeePerGas.high).toBeUndefined()
+    expect(result.priorityFeePerGas.veryHigh).toBeUndefined()
+  })
+})

package/src/lib/spec/divineGas.spec.ts

@@ -0,0 +1,64 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect,
+  it,
+} from 'vitest'
+
+import {
+  sampleBlocknativeGas, sampleEtherchainGasV2, sampleEtherscanGas, sampleEthersGas, sampleEthgasstationGas,
+} from '../../test/index.ts'
+import { divineGas } from '../divineGas.ts'
+
+describe('divineGas', () => {
+  describe('with no payloads supplied', () => {
+    it('divines gas', () => {
+      const result = divineGas([])
+      expect(result).toBeObject()
+      expect(result.timestamp).toBeNumber()
+    })
+  })
+  describe('with sparse payloads supplied', () => {
+    it.each([[sampleEtherscanGas], [sampleEtherchainGasV2], [sampleEtherchainGasV2, sampleEtherscanGas]])('divines gas', (...payloads) => {
+      const result = divineGas(payloads)
+      expect(result).toBeObject()
+      expect(result.timestamp).toBeNumber()
+    })
+  })
+  describe('with one of each supported payload supplied', () => {
+    it('divines gas', () => {
+      const result = divineGas([sampleBlocknativeGas, sampleEtherchainGasV2, sampleEtherscanGas, sampleEthersGas, sampleEthgasstationGas])
+      expect(result).toBeObject()
+      expect(result.baseFee).toBeNumber()
+      expect(result.feePerGas).toBeObject()
+      expect(result.feePerGas.low).toBeNumber()
+      expect(result.feePerGas.medium).toBeNumber()
+      expect(result.feePerGas.high).toBeNumber()
+      expect(result.feePerGas.veryHigh).toBeNumber()
+      expect(result.priorityFeePerGas).toBeObject()
+      expect(result.priorityFeePerGas.low).toBeNumber()
+      expect(result.priorityFeePerGas.medium).toBeNumber()
+      expect(result.priorityFeePerGas.high).toBeNumber()
+      expect(result.priorityFeePerGas.veryHigh).toBeNumber()
+      expect(result.timestamp).toBeNumber()
+    })
+  })
+  describe('with multiple of each supported payload supplied', () => {
+    it('divines gas', () => {
+      const result = divineGas([
+        sampleBlocknativeGas,
+        sampleBlocknativeGas,
+        sampleEtherchainGasV2,
+        sampleEtherchainGasV2,
+        sampleEtherscanGas,
+        sampleEtherscanGas,
+        sampleEthersGas,
+        sampleEthersGas,
+        sampleEthgasstationGas,
+        sampleEthgasstationGas,
+      ])
+      expect(result).toBeObject()
+      expect(result.timestamp).toBeNumber()
+    })
+  })
+})

package/src/lib/transforms/spec/transformGasFromBlocknative.spec.ts

@@ -0,0 +1,44 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect, it,
+} from 'vitest'
+
+import { sampleBlocknativeGas } from '../../../test/index.ts'
+import { transformGasFromBlocknative } from '../transformGasFromBlocknative.ts'
+
+describe('transformGasFromEtherscan', () => {
+  it('returns values in the expected format', () => {
+    const result = transformGasFromBlocknative(sampleBlocknativeGas)
+    expect(result).toBeObject()
+    expect(result.baseFee).toBeNumber()
+    expect(result.feePerGas).toBeObject()
+    expect(result.feePerGas.low).toBeNumber()
+    expect(result.feePerGas.medium).toBeNumber()
+    expect(result.feePerGas.high).toBeNumber()
+    expect(result.feePerGas.veryHigh).toBeNumber()
+    expect(result.priorityFeePerGas).toBeObject()
+    expect(result.priorityFeePerGas.low).toBeNumber()
+    expect(result.priorityFeePerGas.medium).toBeNumber()
+    expect(result.priorityFeePerGas.high).toBeNumber()
+    expect(result.priorityFeePerGas.veryHigh).toBeNumber()
+  })
+  it('matches expected output', () => {
+    const result = transformGasFromBlocknative(sampleBlocknativeGas)
+    expect(result).toMatchObject({
+      baseFee: 13.691_764_456,
+      feePerGas: {
+        low: 12.95,
+        medium: 13.25,
+        high: 13.55,
+        veryHigh: 13.85,
+      },
+      priorityFeePerGas: {
+        low: 0.14,
+        medium: 0.37,
+        high: 0.6,
+        veryHigh: 0.83,
+      },
+    })
+  })
+})

package/src/lib/transforms/spec/transformGasFromEtherchainV2.spec.ts

@@ -0,0 +1,39 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect, it,
+} from 'vitest'
+
+import { sampleEtherchainGasV2 } from '../../../test/index.ts'
+import { transformGasFromEtherchainV2 } from '../transformGasFromEtherchainV2.ts'
+
+describe('transformGasFromEtherchainV2', () => {
+  it('returns values in the expected format', () => {
+    const result = transformGasFromEtherchainV2(sampleEtherchainGasV2)
+    expect(result).toBeObject()
+    expect(result.baseFee).toBeUndefined()
+    expect(result.feePerGas).toBeObject()
+    expect(result.feePerGas.low).toBeNumber()
+    expect(result.feePerGas.medium).toBeNumber()
+    expect(result.feePerGas.high).toBeNumber()
+    expect(result.feePerGas.veryHigh).toBeNumber()
+    expect(result.priorityFeePerGas).toBeObject()
+    expect(result.priorityFeePerGas.low).toBeUndefined()
+    expect(result.priorityFeePerGas.medium).toBeUndefined()
+    expect(result.priorityFeePerGas.high).toBeUndefined()
+    expect(result.priorityFeePerGas.veryHigh).toBeUndefined()
+  })
+  it('matches expected output', () => {
+    const result = transformGasFromEtherchainV2(sampleEtherchainGasV2)
+    expect(result).toMatchObject({
+      baseFee: undefined,
+      feePerGas: {
+        low: 11.2,
+        medium: 12,
+        high: 19.803_047_33,
+        veryHigh: 29.714_286_17,
+      },
+      priorityFeePerGas: {},
+    })
+  })
+})

package/src/lib/transforms/spec/transformGasFromEthers.spec.ts

@@ -0,0 +1,34 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect, it,
+} from 'vitest'
+
+import { sampleEthersGas } from '../../../test/index.ts'
+import { transformGasFromEthers } from '../transformGasFromEthers.ts'
+
+describe('transformGasFromEthers', () => {
+  it('returns values in the expected format', () => {
+    const result = transformGasFromEthers(sampleEthersGas)
+    expect(result).toBeObject()
+    expect(result.baseFee).toBeNumber()
+    expect(result.feePerGas).toBeObject()
+    expect(result.feePerGas.low).toBeUndefined()
+    expect(result.feePerGas.medium).toBeUndefined()
+    expect(result.feePerGas.high).toBeNumber()
+    expect(result.feePerGas.veryHigh).toBeUndefined()
+    expect(result.priorityFeePerGas).toBeObject()
+    expect(result.priorityFeePerGas.low).toBeUndefined()
+    expect(result.priorityFeePerGas.medium).toBeUndefined()
+    expect(result.priorityFeePerGas.high).toBeNumber()
+    expect(result.priorityFeePerGas.veryHigh).toBeUndefined()
+  })
+  it('matches expected output', () => {
+    const result = transformGasFromEthers(sampleEthersGas)
+    expect(result).toMatchObject({
+      baseFee: 13.547_863_64,
+      feePerGas: { high: 28.395_724_162 },
+      priorityFeePerGas: { high: 1.5 },
+    })
+  })
+})

package/src/lib/transforms/spec/transformGasFromEtherscan.spec.ts

@@ -0,0 +1,39 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect, it,
+} from 'vitest'
+
+import { sampleEtherscanGas } from '../../../test/index.ts'
+import { transformGasFromEtherscan } from '../transformGasFromEtherscan.ts'
+
+describe('transformGasFromEtherscan', () => {
+  it('returns values in the expected format', () => {
+    const result = transformGasFromEtherscan(sampleEtherscanGas)
+    expect(result).toBeObject()
+    expect(result.baseFee).toBeNumber()
+    expect(result.feePerGas).toBeObject()
+    expect(result.feePerGas.low).toBeNumber()
+    expect(result.feePerGas.medium).toBeNumber()
+    expect(result.feePerGas.high).toBeNumber()
+    expect(result.feePerGas.veryHigh).toBeNumber()
+    expect(result.priorityFeePerGas).toBeObject()
+    expect(result.priorityFeePerGas.low).toBeUndefined()
+    expect(result.priorityFeePerGas.medium).toBeUndefined()
+    expect(result.priorityFeePerGas.high).toBeUndefined()
+    expect(result.priorityFeePerGas.veryHigh).toBeUndefined()
+  })
+  it('matches expected output', () => {
+    const result = transformGasFromEtherscan(sampleEtherscanGas)
+    expect(result).toMatchObject({
+      baseFee: 27.616_709_247,
+      feePerGas: {
+        low: 28,
+        medium: 29,
+        high: 30,
+        veryHigh: 31,
+      },
+      priorityFeePerGas: {},
+    })
+  })
+})

package/src/lib/transforms/spec/transformGasFromEthgasstation.spec.ts

@@ -0,0 +1,44 @@
+import '@xylabs/vitest-extended'
+
+import {
+  describe, expect, it,
+} from 'vitest'
+
+import { sampleEthgasstationGas } from '../../../test/index.ts'
+import { transformGasFromEthgasstation } from '../transformGasFromEthgasstation.ts'
+
+describe('transformGasFromEthgasstation', () => {
+  it('returns values in the expected format', () => {
+    const result = transformGasFromEthgasstation(sampleEthgasstationGas)
+    expect(result).toBeObject()
+    expect(result.baseFee).toBeNumber()
+    expect(result.feePerGas).toBeObject()
+    expect(result.feePerGas.low).toBeNumber()
+    expect(result.feePerGas.medium).toBeNumber()
+    expect(result.feePerGas.high).toBeNumber()
+    expect(result.feePerGas.veryHigh).toBeNumber()
+    expect(result.priorityFeePerGas).toBeObject()
+    expect(result.priorityFeePerGas.low).toBeNumber()
+    expect(result.priorityFeePerGas.medium).toBeNumber()
+    expect(result.priorityFeePerGas.high).toBeNumber()
+    expect(result.priorityFeePerGas.veryHigh).toBeNumber()
+  })
+  it('matches expected output', () => {
+    const result = transformGasFromEthgasstation(sampleEthgasstationGas)
+    expect(result).toMatchObject({
+      baseFee: 10,
+      feePerGas: {
+        low: 11.33,
+        medium: 12,
+        high: 12,
+        veryHigh: 13,
+      },
+      priorityFeePerGas: {
+        low: 2,
+        medium: 2,
+        high: 2,
+        veryHigh: 2,
+      },
+    })
+  })
+})

package/src/spec/Diviner.spec.ts

@@ -0,0 +1,100 @@
+import '@xylabs/vitest-extended'
+
+import { EthereumGasBlocknativeWitness, EthereumGasBlocknativeWitnessConfigSchema } from '@xyo-network/blocknative-ethereum-gas-plugin'
+import { EtherchainEthereumGasWitnessV2, EthereumGasEtherchainV2WitnessConfigSchema } from '@xyo-network/etherchain-gas-ethereum-blockchain-plugins'
+import { EthereumGasEthersWitness, EthereumGasEthersWitnessConfigSchema } from '@xyo-network/ethers-ethereum-gas-plugin'
+import { EthereumGasEtherscanWitness, EthereumGasEtherscanWitnessConfigSchema } from '@xyo-network/etherscan-ethereum-gas-plugin'
+import type { EthereumGasPayload } from '@xyo-network/gas-price-payload-plugin'
+import { EthereumGasSchema } from '@xyo-network/gas-price-payload-plugin'
+import type { Payload } from '@xyo-network/payload-model'
+import { getProviderFromEnv } from '@xyo-network/witness-blockchain-abstract'
+import {
+  describe, expect, test,
+} from 'vitest'
+
+import { EthereumGasDiviner } from '../Diviner.ts'
+import {
+  sampleBlocknativeGas, sampleEtherchainGasV2, sampleEtherscanGas, sampleEthersGas, sampleEthgasstationGas,
+} from '../test/index.ts'
+
+describe('Diviner', () => {
+  const cases: [title: string, data: Payload[]][] = [
+    ['EthereumGasBlocknativePayload', [sampleBlocknativeGas]],
+    ['EthereumGasEtherchainV2Payload', [sampleEtherchainGasV2]],
+    ['EthereumGasEtherscanPayload', [sampleEtherscanGas]],
+    ['EthereumGasEthersPayload', [sampleEthersGas]],
+    ['EthereumGasEthgasstationPayload', [sampleEthgasstationGas]],
+    ['no gas payloads', []],
+    ['all supported gas payloads', [sampleBlocknativeGas, sampleEtherchainGasV2, sampleEtherscanGas, sampleEthersGas, sampleEthgasstationGas]],
+  ]
+  test.each(cases)('with %s returns divined gas price', async (_title: string, data: Payload[]) => {
+    const diviner = await EthereumGasDiviner.create({ account: 'random' })
+    const payloads = await diviner.divine(data)
+    expect(payloads).toBeArray()
+    expect(payloads.length).toBe(1)
+    const gasPayload = payloads.pop() as EthereumGasPayload
+    expect(gasPayload).toBeObject()
+    expect(gasPayload.schema).toBe(EthereumGasSchema)
+    expect(gasPayload.timestamp).toBeNumber()
+    expect(gasPayload.feePerGas).toBeObject()
+    expect(gasPayload.priorityFeePerGas).toBeObject()
+  })
+  test.skip('diviner calibration', async () => {
+    const provider = getProviderFromEnv()
+    // NOTE: This test is for obtaining concurrent witnessed
+    // results for diviner weighting/calibration
+    const blocknativeGas = (
+      await (
+        await EthereumGasBlocknativeWitness.create({
+          account: 'random',
+          config: { schema: EthereumGasBlocknativeWitnessConfigSchema },
+        })
+      ).observe()
+    )?.[0]
+    const etherchainGasV2 = (
+      await (
+        await EtherchainEthereumGasWitnessV2.create({
+          account: 'random',
+          config: { schema: EthereumGasEtherchainV2WitnessConfigSchema },
+        })
+      ).observe()
+    )?.[0]
+    const etherscanGas = (
+      await (
+        await EthereumGasEtherscanWitness.create({
+          account: 'random',
+          config: {
+            apiKey: process.env.ETHERSCAN_API_KEY || '',
+            schema: EthereumGasEtherscanWitnessConfigSchema,
+          },
+        })
+      ).observe()
+    )?.[0]
+    const ethersGas = (
+      await (
+        await EthereumGasEthersWitness.create({
+          account: 'random',
+          config: { schema: EthereumGasEthersWitnessConfigSchema },
+          provider,
+        })
+      ).observe()
+    )?.[0]
+
+    const observations: Payload[] = [blocknativeGas, etherchainGasV2, etherscanGas, ethersGas]
+
+    const diviner = await EthereumGasDiviner.create({ account: 'random' })
+
+    const payloads = await diviner.divine(observations)
+
+    expect(payloads).toBeArray()
+    expect(payloads.length).toBe(1)
+    for (let payload of payloads) {
+      if (payload?.schema === EthereumGasSchema) {
+        const gasPayload = payload as EthereumGasPayload
+        expect(gasPayload).toBeObject()
+        expect(gasPayload.schema).toBe(EthereumGasSchema)
+        expect(gasPayload.timestamp).toBeNumber()
+      }
+    }
+  })
+})

package/src/spec/Plugin.spec.ts

@@ -0,0 +1,17 @@
+import '@xylabs/vitest-extended'
+
+import { PayloadSetPluginResolver } from '@xyo-network/payloadset-plugin'
+import {
+  describe, expect,
+  test,
+} from 'vitest'
+
+import { EthereumGasPlugin } from '../Plugin.ts'
+
+describe('CryptoMarketCoinGeckoPlugin', () => {
+  test('Add to Resolver', async () => {
+    const plugin = EthereumGasPlugin()
+    const resolver = await new PayloadSetPluginResolver().register(plugin)
+    expect(resolver.resolve(plugin.set)).toBeDefined()
+  })
+})

package/typedoc.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "https://typedoc.org/schema.json",
-  "entryPoints": ["./src/index.ts"],
-  "tsconfig": "./tsconfig.typedoc.json"
-}

package/xy.config.ts

@@ -1,10 +0,0 @@
-import type { XyTsupConfig } from '@xylabs/ts-scripts-yarn3'
-const config: XyTsupConfig = {
-  compile: {
-    browser: {},
-    node: {},
-    neutral: { src: true },
-  },
-}
-
-export default config