Get a DOI with Zenodo

A DOI (Digital Object Identifier) is the permanent https://doi.org/... link that reference managers, journals and scholarly search engines expect. ARIADNE does not issue DOIs itself. Instead it works with Zenodo, the open repository run by CERN: ARIADNE prepares a draft of your article in your Zenodo account, you publish it there, and you declare the DOI back on ARIADNE. The Zenodo record is a third preserved copy of the article (after IPFS and ARIADNE’s own copy, see Storage) and is indexed by scholarly search engines.

The authority for this procedure is the publishing guide, section 8c, and DECISIONS D-108 and D-117.

Who can do it, and where

Only accepted authors of the article can: the publishing author and the co-authors who have confirmed. With your wallet connected, open the article page: under the article’s CID (the fingerprint of its content, see the glossary) there is a folded line DOI for this article. Open it.

• The Zenodo part (“Get a DOI with Zenodo”) appears when the network has Zenodo set up, and disappears once the current version already has a DOI that readers can use.
• The form below it, “Have a DOI already…”, lets you declare any DOI by hand.
• A retracted article takes no new DOI; existing ones can still be withdrawn.

On TestNet: the Zenodo sandbox

On TestNet, ARIADNE uses the Zenodo sandbox (https://sandbox.zenodo.org), Zenodo’s test site. Its DOIs start with 10.5072/ and are for testing only: they do not resolve outside the sandbox and may be deleted at any time. MainNet, when it opens, uses zenodo.org, whose DOIs start with 10.5281/.

Step 1: connect Zenodo

1. Press Connect Zenodo. You are sent to Zenodo, which asks you to allow ARIADNE to create drafts in your account. ARIADNE never gets permission to publish.
2. Accept. Zenodo sends you back to the article, which says “Zenodo is connected. Prepare the draft below.”

The permission lasts at most an hour and is kept only in a sealed cookie in your browser; ARIADNE’s server does not store it. Disconnect Zenodo forgets it at once. If you refuse, the page says “Zenodo was not connected: the permission was not given.”

Step 2: prepare the draft

1. If some authors have no verified ORCID iD with a name, the form asks for Names for the record. Write Family name, Given names, or leave a field empty to use that author’s NFD name or address. You can still edit the names on Zenodo.
2. Press Prepare a Zenodo draft of version N. The draft is always of the article’s current version.

ARIADNE fills the draft as follows:

In the Zenodo draft	Comes from
Files	the version’s files, read from ARIADNE’s gateway and verified against its CID; folders become folder__file names; at most 100 files
README.md	a reading copy for Zenodo’s preview: title, authors, abstract and text, without the header; the canonical index.md is uploaded unchanged
Title, abstract, keywords	the article header
Licence	the header’s license; CC-BY-4.0 when it has none
Authors	publishing author, then confirmed co-authors: the name of each verified ORCID record with its iD, else the name you typed, else the NFD name or address
Type and date	“publication / preprint” (or “dataset” for a dataset), dated on the version’s date, version vN
Description	the abstract and a line linking to the article page, with the version number and the CID
Related identifiers	is identical to the article page and is identical to the version’s content (its CID)
DOI	reserved by Zenodo for this draft
Community	proposed to ARIADNE’s community on Zenodo, ariadne-algo

If you already have an unpublished new version of this record waiting on Zenodo, ARIADNE does not touch it: it stops and links to it.

Step 3: publish it on Zenodo

1. Press Open your draft on Zenodo.
2. Check everything: title, authors, licence, files. Edit what you need, but keep the two “is identical to” links, because the verification needs them.
3. Press Publish on Zenodo.

A published Zenodo record cannot be deleted

Once published, the record and its DOI are permanent, even if the article is later retracted on ARIADNE. Its description can still be edited on Zenodo.

Step 4: declare the DOI back

1. Back on the article, press Declare 10.5072/zenodo.… for version N. (If the button is not there, copy the DOI from Zenodo and use the form below it.)
2. Check the cost (the network fee, about 0.001 ALGO; no deposit) and sign in your wallet.
3. The page says “Sent. The page updates once the indexer has read it and checked the record.”

The form accepts a bare DOI (10.5281/zenodo.1234567), a https://doi.org/... link or doi:.... A DOI must start with 10. and contain a slash. If you paste a DOI of the other Zenodo (a zenodo.org DOI on TestNet, or a sandbox DOI on MainNet), the form warns you.

How the DOI is verified

The declaration only says “this article has this DOI”. The ARIADNE indexer then reads the Zenodo record and marks the DOI verified when:

1. the record is published;
2. its DOI is the one declared (for version 0, its concept DOI, below);
3. it says it is identical to the article page and, for one version, to that version’s CID.

The CID matters because a page address can be reused by another application, while a CID cannot: it is the fingerprint of the content itself. A declaration that is not verified yet is checked about every ten minutes for two days, then weekly, like ORCID iDs.

Result	What the article shows
verified	the DOI with a check mark: “verified: the record points back to this article”
declared	the DOI: “declared by an author; ARIADNE cannot check this registry”
pending	(to authors only) “not checked yet”
unlinked	(to authors only) “the record does not point back to this article”
missing	(to authors only) “no published record with this DOI”
invalid	(to authors only) “a test DOI that does not resolve on this network”

Readers see only verified and declared DOIs. Citations and bibliographies then use the DOI (see Cite an article), and search can filter articles with a DOI.

Version 0: every version

In the declaration form, For offers each version of the article and every version (Zenodo concept DOI), which is version 0. Zenodo gives each record version its own DOI and a concept DOI that stands for all of them. A citation of a version uses that version’s DOI when it has one, else the version-0 DOI.

Later versions

When you publish a new version of the article (see New versions, amendments and retraction), the DOI tools offer a draft of the new version. It becomes a new version of your existing Zenodo record (the page says “a new version of your earlier record”), under the same concept DOI. Publish it on Zenodo and declare its DOI for the new version.

DOIs from other repositories

You can declare a DOI from another repository directly with the form. Its record must also say it is identical to the article page (and, for one version, to that version’s CID).

• Zenodo DOIs are checked against Zenodo.
• On MainNet, DataCite DOIs are checked against DataCite.
• Other DOIs (for example from Crossref), and on TestNet every DOI outside Zenodo, are shown as “declared by an author; ARIADNE cannot check this registry”.

Withdraw a DOI

Each declared DOI has a Withdraw button. It signs an empty declaration for that version (network fee only), in any status of the article. The DOI disappears from the article; the declaration stays in the blockchain history.

If the article is retracted

The DOI stays registered and the Zenodo record stays published: neither can be deleted. Edit the record’s description on Zenodo to say that the article was retracted on ARIADNE. A retracted article takes no new DOI.

Costs

Action	Cost
Connect Zenodo, prepare a draft	free
Publish on Zenodo	free (it happens on Zenodo)
Declare or withdraw a DOI	network fee only, about 0.001 ALGO; no storage deposit