Solidity-Verträge bereitstellen

Dieser Leitfaden behandelt die Bereitstellung von Solidity-Smart-Contracts auf Rome EVM mit Hardhat und Foundry.

Voraussetzungen

• Node.js v18+ (Hardhat) oder Foundry installiert

• Eine mit Guthaben versehene Rome-EVM-Adresse (siehe Schnellstart)

• Ihr privater Schlüssel als Umgebungsvariable exportiert

export PRIVATE_KEY="0xYOUR_PRIVATE_KEY"

Netzwerkkonfiguration

Netzwerk	RPC-URL	Chain-ID
Lokal	http://localhost:9090	1001
Devnet (montispl)	https://montispl.devnet.romeprotocol.xyz	200002
Testnet (Martius)	https://martius-i.testnet.romeprotocol.xyz	121214
Testnet (Caelian)	https://caelian-i.testnet.romeprotocol.xyz	121215

Hardhat

Einrichtung

mkdir my-rome-project && cd my-rome-project
npm init -y
npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox
npx hardhat init

hardhat.config.js

require("@nomicfoundation/hardhat-toolbox");

module.exports = {
  solidity: {
    version: "0.8.28",
    settings: {
      optimizer: { enabled: true, runs: 200 },
    },
  },
  networks: {
    rome_local: {
      url: "http://localhost:9090",
      chainId: 1001,
      accounts: [process.env.PRIVATE_KEY],
    },
    rome_devnet: {
      url: "https://montispl.devnet.romeprotocol.xyz",
      chainId: 200002,
      accounts: [process.env.PRIVATE_KEY],
    },
    rome_martius: {
      url: "https://martius-i.testnet.romeprotocol.xyz",
      chainId: 121214,
      accounts: [process.env.PRIVATE_KEY],
    },
    rome_caelian: {
      url: "https://caelian-i.testnet.romeprotocol.xyz",
      chainId: 121215,
      accounts: [process.env.PRIVATE_KEY],
    },
  },
};

Bereitstellen

npx hardhat run scripts/deploy.js --network rome_devnet

Auf Block-Explorer verifizieren

npx hardhat verify --network rome_martius 0xCONTRACT_ADDRESS

Foundry

Einrichtung

forge init my-rome-project
cd my-rome-project

Bereitstellen

# Lokal
forge create --rpc-url http://localhost:9090 \
  --private-key $PRIVATE_KEY \
  src/Counter.sol:Counter

# Entwicklungsnetz
forge create --rpc-url https://montispl.devnet.romeprotocol.xyz \
  --private-key $PRIVATE_KEY \
  src/Counter.sol:Counter

Bereitgestellten Vertrag aufrufen

# Lesen
cast call 0xCONTRACT_ADDRESS "number()" \
  --rpc-url https://montispl.devnet.romeprotocol.xyz

# Schreiben
cast send 0xCONTRACT_ADDRESS "increment()" \
  --rpc-url https://montispl.devnet.romeprotocol.xyz \
  --private-key $PRIVATE_KEY

Verwendung des Rome Solidity SDK

Für Verträge, die mit Solana-Programmen interagieren, installieren Sie das Rome Solidity SDK:

npm install @rome-protocol/solidity-sdk

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

import {SplToken, CpiProgram, SystemProgram} from "@rome-protocol/solidity-sdk/contracts/core/Precompiles.sol";
import {SPL_ERC20} from "@rome-protocol/solidity-sdk/contracts/token/ERC20SPL.sol";
import {RomeEVMAccount} from "@rome-protocol/solidity-sdk/contracts/core/RomeEVMAccount.sol";

contract MyRomeContract {
    // Das SPL-Token-Guthaben des Benutzers von Solana lesen
    function getSolanaBalance(bytes32 mint) external view returns (uint64) {
        bytes32 userPda = RomeEVMAccount.pda(msg.sender);
        ISplToken.Account memory account = SplToken.account_state(userPda);
        return account.amount;
    }

    // Beliebiges Solana-Programm per CPI aufrufen
    function callSolanaProgram(
        bytes32 programId,
        ICrossProgramInvocation.AccountMeta[] calldata accounts,
        bytes calldata data
    ) external {
        CpiProgram.invoke(programId, accounts, data);
    }
}

Bereitstellungsbeschränkungen

Einschränkung	Grenze	Hinweise
Maximale Contractgröße	480 KB	Erhöht gegenüber Ethereums 24 KB für den OP-Geth-Modus
Transaktionsgrößenlimit	80 KB pro Holder-Konto	Große Bereitstellungen werden transparent über Holder-Konten aufgeteilt
Compute-Budget	~1,4 Mio. CU (atomar)	Verwenden Sie den iterativen Modus für umfangreiche Verträge
Solidity-Version	0.8.28 empfohlen	Frühere Versionen funktionieren, aber 0.8.28 passt zum SDK

Häufige Fehler

Fehler	Ursache	Lösung
Unzureichendes Guthaben für Gas	Die EVM-Adresse hat kein Guthaben	Zahle SOL über die Einzahlungs-UI ein
Nonce zu niedrig	Veralteter Nonce in der Wallet	MetaMask-Konto zurücksetzen oder den Nonce manuell angeben
Ausführung zurückgesetzt	Vertragslogik fehlgeschlagen	Debuggen mit eth_call oder forge test --fork-url
Transaktion zu niedrig bepreist	Gaspreis unter dem Minimum	Gaspreis in der Transaktion erhöhen

Was kommt als Nächstes

• Solana aus EVM aufrufen — verwenden Sie CPI-Precompiles, um mit Solana-Programmen zu interagieren

• Token-Wrapping — ERC-20-Wrapper für SPL-Token bereitstellen

• CU-Optimierung — verringern Sie den Verbrauch von Compute-Einheiten