Onchain Storage

Troubleshooting

Troubleshooting common errors during installation and use of the Irys SDK and CLI.

bigint: Failed to load bindings

Error message: "bigint: Failed to load bindings, pure JS will be used (try npm run rebuild?)"

This error can be safely ignored and will not cause any issues. To eliminate it, install updated Python and C++ build tools for your platform.

MacOS: Current MacOS versions include Python pre-installed. For C++ build tools, first install XCode, then go to Preferences, Downloads, and install the Command Line Tools.

Windows: Windows users need both Python and C++ build tools. Run these commands with administrator permissions:

npm i -g --add-python-to-path --vs2015 --production windows-build-tools

npm i -g node-gyp@latest

UNIX: Most UNIX distributions come with Python. For C++ build tools on Debian-based systems:

sudo apt-get install build-essential

For other distributions, use your package manager to install "GCC build tools".

Error: Not enough balance for transaction

Error message: "Error: Not enough balance for transaction"

This error occurs when attempting to upload to a node without first funding it. Devnet bundler tokens are available free from faucets like Solana and Sepolia.

Error: Blockhash not found

Error message: "Error: Transaction simulation failed: Blockhash not found"

Irys requires transaction confirmation; in some cases, waiting for finalization is necessary. Fix this by configuring Irys as follows:

const irys = new Irys({
  url: nodeUrl,
  token,
  provider,
  config: { tokenOpts: { commitment: "finalized" } },
});