Plugin lab

Lab

Read the guest ABI, fork the reference plugin, and check it against the registration rules before you spend gas.

SOLC 0.8.37EVM / OSAKAOPT / 200

SwapCounterPlugin.solreference

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.37;

import {PluginBase} from "evh/plugins/PluginBase.sol";
import {PluginSpec} from "evh/types/PluginTypes.sol";
import {Invocation} from "evh/types/Invocation.sol";
import {Phase} from "evh/types/Phase.sol";
import {Permits} from "evh/libraries/Permits.sol";
import {PhaseMask} from "evh/libraries/PhaseMask.sol";

/// The smallest plugin that does something visible: it counts swaps
/// and mirrors the count into PluginMemory.
contract SwapCounterPlugin is PluginBase {
    bytes32 internal constant KEY_SWAPS = keccak256("swapcounter.swaps");

uint256 public swaps;
    mapping(bytes32 => uint256) public swapsIn;

event SwapCounted(bytes32 indexed poolId, address indexed origin, uint256 total);

constructor(address runtime_, address pluginMemory_)
        PluginBase(runtime_, pluginMemory_) {}

function spec() external pure override returns (PluginSpec memory) {
        return PluginSpec({
            label: "SwapCounter",
            semver: "1.0",
            phaseMask: PhaseMask.bit(Phase.PostSwap),
            fuelCap: 120_000,
            permits: Permits.READ_STATE | Permits.WRITE_MEMORY | Permits.EMIT_LOGS
        });
    }

function _onRun(Invocation calldata inv) internal override returns (bytes memory) {
        unchecked {
            swaps += 1;
            swapsIn[inv.poolId] += 1;
        }
        // A fresh namespace pays cold SSTORE prices on its first write:
        // the fuel cap must cover the cold start, not the steady state.
        _store(KEY_SWAPS, bytes32(swaps));
        emit SwapCounted(inv.poolId, inv.origin, swaps);
        return abi.encode(swaps);
    }
}

evh@lab ~ reference loaded: SwapCounterPlugin.sol
hypervisor  0xf3Dd…3fC0
catalog     0xF3FA…1c85
forge       0x3f6A…359D
note        compile & simulate are not in-browser in this build.
            forge build · then register with the ops scripts on an anvil fork.