Schnellstart

Deployen Sie Ihren ersten Solidity-Contract auf Rome in unter 5 Minuten.

Stelle deinen ersten Solidity-Contract auf Rome in unter 5 Minuten bereit. Dieser Leitfaden richtet sich an Martius, die öffentliche Testnet-Chain; die gleichen Schritte funktionieren auf Hadrian (Devnet), indem du die Netzwerkwerte austauschst.

Voraussetzungen

• Node.js v22.13+

• MetaMask Browser-Erweiterung

• Eine Solana-Wallet (z. B. Phantom) eingestellt auf Devnet

1. Füge Martius zu MetaMask hinzu

Füge es manuell hinzu (Einstellungen → Netzwerke → Netzwerk hinzufügen):

Feld	Wert
Netzwerkname	Rome Martius
RPC-URL	https://martius.testnet.romeprotocol.xyz/
Chain-ID	121214
Währungssymbol	USDC
Block-Explorer	https://via-martius.testnet.romeprotocol.xyz/

2. Lade deine Wallet auf

Gas wird im SPL-Gas-Token der Chain bezahlt (USDC auf Martius). Zwei Möglichkeiten, ihn zu erhalten:

Von Solana — hole dir Devnet-SOL über den Solana-Faucet (stelle deine Solana-Wallet auf Devnet ein), dann öffne die Rome App, verbinde beide Wallets und wandle es in den Gas-Token um.

Per Bridging — präge Test-USDC auf Ethereum Sepolia über das Circle-Faucet, dann bringe es mit dem Rome Bridge (CCTP). Du benötigst etwas Sepolia-ETH für die Transaktion auf der Quellseite — siehe Faucets für jedes Faucet.

Wie viel? Contract-Deployments auf Rome verursachen Solana-seitige Kontokosten, daher liegen die Gas-Schätzungen deutlich über der Ethereum-Intuition — der Quickstart-Contract schätzt ~20 Mio. Gas und kostet etwa 0.2 USDC für die Bereitstellung, und Wallets prüfen im Voraus ungefähr das Doppelte der Schätzung. Lade mindestens 0,5 USDC Gas; 1 USDC lässt komfortablen Spielraum.

Wenn eine Einzahlung auf der Solana-Seite trotz aufgeladener Wallet mit der Warnung „insufficient SOL“ fehlschlägt, stelle deine Solana-Wallet auf Testnet-Modus / Devnet ein (siehe die FAQ).

3. Erstelle ein Hardhat-Projekt

mkdir rome-hello && cd rome-hello
npx hardhat --init

Akzeptiere bei der Eingabeaufforderung die Standardwerte — Hardhat 3, das aktuelle Verzeichnis und die TypeScript + Node Test Runner + viem-Vorlage — und lass die Abhängigkeiten installieren. Die Vorlage liefert einen Beispiel- Counter -Contract mit Tests; sie stören diesen Leitfaden nicht.

4. Konfiguriere Hardhat für Rome

Bearbeite die generierte hardhat.config.ts und füge die Rome-Netzwerke in defineConfig({ ... }):

  networks: {
    martius: {
      type: "http",
      chainType: "l1",
      chainId: 121214,
      url: "https://martius.testnet.romeprotocol.xyz/",
      accounts: [configVariable("PRIVATE_KEY")],
    },
    rome_local: {
      type: "http",
      chainType: "l1",
      chainId: 1001,
      url: "http://localhost:9090",
      accounts: [configVariable("PRIVATE_KEY")],
    },
  },

configVariable("PRIVATE_KEY") wird aus der Umgebung aufgelöst, also exportiere deinen MetaMask-Privatkey:

export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"

(Für alles, was über einen Wegwerf-Schlüssel hinausgeht, verwende besser den verschlüsselten Keystore, der mit dem Toolbox-Paket geliefert wird: npx hardhat keystore set PRIVATE_KEY.)

5. Schreibe einen Contract

Erstelle contracts/HelloRome.sol:

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

contract HelloRome {
    string public greeting = "Hallo von Solana!";
    uint256 public counter;

    event Greeted(address indexed sender, uint256 count);

    function greet() external returns (string memory) {
        counter++;
        emit Greeted(msg.sender, counter);
        return greeting;
    }

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

6. Bereitstellen

Erstelle scripts/deploy.ts:

import hardhat from "hardhat";

async function main() {
  const { viem } = await hardhat.network.connect();
  const publicClient = await viem.getPublicClient();

  const hello = await viem.deployContract("HelloRome");
  console.log("HelloRome bereitgestellt unter:", hello.address);

  const hash = await hello.write.greet();
  await publicClient.waitForTransactionReceipt({ hash });

  console.log("Zähler:", (await hello.read.counter()).toString());
  console.log("Begrüßung:", await hello.read.greeting());
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

Bereitstellung auf Martius:

npx hardhat run scripts/deploy.ts --network martius

Erwartete Ausgabe (deine Adresse wird abweichen):

HelloRome bereitgestellt unter: 0x09c437e305eeb698e1776cff23ca16c1bb25aabd
Zähler: 1
Begrüßung: Hallo von Solana!

Öffne die bereitgestellte Adresse im Explorer um die Solana-Instruktionen hinter deiner Transaktion zu sehen. Dein Solidity-Contract läuft jetzt auf Solana.

Wie geht es weiter

• Solidity bereitstellen — Hardhat- und Foundry-Deployment im Detail

• Solana aus der EVM aufrufen — Solana-Programme aus Solidity per CPI aufrufen

• Architektur — wie Rome die EVM innerhalb von Solana ausführt

Häufige Fehler

Fehler	Ursache	Lösung
Unzureichendes Guthaben	Nicht genug Gas-Token — Wallets prüfen im Voraus etwa das 2-Fache der Gas-Schätzung	Lade mindestens 0,5 USDC Gas auf (siehe Schritt 2) über das Rome App oder Bridge
Nonce zu niedrig	Nonce der Transaktion stimmt nicht überein	Setze das Konto zurück (MetaMask → Einstellungen → Erweitert → Aktivität löschen)
execution reverted	Contract-Ausführung fehlgeschlagen	Überprüfe die Contract-Logik; verwende eth_call zum Debuggen
Verbindungs-Timeout	RPC nicht erreichbar	Überprüfe die RPC-URL