Quickstart — Foundry

Deploy your first smart contract to Xhavic Testnet using Foundry. This guide takes approximately 10 minutes.

Prerequisites

Foundry installed (curl -L https://foundry.paradigm.xyz | bash && foundryup)
A wallet with testnet ETH (get from faucet.xhavic.io)

1. Create a New Project

forge init my-xhavic-project && cd my-xhavic-project

2. Write a Contract

Replace src/Counter.sol:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

contract HelloXhavic {
    string public greeting = "Hello from Xhavic L2!";
    uint256 public count;

    event Counted(address indexed sender, uint256 newCount);

    function increment() external {
        count++;
        emit Counted(msg.sender, count);
    }

    function setGreeting(string calldata _greeting) external {
        greeting = _greeting;
    }
}

3. Compile

forge build

4. Deploy to Testnet

forge create src/HelloXhavic.sol:HelloXhavic \
  --rpc-url https://testnet-rpc.xhavic.io \
  --private-key $DEPLOYER_KEY

5. Interact

# Read greeting
cast call DEPLOYED_ADDRESS "greeting()" \
  --rpc-url https://testnet-rpc.xhavic.io

# Increment counter
cast send DEPLOYED_ADDRESS "increment()" \
  --rpc-url https://testnet-rpc.xhavic.io \
  --private-key $DEPLOYER_KEY

# Read count
cast call DEPLOYED_ADDRESS "count()" \
  --rpc-url https://testnet-rpc.xhavic.io

Prerequisites

1. Create a New Project

2. Write a Contract

3. Compile

4. Deploy to Testnet

5. Interact

What’s Next?