2025-10-03 14:45:52 -04:00
|
|
|
---
|
|
|
|
|
title: Query IPFS Node Status
|
|
|
|
|
description: Check connectivity and status of the distributed storage layer
|
2026-09-02 16:53:38 -04:00
|
|
|
seo:
|
|
|
|
|
title: "IPFS Node Information"
|
2025-10-03 14:45:52 -04:00
|
|
|
---
|
|
|
|
|
|
2026-09-02 16:53:38 -04:00
|
|
|
:::info
|
|
|
|
|
IPFS provides distributed storage for large objects, vault exports, and encrypted backups.
|
|
|
|
|
:::
|
2025-10-03 14:45:52 -04:00
|
|
|
|
|
|
|
|
## IPFS Integration
|
|
|
|
|
|
|
|
|
|
### Node Information
|
|
|
|
|
- **Peer ID**: Unique identifier for the IPFS node
|
|
|
|
|
- **Peer Name**: Human-readable node name
|
|
|
|
|
- **Peer Type**: Node configuration (gateway, full, light)
|
|
|
|
|
- **Version**: IPFS daemon version
|
|
|
|
|
|
|
|
|
|
### Use Cases
|
|
|
|
|
- **Large Files**: Store files exceeding `maxRecordSize`
|
|
|
|
|
- **Vault Exports**: Backup encrypted vault data
|
|
|
|
|
- **Protocol Assets**: Store protocol-related media
|
|
|
|
|
- **Public Content**: Distribute public records efficiently
|
|
|
|
|
|
2026-09-02 16:53:38 -04:00
|
|
|
:::tip
|
|
|
|
|
Store only metadata and CIDs on-chain for gas efficiency, with actual data in IPFS.
|
|
|
|
|
:::
|
2025-10-03 14:45:52 -04:00
|
|
|
|
|
|
|
|
## Common Patterns
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# Upload to IPFS first
|
|
|
|
|
ipfs add large_file.pdf
|
|
|
|
|
# Store CID in DWN record
|
|
|
|
|
snrd tx dwn records-write --data-cid <cid>
|
|
|
|
|
```
|
|
|
|
|
|
2026-09-02 16:53:38 -04:00
|
|
|
:::warning
|
|
|
|
|
Ensure IPFS node is running and accessible before storing large objects.
|
|
|
|
|
:::
|
