Releases: consensus-shipyard/ipc
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
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
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
🐛 Bug Fixes
📚 Documentation
- (docs) Moved documentation to monorepo (#1014)
- (specs) Subnet Genesis v2 spec (#1113)
- (node) Updated running docs with Consistent Genesis (#1128)
⚙️ Miscellaneous Tasks
Axon r02
Full changelog below.
⭐ HIGHLIGHTED | Observability Framework 👁️📊
- Introduced a new observability framework utilizing the
ipc-observabilitycrate.- 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_getTransactionReceiptnull 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.