SunSwap V4 Core

SunSwap V4 Core is the core contracts repository of the SunSwap protocol. It is built with Hardhat and Foundry, and supports development, testing, and deployment on Tron networks.

SunSwap V4 Core is the foundational contract library of SunSwap V4, responsible for implementing the essential AMM logic and state management.
It separates accounting from execution, enabling a modular architecture where liquidity, swaps, and fee logic can be extended through external modules.

Key responsibilities include:

• Vaults: secure storage of assets and accounting of balances.
• Pool Managers: creation and management of liquidity pools with customizable parameters.
• Hooks: extension points that allow developers to add custom logic (e.g., dynamic fees, on-chain strategies) without modifying the core contracts.

By isolating the core AMM logic, SunSwap V4 Core ensures stability, security, and composability. This design allows developers to innovate on top of the protocol while maintaining a reliable foundation for liquidity management and trading.

---

Deployments

contract	chain	address
PoolManager	TRON Mainnet	TVjuTE3V5bMVdpfNhid8kD2v35T2k1u1Br
	NILE Testnet	TVivLPeq7FMmTG8Z7HaiBgHTsMwCEcipKT
protocolFeeController	TRON Mainnet	TEays9UfJn2EqKjkN7hWUWewBGpGxTzWEv
	NILE Testnet	TDch7PxQNbsuCQpzPd2LK7htR5qB3wvdtF

---

Environment (ENV)

node >= v22.14.0
npm >= 10.9.2
@sun-protocol/sun-studio >= 0.2.2

---

Compile, Test and Deploy

Installation

npm install

Hardhat Configuration

In hardhat.config.ts, you can configure compiler options, networks, and other settings.

compilers

You can use multiple versions of the Solidity and Vyper compilers at the same time:

solidity: {
  compilers: [
    { version: "0.8.26", settings },
  ],
},

networks

You can add the Tron network and other EVM-compatible networks, for example:

networks: {
  localhost: {
    live: false,
    saveDeployments: true,
    tags: ["local"],
    deploy: ["deploy/"],
  },
  tron: {
    url: "https://trongrid.io/jsonrpc",
    tron: true,
    deploy: ["deployTron/"],
    accounts: [`${process.env.PRIVATE_KEY}`],
  },
  nile: {
    url: "https://nile.trongrid.io/jsonrpc",
    tron: true,
    deploy: ["deployTron/"],
    accounts: [`${process.env.PRIVATE_KEY}`],
  },
  sepolia: {
    url: "https://sepolia.drpc.org",
    tron: false,
    deploy: ["deploy/"],
    accounts: [`${process.env.PRIVATE_KEY}`],
  },
}

Other options

tronSolc support:

tronSolc: {
  enable: true, // if using tronSolc
},

namedAccounts for configuring deployer accounts:

namedAccounts: {
  deployer: {
    default: 0, // by default take the first account as deployer
  },
}

Compile

npx hardhat compile

or:

npm run compile

Unit Tests

Hardhat tests

npx hardhat test

or:

npm run test

Foundry tests

Initialize Foundry:

npm run init-foundry

Run Foundry tests:

npm run test-foundry

Deploy

Adapt the scripts under deploy/ or deployTron/ as needed to deploy the contracts, then run:

npx hardhat deploy --network <network> --tags <tag>

or use npm scripts:

npm run deploy-tron   # Tron network
npm run deploy        # other EVM-compatible networks

After deployment, you can check deployed contract info at:

deployments/<network>/<contractName>.json

---

Community & Support

If you have questions about this project, find bugs, or would like to contribute, you can reach the team and community via:

• Telegram
• Twitter

Please follow official announcements from these channels for the latest information on deployments, upgrades, and security notices.