Deterministic on-chain lifecycle engine modeling semiconductor fabrication — executed entirely through direct contract interaction (no backend layer) built on the XRPL EVM Sidechain Testnet. A fully deployed Solidity contract powering a live Web3 state machine — no backend, no server, one frontend execution layer.
Contract on Explorer → https://explorer.testnet.xrplevm.org/address/0x870201041262975C5b40941e1fE85792Fb2dfF3D
ScreenRecorderProject65.mp4
COHR Lab Simulator — a system-level interface for modeling event-driven workflows that trigger programmable on-chain value routing (USDC/XRP) across coordinated execution stages.
COHR LAB is the operational control layer for a deterministic semiconductor fabrication pipeline deployed on the XRPL EVM Sidechain.
It is not a static dashboard — it is a direct execution interface over a production Solidity state machine.
Through a single frontend surface, operators can:
- create fabrication batches
- advance batches through real manufacturing stages
- attach per-stage process notes
- track full lifecycle timestamps
- audit complete production history on-chain
The system enforces a strict constraint:
No backend. No API. No middleware.
Most Web3 applications rely on off-chain orchestration layers, APIs, and backend services to coordinate execution.
COHR removes that entirely.
This system demonstrates:
- fully deterministic execution without backend infrastructure
- direct UI → contract interaction as the sole control surface
- on-chain lifecycle systems that mirror real-world industrial processes
- verifiable, replayable state transitions without reliance on external systems
This is not a dashboard — it is a control system for programmable reality
UI
→ ethers.js (provider + signer)
→ XRPL EVM Sidechain
→ CohrLab.sol (state machine + lifecycle logic)
- every state transition is immutable
- every lifecycle step is timestamped
- every batch is independently owned
- every history is replayable from events
- ✅ Live contract deployed on XRPL EVM Testnet
- ✅ Deterministic 6-stage fabrication lifecycle
- ✅ Immutable state transitions (no rollback)
- ✅ Per-batch ownership enforcement
- ✅ Indexed event log for full lifecycle replay
- ✅ Terminal states (Complete / Abandoned)
COHR enforces strict invariants at the contract level:
- ✅ A batch can only move forward (no rollback)
- ✅ Only the owner can mutate state
- ✅ Each stage is executed exactly once
- ✅ Terminal states are irreversible
- ✅ Full lifecycle can be reconstructed from events alone
This ensures deterministic, audit-safe execution under all conditions
- ❌ Incorrect gas overrides will cause transaction failure (XRPL EVM limitation)
- ❌ Users must manually confirm every transaction (no relayer layer)
- ❌ No batching — each lifecycle step is a discrete transaction
- ❌ UI does not cache state — all reads come directly from chain
- ❌ Network instability directly impacts execution and UX
- ❌ Frontend dependency — no fallback execution path without UI
- ✅ Explicit gas configuration enforced in all write calls
- ✅ Idempotent contract design (no duplicate state transitions)
- ✅ Event-driven UI reconstruction (stateless frontend)
- ✅ Clear lifecycle boundaries reduce invalid transitions
- ✅ No external contract calls → eliminates reentrancy risk
- ✅ Strict ownership enforcement on all state mutations
- ✅ Bounded state machine → prevents invalid stage transitions
- ✅ No dynamic execution paths → predictable behavior
- ✅ Immutable deployment → no upgrade attack surface
- ❌ No pausable mechanism (cannot halt contract)
- ❌ No emergency admin override
- ❌ No upgrade proxy (logic cannot be modified post-deploy)
Designed for deterministic execution over administrative control
- ✅ createBatch → ~120k gas
- ✅ advanceBatch → ~80k gas
- ✅ setStepNote → ~60k gas
- ✅ Fixed-size arrays reduce dynamic storage overhead
- ✅ uint8 stage encoding minimizes storage footprint
- ✅ No external calls → consistent gas profile
- ✅ Linear lifecycle progression → predictable execution cost
- ✅ No complex loops → bounded computation
Designed for predictable, stable execution per lifecycle step
- ✅ Crystal → Wafer → Epitaxy → Lithography → Testing → Pigtail
- ✅ Per-stage timestamps stored on-chain
- ✅ Operator notes per stage
- ✅ Batch-level ownership model
- ✅ Event-driven audit reconstruction
ScreenRecorderProject64.mp4
This interface exposes direct interaction with the contract lifecycle system, allowing users to create and advance fabrication batches through signed transactions.
Deployed: 0x870201041262975C5b40941e1fE85792Fb2dfF3D
Network: XRPL EVM Sidechain Testnet (Chain ID: 1449000)
Compiler: Solidity 0.8.x
createBatch(string name)
advanceBatch(uint256 id)
abandonBatch(uint256 id)
setStepNote(uint256 id, uint8 step, string note)getBatch(uint256 id)
getBatchSteps(uint256 id)
getBatchCount()
getBatchesByOwner()| Pattern | Implementation |
|---|---|
| Explicit state machine | uint8 stage (0–5) |
| Terminal states | Complete / Abandoned |
| Per-record ownership | batch.owner |
| Fixed arrays | timestamps + notes |
| Indexed events | lifecycle tracking |
| No dependencies | single-file contract |
| Layer | Technology |
|---|---|
| Blockchain | XRPL EVM Sidechain Testnet |
| Smart Contract | Solidity 0.8.x |
| Web3 Provider | Ethers.js v5 |
| Frontend | Vanilla HTML/CSS/JS |
| Hosting | Vercel |
cohr-lab/
├── index.html
├── CohrLab.sol
├── script/
├── README.md
└── LICENSE
COHR LAB is a stateless frontend that interacts directly with a deployed smart contract — no backend required.
git clone https://github.com/zrt219/cohr-lab
cd cohr-lab
npx serve .Open: http://localhost:3000
| Field | Value |
|---|---|
| RPC | https://rpc.testnet.xrplevm.org |
| Chain ID | 1449000 |
| Symbol | XRP |
const overrides = {
gasLimit: 300000,
gasPrice: ethers.utils.parseUnits("100", "gwei"),
type: 0
};- Import repo into Vercel
- Framework: Other
- Build: none
- Output:
./
Static deployment — UI connects directly to XRPL EVM
| Field | Value |
|---|---|
| Network Name | XRPL EVM Testnet |
| RPC URL | https://rpc.testnet.xrplevm.org |
| Chain ID | 1449000 |
| Symbol | XRP |
| Explorer | https://explorer.testnet.xrplevm.org |
- ❌ No
eth_estimateGas - ❌ No
eth_gasPrice
const overrides = {
gasLimit: 300000,
gasPrice: ethers.utils.parseUnits("100", "gwei"),
type: 0
};forge script script/Deploy.s.sol:DeployCohrLab --rpc-url https://rpc.testnet.xrplevm.org --broadcast --legacy -vvvv
| Project | Description | Status |
|---|---|---|
| ZUC Mine Command Center | On-chain uranium mining operations dashboard — real-time reserve tracking, miner registry, and contract interaction via a fully frontend-driven command interface | ✅ Live |
| U235 Fuel Cycle | Nuclear fuel cycle pipeline — uranium ore to enriched fuel rod, deterministic multi-stage processing with full on-chain traceability | ✅ Live |
| ISR Network | Intelligence surveillance reconnaissance system — on-chain asset tracking, mission lifecycle state machine, and role-based operator control | ✅ Live |
| Dark Matter Farm | DeFi yield protocol — experimental high-convexity farming system with custom reward mechanics and on-chain state-driven emissions | ✅ Live |
| COHR LAB | Semiconductor fabrication lifecycle system — deterministic on-chain state machine tracking irreversible production stages from crystal growth to final pigtail with full auditability | ✅ Live |
MIT — see LICENSE