How to use in backend site. (Express, Fastify, NestJS)

[truongly1997]

Hi pinata engineer

We provide an API to every upload their image. Then our backend application will integrate with pinata by using pinata-web3 like the code below

  @AppCatch(Pinata_ERROR.STREAM_TO_IPFS_FAILED)
  async streamToIPFS(chunks: Readable, _metadata: PinataMetadata = {}, _groupId?: string) {
    try {
      const ipfs = await this.pinata.upload.stream(chunks, { cidVersion: 1, ..._metadata })
      return ipfs
    } catch (error) {
      this.logger.error('streaming to IPFS failed: ', error)
    }
  }

it working well but lately, when our tester try to upload same image twice times. The second always return undefined instead of object

      "hash": "bafybeicap2pomrxztny73st6d6h5nutiryrquu5dykwrfvessjyclgzm5u",
      "size": 4062722,
      "time": "2025-06-03T05:31:05.018Z",
      "isDuplicate": true

So that we reading documentation and try to implement the example follow the quickstart https://docs.pinata.cloud/frameworks/node-js

If you have an document guide how to upload from backend site please give us to following

Thank and best regards

[polluterofminds]

Hey @truongly1997, thanks for the report! The pinata-web3 SDK is deprecated in favor of a general purpose SDK (which is the repo you're reporting under). The syntax is very similar, so I'm wondering if you can upgrade to this SDK and test?

https://docs.pinata.cloud/sdk/getting-started

[stevedylandev]

Taking a closer look at the latter error message I think this might be due to the react hooks being included with the SDK, but react should be an optional dependency. Can you try the following?

• Remove node_modules
• Uninstall pinata (npm remove pinata)
• Install Pinata again but omit optional dependencies: npm install pinata --omit=optional

[stevedylandev]

Hey @truongly1997! I believe I just fixed this in 2.4.7; can you try upgrading with npm i pinata@latest and see if it works now?