Integration Guide

Developers can integrate with Spheres.fun by calling our smart contracts directly through any HyperEVM RPC endpoint.

Below you'll find the complete contract interface and deployment details for our protocol:

Network Configuration:

• Chain ID: 999 (HyperEVM)

• RPC URL: https://rpc.hyperliquid.xyz/evm

• Block Explorer: https://purrsec.com/

Official Deployment Addresses:

TOKEN_FACTORY = 0x604181Fd9182820c8c6D9cD43a699eCFb678F9Af
BONDING_CURVE = 0x106A8AE46EB4579d1C88b2F6018b3c511E0C0d57
TOKEN_REGISTRY = 0x056aF20fd18Ca0F7e199727706455f5461c735e5
DEX_MIGRATION = 0x2F1fEa33c56d992d1406e1E8BD8f7173bbf21Ca9

Core Trading Functions:

solidity"function buyTokens(address token, uint256 minTokenAmount) external payable"

solidity"function sellTokens(address token, uint256 tokenAmount, uint256 minHypeAmount) external"

solidity"function getCurrentPrice(address token) public view returns (uint256)"

solidity"function calculateBuyAmount(address token, uint256 hypeAmount) public view returns (uint256)"

solidity"function calculateSellAmount(address token, uint256 tokenAmount) public view returns (uint256)"

Token Discovery Functions:

solidity"function getAllTokensCount() public view returns (uint256)"

solidity"function allTokens(uint256 index) public view returns (address)"

solidity"function getCreatorTokens(address creator) public view returns (address[])"

Token Information Functions:

solidity"function getTokenInfo(address token) public view returns (address creator, uint256 hypeCollected, uint256 tokensSold, uint256 tokenReserve, bool graduated, uint256 createdAt)"

solidity"function getTokenMetadata(address token) public view returns (string description, string imageUrl, string twitter, string telegram, string website)"

solidity"function getBondingCurveProgress(address token) public view returns (uint256 currentHype, uint256 targetHype, uint256 progressPercentage)"