notional

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.

ContractAddress
LaunchpadCreates coins, runs their bonding curves and moves each full curve to a locked HyperSwap pool.0x23dd7bfd395597e56a02a045f11697d0858fcd18 on HyperEVMScan, opens in a new tab
RouterRoutes every trade through bonding curves and NLP pools for the best price.0x538a6e8231d4acf16a8546d2f93f7c44fb80831d on HyperEVMScan, opens in a new tab
NLP pool factoryCreates NLP pools, one per pair of tokens and fee tier.0x313ca265d81ae2fb02a61b88d01dc42ee509a3db on HyperEVMScan, opens in a new tab
NLP position managerAdds and removes liquidity and collects a position's fees.0x703ceeccb5b1ef391f73d41eeccf9726e671258a on HyperEVMScan, opens in a new tab
NLP vaultTakes USDC deposits and provides liquidity across NLP pools.0x1c120c89bf0f92e1ada312a9de8d472c4aa0d455 on HyperEVMScan, opens in a new tab
StakingHolds staked NOTIONAL and its locks, and pays out staking rewards.0xd9e4c9126231d103355c65fb5e55700b20b8a826 on HyperEVMScan, opens in a new tab
Fee distributorSplits protocol fees between stakers, the NLP vault and the treasury.0xad1c7fe3b5efcf60f042f8773b1ca63a33b69e87 on HyperEVMScan, opens in a new tab
Builder registryRegisters builder codes and their fees, and pays builders what their codes earn.0x5b486c48aa83ae6022ff528161f7a14bdcb816d5 on HyperEVMScan, opens in a new tab
NOTIONAL tokenThe protocol token: staked for a share of fees and voting power.0x7e57000000000000000000000000000000000000 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.

TypeScript
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.

TypeScript
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:

Solidity
// 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. fee is 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, in tokenIn.

Each NLP pool emits Swap, Mint, Burn and Collect: one for each swap, deposit, withdrawal and fee collection.

Welcome to notional

notional is an interface to smart contracts on HyperEVM. You stay in control of your wallet, every transaction is final, and memecoins and tokenized stocks can lose all of their value.