DEVELOPER DOCS
Commands
upload

upload

Uploads a single file.

Parameters

  • -n: The network to check. Values are mainnet or devnet (if you omit, the default is mainnet).
  • -t: The token to use when uploading.
  • -w: Your private key.
  • --tags: Tags to include, format <name> <value>
  • --provider-url: RPC URL to use. This is only required when using Devnet.

Examples

Mainnet

irys upload myImage.png \
  -t ethereum \
  -w bf20......c9885307 \
  --tags tagName1 tagValue1 tagName2 tagValue2

Devnet

irys upload myImage.png \
  -n devnet \
  -t ethereum \
  -w bf20......c9885307 \
  --tags tagName1 tagValue1 tagName2 tagValue2 \
  --provider-url https://rpc.sepolia.dev
ℹ️

Devnet RPC URLs change often, use a recent one from https://chainlist.org/ (opens in a new tab)

Downloading

Files uploaded via irys upload can be downloaded using the transaction ID provided after a successful upload.

irys upload myImage.png \
  -n mainnet \
  -t ethereum \
  -w bf20......c9885307 \
  --tags tagName1 tagValue1 tagName2 tagValue2
 
Loaded address: 0xac568a981b1370b2e1baa8ce30bd5ac9e28c572d
Uploaded to https://gateway.irys.xyz/yPX6_rwxfJ_2gTvXSHGoumIvlFR-EwuRlUMmHpeLHUM