Skip to content

Warehouse Receipts

The fastest way to use the Warehouse Receipts workspace is the live application:

https://openetr.org/warehouse-receipts

The workspace lets you work in warehouse receipt language while the underlying OpenETR component publishes, queries, and verifies signed evidence records for the receipt document digest.

For the policy rationale and relationship to the Model Law on Warehouse Receipts, see Warehouse Receipts Need Consequential State.

What You Can Do

The Warehouse Receipts workspace supports two broad modes.

Mode What You Can Do
Read-only Query a receipt document by uploading the file and recomputing its digest.
Signed in Select an acting profile, create initial receipt evidence records, and publish later evidence records.

Read-only users can inspect whether a receipt artifact has an OpenETR record.

Signed-in users can operate the workspace with profiles and signer keys.

Control Desk Concepts

Term Meaning In The App
Warehouse Receipts workspace The operating surface for warehouse receipt actions.
Control Desk Key The root/admin key used for recovery and profile management.
Commitment Profile A profile organized by the Control Desk Key that can sign commitments.
Acting Profile The selected Commitment Profile currently used to sign warehouse receipt actions.
Receipt Evidence Record A signed OpenETR Anchor or evidence record.
Docs Link back to this documentation site.

The Acting Profile is the selected Commitment Profile that signs operational actions such as creating the initial evidence record, transferring, encumbering, discharging, redeeming, or terminating receipt control.

Query A Receipt

Use Query Evidence Record when you have a warehouse receipt file and want to inspect its OpenETR state.

  1. Open the Warehouse Receipts workspace.
  2. Upload the warehouse receipt file.
  3. Confirm or adjust the relay field.
  4. Select Query Evidence Record.

The app computes the file digest locally in the request flow, queries the configured relays, and shows candidate Anchor records, current controller, lifecycle state, evidence events, and outstanding encumbrances where available.

Sign In And Select An Acting Profile

To create or control receipt evidence records, sign in with a Control Desk Key or session key.

When signed in, the workspace shows:

  • the Control Desk Key;
  • the Acting Profile;
  • a Commitment Profile selector;
  • an Update Current Profile button;
  • a Backup Key action for recovery material.

Use the profile selector to choose which Commitment Profile should sign operational actions.

Back Up The Control Desk Key

The Backup Key dialog lets you copy recovery material to the clipboard.

Store this material carefully. The Control Desk Key can organize and recover relay-backed profile configuration and signer records.

Update The Acting Profile

Use Update Current Profile to edit the selected profile metadata.

Profile metadata may include:

  • name;
  • display name;
  • about;
  • address;
  • website;
  • NIP-05;
  • LEI or other identifying fields.

The profile editor publishes an updated Nostr profile event for the acting signer.

Create A Receipt Evidence Record

Use Create Evidence Record when the warehouse operator or issuer profile wants to publish the first OpenETR Anchor record for an already-issued warehouse receipt artifact.

The app:

  1. hashes the uploaded receipt file;
  2. creates the object id;
  3. signs an Anchor Event with the Acting Profile;
  4. includes structured event tags such as receipt reference and description where provided;
  5. publishes the event to the configured relay set.

The receipt file itself remains outside OpenETR. OpenETR records the digest and control evidence.

Next Steps

For local development or deployment, see Installation And Local Development.