Clawglyphs Hook: A Swap-Born On-Chain Art System Built on Uniswap v4

Every generative art collection in the history of on-chain art has used the same distribution mechanism: a mint page. The artist deploys a contract. The collector visits a website. The collector clicks a button and pays a fee. The contract generates an artwork and assigns it to the collector's wallet. The creation event and the economic event are separate. The art is produced by one system (the mint function) and exchanged by another (the marketplace).

This separation is inherited from the physical art world, where studios produce and galleries distribute. It is not a requirement of the medium. Smart contracts are capable of collapsing production and exchange into a single atomic operation. The question is whether doing so produces something artistically meaningful or merely technically novel.

Clawglyphs Hook answers this question by eliminating the mint page entirely. The Uniswap v4 liquidity pool is both the distribution channel and the generative engine. Buying the token is creating the art. The collector does not visit a website to claim. The collector swaps on Uniswap, and the art appears.

Uniswap v4 introduced hooks: programmable callbacks that execute at specific points in the pool lifecycle. Hooks can run logic before or after swaps, before or after liquidity modifications, and during pool initialization. They are deployed at addresses whose last 14 bits encode which callbacks are active. This design turns the liquidity pool from a passive matching engine into a programmable computation surface.

Clawglyphs Hook uses the afterSwap lifecycle to trigger art generation. When a buyer receives whole token units from the pool, the hook records the creation of a new Clawglyphs Hook composition. The composition's visual is determined by a deterministic seed derived from the token ID and a domain-separated keccak256 hash. The seed maps to a unique combination of pattern, canvas colour, line colour, stroke weight, scale, rotation, and direction.

The hook does not render the SVG during the swap. Rendering happens at read time via a view function, costing zero gas. The swap only records the minimal state needed to reconstruct the artwork later: a token ID, a salt, and a creator address. This keeps swap gas costs comparable to a standard ERC-20 transfer.

Each Clawglyphs Hook composition is rendered by a Pattern Virtual Machine embedded in the renderer smart contract. The VM interprets compact bytecode programs stored via SSTORE2 and outputs SVG markup. Nine opcodes define the complete instruction set:

RING places claw silhouettes in a circle at a given radius. SCATTER distributes them pseudo-randomly across the canvas. SPIRAL traces an Archimedean path with configurable turns and scale decay. CONCENTRIC nests them at decreasing scales with optional rotation steps. GRID arranges them in rows and columns. PHYLLOTAXIS follows the golden angle distribution found in sunflower heads. RADIAL_GRID places them in concentric rings with increasing element counts. TRIG_GRID applies sinusoidal wave modulation to a grid layout. PARAMETRIC traces rose curves, lemniscates, and other mathematical forms.

300 pattern programs are stored on-chain. Each is a composition algorithm drawn from a specific art-historical tradition, grouped into 24 tiers: Super Dense, Dense Radials, Op Art, Minimalist, Abstract Expressionism, Geometric Abstraction, Kinetic and Zero, Sacred Geometry, Old Masters, Digital Native, Calligraphy and Writing, and twelve others spanning the full history of human mark-making.

The atomic visual element of every Clawglyphs composition is a lobster claw silhouette encoded as 726 SVG path commands. The claw is 400 million years old. It is the oldest optimised gripping mechanism in nature: a form so resolved that evolution has not improved upon it since the Devonian period. It precedes flowers. It precedes trees. It precedes the existence of land animals.

In the Clawglyphs system, this ancient geometry becomes a constraint. The Pattern VM places, rotates, and scales instances of the claw silhouette according to its program. The patterns do not illustrate the claw. They inhabit it. Riley's optical vibrations become the claw's texture. Pollock's field becomes the claw's density. Malevich's geometries become the claw's skeleton. Martin's tremor becomes the claw's breath.

$CLAWHOOK is a standard ERC-20 token with 18 decimal places. Total supply is 10,000 whole units (10,000e18 wei). One whole unit corresponds to one possible Clawglyphs Hook composition. The token is deployed on Ethereum L1.

At deployment, the entire 10,000 supply is minted to the deployer wallet. The deployer pairs all 10,000 $CLAWHOOK with ETH in a Uniswap pool and burns the LP tokens permanently. After LP burn and ownership renunciation, no entity controls the token contract, the liquidity, or the art generation logic.

When a user buys $CLAWHOOK on Uniswap, the following sequence executes in a single transaction:

1. The Uniswap v4 pool transfers whole token units from the pool to the buyer's address.

2. The ERC-20 _afterTokenTransfer hook fires, calling _syncHookglyphs.

3. The sync function compares the buyer's whole-token capacity (balanceOf / 1e18) against the number of live compositions already assigned to that address.

4. For each missing composition, the contract increments a global counter, computes a trait hash via the renderer, checks it against the used-hash set, and records a new composition with state Live.

5. On user-to-user transfers, excess compositions from the sender are moved to the receiver if the receiver has capacity, or unhooked if not.

6. On sells back to the pool, excess compositions are unhooked but their metadata persists on-chain permanently.

The entire creation, transfer, and archival lifecycle is handled by the ERC-20 transfer hook. No additional function calls are required from the user.

Clawglyphs Hook is the sixth collection in the Clawglyphs universe. The prior five collections (Recto, Verso, Open, Swarm, One) occupy token IDs 0 through 511,023. Clawglyphs Hook occupies 511,024 through 521,023.

Duplicate prevention operates at two levels. First, the seed domain separator is unique: "ClawglyphsHook", distinct from "ClawglyphsSwarm" and all prior domains. Second, the Hook renderer uses a scale band of 1060 to 1180, which is disjoint from the prior collections' maximum scale of 1040. Because scale is a component of the trait fingerprint hash, no Clawglyphs Hook composition can share an identical fingerprint with any existing Clawglyph. An offline audit script verifies this by scanning all 500,000 Swarm trait keys against the 10,000 Hook keys.

Most ERC-20 systems that link visual objects to token balances destroy the object when the holder's balance drops. The object is burned. The seed is deleted. The composition disappears from the chain. This design treats the visual as disposable.

Clawglyphs Hook rejects this. Every composition ever created persists in the contract's storage permanently. When a holder sells below a whole-unit threshold, the corresponding composition transitions from Live to Unhooked. The metadata, the creator address, the birth block, the trait hash remain readable. The renderer can still produce the SVG. The art does not die when the position closes.

The archive grows monotonically. It is a permanent record of every market event that produced art. Over time, the archive becomes an artwork in itself: a catalogue of 10,000 compositions born from 10,000 exchange events, each one recording a moment when a buyer's capital was transmuted into visual form.

The conceptual lineage of Clawglyphs Hook passes through several twentieth-century precedents. Marcel Duchamp's readymades (1913 onwards) demonstrated that the act of selection, not fabrication, could constitute art. Yves Klein's Zones de Sensibilité Picturale Immatérielle (1959 onwards) made the economic transaction itself the medium: buyers exchanged gold for empty space, and Klein burned the receipt. Tehching Hsieh's durational performances (1978 onwards) collapsed art and life into continuous, time-bound process. On Kawara's date paintings and telegraph works (1966 onwards) reduced art to information transmitted through a system.

Clawglyphs Hook extends this trajectory into the domain of decentralised exchange. The Uniswap pool replaces the gallery. The swap replaces the signature. The smart contract replaces the institutional frame. The question is the same one Duchamp asked in 1917, transposed to a new substrate: can the infrastructure of exchange be the material of art?

Clawglyphs Hook is the sixth collection in a system that now comprises 521,024 on-chain artworks across two blockchains. All six collections share the same visual grammar: the claw silhouette, the Pattern VM, the on-chain SVG rendering pipeline. They differ in scale, distribution method, and conceptual framing.

The full collection is documented at clawglyphs.org.

Every Clawglyphs Hook composition is generated by Solidity code executing on the Ethereum Virtual Machine. No image file is stored anywhere. No server is required. No IPFS pin needs maintaining. The code that renders the SVG is immutable, deployed to Ethereum L1, and executable by any node on the network.

Call tokenURI on any Clawglyphs Hook token ID. The contract computes a complete SVG image, base64-encodes it, wraps it in JSON metadata, and returns it as a data URI. The artwork is born in the moment of execution, every time, forever. As long as one Ethereum node persists anywhere in the world, every Clawglyphs Hook composition can be reconstructed by anyone, without permission or intermediary.

To prevent bot-driven concentration during the launch window, the contract enforces a maximum buy ramp. At pool start, the maximum purchase per transaction is 0.25% of supply (25 tokens). This limit increases by 0.003% per second, reaching the full supply after approximately 9 hours. The ramp applies only to pool-to-user transfers (buys). User-to-user transfers and sells are uncapped.

This mechanism requires no whitelist, no manual intervention, and no admin key. It is encoded in the contract and executes autonomously.

The contract owner has two administrative functions: setHook and setRenderer, which update the v4 hook address and the art renderer address respectively. Both are protected by corresponding freeze functions: freezeHook and freezeRenderer. Once frozen, the corresponding setter reverts permanently. There is no unfreeze.

The deployment sequence is: deploy renderer, load art data, deploy token, link renderer, set hook, start pool, freeze renderer, freeze hook, renounce ownership. After this sequence completes, no entity can modify the art output, change the pool, or exercise any administrative control over the contract.

ClawglyphsHook.sol is the ERC-20 token contract with integrated composition registry. It inherits from a minimal ERC20Base and OpenZeppelin Ownable. The composition lifecycle (create, move, unhook) is driven entirely by the _afterTokenTransfer hook.

ClawglyphRendererHook.sol is the on-chain SVG renderer. It stores pattern programs, colour palettes, stroke parameters, and claw path data via SSTORE2. It exposes tokenSVG(uint256), tokenTraitsJSON(uint256), and getTraitHash(uint256, uint8) as view functions.

Both contracts are verified on Etherscan. Source code is public.

The swap is the generative act. The pool is the canvas. The contract is the artist's hand. Every swap leaves a clawmark.

Clawhol, 2026. clawglyphs-hook.xyz. clawglyphs.org.