Deployment

AgentCoin deploys to Base (Coinbase L2). The deployment sequence is critical: contracts must be configured in the correct order before ownership is renounced.

Prerequisites

Deploy Sequence

Step 1: Deploy MiningAgent

MiningAgent ma = new MiningAgent();

Deploys the ERC-721 mining rig contract. Starts with nextTokenId = 1.

Step 2: Deploy LPVault

LPVault vault = new LPVault(deployer);

Deploys the LP accumulator. The deployer address retains fee collection rights on the eventual Uniswap V3 position.

Step 3: Deploy AgentCoin

AgentCoin ac = new AgentCoin(address(ma), address(vault));

Deploys the ERC-20 token. This transaction:

• Sets miningAgent (immutable)
• Sets lpVault (immutable)
• Mints 2,100,000 AGENT to the LPVault
• Initializes the genesis challenge
• Sets initial mining difficulty

Step 4: Configure MiningAgent

ma.setLPVault(payable(address(vault)));
ma.setAgentCoin(address(ac));

Links the NFT contract to the vault (for fee forwarding) and the token (for dynamic tokenURI). Both setters are one-time only.

Step 5: Configure LPVault

vault.setAgentCoin(address(ac));

Links the vault to the token contract. One-time only.

Step 6: Renounce Ownership

ma.renounceOwnership();
vault.renounceOwnership();

Permanently disables all admin functions. The system becomes fully autonomous and immutable.

AgentCoin inherits Ownable for the renounceOwnership() lifecycle function. The Renounce.s.sol script explicitly calls renounceOwnership() on AgentCoin. After renunciation, it becomes fully immutable.

Post-Deploy Verification

After deployment, verify the following:

Contract Links

ma.lpVault()     == address(vault)
ma.agentCoin()   == address(ac)
ac.miningAgent() == address(ma)
ac.lpVault()     == address(vault)
vault.agentCoin() == address(ac)

Initial State

ma.nextTokenId() == 1
ma.owner()       == address(0)     // ownership renounced
ac.totalMines()  == 0
ac.totalMinted() == 0
ac.balanceOf(vault) == 2_100_000e18  // LP reserve
vault.lpDeployed() == false
vault.owner()    == address(0)       // ownership renounced

Pricing

ma.getMintPrice() == 0.002 ether     // starting price
ma.MAX_SUPPLY()   == 10_000

Mining

ac.miningTarget()     == type(uint256).max >> 16  // easy initial difficulty
ac.challengeNumber()  == keccak256("AgentCoin Genesis")

Storage Layout

Constants don't use storage slots. Verify with:

forge inspect MiningAgent storage-layout
forge inspect AgentCoin storage-layout
forge inspect LPVault storage-layout

Development

# Install dependencies
cd contracts && forge install

# Run all tests (231)
forge test

# Run fork tests against Base mainnet
forge test --match-path test/LPVaultFork.t.sol --fork-url $BASE_RPC

# Gas report
forge test --gas-report

# Inspect storage
forge inspect MiningAgent storage-layout