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:3000Run 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 --releaseRepository 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