Skip to main content

Applications for the autumn mentorship cohort are open until 30 September. Apply now

Cardano Technical Literacy

Protocol Parameters Without the Jargon

A working map of the protocol parameters, how to read a parameter change proposal line by line, what second-order effects to expect, and the point at which the honest move is to ask an expert.

FoundationReading + exercise94 minv1.0.0 · effective Aug 9, 2026
Course catalogue

Learning outcomes

  • Group parameters into network, economic, technical and governance clusters and say what each governs
  • Read a parameter change as current value, proposed value, delta, source, effective date and claimed outcome
  • Describe plausible second-order effects and separate a mechanism from a proven impact
  • Recognise the boundary of your own competence and write a focused expert request
94 minutes · 4 lessonsVersion 1.0.0 · effective 8/9/2026
Lesson 1 of 422 min read

A map of the parameters

Four clusters - network, economic, technical and governance - instead of a flat list of names you cannot hold in your head.

What you will be able to do

Protocol parameters are usually presented to representatives as a wall of names - a table of thirty-odd identifiers, some of them abbreviations of abbreviations, each with a number beside it. Presented that way they are unlearnable, and the honest response of most people is to defer to whoever sounds most confident. That is the failure this lesson is designed to prevent. You do not need to be able to recite the parameter set. You need a map: a small number of clusters, each with a clear job, so that when a proposal names a parameter you can immediately say which part of the system it governs and who is affected first.

  • Place a named parameter into one of four clusters.
  • Say in plain language what each cluster governs.
  • Read current values from the chain, dated, rather than from a summary.
  • Identify who notices a change first, before forming any view about it.

Definitions

Protocol parameter
A value in the ledger''s configuration that nodes agree on and enforce, and that can be changed by an on-chain process rather than by a software release.
Parameter change action
The governance action type used to propose new values for one or more updatable protocol parameters. CIP-1694 defines it as a distinct action type with its own voting requirements.
Cluster
A grouping used in this course - network, economic, technical, governance - chosen because members of a cluster tend to affect the same people and require the same kind of expertise.
Epoch
The fixed-length period after which certain changes, including parameter updates, take effect. Parameter values are therefore always "as of" some epoch.
Current value
What the chain says today. Not what a proposal, an article or this course says - all of which age.

The four clusters

Network parameters govern capacity and propagation: how large a block may be, how large a transaction may be, how much of a block a single element may occupy. Their job is to hold the tension between throughput and the ability of ordinary machines, on ordinary connections, to keep up. Raise capacity and you can fit more activity into a block; you also increase what every node must receive, validate and relay within the time available. The people who notice first are stake pool operators and relay operators, and after them anyone whose transactions compete for space at busy moments.

Economic parameters govern who pays and who is paid: the components that determine minimum transaction fees, the deposits required to register things on chain, and the values that shape how rewards are distributed across the stake pool set. Their job is to price the use of a shared resource and to keep incentives pointed at behaviour the network wants. The people who notice first are users making small transactions, operators of services that submit many transactions, and pool operators and delegators whose returns shift.

Technical parameters govern script execution: the limits on computational and memory units a transaction may consume, and the prices attached to those units. Their job is to bound what a single transaction can ask the network to do and to make that cost predictable. The people who notice first are builders of on-chain applications, whose contracts either fit inside the limits or do not, and whose users pay the resulting execution fees.

Governance parameters govern the decision process itself: voting thresholds for different action types, deposits for submitting actions and registering as a representative, and term or expiry lengths. Their job is to set how hard it is to change things and how much skin proposers and representatives must have in the game. Everyone in governance notices, though usually only when an action later passes or fails at the margin. CIP-1694 is the reference for how these fit together, and it is worth reading its threshold section once even if you never read another specification.

The clusters are a working aid, not an official taxonomy, and some parameters sit on a boundary - execution unit prices are technical in what they limit and economic in what they cost. When a parameter straddles two clusters, that is itself useful information: it usually means the change has at least two constituencies, and any proposal that discusses only one of them is incomplete.

Worked example - reading, not reciting

Method, illustrative

A proposal names maxBlockBodySize. Cluster: network. What it governs: the upper bound on the body of a block, and therefore how much transaction data every node must move and validate each block. Who notices first: relay and pool operators on the weakest hardware and connections in the set. Second constituency: users during congestion, who see waiting times change. Current value: unknown until read - go to a chain explorer or query a node, record the number, and write "as of epoch N, read 2026-08-09 via <method>".

Notice how little the exercise required. No engineering, no benchmark, no opinion on whether the change is wise. Four lines produced from the parameter name alone, and they already tell you which experts are relevant and which section of the proposal is missing if it never mentions operators. This is the level of literacy the lesson is aiming at, and it is achievable in an afternoon.

Counterexample

A representative reads a summary thread stating that a fee parameter is currently at a certain value, repeats that figure in a published rationale, and is corrected a week later - the figure had been changed two epochs earlier. The underlying reasoning may have been fine; the credibility of the rationale is gone, because the one checkable fact in it was wrong. Reading the chain would have taken two minutes.

A second representative learns the parameter names by memorising the table and can recite them, but when a proposal arrives naming an execution unit price cannot say who is affected. Memorisation without a map produces fluency without comprehension, and it is more dangerous than admitted ignorance because it sounds informed.

Common mistakes

  • Treating the parameter set as a flat list to be memorised rather than clusters to be understood.
  • Quoting a current value from a summary, a slide or an article instead of from the chain.
  • Recording a value without the epoch or date, which makes it unusable a month later.
  • Assuming a parameter with a technical-sounding name has no economic constituency.
  • Using the proposal''s paraphrase of a parameter name instead of the exact ledger name.

What this establishes

You can take any parameter named in a governance action, place it in a cluster, state what that cluster governs, name the group that feels the change first, and read its current value with a date and method attached. That is enough to know what a proposal ought to discuss and to notice when it does not.

What remains unknown

Clustering tells you nothing about magnitude. Knowing that a parameter is a network parameter does not tell you whether a given increase is trivial or destabilising, and no amount of taxonomy will supply that. The next lesson gets the change itself onto paper in a comparable form; the one after that deals with the effects; and the last deals with the point where the honest answer is that you need help.

Learn the map, not the table. Four clusters and a habit of dating every value you read will carry you further than a memorised parameter list.

Takeaways

  • Parameters are not a flat list; they cluster by the part of the system they govern.
  • Network parameters govern capacity, economic parameters govern who pays, technical parameters govern execution, governance parameters govern the decision process itself.
  • Never quote a current value without the date and method you read it by.
  • Naming the cluster tells you who is affected first and which experts to ask.

Applied activity

Cluster five parameters

Open the official parameter guide and pick five parameters you have seen mentioned in governance discussion. For each, write one line: the exact ledger name, the cluster it belongs to, one sentence on what it governs, and who would notice first if it changed. Then read the current value of two of them from a chain explorer or node query, and record the value together with the epoch or date and the method you used. Do not copy values from a forum post.

Deliverable: Five clustered parameter lines and two dated, sourced current-value readings. · about 25 minutes

Sources

Practical exercise

Parameter review note

Take the fictional composite parameter change used in this course, or a real proposal of your choice, and write one neutral review note. Include: the parameter and its cluster; the six-line change table (current value with the date and method you read it, proposed value, delta in absolute and percentage terms, source, effective date, claimed outcome); the mechanism the proposer relies on, stated in your own words; two plausible second-order effects and who bears each; the tradeoff you believe is being made; a competence statement naming what you cannot assess; and one focused expert request. Do not state whether the change is good or bad, and do not present a mechanism as a proven impact.

Deliverable: A one-page parameter review note: change table, mechanism, second-order effects, tradeoff, competence statement, expert request and an explicit uncertainty list.

  1. 1.What exactly is being asked for, in your own words, without the proposer's framing?
  2. 2.Which claims did you verify against a primary source, and which source was it?
  3. 3.Which claims could you not verify, and what would it take to verify them?
  4. 4.What is the strongest argument against your current reading of the evidence?
  5. 5.What would you publish so someone who disagrees with you can audit your reasoning?
Autosaves on this device0 / 20,000

Signed out: this draft stays on this device. Sign in to save it to your account and have it count towards completion.

Final assessment

Protocol parameters assessment

Eight questions on mapping, reading and reviewing parameter changes. Answers and explanations appear only after you submit. Retries are unlimited and results are private.

8 questions · pass mark 70%Private result · unlimited attempts · never published

Sign in to submit an attempt. Assessments are graded on the server, so they cannot be taken anonymously.

  1. 1. An expert answers that the proposed increase is measurably fine on higher-specification hardware and marginal on lower-specification hardware. What follows?

    Which part of this is an engineering question?

  2. 2. A proposal cites a benchmark whose hardware, workload and configuration are not described. What is the correct finding?

    What can you actually establish?

  3. 3. How should a reviewer establish the current value of a parameter?

    Which reading can a stranger repeat?

  4. 4. Raising a maximum transaction size limit has which first-order effect?

    First order assumes nobody changes behaviour.

  5. 5. A proposal changes a limit on how much computational and memory work a single transaction may consume. Which cluster is it, and who notices first?

    Think about what the limit bounds.

  6. 6. A parameter moves from 4 to 14, and another moves from 90 to 100. How should these deltas be reported?

    One number is the same for both.

  7. 7. A reviewer writes: "services will batch more, so network fees will fall across the board." What is wrong with this?

    Look at both the certainty and the scope.

  8. 8. A forum thread and the anchored metadata attached to the on-chain action describe the change differently. Which is the proposal?

    What is the action actually bound to?

Reference sheet

Parameter review worksheet

A printable worksheet for reviewing any parameter change the same way twice.

Definitions

Protocol parameter
A value in the ledger''s configuration that nodes agree on and enforce, and that can be changed by an on-chain process rather than by a software release.
Parameter change action
The governance action type used to propose new values for one or more updatable protocol parameters. CIP-1694 defines it as a distinct action type with its own voting requirements.
Cluster
A grouping used in this course - network, economic, technical, governance - chosen because members of a cluster tend to affect the same people and require the same kind of expertise.
Epoch
The fixed-length period after which certain changes, including parameter updates, take effect. Parameter values are therefore always "as of" some epoch.
Current value
What the chain says today. Not what a proposal, an article or this course says - all of which age.
Proposed value
The value the action would set, quoted from the anchored proposal document rather than from any restatement of it.
Delta
The change, expressed both as an absolute step and as a proportion of the current value. Both are needed: the same absolute step can be negligible or enormous depending on the base.
Anchor
The off-chain metadata document bound to the on-chain governance action. It is the authoritative statement of what is proposed and why.
Effective date
The epoch at which the new value takes effect if the action passes, and therefore the boundary between the old regime and the new.
Claimed outcome
What the proposer says the change will achieve, stated in their words, before you paraphrase or judge it.
First-order effect
What changes mechanically the moment the new value takes effect, with no one doing anything differently.
Second-order effect
What actors - users, builders, operators, services - do in response to the first-order change.
Third-order effect
What follows if those responses persist and become the new normal.
Tradeoff
The thing given up to get the thing gained. A change with no identifiable tradeoff usually means the reviewer has not found it yet.
Mechanism
A causal story: because A changes, B should follow. Mechanisms can be reasoned about from the specification.
Impact
A measured outcome, observed under stated conditions. Impacts require data, a method and a date.
Interaction
A relationship in which the effect of changing one parameter depends on the value of another.
Competence boundary
The line between what you can assess from documents, arithmetic and your own reading, and what requires specialist knowledge, tooling or measurement.
Benchmark claim
An assertion that a change was measured to have some effect, under stated conditions, using stated methods.
Model claim
An assertion derived from a simulation or calculation over assumptions, rather than from observation.
Focused request
A question narrow enough to answer in a paragraph, accompanied by everything the expert needs and nothing they do not.
Deference
Adopting an expert''s conclusion as your decision. Distinct from using their answer as one input into your own judgement.

Checklist / method

  • Name the parameter exactly as the ledger names it, not as the summary paraphrases it
  • Cluster it: network (capacity and propagation), economic (fees, rewards, deposits), technical (scripts and execution), governance (thresholds, terms, deposits)
  • Current value: record the number, the epoch or date you read it, and how you read it
  • Proposed value: quote it from the anchored proposal, not from a thread
  • Delta: state it in absolute and percentage terms, and say which direction increases load
  • Source: prefer the on-chain action and its anchored metadata over any summary
  • Effective date: which epoch does it take effect, and what happens in between
  • Claimed outcome: quote the proposer's claim verbatim before assessing it
  • Mechanism versus impact: can you describe the causal chain? Has anyone measured it?
  • Who bears the cost first - users, builders, stake pool operators, the treasury?
  • Which other parameter does this one interact with, and is that interaction discussed?
  • Is this reversible, and at what cost and delay if it goes badly?
  • Is a benchmark or model cited? Who ran it, on what hardware or assumptions, and is it reproducible?
  • Competence line: write plainly what you can and cannot assess yourself
  • Expert request: one specific question, your current understanding, and the deadline
  • Values in this course are illustrative or fictional composites; read the chain for live numbers
  • A change is not automatically good or bad; record the tradeoff, not a verdict

Verified sources

Final template

  1. 1.What was asked - a plain restatement of the request.
  2. 2.What I verified - claim, source, and what the source actually says.
  3. 3.What I could not verify - the open list, with the question still outstanding.
  4. 4.Strongest counter-argument - stated in its best form.
  5. 5.Disclosures - relationships, holdings or history relevant to this action.
  6. 6.How I would publish this - the rationale a reader could audit.