Documentation · Reference

Selectors

Function selectors, event topics and error selectors for GeneHook, GeneToken and GeneLens, produced by forge at the frozen RC4 commit.

Verified commit. Every value on this page was produced by forge inspect on a detached checkout of tag rc4-audit-candidate at commit aca5fcd3bbc9ecb1026de58bea431d406d8ecfff (git rev-parse HEAD checked; working tree clean), forge 1.5.1-stable (b0a9dd9c), solc 0.8.26 as pinned in foundry.toml:11-15. Commands:

forge inspect src/GeneHook.sol:GeneHook  methodIdentifiers --json
forge inspect src/GeneHook.sol:GeneHook  events --json
forge inspect src/GeneHook.sol:GeneHook  errors --json
forge inspect src/GeneToken.sol:GeneToken methodIdentifiers | events | errors --json
forge inspect src/GeneLens.sol:GeneLens   methodIdentifiers | events | errors --json

The build artifacts in that checkout reproduce the bytecode hashes recorded at the freeze exactly (GeneHook runtime sha256 17e1418e…84b4d4, creation sha256 50bd04f6…2ef373; GeneLens and GeneToken likewise).

Citation keys. H = src/GeneHook.sol, L = src/GeneLens.sol, T = src/GeneToken.sol.

Event topic note. forge inspect prints events with source type names (GeneHook.EpochRecord, GeneHook.State, PoolId). The topic is the keccak256 of the canonical ABI signature, in which a struct is a tuple, an enum is uint8 and PoolId is bytes32. Each canonical signature below was re-hashed with cast keccak and matches the forge output.

#GeneHook functions

27 functions. The count matches the list pinned by test/unit/HookAbi.t.sol:22-51. Behaviour is documented on GeneHook.

#State-changing

#Hook callbacks

#Views, constant and immutables

#GeneHook events

MassAdded.kind values: 0 genesis, 1 METABOLISM bid, 2 IMMUNITY bid, 3 ask, 4 churn-tier bid (H:138; emitted with those literals at H:433, H:485, H:501, H:518, H:546). Field meanings are on Events.

Index only logs whose emitting address is the GeneHook address. A contract elsewhere can emit the same topic.

#GeneHook errors

Conditions are on Errors. Errors raised inside the PoolManager or OpenZeppelin ERC20 during a GENE call carry their own selectors and are not listed here, except GeneToken's below.

#GeneToken

#GeneToken functions

#GeneToken events

#GeneToken errors

#GeneLens

20 functions; no events and no custom errors. GeneLens is optional, stateless and not called by GeneHook (L:12-19). Every function except genome() takes the hook address first.

positionAt reverts with the string "index" for an out-of-range index (L:94).

#PoolManager events

These are PoolManager events, not GENE events. Topics were computed with cast keccak over the canonical signatures of the vendored v4-core interface (lib/v4-core/src/interfaces/IPoolManager.sol:60, 78, 91; v4-core 59d3ecf5, foundry.toml:2).