Initial commit of kurtosis-cdk

Author: AlexChetverov

.gitignore

@@ -28,4 +28,21 @@ templates/contract-deploy/combined.json
 templates/contract-deploy/dynamic-kurtosis-allocs.json
 templates/contract-deploy/dynamic-kurtosis-conf.json
 templates/contract-deploy/genesis.json
-anvil_state.json
+anvil_state.json
+node_modules
+.env
+
+# Hardhat files
+/cache
+/artifacts
+
+# TypeChain files
+/typechain
+/typechain-types
+
+# solidity-coverage files
+/coverage
+/coverage.json
+
+# Hardhat Ignition default folder for deployments against a local node
+ignition/deployments/chain-31337

README.md

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+
+contract PrecompileWrapper {
+    address constant SHA256_PRECOMPILE = 0x0000000000000000000000000000000000000002;
+
+    function sha256ViaPrecompile(bytes memory input) public view returns (bytes32) {
+        (bool success, bytes memory result) = SHA256_PRECOMPILE.staticcall(input);
+        require(success, "Precompile call failed");
+
+        return abi.decode(result, (bytes32));
+    }
+}

contracts/PrecompileWrapper.sol

@@ -0,0 +1,16 @@
+import { HardhatUserConfig } from "hardhat/config";
+import "@nomicfoundation/hardhat-toolbox";
+
+const config: HardhatUserConfig = {
+  solidity: "0.8.28",
+  networks: {
+    erigon: {
+      url: "http://127.0.0.1:54906",
+      accounts: ["0x12d7de8621a77640c9241b2595ba78ce443d05e94090365ab3bb5e19df82c625"], // account address (from Kurtosis README)
+      gas: 3_000_000, // fixed gas limit
+      gasPrice: 1_000_000_000, // required to force legacy Tx (no EIP-1559)
+    }
+  }
+};
+
+export default config;

hardhat.config.ts

@@ -0,0 +1,20 @@
+// This setup uses Hardhat Ignition to manage smart contract deployments.
+// Learn more about it at https://hardhat.org/ignition
+
+import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
+
+const JAN_1ST_2030 = 1893456000;
+const ONE_GWEI: bigint = 1_000_000_000n;
+
+const LockModule = buildModule("LockModule", (m) => {
+  const unlockTime = m.getParameter("unlockTime", JAN_1ST_2030);
+  const lockedAmount = m.getParameter("lockedAmount", ONE_GWEI);
+
+  const lock = m.contract("Lock", [unlockTime], {
+    value: lockedAmount,
+  });
+
+  return { lock };
+});
+
+export default LockModule;

ignition/modules/Lock.ts

@@ -0,0 +1,29 @@
+[
+  {
+    "stage": "1",
+    "description": "Raw Precompile Call",
+    "txHash": null,
+    "receiver": "0x0000000000000000000000000000000000000002",
+    "input": "0x47617465776179",
+    "decodedOutput": "0x41ed52921661c7f0d68d92511589cc9d7aaeab2b5db49fb27f0be336cbfdb7df",
+    "verdict": "pass"
+  },
+  {
+    "stage": "2",
+    "description": "Contract Wrapper Deployment",
+    "txHash": "0x89a2aa0b4597097161faa499ba8aa1cd2d3ac752198a417707165f2682969444",
+    "receiver": "0x62bf798EdaE1B7FDe524276864757cc424A5c3dD",
+    "decodedOutput": null,
+    "verdict": "pass"
+  },
+  {
+    "stage": "3",
+    "description": "Contract Invocation",
+    "txHash": null,
+    "receiver": "0x62bf798EdaE1B7FDe524276864757cc424A5c3dD",
+    "input": "sha256ViaPrecompile(\"Gateway\")",
+    "decodedOutput": "0x41ed52921661c7f0d68d92511589cc9d7aaeab2b5db49fb27f0be336cbfdb7df",
+    "expectedOutput": "0x41ed52921661c7f0d68d92511589cc9d7aaeab2b5db49fb27f0be336cbfdb7df",
+    "verdict": "pass"
+  }
+]

results.json

@@ -0,0 +1,4 @@
+[ZoneTransfer]
+ZoneId=3
+ReferrerUrl=https://chatgpt.com/
+HostUrl=https://files.oaiusercontent.com/file-KYd8rjQM3bSc2oynRBZ1ft?se=2025-05-19T13%3A15%3A34Z&sp=r&sv=2024-08-04&sr=b&rscc=max-age%3D299%2C%20immutable%2C%20private&rscd=attachment%3B%20filename%3Dresults.json&sig=0EXzjLwCg6ikMA6g7sOzqjxyA0mfwrd/7fI3DktSzyw%3D

results.json:Zone.Identifier

@@ -0,0 +1,26 @@
+import { ethers } from "hardhat";
+
+const provider = new ethers.JsonRpcProvider("http://localhost:54906");
+
+const precompileType = {
+  address: "0x0000000000000000000000000000000000000002",
+  name: "SHA256"
+};
+
+const inputData = "0x47617465776179"; // "Gateway"
+
+async function callPrecompile(type: { address: string; name: string }, data: string): Promise<void> {
+  try {
+    const tx = {
+      to: type.address,
+      data: data
+    };
+
+    const result: string = await provider.call(tx);
+    console.log(`${type.name} result for ${inputData} is: ${result}`);
+  } catch (err) {
+    console.error("Error calling precompile:", err);
+  }
+}
+
+callPrecompile(precompileType, inputData);

scripts/callRawPrecompile.ts

@@ -0,0 +1,27 @@
+import { JsonRpcProvider, Wallet, Contract } from "ethers";
+import fs from "fs";
+import * as dotenv from "dotenv";
+dotenv.config();
+
+// Replace with actual values
+const CONTRACT_ADDRESS = "0xB49fA7dD4d70F773015a9c848A8719FA86D81275"; 
+const RPC_URL = "http://127.0.0.1:54906";
+const PRIVATE_KEY = "0x12d7de8621a77640c9241b2595ba78ce443d05e94090365ab3bb5e19df82c625"; // private key (from Kurtosis README)
+
+const artifact = JSON.parse(fs.readFileSync("artifacts/contracts/PrecompileWrapper.sol/PrecompileWrapper.json", "utf8"));
+const ABI = artifact.abi;
+
+async function main() {
+  const provider = new JsonRpcProvider(RPC_URL);
+  const wallet = new Wallet(PRIVATE_KEY, provider);
+  const precompileWrapper = new Contract(CONTRACT_ADDRESS, ABI, wallet);
+
+  const input = new TextEncoder().encode("Gateway"); // "Gateway" => bytes
+  const result = await precompileWrapper.sha256ViaPrecompile(input);
+
+  console.log("SHA256 of 'Gateway' via precompile:", result);
+}
+
+main().catch((err) => {
+  console.error("Error in script execution:", err);
+});

scripts/contractInvocation.ts

@@ -0,0 +1,21 @@
+import { ethers } from "hardhat";
+
+async function main() {
+  const [deployer] = await ethers.getSigners();
+  console.log("Deploying contract with:", deployer.address);
+
+  const Wrapper = await ethers.getContractFactory("PrecompileWrapper");
+
+  // Deploy with explicit gas limit and legacy type (type: 0)
+  const txResponse = await Wrapper.deploy({ gasLimit: 1_000_000, type: 0 });
+  const contract = await txResponse.waitForDeployment();
+
+  // Access from txResponse instead of contract to avoid undefined error
+  console.log("PrecompileWrapper deployed to:", contract.target);
+  console.log("Deployment tx hash:", txResponse.deploymentTransaction()?.hash);
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});