Skip to content
Documentation/Getting started

Your first record

Go from a data file to a verified record and downloadable evidence.

On this page

Before you start

You need an issuer session, an active organization, and write access to a registered plant. Prepare monthly data and check the plant timezone.

Start with a completed month. Use a JSON file with schemaVersion 2.0.0, a matching plantCode, and registered metrics. Select the record type in the dashboard.

Follow the workflow

  1. Select the plant and record type, then upload the JSON file.
  2. Review periods, metrics, and validation errors; confirm the record.
  3. Wait for off-chain verification to complete.
  4. If the record and plan are eligible, an IssuerAdmin authorizes anchoring with the embedded CDP wallet. The platform pays transaction fees.
  5. Wait for finalized confirmation, then open the detail view and download the evidence bundle.

Check the result

Read lifecycle, verification, anchoring, and integrity states separately. An internally committed record can be Verified without being Anchored.

Download the evidence and use /verify in the issuer dashboard. Chain comparison requires the CLI with an RPC connection and an independently confirmed ledger address.

Sources reviewed in the monorepo

Based on source code; live availability is stated separately.

  • apps/issuer-dashboard/src/app/dashboard/data/commit/page.tsx
  • apps/api/src/modules/shadow-ledger/api/shadow-ledger.controller.ts
  • apps/api/src/modules/shadow-ledger/api/anchor-batches.controller.ts