MARK Protocol

Decentralised and privacy-first by design. Leveraging zero-knowledge proofs for secure, scalable settlement on the Superchain.

Code is a rule. No DAO, no drama. Don't Trust, Verify.

The protocol enforces settlement rules on-chain. Whether operators run it as a centralised service or a decentralised network is their choice — the contracts don't care.

Getting Started

Prerequisites

• Foundry
• Node.js + pnpm

1. Clone the repository

git clone https://github.com/trade/mark.git
cd mark

2. Install dependencies

pnpm i

3. Start development

pnpm dev

This will:

• Start a local Superchain network (1 L1 + 2 L2 chains) via supersim
• Launch the frontend at http://localhost:5173
• Deploy contracts to the local network

Branching Policy

Full policy is documented in BRANCHING.md.

• dev — active integration and feature work
• canary — stabilisation, maps to staging deployment
• main — production-ready only
• Release promotion path: dev -> canary -> main
• Production readiness workflow is gated to main

Deploying Contracts

MARK uses super-cli (sup) for contract deployment across the Superchain.

Interactive mode

pnpm sup

Non-interactive mode

pnpm sup deploy create2 --chains supersiml2a,supersiml2b --salt ethers phoenix --forge-artifact-path contracts/out/<Contract>.sol/<Contract>.json --network supersim --private-key <private-key>

Prepare mode (print command without running)

pnpm sup --prepare

Build before deploying

pnpm build:contracts

Overview

Contracts

• RYLA Credits (RYLA) — Superchain-compatible credit token. Mintable and burnable only by the settlement module.
• MARKSettlementModule — Operator-gated settlement boundary with replay protection and optional ZK proof verification.
• MARKBridgeAdapter — Operator-gated bridge adapter routing RYLA cross-chain via SuperchainTokenBridge with rate limits.
• AttestedSettlementVerifier — EIP-712 signature-based verifier for settlement intents.

Tools

• supersim — local Superchain test environment with pre-deployed contracts
• sup (super-cli) — multi-chain deployment with sponsored transactions
• foundry — smart contract development framework
• wagmi / viem — TypeScript libraries for the EVM
• vite / tailwind / shadcn — frontend tooling and UI components

Directory Structure

mark/
├── contracts/          # Smart contract code (Foundry)
├── src/                # Frontend code (vite, tailwind, shadcn, wagmi, viem)
├── public/             # Static assets
├── supersim-logs/      # Local supersim logs
├── package.json        # Project dependencies and scripts
└── mprocs.yaml         # Multi-process dev runner

Debugging

• Full interoperability error signatures: abi-signatures.md
• Common errors:
  • TargetCallFailed(): 0xeda86850
  • MessageAlreadyRelayed: 0x9ca9480b
  • Unauthorized(): 0x82b42900

Resources

• Interop guides: https://docs.optimism.io/app-developers/tutorials/interop
• Superchain Dev Console: https://console.optimism.io/

License

Files are licensed under the MIT license.