Contracts
notional runs on these contracts on HyperEVM, chain ID 999. Each address links to HyperEVMScan.
Preview addresses: no contract is deployed at any of them. Do not send funds or tokens to these addresses.
| Contract | Address |
|---|---|
| LaunchpadCreates coins, runs their bonding curves and moves each full curve to a locked HyperSwap pool. | 0x23dd7bfd395597e56a02 on HyperEVMScan, opens in a new tab |
| RouterRoutes every trade through bonding curves and NLP pools for the best price. | 0x538a6e8231d4acf16a85 on HyperEVMScan, opens in a new tab |
| NLP pool factoryCreates NLP pools, one per pair of tokens and fee tier. | 0x313ca265d81ae2fb02a6 on HyperEVMScan, opens in a new tab |
| NLP position managerAdds and removes liquidity and collects a position's fees. | 0x703ceeccb5b1ef391f73 on HyperEVMScan, opens in a new tab |
| NLP vaultTakes USDC deposits and provides liquidity across NLP pools. | 0x1c120c89bf0f92e1ada3 on HyperEVMScan, opens in a new tab |
| StakingHolds staked NOTIONAL and its locks, and pays out staking rewards. | 0xd9e4c9126231d103355c on HyperEVMScan, opens in a new tab |
| Fee distributorSplits protocol fees between stakers, the NLP vault and the treasury. | 0xad1c7fe3b5efcf60f042 on HyperEVMScan, opens in a new tab |
| Builder registryRegisters builder codes and their fees, and pays builders what their codes earn. | 0x5b486c48aa83ae6022ff on HyperEVMScan, opens in a new tab |
| NOTIONAL tokenThe protocol token: staked for a share of fees and voting power. | 0x7e570000000000000000 on HyperEVMScan, opens in a new tab |
The contracts cannot be upgraded: the code at these addresses is the code that runs. The RPC endpoint and the rest of the network details are on Wallets and network.
Interacting with the contracts
Any EVM library works. The examples use viem, which has HyperEVM built in, and inline ABIs with just the functions they call.
Quote a trade on the Router
The Router quotes and executes every trade: on bonding curves and in NLP pools. quote returns what a trade would pay out right now, after fees. Its last argument is a builder code, whose fee the quote takes out too.
import { createPublicClient, formatUnits, http, parseEther, zeroAddress, zeroHash } from "viem";
import { hyperEvm } from "viem/chains";
const client = createPublicClient({ chain: hyperEvm, transport: http() });
// Only the functions you call need to be in the ABI.
const routerAbi = [
{
type: "function",
name: "quote",
stateMutability: "view",
inputs: [
{ name: "tokenIn", type: "address" },
{ name: "tokenOut", type: "address" },
{ name: "amountIn", type: "uint256" },
{ name: "builderCode", type: "bytes32" },
],
outputs: [{ name: "amountOut", type: "uint256" }],
},
] as const;
// What 1 HYPE buys of NOTIONAL right now, after fees. The zero address stands for HYPE itself, and the
// zero hash for no builder code.
const amountOut = await client.readContract({
address: "0x538a6e8231d4acf16a8546d2f93f7c44fb80831d",
abi: routerAbi,
functionName: "quote",
args: [zeroAddress, "0x7e57000000000000000000000000000000000000", parseEther("1"), zeroHash],
});
const coins = formatUnits(amountOut, 18); // Coins launched on notional have 18 decimals.Read a coin's curve on the Launchpad
curveOf returns a coin's pair token, the coins sold and the pair asset raised so far, and how close the curve is to graduation.
const launchpadAbi = [
{
type: "function",
name: "curveOf",
stateMutability: "view",
inputs: [{ name: "coin", type: "address" }],
outputs: [
{ name: "pairToken", type: "address" },
{ name: "sold", type: "uint256" },
{ name: "raised", type: "uint256" },
{ name: "progressBps", type: "uint16" },
{ name: "graduated", type: "bool" },
],
},
] as const;
const [pairToken, sold, raised, progressBps, graduated] = await client.readContract({
address: "0x23dd7bfd395597e56a02a045f11697d0858fcd18",
abi: launchpadAbi,
functionName: "curveOf",
args: ["0x7e57000000000000000000000000000000000000"],
});
// progressBps runs from 0 to 10,000: 900 means the curve is 9% of the way to graduation.To send trades through the Router and charge a fee of your own on them, see Builders.
Events
The events to follow if you index notional yourself:
// Launchpad
event CoinCreated(address indexed coin, address indexed creator, address pairToken);
event Trade(address indexed coin, address indexed trader, bool isBuy, uint256 coinAmount, uint256 pairAmount, uint256 fee);
event Graduated(address indexed coin, address pool);
// Router
event Routed(address indexed sender, address tokenIn, address tokenOut, uint256 amountIn, uint256 amountOut, bytes32 indexed builderCode, uint256 builderFee);CoinCreated: a coin launches.Trade: someone buys or sells on a bonding curve.feeis the whole 1%, in the pair asset.Graduated: a curve completes and its liquidity is locked in a HyperSwap pool.Routed: any trade sent through the Router, with the builder code it carried and the builder fee it paid, intokenIn.
Each NLP pool emits Swap, Mint, Burn and Collect: one for each swap, deposit, withdrawal and fee collection.
