Skip to main content

Explorer

The Filedgr Explorer is the public face of the platform. It lets anyone look up a vault, a transaction or a file hash and confirm what was notarized, without a Filedgr account and without trusting you.

Publishing a vault

Nothing is public by default. Every vault resolves to a publication level, and until you raise it, the Explorer will not show the vault at all.

LevelWhat the public sees
HIDDENNothing. The vault does not appear in the Explorer
ON_CHAIN_ONLYThe on-chain record — hashes, transactions, timestamps — with names and other identifying detail stripped
FULL_NAMESThe on-chain record plus human-readable names

The level is resolved in this order: the vault's own publication row, then your entity's default, then HIDDEN.

POST /publications body: {"vault_id": "...", "publication_level": "FULL_NAMES"}
DELETE /publications/{vault_id} unpublish a single vault
PUT /publications/entity-default body: {"publication_level": "ON_CHAIN_ONLY"}

All three return 204 No Content, and all three are authenticated as your entity.

note

ON_CHAIN_ONLY is the useful middle ground: a counterparty can verify that a file was notarized and when, without learning what you called it or who else holds permissions.

The public API

The Explorer's read API is unauthenticated and lives on its own host, https://explorer-api.filedgr.networknot api.filedgr.network. It only ever returns what the publication level allows.

Verify a file hash

The endpoint most integrations want. Give it a hash, get back what the platform knows about it:

curl -X POST "https://explorer-api.filedgr.network/verify/file-hash" \
-H "Content-Type: application/json" \
-d '{"hash": "0xcdcd...cd"}'
curl "https://explorer-api.filedgr.network/search?q=<term>&type=<type>&ledger=<ledger>"

type and ledger are optional filters. No results comes back as {"items": []}.

Everything else

EndpointReturns
GET /vaults/{vault_id}Vault detail
GET /vaults/{vault_id}/streamsIts streams
GET /vaults/{vault_id}/attachmentsIts data attachments
GET /vaults/{vault_id}/permissionsWho holds access
GET /vaults/{vault_id}/signaturesSignatures on the vault
GET /vaults/{vault_id}/timelineOrdered history of the vault
GET /streams/{stream_id}Stream detail
GET /streams/{stream_id}/attachmentsThe stream's attachments
GET /attachments/{attachment_id}/filesFiles inside an attachment
GET /signatures/by-hash/{file_hash}Signatures over a file hash
GET /signatures/by-wallet/{wallet_address}Everything a wallet has signed
GET /signatures/{signature_id}One signature
GET /transactions/{tx_hash}Transaction detail
GET /transactions/{tx_hash}/relatedRecords anchored by the same transaction
GET /assets/{asset_id}Asset detail
GET /assets/{asset_id}/permissionsAsset access
GET /entities/{entity_id}Entity detail
GET /entities/{entity_id}/vaultsAn entity's published vaults
GET /activityRecent public activity
GET /statsPlatform-wide counters
GET /stats/ledger/{ledger}Counters for one ledger

Linking a recipient straight to the proof

For a specific counterparty, a proof package is usually a better fit than publishing: it is scoped to the files you choose, expires, and can be download-limited — where publishing is open to everyone, indefinitely.

Use the Explorer when you want the record to be publicly checkable, and a proof package when you want it checkable by one recipient.

Next steps