Back to z4p

Documentation

For Developers

z4p is an open-source Rust workspace. The best place to start is the z4p repository.

Architecture

  • CoreHarness — Tick scheduling, agent orchestration, tool routing
  • MarkdownVault — File-based bible with FTS5 retrieval
  • PermissionEngine — Policy evaluation, allowance checks, halts
  • Gateway — Axum HTTP API, /vault UI, and MCP endpoint
  • Loop blueprints — Reusable on-chain runners (price_watcher, wallet_monitor, ...)

Extending z4p

  • Add a skill by defining a new tool callable from agent ticks.
  • Add a loop by implementing a scoped bot blueprint.
  • Add an MCP server to expose external data or execution venues.

API

The local gateway exposes endpoints for vault, bots, trades, and MCP tool routing. Run z4p gateway and explore /vault or the OpenAPI docs in the repo.