https://github.com/decred/dcrtimegui

Timestamp files with blockchain
https://github.com/decred/dcrtimegui

Last synced: 9 months ago
JSON representation

Timestamp files with blockchain

• Host: GitHub
• URL: https://github.com/decred/dcrtimegui
• Owner: decred
• License: isc
• Created: 2018-12-03T14:30:04.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-12-04T14:04:41.000Z (over 2 years ago)
• Last Synced: 2025-07-28T15:26:23.122Z (11 months ago)
• Language: JavaScript
• Size: 6.5 MB
• Stars: 14
• Watchers: 6
• Forks: 12
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
dcrtimegui

==========

[![Build Status](https://github.com/decred/dcrtimegui/workflows/Build%20and%20Test/badge.svg)](https://github.com/decred/dcrtimegui/actions)

[![ISC License](https://img.shields.io/badge/license-ISC-blue.svg)](http://copyfree.org)

## Overview

**Dcrtimegui is a web application which provides an easy and free timestamping service using dcrtime as the backend.**

A hash of each submitted file is calculated and sent to a dcrtime server, which aggregates these hashes, organizes them into a merkle tree, hashes that tree down to a merkle root, and timestamps that merkle root in the Decred blockchain once an hour.

## Technical details

- This service, dcrtime and Decred use the sha256 hash function.

- **The files are not stored in the server**. It uses 

[dcrtime](https://github.com/decred/dcrtime) as backend to store and timestamp the

files hashes.

- This app uses the [dcrtimejs](https://github.com/tiagoalvesdulce/dcrtimejs) to communicate with the dcrtime APIs.

## Running APIs

| Network | Base URL                              |

| ------- | ------------------------------------- |

| Testnet | https://time-testnet.decred.org:59152 |

| Mainnet | https://time.decred.org:49152 |

## Development

To start the development server:

`yarn && yarn start` 

## Production

To generate the production bundle for mainnet:

`yarn && yarn build`

For testnet: 

`yarn && yarn build-testnet`

## Verify and timestamp SHA256 hashes using URL parameters

It's possible to use the results route to verify and timestamp SHA256 hashes 

directly. There are tree parameters to be set:

- **hashes** (required): the hashes to be timestamped separated by comma.

- **names** (optional): the name associated to each hash separated by comma. 

The names has to follow the same order as the digests are provided. Its used 

only for displaying purposes. If the name is not provided, the digest will be 

used as the name instead.

- **timestamp** (optional): if true, the hashes which aren't timestamped yet will

 be sent to dcrtime.

#### Usage

The following URL will verify the hashes of two files (file1.json and file2.txt),

the hashes which can't be found in the server will be uploaded for timestamping in

dcrtime.

```

https://localhost:3000/results#hashes=11779c9e577ee238a61dc49227bc8cd8cbd7f8db60efb7d2d3336706d32b5372,fc11cc406688eb75d83ee3db77f4d1776b81de16ddba10738a7d3703299b7646&names=file1.json,file2.txt&timestamp=true

```