Mainnet upgrade

[cmjc]

Note

This makes the significant changes for the mainnet release. It will have a follow on PR or additional commits to this PR to update once the release is made:

• Contract Interface Reference - add Examples for the delegated staking functions
• Updates for any Autonity CLI changes since autdev 6 release.

---

Documentation PR to add and update documentation for the Mainnet Protocol upgrade as detailed beneath.

---

Overview.

Commits:

• Edits to ...

Inflation mechanism.

Commits: 3ac3f7b

• Reference, Protocol Parameters. Clarifications around protocol schedules, NTN supply, inflation base.
• Concepts, Protocol assets, Newton: Edits for ...

Concepts

Commits: 80803fc, de4bb85, e720bc6, 5e71c37, 2d74ac4, 6111372, 3222ca5, 75e0c98, 7fbef6a, cac142e

• General. Editorial edits.
• AGC. Edits for change to Pebble DB.
• Architecture. Edits to update protocol contract addresses and update for the new Auctioneer Contract.
• System model. Edits for clustering threshold on ACN.
• OAFD and Oracle network. Edits for new non reveal penalty
• ASM. Edits for the new Auctioneer Contract and debt and interest auction mechanism.
• AFD. Edits for the new delta, range, and grace period mechanism.

Networks

Commits: 247a86d, 6ee5f67, d29cf84, aa5653d, 1b8ac24, bd9580d

• Piccadilly Testnet page: To update as legacy and superceded by Bakerloo.
• Bakerloo Testnet page: To restore and update to the new network configuration.
• Mainnet page: Drafted but commented out

Guides

Commits: bb56c76, afda4df,
3d5eea7,
d40dd28,
84bf2b0,
8c8e1ec,
c4d2542, 99bb047, 52b9da4

• Running a node. Edits to install and run for the new version.

• Running an Oracle Server. Edits to install and run for the new version and for the configuration file changes.

• Register as a validator. Edits to clarify the networking setup.

• Validator. Edits to clarify ATN and NTN inflation rewards in Validator economics section. Add note for considerations before validator pausing.

• CDP. Replace public getter cdps example with the new Stabilization Contract cdps() method. Update for bidDebt.

• Accounts: Update pages Setup "Autonity CLI", "Create an account"

Reference, Genesis and Protocol Parameters

Commits: bb56c76, 2d74ac4,
3ac3f7b,
5f162af, aa5653d,

• Genesis:

  • Update genesis configuration objects and fields

• Protocol Parameters:

  • Update protocol parameters fields (new oracle accountability non reveal parameters, new configuration values, editorial updates)

Reference, Autonity Interfaces

General

Commits: 2dae848, 664cf44, 664cf44, 800e438, 3d5eea7, 2cf7969, 97ca42c, 2583aa8, 8591a0b, c930e09, c513f21, 051d012, 36029f9, 075e1fe, c9dc471, 8a0e4ef,
b137916,

• Update Usage and Examples for new autonity-cli supported commands

Autonity Interfaces, Governance and Protocol Only Reference

Commits: 9adc27c, bb56c76, bb7ca92, 2d74ac4, 10f8251, 3d5eea7,
5f162af,
64f1135,
90c2c6c

• Edits to usage and examples

• Edits to events for the new config update event model, new and updated events.

• Added Getters: abi, getClientConfig, getBondingRequestByID, getUnbondingRequestByID, getCurrentCommitteeSize, getLastEpochTime, getSchedule, getTotalSchedules

• Added setters/getters for delegated staking interface: bondFrom, unbondFrom, bondingAllowance, approveBonding

• Added Setters: removeCDPRestrictions, setDefaultACUUSDPrice, setDefaultNTNATNPrice, setDefaultNTNUSDPrice, useFixedGenesisPrices, setClusteringThreshold, setEip1559Params, setGasLimit

• Deprecated setter: setMinimumBaseFee (replaced by setEip1559Params)

AFD Interface

Commit: 7fbef6a

• Add new getters: getBeneficiary, getConfig, getEvent, getEventsLength, getHistory, getSlashingHistory, getGracePeriod

ASM Interfaces

Commit: cac73a1, 87d98d1, 24fee8c, 9772827, f5b9259, 985067e, 3ac3f7b

• Add Inflation Controller Contract Interface

  • new getParams() method

• Add Auctioneer Contract Interface

• Update Stabilization Contract Interface:

  • Update events and constraint checks

  • Update methods: collateralPrice(), borrowLimit(), minimumCollateral(), interestDue()

  • Add new methods: config(),cdps(), debtAmountAtTime(), collateralPriceACU(), acuPrice(), getPendingInterestRate(), getAggregatedInterestExponent() , getCurrentRateActiveTimestamp(), getCurrentRate(), getAnnouncementWindow(), getPendingAnnouncementWindow(), getPendingMinCollateralizationRatioInfo(), minCollateralizationRatio(), liquidationRatio(), getPendingLiquidationRatioInfo(), lastUpdated(), interestExponent()

• Update ACU Contract Interface:

  • Update events and constraint checks
  • Update methods: modifyBasket() to add event; value();
  • Add new methods: rescale(), multiplier(), scaledQuantities(), getScaleFactor(), getScale(), getRound()

• Update Supply Control Contract Interface:

  • Update methods: getTotalSupply(), getStabilizer();

Liquid Contract Interface

Commit: 5789b1a, 27ca06e

• Clarify ERC-20 balanceOf returns total balance of LNTN (i.e. locked and unlocked) and editorial on claimedRewards and unclaimedRewards

Oracle Contract Interface

Commits: de4bb85, e720bc6, 5e71c37, 09c20e9

• Updated Getters: getVoters
• Added Getters: getConfig, getLastRoundBlock, getNewVotePeriod, getNonRevealThreshold, getReports, getRewardPeriodPerformance, getSymbolUpdatedRound, getVoterInfo, getVoterTreasuries, getVoterValidators

Reference, Autonity Command-line

Commits: 5711e98,
f4ee147, 8062a94

• Update command-line options to AGC
• Update command-line options to AOS

Glossary

Commits: 3ac3f7b, a49e0eb

• Add terms for: circulating supply, total supply.
• Edit terms for: Autonity network, validator, AGC.

---

[github-actions]

🚀 This branch can be previewed at https://ce8ee420.docs-autonity-org.pages.dev

[vpiyush]

Reviewed the Validator enode related changes. Those look good to me.

[aiman]

Just a few comments and suggestions. Otherwise LGTM and good for merge, pending separate additional PRs as needed.