Deploy Your Contract (Foundry)

Deploy Your First Contract (Foundry)

This guide deploys a simple Solidity contract to SATUCHAIN Testnet using Foundry (forge/cast).

Requirements

• Foundry installed (forge, cast)

• A wallet with tSTU for gas (faucet): https://faucet.satuchain.com/

• SATUCHAIN Testnet:

  • RPC: https://rpc-testnet.satuchain.com

  • Chain ID: 17081945

  • Explorer: https://testnet.satuchain.com

1) Install Foundry

If Foundry is not installed:

curl -L https://foundry.paradigm.xyz | bash
foundryup

Confirm:

forge --version
cast --version

2) Create a New Project

mkdir satuchain-foundry
cd satuchain-foundry
forge init

3) Add the Contract

Create src/Storage.sol:

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

contract Storage {
    uint256 private value;

    event ValueChanged(uint256 newValue);

    function set(uint256 newValue) external {
        value = newValue;
        emit ValueChanged(newValue);
    }

    function get() external view returns (uint256) {
        return value;
    }
}

4) Configure Environment Variables

Create a .env file:

RPC_URL=https://rpc-testnet.satuchain.com
PRIVATE_KEY=YOUR_TESTNET_PRIVATE_KEY

Notes:

• Use a testnet-only wallet private key.

• Never commit .env to version control.

Load env vars (Linux/macOS):

source .env

Windows PowerShell:

$env:RPC_URL="https://rpc-testnet.satuchain.com"
$env:PRIVATE_KEY="YOUR_TESTNET_PRIVATE_KEY"

5) Build

forge build

6) Deploy

Deploy Storage using forge create:

forge create \
  --rpc-url $RPC_URL \
  --private-key $PRIVATE_KEY \
  --chain-id 17081945 \
  src/Storage.sol:Storage

Output will include:

• Deployed contract address

• Transaction hash

7) Verify on Explorer

1. Open the explorer: https://testnet.satuchain.com

2. Search the transaction hash or contract address.

3. Confirm the contract creation transaction succeeded.

8) Interact With the Contract (Optional)

Replace <CONTRACT_ADDRESS> with your deployed address.

Read the value:

cast call <CONTRACT_ADDRESS> "get()(uint256)" --rpc-url $RPC_URL

Set a new value (example: 123):

cast send <CONTRACT_ADDRESS> "set(uint256)" 123 \
  --rpc-url $RPC_URL \
  --private-key $PRIVATE_KEY \
  --chain-id 17081945

Then read again:

cast call <CONTRACT_ADDRESS> "get()(uint256)" --rpc-url $RPC_URL

Troubleshooting

Insufficient funds

• Claim more tSTU and retry.

Invalid sender / signature error

• Verify the private key and ensure it matches the account with tSTU.

RPC not responding

• Confirm RPC URL is correct and retry the command.