axon-r07

[axon-r07] - 2024-12-02

⭐ HIGHLIGHT | Activity rollups

Activity rollups serve as a mechanism for synthesizing and exporting critical information about activity within a subnet
to parent or ancestor networks, potentially reaching the root network. This enables the triggering of external actions
such as reward distribution via token inflation, validator set rebalancing based on performance metrics, and other
systemic updates. These rollups are continuously aggregated during subnet execution and are periodically consolidated
and released through bottom-up checkpoints, ensuring efficient and structured communication across subnet tree layers.

Find the full explainer here: https://github.com/consensus-shipyard/ipc/blob/main/docs/fendermint/activity_rollups.md

🚀 Features

• Enable process metrics (#1180)
• Add subnet_id to metrics as a global label (#1204)
• Subnet activity rollups and validator rewards (phase 1) (#1181)
• (misc) Examples: validator rewards with ERC20 minting (#1200)

🐛 Bug Fixes

• Update deploy command for calibration net (#1184)
• Fix HumanReadable serialization error (#1189)
• Use eth_getTransactionCount(pending) to get nonce (#1194)
• Docs for deploy command (#1191)
• Clippy + upgrade dependencies + Rust 1.81.0 (#1188)
• For "Nonce Has Already Been Used" Issue During Deployment on Calibrationnet (#1186)
• Add --artifacts-path flag documentation (#1199)
• Install target arch (#1203)
• Metrics validator label to use address instead of pk struct formatting (#1201)
• Update deploy-registry.ts (#1206)
• Fix inconsistent network btw eth and fendermint (#1212)
• Improve Gas Fee Estimation by Integrating Filecoin's EIP-1559-Compatible APIs (#1182)

🚜 Refactor

• (ipld) Migrate metrics scheme (#1207)

📚 Documentation

• Add a doc for activity rollups. (#1222)

⚙️ Miscellaneous Tasks

• (release) Axon-r06. (#1176)
• Upgrade fvm and builtin-actors versions (#1209)

Docs

• Fix a broken reference for the subnets webpage (#1178)

New Contributors

• @sam701 made their first contribution in #1180
• @LePremierHomme made their first contribution in #1199
• @francoisthire made their first contribution in #1178

Full commit log: axon-r06...axon-r07

axon-r06

[axon-r06] - 2024-10-18

Full changelog below.

⭐ HIGHLIGHT | Customizable gas markets (with EIP-1559 default), base fee oscillation, premium distribution ⛽

This release introduces the concept of gas markets. Gas markets are algorithmic entities that determine key aspects of transaction pricing and dynamics within subnets. Starting from the axon-r06 release, subnets can freely customize their gas market by deploying an actor on address f098 that adheres to a standard actor interface.

This interface will evolve over time to accommodate new capabilities and features. But today, gas markets can update the base fee and the block gas limit through this interface.

IPC ships with EIP-1559 as the default gas market, with constants identical to Filecoin mainnet's by default. The constants can be changed at genesis, or through a network upgrade.

Finally, IPC subnets now correctly distribute transaction gas premiums to the block producer, and a block gas limit is enforced at the consensus layer.

For more information, refer to this documentation page: https://github.com/consensus-shipyard/ipc/blob/main/docs/fendermint/gas_markets.md

🚀 Features

• (node) Separate tracing and logging files (#1090)
• Ipc cli util command to convert f4 to eth address (#1168)
• Prefix metrics with "ipc" (#1172)
• Customizable gas markets (with EIP-1559 default), base fee oscillation, premium distribution (#1173)

🐛 Bug Fixes

• Correct link to identify protocol (#1159)
• Tracing deserialization (#1163)
• (cli) Subnet get-validator: add support for 0x Eth addrs. (#1164)
• Incorrect function call (#1171)

🚜 Refactor

• Replace LogLevel type with String (#1167)

📚 Documentation

• Move bottom up spec location (#1154)
• Add docs for gas markets. (#1174)

Spec

• Bottom up interaction (#899)

axon-r05

[axon-r05] - 2024-09-24

Full changelog below.

⭐ HIGHLIGHT | Token-bound validator collateral 🪙🔐

Token-bound validator collateral enables subnets to designate an ERC20 token as the staking collateral for consensus validators, rather than being limited to the parent chain's native token (e.g., FIL).

This feature provides subnet operators with the flexibility to use their own tokens for staking, aligning network security with the native token economy. As subnets grow and evolve, this capability becomes increasingly important for subnet autonomy. Validators can stake the subnet’s native token, simplifying participation and reinforcing the subnet's economic model.

By decoupling consensus security from the parent token, subnet operators gain greater control over their own cryptoeconomics, making it easier to integrate staking, rewards, and penalties with their native token. This is essential for future subnet development, ensuring that staking mechanisms can evolve alongside the growth of specialized token economies.

🚀 Features

• (contracts) Token-bound validator collateral (#1130)

🐛 Bug Fixes

• (topdown) Pull effects up until committed finality. (#887)

⚙️ Miscellaneous Tasks

• Remove Python requirement for contracts development (#1144)

axon-r04

[axon-r04] - 2024-09-18

Full changelog below.

⭐ HIGHLIGHT | Validator Gating 🌁🌉

The Validator Gater feature allows the interception of validator-related actions, such as staking, unstaking, and explicit validator membership adjustments (federated membership), based on user-defined policies. By implementing a custom smart contract that adheres to the IValidatorGater interface, developers can enforce custom logic to either permit or deny these actions.

This feature is designed to support both federated and collateral-based networks, providing flexibility to manage validator permissions and validator power assignments through an external gating contract.

🚀 Features

• (contracts) Validator gating (#1127)

📚 Documentation

• (docs) Validator gating docs (#1127)

⚙️ Miscellaneous Tasks

• Fixed typos (#1137)
• Fixed clippy (#1133)

Axon r03

[axon-r03] - 2024-09-06

Full changelog below.

⭐ HIGHLIGHT | Consistent Genesis 🧬🚀

The Consistent Genesis feature introduces an additional step of sealing the genesis, ensuring the inclusion of the genesis state, including both custom and built-in actors. This step prevents inconsistencies during node initialization. Previously, the genesis process required certain actors to be deployed at runtime when the node started, which could result in a panic and prevent the node from starting. With the Consistent Genesis update, actor code is directly incorporated into the genesis as part of the state tree, ensuring stability and consistency across all node starts.

🚀 Features

• (node) Consistent Genesis (#1016)
• (contracts) Improvements to contract deployment scripts (#1108)

🐛 Bug Fixes

• (core) Set the default Fendermint log level to INFO (#1123)
• (ci) CI speed-up improvements (#1124)

📚 Documentation

• (docs) Moved documentation to monorepo (#1014)
• (specs) Subnet Genesis v2 spec (#1113)
• (node) Updated running docs with Consistent Genesis (#1128)

⚙️ Miscellaneous Tasks

• Fixed typos and updated dependencies (#1087, #1106, #1089)
• Fixed clippy/fmt and improved cache usage (#1125)
• Applied Prettier formatting to contracts (#1111)

Axon r02

Full changelog below.

⭐ HIGHLIGHTED | Observability Framework 👁️📊

• Introduced a new observability framework utilizing the ipc-observability crate.
  • This framework introduces events and metrics for detailed system monitoring and analysis.
  • Integrates with Prometheus for real-time tracking, alerting, and visualization.
  • Simplifies observability integration with ready-to-use macros, structs, and functions.

IPC now emits events during execution. These events are recorded in the Journal, and are transformed into Prometheus metrics. Observability configuration is performed via config.toml.

Refer to full observability documentation here.

New events and metrics

Domain	Event	Description	Metric(s) derived
Consensus	BlockProposalReceived	Tracks block proposal reception	consensus_block_proposal_received_height (IntGauge)
Consensus	BlockProposalSent	Tracks block proposal sending	consensus_block_proposal_sent_height (IntGauge)
Consensus	BlockProposalEvaluated	Records the result from evaluating block proposals	consensus_block_proposal_accepted_height (IntGauge), consensus_block_proposal_rejected_height (IntGauge)
Consensus	BlockCommitted	Tracks committed blocks	consensus_block_committed_height (IntGauge)
Execution	MsgExec	Represents various message execution paths (Check, Apply, Estimate, Call)	exec_fvm_check_execution_time_secs (Histogram), exec_fvm_estimate_execution_time_secs (Histogram), exec_fvm_apply_execution_time_secs (Histogram), exec_fvm_call_execution_time_secs (Histogram)
Bottomup	CheckpointCreated	Records checkpoint creation	bottomup_checkpoint_created_total (IntCounter), bottomup_checkpoint_created_height (IntGauge), bottomup_checkpoint_created_msgcount (IntGauge), bottomup_checkpoint_created_confignum (IntGauge)
Bottomup	CheckpointSigned	Records checkpoint signatures	bottomup_checkpoint_signed_height (IntGaugeVec)
Bottomup	CheckpointFinalized	Records checkpoint finalization (quorum reached)	bottomup_checkpoint_finalized_height (IntGauge)
Topdown	ParentRpcCalled	Tracks parent RPC calls in the context of top-down finality	topdown_parent_rpc_call_total (IntCounterVec), topdown_parent_rpc_call_latency_secs (HistogramVec)
Topdown	ParentFinalityAcquired	Records acquisition of new parent finality	topdown_parent_finality_latest_acquired_height (IntGaugeVec)
Topdown	ParentFinalityPeerVoteReceived	Records peer votes for parent finality	topdown_parent_finality_voting_latest_received_height (IntGaugeVec)
Topdown	ParentFinalityPeerVoteSent	Records own votes for parent finality	topdown_parent_finality_voting_latest_sent_height (IntGauge)
Topdown	ParentFinalityPeerQuorumReached	Records quorum reached in parent finality voting	topdown_parent_finality_voting_quorum_height (IntGauge), topdown_parent_finality_voting_quorum_weight (IntGauge)
Topdown	ParentFinalityCommitted	Tracks parent finality committed on chain	topdown_parent_finality_committed_height (IntGauge)
System	TracingError	Logs tracing errors	tracing_errors (IntCounterVec)

🚀 Features

• (node) New observability architecture + events (#1053)
• (node) New observability bottom up tracing/metrics (#1061)
• (ethapi) Add eth cors settings (#1021)
• (node) File-based observability configuration (#1078)
• (node) Observability docs and changelog section (#1083)

🐛 Bug Fixes

• (ethapi) Make eth_getTransactionReceipt null for unexecuted/unknown transactions (#1006)

🚜 Refactor

• (node) Observability refinements. (#1085)

📚 Documentation

• (specs) Ethereum JSON-RPC API (#913)

⚙️ Miscellaneous Tasks

• Validate PR titles against conventional commits. (#1075)

Axon r01

Introducing Axon

It's early days for IPC! We are starting to enact a proper versioning and changelog practices. The framework will evolve rapidly in the next quarters, and it'll do so in major architectural milestones. With high probability, backwards compatibility between these milestones will not be preserved, requiring a manual migration to upgrade from one to the next. To cite a few such expected milestones: IPC modularization, consensus pluggability, Wasm-based client kernel.

We introduce the notion of "product generations" to represent the lifetime of IPC under each of these major architectural iterations. Product generations are named alphabetically A-Z (we certainly don't expect more than 26 generations...) We've kept the naming universe deliberately broad: entities/concepts found in biological, mathematical, or computing networks.

The first product generation is called Axon!

Find more background on these choices / implications here: #1012.

Axon r01

This is the baseline release of the IPC framework. A variation of this release is powering the networks of Fluence and Basin. Throughout the Axon generation, we do not expect to release crates and therefore we're staying away from adopting semver, resorting instead to simple sequential revision numbers. We're aiming to cut/tag revisions and publish changelogs on a weekly basis, with some flexibility to account for work in progress landing smoothly.

Axon r01 supports these major features (not a comprehensive list):

• CometBFT/Ignite-based consensus (currently on v0.37 but with plans to upgrade to v0.38 / v1).
• Wasm- and IPLD-based Filecoin Virtual Machine as an execution layer, supporting custom built-in Wasm actors, custom syscalls, custom gas price lists, and more.
• Ethereum-compatible runtime and JSON-RPC API (quasi-Dencun level, missing MCOPY support).
• Validator membership: federated (proof of authority) and collateral-driven (basis for proof of stake).
• Configurable supply source for subnets: either inheriting the parent root coin, or adopting an ERC20-compatible token for circulating supply / gas.
• L2 subnet creation, with L3+ behind a feature flag until we harden message propagation, response paths, and fault scenarios.
• Asynchronous general message passing across the IPC hierarchy, with result and return data delivery back to the caller.
• Cross-linked security: checkpointing on the parent via the relayer, and committing parent's finality in the subnet.
• Ability to permission and restrict contract deployment in subnets.
• Upgradability: framework actors can be upgraded through contract upgrades, and subnet hard forks can be run with the UpgradeScheduler.
• Validator management through the parent network.
• Automatic chain snapshots, with ability to bootstrap from them.
• Compatibility with the BlockScount explorer and Ethereum wallets out of the box.
• ... and a lot more.

Join the conversation!

Come ask your questions or give us feedback in the #ipc channel on Filecoin Slack.