Skip to main content

Digital Twins

Digital twins are blockchain-based representations of physical assets.

Components​

Asset Template​

  • Defines which streams a vault starts with
  • Supplies the default image

Data Layer​

  • IPFS storage
  • Streams and data attachments

Smart Contract Layer​

  • Access control
  • Ownership management
  • Interaction rules

Implementation​

Creation Process​

  1. Select template
  2. Deploy vault
  3. Initialize data
  4. Set permissions

Adding data​

Data is added by creating a data attachment against a stream and uploading the file. Attachments are create-then-finalize; there is no in-place update of an attachment's contents. See the Quick Start for the full flow.

Verification​

Verification is per file hash, not per vault. Hash the file locally and ask the public Explorer API whether Filedgr knows it:

curl -X POST https://<explorer-host>/verify/file-hash \
  -H "Content-Type: application/json" \
  -d '{"hash": "<sha256-of-the-file>"}'
{ "verified": true, "match_type": "ATTESTED", "signatures": [ ... ], "files": [ ... ] }

match_type is one of:

ValueMeaning
ATTESTEDA signature record for this hash is anchored on-chain
UPLOADEDThe platform holds a file with this hash, but it has not been attested
UNKNOWNNo match

To list who signed a given file, use GET /signatures/by-hash/{file_hash} on the same API.

Use Cases​

  • Product certification
  • Asset tracking
  • Supply chain management
  • Maintenance records
  • Quality assurance