Tuesday, April 21, 2026
HomeEthereumThe 1.x Recordsdata: A Primer for the Witness Specification

The 1.x Recordsdata: A Primer for the Witness Specification

Since a variety of us have a bit extra time on our palms, I believed now may be a superb alternative to proceed with one thing maybe somewhat bit boring and tedious, however nonetheless fairly basic to the Stateless Ethereum effort: understanding the formal Witness Specification.

Just like the captain of the Battleship in StarCraft, we will take it sluggish. The witness spec isn’t a very sophisticated idea, however it is vitally deep. That depth is somewhat daunting, however is effectively price exploring, as a result of it will present insights that, maybe to your nerdy delight, lengthen effectively past the world of blockchains, and even software program!

By the tip of this primer, it is best to have no less than minimum-viable-confidence in your potential to grasp what the formal Stateless Ethereum Witness Specification is all about. I am going to attempt to make it somewhat extra enjoyable, too.

Recap: What you must find out about State

Stateless Ethereum is, in fact, a little bit of a misnomer, as a result of the state is admittedly what this entire effort is about. Particularly, discovering a strategy to make preserving a replica of the entire Ethereum state an non-compulsory factor. If you have not been following this sequence, it may be price taking a look at my earlier primer on the state of stateless Ethereum. I am going to give a brief TL;DR right here although. Be happy to skim in case you really feel such as you’ve already acquired a superb deal with on this matter.

The entire ‘state’ of Ethereum describes the present standing of all accounts and balances, in addition to the collective reminiscences of all sensible contracts deployed and working within the EVM. Each finalized block within the chain has one and just one state, which is agreed upon by all individuals within the community. That state is modified and up to date with every new block that’s added to the chain.

The Ethereum State is represented in silico as a Merkle-Patricia Trie: a hashed information construction that organizes every particular person piece of knowledge (e.g. an account steadiness) into one huge related unit that may be verified for uniqueness. The entire state trie is simply too huge to visualise, however this is a ‘toy model’ that will likely be useful once we get to witnesses:

toy state trie

Like magical cryptographic caterpillars, the accounts and code of sensible contracts stay within the leaves and branches of this tree, which by way of successive hashing ultimately results in a single root hash. If you wish to know that two copies of a state trie are the identical, you possibly can merely evaluate the foundation hashes. Sustaining comparatively safe and indeniable consensus over one ‘canonical’ state is the essence of what a blockchain is designed to do.

With a purpose to submit a transaction to be included within the subsequent block, or to validate {that a} specific change is per the final included block, Ethereum nodes should hold an entire copy of the state, and re-compute the foundation hash (over and over). Stateless Ethereum is a set of modifications that can take away this requirement, by including what’s often called a ‘witness’.

A Witness Sketch

Earlier than we dive into the witness specification, it will be useful to have an intuitive sense of what a witness is. Once more, there’s a extra thorough clarification within the submit on the Ethereum state linked above.

A witness is a bit like a cheat sheet for an oblivious (stateless) pupil (consumer). It is simply the minimal quantity of knowledge have to cross the examination (submit a legitimate change of state for inclusion within the subsequent block). As an alternative of studying the entire textbook (preserving a replica of the present state), the oblivious pupil (stateless consumer) asks a pal (full node) for a crib sheet to submit their solutions.

In very summary phrases, a witness gives the entire wanted hashes in a state trie, mixed with some ‘structural’ details about the place within the trie these hashes belong. This permits an ‘oblivious’ node to incorporate new transaction in its state, and to compute a brand new root hash regionally – with out requiring them to obtain a complete copy of the state trie.

Let’s transfer away from the cartoonish thought and in direction of a extra concrete illustration. Here’s a “actual” visualization of a witness:

witness-hex

I like to recommend opening this picture in a brand new tab so as to zoom in and actually respect it. This witness was chosen as a result of it is comparatively small and simple to select options. Every little sq. on this picture represents a single ‘nibble’, or half of a byte, and you’ll confirm that your self by counting the variety of squares that it’s important to ‘cross by way of’, beginning on the root and ending at an Ether steadiness (it is best to depend 64). Whereas we’re this picture, discover the large chunk of code inside one of many transactions that have to be included for a contract name — code makes up a comparatively giant a part of the witness, and could possibly be decreased by code merkleization (which we’ll discover one other day).

Some Formalities

One of many basic distinguishing options of Ethereum as a protocol is its independence from a selected implementation. Because of this, quite than only one official consumer as we see in Bitcoin, Ethereum has a number of fully completely different variations of consumer. These shoppers, written in varied programming languages, should adhere to The Ethereum Yellow Paper, which explains in far more formal phrases how any consumer ought to behave with the intention to take part within the Ethereum protocol. That means, a developer writing a consumer for Ethereum would not need to cope with any ambiguity within the system.

The Witness Specification has this precise purpose: to supply an unambiguous description of what a witness is, which can make implementing it simple in any language, for all shoppers. If and when Stateless Ethereum turns into ‘a factor’, the witness specification might be inserted into the Yellow Paper as an appendix.

Once we say unambiguous on this context, it means one thing stronger than what you may imply in peculiar speech. It isn’t that the formal specification is only a actually, actually, actually, detailed description of what a witness is and the way it behaves. It implies that, ideally, there may be actually one and just one means describe a selected witness. That’s to say, in case you adhere to the formal specification, it might be unimaginable so that you can write an implementation for Stateless Ethereum that generates witnesses completely different than every other implementation additionally following the foundations. That is key, as a result of the witness goes to (hopefully) turn into a brand new cornerstone of the Ethereum protocol; It must be right by development.

A Matter of Semantics (and Syntax)

Though ‘blockchain improvement’ normally implies one thing new and thrilling, it have to be mentioned that a variety of it’s grounded in a lot older and wiser traditions of laptop programming, cryptography, and formal logic. This actually comes out within the Witness Specification! With a purpose to perceive the way it works, we have to really feel snug with a few of the technical phrases, and to do this we will need to take somewhat detour into linguistics and formal language principle.

Learn aloud the next two sentences, and pay specific consideration to your intonation and cadence:

  • furiously sleep concepts inexperienced colorless
  • colorless inexperienced concepts sleep furiously

I guess the primary sentence got here out a bit robotic, with a flat emphasis and pause after every phrase. Against this, the second sentence most likely felt pure, if a bit foolish. Despite the fact that it did not actually imply something, the second sentence made sense in a means that the primary one did not. It is a little instinct pump to attract consideration to the excellence between Syntax and Semantics. When you’re an English speaker you’ve an understanding of what the phrases characterize (their semantic content material), however that was largely irrelevant right here; what you observed was a distinction between legitimate and invalid grammar (their syntax).

This instance sentence is from a 1956 paper by one Noam Chomsky, which is a reputation you may acknowledge. Though he’s now often called an influential political and social thinker, Chomsky’s first contributions as an educational had been within the discipline of logic and linguistics, and on this paper, he created some of the helpful classification techniques for formal languages.

Chomsky was involved with the mathematical description of grammar, how one can categorize languages based mostly on their grammar guidelines, and what properties these classes have. One such property that’s related to us is syntactic ambiguity.

Ambiguous Buffalo

Contemplate the grammatically right sentence “Buffalo buffalo Buffalo buffalo buffalo buffalo Buffalo buffalo.” — this can be a basic instance that illustrates simply how ambiguous English syntax guidelines might be. When you perceive that, relying on the context, the phrase ‘buffalo’ can be utilized as a verb (to intimidate), an adjective (being from Buffalo, NY), or a noun (a bison), you possibly can parse the sentence based mostly on the place every phrase belongs.

We may additionally use solely completely different phrases, and a number of sentences: “You understand these NY bison that different NY bison intimidate? Nicely, they intimidate, too. They intimidate NY bison, to be precise.”

However what if we need to take away the anomaly, however nonetheless limit our phrases to make use of solely ‘buffalo’, and hold all of it as a single sentence? It is potential, however we have to modify the foundations of English a bit. Our new “language” goes to be somewhat extra precise. A technique to do this could be to mark every phrase to point its a part of speech, like so:

Buffalo{pn} buffalo{n} Buffalo{pn} buffalo{n} buffalo{v} buffalo{v} Buffalo{pn} buffalo{n}

Maybe that is nonetheless not tremendous clear for a reader. To make it much more precise, let’s attempt utilizing a little bit of substitution to assist us herd a few of these “buffalo” into teams. Any bison from Buffalo, NY is admittedly only one particular model of what we might name a “noun phrase”, or . We are able to substitute into the sentence each time we encounter the string Buffalo{pn} buffalo{n}. Since we’re getting a bit extra formal, we’d determine to make use of a shorthand notation for this and different future substitution guidelines, by writing:

::= Buffalo{pn} buffalo{n}

the place ::= means “What’s on the left aspect might be changed by what’s on the precise aspect”. Importantly, we do not need this relationship to go the opposite means; think about how mad the Boulder buffalo would get!

Making use of our substitution rule to the complete sentence, it could change to:

buffalo{v} buffalo{v}

Now, that is nonetheless a bit complicated, as a result of on this sentence there’s a sneaky relative clause, which might be seen much more clearly by inserting the phrase ‘that’ into the primary half our sentence, i.e. *that* buffalo{v}….

So let’s make a substitution rule that teams the relative clause into , and say:

::= buffalo{v}

Moreover, since a relative clause actually simply makes a clarification a few noun phrase, the 2 taken collectively are equal to simply one other noun phrase:

::=

With these guidelines outlined and utilized, we are able to write the sentence as:

buffalo{v}

That appears fairly good, and actually will get on the core relationship this foolish sentence expresses: One specific group of bison intimidating one other group of bison.

We have taken it this far, so why not go all the best way? Each time ‘buffalo’ as a verb precedes a noun, we may name {that a} verb phrase, or , and outline a rule:

::= buffalo{v}

And with that, we have now our single full legitimate sentence, which we may name S:

S ::=

What we have finished right here may be higher represented visually:

buffalo

That construction seems curiously acquainted, would not it?

The buffalo instance is a bit foolish and never very rigorous, however it’s shut sufficient to exhibit what is going on on with the bizarre mathematical language of the Witness Specification, which I’ve very sneakily launched in my rant about buffalo. It is referred to as Backus-Naur kind notation, and it is usually utilized in formal specs like this, in quite a lot of real-world eventualities.

The ‘substitution guidelines’ we outlined for our restricted English language helped to be sure that, given a herd of “buffalo”, we may assemble a ‘legitimate’ sentence while not having to know something about what the phrase buffalo means in the true world. Within the classification first elucidated by Chomsky, a language that has precise sufficient guidelines of grammar that assist you to do that is referred to as a context-free language.

Extra importantly, the foundations make sure that for each potential sentence comprised of the phrase(s) buffalon, there may be one and just one strategy to assemble the information construction illustrated within the tree diagram above. Un-ambiguity FTW!

Go Forth and Learn the Spec

Witnesses are at their core only a single giant object, encoded right into a byte array. From the (anthropomorphic) perspective of a stateless consumer, that array of bytes may look a bit like a protracted sentence comprised of very comparable trying phrases. As long as all shoppers observe the identical algorithm, the array of bytes ought to convert into one and just one hashed information construction, no matter how the implementation chooses to characterize it in reminiscence or on disk.

The manufacturing guidelines, written out in part 3.2, are a bit extra advanced and much much less intuitive than those we used for our toy instance, however the spirit could be very a lot the identical: To be unambiguous pointers for a stateless consumer (or a developer writing a consumer) to observe and be sure they’re getting it proper.

I’ve glossed over rather a lot on this exposition, and the rabbit gap of formal languages goes far deeper, to make sure. My goal right here was to simply present sufficient of an introduction and basis to beat that first hurdle of understanding. Now that you’ve cleared that hurdle, it is time pop open wikipedia and deal with the remaining your self!

As at all times, in case you have suggestions, questions, or requests for matters, please @gichiba or @JHancock on twitter.

RELATED ARTICLES

LEAVE A REPLY

Please enter your comment!
Please enter your name here

Most Popular

Recent Comments