Repo API

• ipfs.repo.gc([options])
  • Parameters
  • Options
  • Returns
  • Example
• ipfs.repo.stat([options])
  • Parameters
  • Options
  • Returns
  • Example
  • Notes
• ipfs.repo.version([options])
  • Parameters
  • Options
  • Returns
  • Example

ipfs.repo.gc([options])

Perform a garbage collection sweep on the repo.

Parameters

None

Options

An optional object which may have the following keys:

Name	Type	Default	Description
quiet	boolean	false	Write minimal output
timeout	Number	undefined	A timeout in ms
signal	AbortSignal	undefined	Can be used to cancel any long running requests started as a result of this call

Returns

Type	Description
AsyncIterable<Object>	An async iterable that yields objects describing nodes that were garbage collected

Each yielded object contains the following properties:

• err is an Error if it was not possible to GC a particular block.
• cid is the CID of the block that was Garbage Collected.

Example

for await (const res of ipfs.repo.gc()) {
  console.log(res)
}

ipfs.repo.stat([options])

Get stats for the currently used repo.

Parameters

None

Options

An optional object which may have the following keys:

Name	Type	Default	Description
human	boolean	false	Return storage numbers in MiB
timeout	Number	undefined	A timeout in ms
signal	AbortSignal	undefined	Can be used to cancel any long running requests started as a result of this call

Returns

Type	Description
Promise<Object>	An object containing the repo's info

the returned object has the following keys:

• numObjects is a BigInt.
• repoSize is a BigInt, in bytes.
• repoPath is a string.
• version is a string.
• storageMax is a BigInt.

Example

const stats = await ipfs.repo.stat()
console.log(stats)

// { numObjects: 15,
//   repoSize: 64190,
//   repoPath: 'C:\\Users\\henri\\AppData\\Local\\Temp\\ipfs_687c6eb3da07d3b16fe3c63ce17560e9',
//   version: 'fs-repo@6',
//   storageMax: 10000000000 }

Notes

stats.repo and repo.stat can be used interchangeably.

ipfs.repo.version([options])

Show the repo version.

Parameters

None

Options

An optional object which may have the following keys:

Name	Type	Default	Description
timeout	Number	undefined	A timeout in ms
signal	AbortSignal	undefined	Can be used to cancel any long running requests started as a result of this call

Returns

Type	Description
Promise<String>	A String containing the repo's version

Example

const version = await ipfs.repo.version()
console.log(version)

// "6"