Resource center · Digital Assets

Preparing a crypto-asset whitepaper for iXBRL tagging.

Tagging is cheap when the document was drafted with the structure in mind and expensive when it was not. The work is almost entirely upstream of the tagging pass itself.

Guide MiCA · European Union · structured disclosure

What the white paper is

Under Regulation (EU) 2023/1114, a crypto-asset white paper is a regulatory disclosure document. It carries prescribed content, is notified to the competent authority, and is published. Where the requirement applies, it is also produced in a machine-readable form, so the same file serves a human reader and an automated one.

The obligation attaches to the offeror or the person seeking admission to trading. A platform admitting an asset should establish who carries it for that asset rather than assuming the question does not arise.

Content requirements

The required content varies by token category — crypto-assets other than asset-referenced and electronic money tokens, asset-referenced tokens, and electronic money tokens each have their own set — but the structural blocks recur.

Recurring content blocks
BlockCarries
The offeror or issuerIdentity, legal form, registered address, management body and, where relevant, identifiers.
The projectDescription of the project, its stage, use of funds, and the parties involved in delivering it.
The offer or admissionWhether it is an offer to the public or an admission to trading, the amount, the price or pricing method, subscription terms and target holders.
The crypto-assetType, characteristics, functionality, and the rights and obligations attached to it.
TechnologyThe underlying technology, consensus mechanism, protocols and any audit of them.
RisksRisks relating to the offeror, the asset, the project, the technology and any mitigation measures.
SustainabilityPrincipal adverse impacts on the climate and other environment-related effects of the consensus mechanism.

The prescribed warning statements and the management body statement on compliance are part of the content, not front matter, and they are tagged like everything else.

Structuring a document for tagging

Inline tagging attaches structured meaning to elements of a human-readable document. That only works where the element to be tagged exists as a discrete, identifiable piece of the document. Four drafting habits make the difference:

  • One fact, one element. A sentence that states the issuer’s legal form, address and registration number together has to be decomposed before any of the three can be tagged cleanly.
  • Use real headings. Sections identified by formatting rather than by heading structure cannot be located reliably.
  • Keep numbers out of prose. Amounts, dates and quantities that need tagging belong in fields or tables, not embedded mid-sentence with surrounding qualification.
  • Write the required blocks as blocks. Where content is scattered across the document because it read better that way, the tagging pass has to gather it, and every subsequent revision re-scatters it.
Drafting and tagging are the same task from opposite ends. A document drafted against the content requirements tags in a fraction of the time of one drafted as marketing prose and mapped afterwards.

The tagging pass

The pass itself is mechanical once the document is structured: each required item is located, matched to the corresponding element of the taxonomy in force, and tagged with the appropriate context — the entity, the period or point in time, and the unit where the value is numeric. Text blocks are tagged as blocks; individual values are tagged individually.

Two judgement calls recur. Where the document says something the taxonomy has no element for, it is left untagged rather than forced into an approximate element. Where the document is silent on a required item, that is a content gap to resolve with the drafter, not a tagging problem to work around.

Validation and publication

The tagged file is validated for well-formedness, for taxonomy conformance, and for completeness against the required content. It is then notified to the competent authority and published, in a location that remains accessible for as long as the offer or admission requires. Keep the validation output with the published file; it evidences what was checked at the point of publication.

Amendments and versions

Where the white paper is modified, the modified version carries the same content and tagging obligations and is notified and published in the same way. Version control matters more here than in most reporting work, because earlier versions remain relevant to holders who acquired on the basis of them. Keep each published version, its tagged file and its validation output together as a set.

Official sources

Primary instruments only. Each is named in full so the reference remains traceable even if a link moves.

  1. Regulation (EU) 2023/1114 on markets in crypto-assets (MiCA), Titles II, III and IV — white paper content and publicationEUR-Lex · Regulation · required content by token category
  2. European Securities and Markets Authority — technical standards on the machine-readable format for crypto-asset white papersESMA · taxonomy and format · consult the instrument in force
  3. XBRL International — the Inline XBRL specificationXBRL International · the tagging mechanism itself

REGREP is an independent software provider. This record explains a reporting framework in plain language and is not legal, tax or regulatory advice. Confirm scope, thresholds and submission dates with your competent authority before you file.

Keep reading

More on this framework, and the module that produces the filing.

All digital assets resources

Bring us the draft, not the final document.

Tagging is scoped per white paper, and the cost falls sharply when the structure is settled before the prose is.