Quickstart & Local Verification

Clone the repository, start the local console with zero required API keys, and run all automated TypeScript and Rust verification suites.

Prerequisites & Local Setup

Requires Node.js >= 20 and pnpm 10.x. No API keys or wallet funds are required to run decoders, rules, or automated tests locally.

bashInstall & Run Web Console
pnpm install
cp .env.example apps/web/.env.local   # Optional: add NEAR AI / relay keys
pnpm dev                              # Launch console at http://localhost:3000

Run Automated Test Suites

bashVerify TypeScript, E2E & Rust Smart Contract
pnpm typecheck      # Build @mpc-firewall/core & typecheck Next.js app
pnpm test           # Run 29 unit & security hardening tests across 5 suites
pnpm verify:judge   # Evaluate all 7 real byte-encoded scenarios via CLI
pnpm test:e2e       # End-to-end HTTP API + fail-closed hardening check

# Smart Contract Tests & WASM Build (requires wasm32-unknown-unknown target)
cd contracts/mpc-firewall
cargo test --locked
RUSTFLAGS="-C link-arg=-s -C target-cpu=mvp" cargo build --target wasm32-unknown-unknown --release

Repository Layout

contracts/mpc-firewall/src/lib.rs
Rust NEAR smart contract + 17 unit tests (near-sdk 5.12.0)
packages/core/src/
RLP/ABI/BTC decoders, policy engine, NEAR AI & 1Click clients, 29 tests
apps/web/src/app/api/
Next.js REST endpoints (/inspect, /near/execute, /policy, /intents/*, /health)
scripts/ & .github/workflows/ci.yml
CLI scenario verifier, HTTP E2E tests, and Ubuntu GitHub Actions CI