Monday, March 23, 2026
HomeEthereumThe 1.x Information: A Primer for the Witness Specification

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

Since a whole lot of us have a bit extra time on our arms, I believed now is perhaps alternative to proceed with one thing maybe a bit of bit boring and tedious, however nonetheless fairly elementary to the Stateless Ethereum effort: understanding the formal Witness Specification.

Just like the captain of the Battleship in StarCraft, we’ll take it gradual. The witness spec shouldn’t be a very sophisticated idea, however it is rather deep. That depth is a bit of daunting, however is properly price exploring, as a result of it’s going to present insights that, maybe to your nerdy delight, lengthen properly past the world of blockchains, and even software program!

By the tip of this primer, it’s best to have a minimum of minimum-viable-confidence in your capability to know what the formal Stateless Ethereum Witness Specification is all about. I will attempt to make it a bit of extra enjoyable, too.

Recap: What you could learn about State

Stateless Ethereum is, in fact, a little bit of a misnomer, as a result of the state is absolutely what this complete effort is about. Particularly, discovering a approach to make maintaining a replica of the entire Ethereum state an non-compulsory factor. If you have not been following this sequence, it is perhaps price taking a look at my earlier primer on the state of stateless Ethereum. I will give a brief TL;DR right here although. Be happy to skim when you really feel such as you’ve already received deal with on this subject.

The entire ‘state’ of Ethereum describes the present standing of all accounts and balances, in addition to the collective reminiscences of all good contracts deployed and operating within the EVM. Each finalized block within the chain has one and just one state, which is agreed upon by all contributors 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 data (e.g. an account stability) 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 might be useful after we get to witnesses:

toy state trie

Like magical cryptographic caterpillars, the accounts and code of good contracts dwell 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 examine the basis hashes. Sustaining comparatively safe and indeniable consensus over one ‘canonical’ state is the essence of what a blockchain is designed to do.

With a view to submit a transaction to be included within the subsequent block, or to validate {that a} explicit change is according to the final included block, Ethereum nodes should preserve an entire copy of the state, and re-compute the basis hash (time and again). Stateless Ethereum is a set of modifications that may take away this requirement, by including what’s generally known as a ‘witness’.

A Witness Sketch

Earlier than we dive into the witness specification, it’s going to 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) scholar (shopper). It is simply the minimal quantity of data must move the examination (submit a legitimate change of state for inclusion within the subsequent block). As a substitute of studying the entire textbook (maintaining a replica of the present state), the oblivious scholar (stateless shopper) asks a good friend (full node) for a crib sheet to submit their solutions.

In very summary phrases, a witness supplies 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 domestically – with out requiring them to obtain a whole copy of the state trie.

Let’s transfer away from the cartoonish concept 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 that you could zoom in and actually admire it. This witness was chosen as a result of it is comparatively small and simple to pick options. Every little sq. on this picture represents a single ‘nibble’, or half of a byte, and you may confirm that your self by counting the variety of squares that it’s important to ‘move by way of’, beginning on the root and ending at an Ether stability (it’s best to rely 64). Whereas we’re this picture, discover the massive 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 may very well be lowered by code merkleization (which we’ll discover one other day).

Some Formalities

One of many elementary distinguishing options of Ethereum as a protocol is its independence from a specific implementation. That is why, somewhat than only one official shopper as we see in Bitcoin, Ethereum has a number of fully completely different variations of shopper. These purchasers, written in numerous programming languages, should adhere to The Ethereum Yellow Paper, which explains in way more formal phrases how any shopper ought to behave with a purpose to take part within the Ethereum protocol. That approach, a developer writing a shopper for Ethereum would not need to cope with any ambiguity within the system.

The Witness Specification has this precise objective: to supply an unambiguous description of what a witness is, which can make implementing it easy in any language, for all purchasers. If and when Stateless Ethereum turns into ‘a factor’, the witness specification may 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 odd speech. It is not that the formal specification is only a actually, actually, actually, detailed description of what a witness is and the way it behaves. It signifies that, ideally, there’s actually one and just one approach describe a specific witness. That’s to say, when you adhere to the formal specification, it might be not possible so that you can write an implementation for Stateless Ethereum that generates witnesses completely different than some other implementation additionally following the foundations. That is key, as a result of the witness goes to (hopefully) develop into a brand new cornerstone of the Ethereum protocol; It must be appropriate by development.

A Matter of Semantics (and Syntax)

Though ‘blockchain growth’ often implies one thing new and thrilling, it have to be mentioned that a whole lot of it’s grounded in a lot older and wiser traditions of pc programming, cryptography, and formal logic. This actually comes out within the Witness Specification! With a view to perceive the way it works, we have to really feel snug with among the technical phrases, and to try this we’ll need to take a bit of detour into linguistics and formal language principle.

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

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

I wager the primary sentence got here out a bit robotic, with a flat emphasis and pause after every phrase. Against this, the second sentence in all probability felt pure, if a bit foolish. Regardless that it did not actually imply something, the second sentence made sense in a approach that the primary one did not. It is a little instinct pump to attract consideration to the excellence between Syntax and Semantics. In the event you’re an English speaker you may have an understanding of what the phrases characterize (their semantic content material), however that was largely irrelevant right here; what you seen 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 generally known as an influential political and social thinker, Chomsky’s first contributions as an instructional have been within the area of logic and linguistics, and on this paper, he created one of the vital helpful classification programs 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 appropriate sentence “Buffalo buffalo Buffalo buffalo buffalo buffalo Buffalo buffalo.” — this can be a basic instance that illustrates simply how ambiguous English syntax guidelines may be. In the event 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 totally completely different phrases, and a number of sentences: “You already know 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 paradox, however nonetheless prohibit our phrases to make use of solely ‘buffalo’, and preserve 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 a bit of extra precise. A technique to try this can 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 absolutely only one particular model of what we’d 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 would 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 may be changed by what’s on the appropriate aspect”. Importantly, we do not need this relationship to go the opposite approach; think about how mad the Boulder buffalo would get!

Making use of our substitution rule to the total sentence, it might 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 may 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 couple of noun phrase, the 2 taken collectively are equal to only 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 explicit group of bison intimidating one other group of bison.

We have taken it this far, so why not go all the way in which? Every 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’ve got our single full legitimate sentence, which we may name S:

S ::=

What we have accomplished right here is perhaps 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 known as Backus-Naur kind notation, and it is typically utilized in formal specs like this, in quite a lot of real-world situations.

The ‘substitution guidelines’ we outlined for our restricted English language helped to guarantee 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 actual world. Within the classification first elucidated by Chomsky, a language that has precise sufficient guidelines of grammar that assist you to do that is known as a context-free language.

Extra importantly, the foundations be certain that for each potential sentence comprised of the phrase(s) buffalov, there’s one and just one approach 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 shopper, that array of bytes may look a bit like a protracted sentence comprised of very related trying phrases. As long as all purchasers 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 complicated 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 tips for a stateless shopper (or a developer writing a shopper) 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 certain. My intention right here was to only present sufficient of an introduction and basis to beat that first hurdle of understanding. Now that you’ve got 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