Next major release - V9.0

.github/workflows/ci.yml

@@ -61,7 +61,6 @@ jobs:
         working-directory: ${{ github.workspace }}/barge
         run: |
           bash -x start_ocean.sh 2>&1 > start_ocean.log &
-
       - name: Install deps & build
         run: npm ci && npm run build:metadata
       - name: Wait for node to be ready
@@ -151,7 +150,6 @@ jobs:
         working-directory: ${{ github.workspace }}/barge
         run: |
           bash -x start_ocean.sh 2>&1 > start-node.log &
-
       - name: Install deps & build
         run: npm ci && npm run build:metadata
 
@@ -222,7 +220,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        node: ["22", "20"]
+        node: ["22", "24"]
 
     steps:
       - uses: actions/checkout@v3

.github/workflows/publish.yml

@@ -14,7 +14,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
           registry-url: https://registry.npmjs.org/
       - run: npm ci
 

CHANGELOG.md

@@ -4,9 +4,71 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
-#### [v8.6.2](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.4...v8.6.2)
+#### [v9.0.0-next.12](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.11...v9.0.0-next.12)
 
+- Feature/auth for policy server [`#2134`](https://github.com/oceanprotocol/ocean.js/pull/2134)
+- more p2p updates [`c7f82f4`](https://github.com/oceanprotocol/ocean.js/commit/c7f82f4136b4dcb536326748c088847e02e73b83)
+- p2p_improve [`9f03d09`](https://github.com/oceanprotocol/ocean.js/commit/9f03d0991919587b98f2b5000fd213d525272006)
+- Release 9.0.0-next.10 [`7fed9c7`](https://github.com/oceanprotocol/ocean.js/commit/7fed9c78df0ce3c601453340fc4614cef554b11a)
+
+#### [v9.0.0-next.11](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.10...v9.0.0-next.11)
+
+> 21 August 2026
+
+- update deps [`0c5027e`](https://github.com/oceanprotocol/ocean.js/commit/0c5027e0ea487ce6c32e02100b0391f0ba2e6d60)
+- bumps [`7e0fe52`](https://github.com/oceanprotocol/ocean.js/commit/7e0fe5210fb467bba06980dc903c6d8654eca79c)
+- Release 9.0.0-next.11 [`8af747f`](https://github.com/oceanprotocol/ocean.js/commit/8af747f0bd3808a7e8b0334361412cbb2ca93c36)
+
+#### [v9.0.0-next.10](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.9...v9.0.0-next.10)
+
+> 20 August 2026
+
+- Feature/auth for policy server [`#2134`](https://github.com/oceanprotocol/ocean.js/pull/2134)
+- test node 24 [`#2135`](https://github.com/oceanprotocol/ocean.js/pull/2135)
+- hardcode http paths [`#2133`](https://github.com/oceanprotocol/ocean.js/pull/2133)
+- add node compute job/service runTimeMetrics [`#2132`](https://github.com/oceanprotocol/ocean.js/pull/2132)
+- Bump ip-address from 10.2.0 to 10.5.0 [`#2131`](https://github.com/oceanprotocol/ocean.js/pull/2131)
+- Bump svgo from 2.8.2 to 2.8.3 [`#2122`](https://github.com/oceanprotocol/ocean.js/pull/2122)
+- Bump body-parser and express [`#2121`](https://github.com/oceanprotocol/ocean.js/pull/2121)
+- Bump postcss from 8.5.13 to 8.5.26 [`#2130`](https://github.com/oceanprotocol/ocean.js/pull/2130)
 - send job name on started endpoint [`#2117`](https://github.com/oceanprotocol/ocean.js/pull/2117)
+- Release 9.0.0-next.10 [`7fed9c7`](https://github.com/oceanprotocol/ocean.js/commit/7fed9c78df0ce3c601453340fc4614cef554b11a)
+- Release 8.6.2 [`ab42c87`](https://github.com/oceanprotocol/ocean.js/commit/ab42c8716cef67bd8e9c43c12fb1d20bd2283492)
+
+#### [v9.0.0-next.9](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.8...v9.0.0-next.9)
+
+> 5 August 2026
+
+- output bucke & workflows [`#2129`](https://github.com/oceanprotocol/ocean.js/pull/2129)
+- Release 9.0.0-next.9 [`ad36739`](https://github.com/oceanprotocol/ocean.js/commit/ad36739735512d6d7cbbc1578b892ace85846421)
+
+#### [v9.0.0-next.8](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.7...v9.0.0-next.8)
+
+> 29 July 2026
+
+- add missing enum (restarting) [`#2126`](https://github.com/oceanprotocol/ocean.js/pull/2126)
+- Release 9.0.0-next.8 [`101351b`](https://github.com/oceanprotocol/ocean.js/commit/101351b103a2bf2ddefd5cc0d4c1d4acdd1061e0)
+
+#### [v9.0.0-next.7](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.6...v9.0.0-next.7)
+
+> 29 July 2026
+
+- Feat/162 service restart notify [`#2125`](https://github.com/oceanprotocol/ocean.js/pull/2125)
+- Release 9.0.0-next.7 [`bc87e0e`](https://github.com/oceanprotocol/ocean.js/commit/bc87e0eda3bde37055742e68733c2e16b41b2ef1)
+
+#### [v9.0.0-next.6](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.5...v9.0.0-next.6)
+
+> 24 July 2026
+
+- allow dockerspecs on service restart [`#2119`](https://github.com/oceanprotocol/ocean.js/pull/2119)
+- Release 9.0.0-next.6 [`cedce7b`](https://github.com/oceanprotocol/ocean.js/commit/cedce7baf92684045feaac09951a6f7bd25efe88)
+
+#### [v9.0.0-next.5](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.4...v9.0.0-next.5)
+
+> 23 July 2026
+
+- Feature/162 inference services es [`#2118`](https://github.com/oceanprotocol/ocean.js/pull/2118)
+- Release 9.0.0-next.5 [`d229d54`](https://github.com/oceanprotocol/ocean.js/commit/d229d54d863e51163a509b5479c6694d6ad9f384)
 
 #### [v9.0.0-next.4](https://github.com/oceanprotocol/ocean.js/compare/v9.0.0-next.3...v9.0.0-next.4)
 
@@ -29,23 +91,30 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 - add service streamable logs [`#2113`](https://github.com/oceanprotocol/ocean.js/pull/2113)
 - Release 9.0.0-next.2 [`a64f21d`](https://github.com/oceanprotocol/ocean.js/commit/a64f21d75622c03d814525e5e72759adab06c4af)
 
-#### [v9.0.0-next.1](https://github.com/oceanprotocol/ocean.js/compare/v8.6.1...v9.0.0-next.1)
+#### [v9.0.0-next.1](https://github.com/oceanprotocol/ocean.js/compare/v8.6.2...v9.0.0-next.1)
 
 > 9 July 2026
 
 - sign issuer peer id [`#2111`](https://github.com/oceanprotocol/ocean.js/pull/2111)
 - Feature/new bundle for escrow [`#2109`](https://github.com/oceanprotocol/ocean.js/pull/2109)
 - Feature/services [`#2101`](https://github.com/oceanprotocol/ocean.js/pull/2101)
+- Release 9.0.0-next.1 [`687ec49`](https://github.com/oceanprotocol/ocean.js/commit/687ec49581448f60578cb9223e150e43e07b4d67)
+- Update NODE_VERSION from pr-1404 to pr-1408 [`7ff612b`](https://github.com/oceanprotocol/ocean.js/commit/7ff612bd4f4c33f41b81becfb17f418d496e9ed9)
+- Update ci.yml [`54afe0d`](https://github.com/oceanprotocol/ocean.js/commit/54afe0d15d5e5268e72169cc24449c4c34680622)
+
+#### [v8.6.2](https://github.com/oceanprotocol/ocean.js/compare/v8.6.1...v8.6.2)
+
+> 17 July 2026
+
+- send job name on started endpoint [`#2117`](https://github.com/oceanprotocol/ocean.js/pull/2117)
 - Feature/add claude [`#2112`](https://github.com/oceanprotocol/ocean.js/pull/2112)
 - Bump @libp2p/tcp from 11.0.18 to 11.0.22 [`#2092`](https://github.com/oceanprotocol/ocean.js/pull/2092)
 - Bump @babel/plugin-transform-modules-systemjs from 7.25.9 to 7.29.4 [`#2087`](https://github.com/oceanprotocol/ocean.js/pull/2087)
 - Bump esbuild and tsx [`#2097`](https://github.com/oceanprotocol/ocean.js/pull/2097)
 - Bump eslint-config-prettier from 10.1.5 to 10.1.8 [`#2091`](https://github.com/oceanprotocol/ocean.js/pull/2091)
 - Bump @libp2p/kad-dht from 16.1.6 to 16.3.1 [`#2093`](https://github.com/oceanprotocol/ocean.js/pull/2093)
 - remove codeowner [`#2108`](https://github.com/oceanprotocol/ocean.js/pull/2108)
-- Release 9.0.0-next.1 [`687ec49`](https://github.com/oceanprotocol/ocean.js/commit/687ec49581448f60578cb9223e150e43e07b4d67)
-- Update NODE_VERSION from pr-1404 to pr-1408 [`7ff612b`](https://github.com/oceanprotocol/ocean.js/commit/7ff612bd4f4c33f41b81becfb17f418d496e9ed9)
-- Update ci.yml [`54afe0d`](https://github.com/oceanprotocol/ocean.js/commit/54afe0d15d5e5268e72169cc24449c4c34680622)
+- Release 8.6.2 [`ab42c87`](https://github.com/oceanprotocol/ocean.js/commit/ab42c8716cef67bd8e9c43c12fb1d20bd2283492)
 
 #### [v8.6.1](https://github.com/oceanprotocol/ocean.js/compare/v8.6.0...v8.6.1)
 
@@ -161,7 +230,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 - update ddo.js [`#2071`](https://github.com/oceanprotocol/ocean.js/pull/2071)
 - Release 8.0.1 [`87b651d`](https://github.com/oceanprotocol/ocean.js/commit/87b651d139218325a06028e0b042af9777f07eb7)
 
-### [v8.0.0](https://github.com/oceanprotocol/ocean.js/compare/v7.0.0-next.8...v8.0.0)
+### [v8.0.0](https://github.com/oceanprotocol/ocean.js/compare/v7.0.0-next.13...v8.0.0)
 
 > 14 April 2026
 
@@ -174,6 +243,42 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 - Bump basic-ftp from 5.2.0 to 5.2.1 [`#2064`](https://github.com/oceanprotocol/ocean.js/pull/2064)
 - Release 8.0.0 [`16497f6`](https://github.com/oceanprotocol/ocean.js/commit/16497f63603e8f1ed0884dae4ce45fbe038cc412)
 
+#### [v7.0.0-next.13](https://github.com/oceanprotocol/ocean.js/compare/v7.0.0-next.12...v7.0.0-next.13)
+
+> 9 April 2026
+
+- create auth token with signed messge [`664a9b3`](https://github.com/oceanprotocol/ocean.js/commit/664a9b36552a8aaad6d995f5ef615735aba0c58f)
+- Release 7.0.0-next.13 [`8358b51`](https://github.com/oceanprotocol/ocean.js/commit/8358b513704e15e018a596dfdc013667968ea16b)
+
+#### [v7.0.0-next.12](https://github.com/oceanprotocol/ocean.js/compare/v7.0.0-next.11...v7.0.0-next.12)
+
+> 9 April 2026
+
+- fetchnodelogs p2p method [`218c472`](https://github.com/oceanprotocol/ocean.js/commit/218c4720a2f82d780cfc6f29f24372fd2a706649)
+- Release 7.0.0-next.12 [`5abf22f`](https://github.com/oceanprotocol/ocean.js/commit/5abf22f8ac3c02d1b61eb89df77c2dee06dcaf42)
+
+#### [v7.0.0-next.11](https://github.com/oceanprotocol/ocean.js/compare/v7.0.0-next.10...v7.0.0-next.11)
+
+> 9 April 2026
+
+- Release 7.0.0-next.11 [`b8a24d9`](https://github.com/oceanprotocol/ocean.js/commit/b8a24d92842e3ca6c91c3810d77ac24767486c87)
+- export libp2p node [`cfae9c5`](https://github.com/oceanprotocol/ocean.js/commit/cfae9c5ec5749c8902717f4e231a1baa14a880c6)
+
+#### [v7.0.0-next.10](https://github.com/oceanprotocol/ocean.js/compare/v7.0.0-next.9...v7.0.0-next.10)
+
+> 9 April 2026
+
+- p2p store discovered nodes & add dockerregistryauth [`8689233`](https://github.com/oceanprotocol/ocean.js/commit/8689233403c0a73e555844d72e04f48e7d581cab)
+- Release 7.0.0-next.10 [`b74e620`](https://github.com/oceanprotocol/ocean.js/commit/b74e62047ec6c05e2b30491a643693556edbdb58)
+- lint fix [`cfa8ffd`](https://github.com/oceanprotocol/ocean.js/commit/cfa8ffd0b598e48fcf3c4cf008d9b4a72e0b25a8)
+
+#### [v7.0.0-next.9](https://github.com/oceanprotocol/ocean.js/compare/v7.0.0-next.8...v7.0.0-next.9)
+
+> 9 April 2026
+
+- fix review comments [`51f59c5`](https://github.com/oceanprotocol/ocean.js/commit/51f59c52ca9885087d8a00c77ae053e3495a7d65)
+- Release 7.0.0-next.9 [`5c02645`](https://github.com/oceanprotocol/ocean.js/commit/5c0264573d89ae7eb805a256f446f8c98086329a)
+
 #### [v7.0.0-next.8](https://github.com/oceanprotocol/ocean.js/compare/v7.0.0-next.7...v7.0.0-next.8)
 
 > 8 April 2026
@@ -450,7 +555,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 - export util addrs functions [`#2017`](https://github.com/oceanprotocol/ocean.js/pull/2017)
 - Release 4.3.6 [`b28db44`](https://github.com/oceanprotocol/ocean.js/commit/b28db446144939e9ed864cc11559f718104d094b)
 
-#### [v4.3.5](https://github.com/oceanprotocol/ocean.js/compare/v4.3.3...v4.3.5)
+#### [v4.3.5](https://github.com/oceanprotocol/ocean.js/compare/v4.3.4...v4.3.5)
 
 > 17 November 2025
 
@@ -459,6 +564,14 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 - remove typo [`f199f4a`](https://github.com/oceanprotocol/ocean.js/commit/f199f4af809eb85249fe0c59303fcc3207d8e7a7)
 - export EnterpriseFeeCollector [`68712a2`](https://github.com/oceanprotocol/ocean.js/commit/68712a2af17824bb8fc78824842376e35f582487)
 
+#### [v4.3.4](https://github.com/oceanprotocol/ocean.js/compare/v4.3.3...v4.3.4)
+
+> 15 November 2025
+
+- add EnterpriseFee [`b502882`](https://github.com/oceanprotocol/ocean.js/commit/b502882d05375eda326166608730a11e779c6f42)
+- Release 4.3.4 [`e45a7de`](https://github.com/oceanprotocol/ocean.js/commit/e45a7defa239f6800eb68a13e1a9a3d9662f509d)
+- bump contracts [`0b226a1`](https://github.com/oceanprotocol/ocean.js/commit/0b226a107f309c6b200249d498ae7568343fcb92)
+
 #### [v4.3.3](https://github.com/oceanprotocol/ocean.js/compare/v4.3.2...v4.3.3)
 
 > 1 August 2025

Cheatsheet.md

@@ -313,14 +313,34 @@ const jobStatus = await ProviderInstance.computeStatus(
 
 ### Get download compute results URL
 
+`getComputeResultUrl` is an HTTP-transport capability. Over a P2P node there is no URL for the
+result — the protocol answers with the result bytes — so call `getComputeResult` (a streaming
+generator) instead. Use `isP2pUri(providerUrl)` to branch.
+
 ```javascript
 
-const downloadURL = await ProviderInstance.getComputeResultUrl(
+if (isP2pUri(providerUrl)) {
+    // P2P node: no URL, the protocol streams the result bytes back.
+    const stream = await ProviderInstance.getComputeResult(
+        providerUrl,
+        consumerAccount,
+        computeJobId,
+        0
+    )
+    const chunks = []
+    for await (const chunk of stream) {
+        chunks.push(chunk)
+    }
+    const result = Buffer.concat(chunks)
+} else {
+    // HTTP node: fetch a downloadable URL for the result.
+    const downloadURL = await ProviderInstance.getComputeResultUrl(
         providerUrl,
         consumerAccount,
         computeJobId,
         0
     )
+}
 
 
 ```

CodeExamples.md

@@ -204,7 +204,7 @@ Next, we define the metadata that will describe our data asset. This is what we
     publisherAccount = (await provider.getSigner(0)) as Signer
     consumerAccount = (await provider.getSigner(1)) as Signer
     stakerAccount = (await provider.getSigner(2)) as Signer
-    const config = new ConfigHelper().getConfig(
+    config = new ConfigHelper().getConfig(
       parseInt(String((await publisherAccount.provider.getNetwork()).chainId))
     )
     Object.assign(config, getNodeEndpointConfig())

ComputeExamples.md

@@ -151,6 +151,9 @@ import {
   unitsToAmount,
   AssetFiles
 } from '../../src/index.js'
+<!--
+import { isP2pUri } from '../../src/index.js'
+-->
 import crypto from 'crypto-js'
 import { DDO } from '@oceanprotocol/ddo-js'
 import { EscrowContract } from '../../src/contracts/Escrow.js'
@@ -434,7 +437,7 @@ We need to load the configuration. Add the following code into your `run(){ }` f
     )
     publisherAccount = (await provider.getSigner(0)) as Signer
     consumerAccount = (await provider.getSigner(1)) as Signer
-    const config = new ConfigHelper().getConfig(
+    config = new ConfigHelper().getConfig(
       parseInt(String((await publisherAccount.provider.getNetwork()).chainId))
     )
     Object.assign(config, getNodeEndpointConfig())
@@ -694,6 +697,12 @@ Now, let's see the current status of the previously started computer job
 
   ### 11.2 Get download compute results URL
 <!--
+    // HTTP-transport only: a peer answers with the result bytes and carries no URL for
+    // them, so this rejects over P2P and everything below it does not apply. Returning
+    // early rather than calling this.skip(): the guide generator turns the it() line into
+    // a markdown heading by matching an arrow function, so this callback has to stay one,
+    // and an arrow has no mocha context to skip from.
+    if (isP2pUri(providerUrl)) return
 -->
 ```Typescript
     await sleep(10000)
@@ -912,6 +921,12 @@ Now, let's see the current status of the previously started computer job
 
   ### 13.2 Get download compute results URL
 <!--
+    // HTTP-transport only: a peer answers with the result bytes and carries no URL for
+    // them, so this rejects over P2P and everything below it does not apply. Returning
+    // early rather than calling this.skip(): the guide generator turns the it() line into
+    // a markdown heading by matching an arrow function, so this callback has to stay one,
+    // and an arrow has no mocha context to skip from.
+    if (isP2pUri(providerUrl)) return
 -->
 
 ```Typescript

README.md

@@ -57,12 +57,34 @@ npm install @oceanprotocol/lib
 - Developers using this library should ensure their tsconfig.json includes the necessary options:
 ```
 {
-  "moduleResolution": "node",
+  "moduleResolution": "bundler",
+  "module": "esnext",
   "esModuleInterop": true,
   "allowSyntheticDefaultImports": true
 }
 ```
-- If using Next.js, they may need "moduleResolution": "bundler" for better compatibility.
+- `"moduleResolution": "nodenext"` works too. The older `"node"` (node10) mode was removed in
+  TypeScript 7, so don't use it — and it cannot resolve this package's `exports` map anyway.
+
+### ESM only
+
+`@oceanprotocol/lib` ships as ES modules only — there is no CommonJS build, because most of
+its runtime dependencies (the libp2p stack, `multiformats`, `uint8arrays`) are themselves
+ESM-only. Import it:
+
+```js
+import { ProviderInstance, ConfigHelper } from '@oceanprotocol/lib'
+```
+
+From CommonJS code, use Node's built-in `require(esm)` support, available from **Node
+22.12**:
+
+```js
+const { ConfigHelper } = require('@oceanprotocol/lib')
+```
+
+On Node 22.0–22.11 this throws `ERR_REQUIRE_ESM`; use a dynamic `await import(...)`
+instead, or move the calling module to ESM.
 
 ## 📖 Documentation