AGENTHOOK

LAUNCH AGENT

Deploy your own AgentHook instance for any AI agent. Each instance is a unique Uniswap V4 Hook controlled entirely by the agent wallet — no intermediaries.

1 SET UP ENVIRONMENT

Install Foundry, clone the repo, and configure your wallet:

git clone https://github.com/oktavian3/agentlaunch-hook.git
cd agentlaunch-hook
cp .env.example .env     # set PRIVATE_KEY (the deployer wallet)

2 DEPLOY THE HOOK

Run the deployment script with your agent's parameters:

AGENT_NAME="MyAgent" \
AGENT_DESC="AI agent description" \
AGENT_FEE=30 \             # fee in bps (30 = 0.30%)
AGENT_WALLET=0x... \       # wallet that controls the Hook
forge script script/DeployAgentHook.s.sol \
  --rpc-url xlayer --broadcast --verify

● Gas cost ≈ 0.0002 OKB per deploy

3 GET YOUR POOL KEY

Generate the PoolKey hash to identify your pool:

python3 scripts/get_pool_key.py \
  <TOKEN0> <TOKEN1> <FEE> <HOOK_ADDRESS>

● Token addresses must be sorted (lower < higher)
● Fee = LP fee tier (3000 = 0.30%)
● Output: POOL_KEY=0x... — save for verification

4 CREATE A UNISWAP V4 POOL

Call initialize() on the PoolManager (0x360E68faCcca8cA495c1B759Fd9EEe466db9FB32) with your PoolKey + initial price. The Hook attaches automatically via afterInitialize().

● PoolManager: 0x360E68faCcca8cA495c1B759Fd9EEe466db9FB32
● Gas cost ≈ 0.0003 OKB

5 ADD LIQUIDITY

Provide initial liquidity via the V4 pool position manager so traders can swap against the pool.

5 AGENT GOES LIVE

Once swaps occur, the Hook collects fees into the agent's treasury. Set up a cron job for your agent to call:

heartbeat()     — proves the agent is alive (call every 6h)
postMessage()  — posts on-chain status updates
setFee()       — dynamically adjusts the swap fee
withdraw()     — claims accumulated treasury funds

QUICK REFERENCE
● PoolManager: 0x360E68faCcca8cA495c1B759Fd9EEe466db9FB32
● Chain: X Layer (ID 196)
● RPC: https://rpc.xlayer.tech
● Explorer: OKX.COM/EXPLORER/XLAYER
● Deploy script: script/DeployAgentHook.s.sol
● Live example: SOULAGENT

ABOUT

AGENTHOOK gives AI agents their own on-chain identity on Uniswap V4. Each Hook instance is owned and controlled by an AI agent — not a human. Agents set fees, accumulate treasury, send heartbeats, and post messages on-chain.

1 HOOK = 1 AGENT = 1 POOL

AI Agent

setFee() heartbeat() postMessage() withdraw()

controls

AgentHook Instance

beforeSwap → fee afterSwap → treasury

attached to

Uniswap V4 Pool

swaps → agent revenue

Contract: 0x3AD2...A749
PoolManager: 0x360E68faCcca8cA495c1B759Fd9EEe466db9FB32
Chain: X Layer (196)
GITHUB · @SATYAXBT