About OctoGate
OctoGate is Untangled Finance's permissioning layer for Stellar DeFi. It governs two separate controls:
- Account permissioning: which operations an OpenZeppelin (OZ) smart account is authorized to perform, synthesized from recorded transaction traces.
- Venue permissioning: which venues, markets, and counterparties an account is allowed to reach.
Both components are under active development on Stellar testnet.
Account permissioning: OZ Policy Builder
The OZ Policy Builder is an off-chain toolkit that records a Soroban transaction and synthesises the minimal policy that permits exactly that flow.
Recorded Transaction ──▶ Synthesizer ──▶ OZ Policy ──▶ Install on smart account
(off-chain) │ │
▼ ▼
PolicyIR (intermediate) ProposedPolicy
Key components:
| Package | Role |
|---|---|
@crediolabs/policy-synth | TypeScript synthesis core |
@crediolabs/policy-builder-mcp | MCP server for AI agent integration |
apps/policy-builder-web | Browser UI for the install flow |
apps/policy-builder-cli | CLI for scripted policy authoring |
The tool analyses a transaction trace, extracts the authorized call scope and spending bounds, and compiles them into an OZ-native policy. Where the OZ built-in primitives cannot express a constraint (e.g. per-method scoping or oracle price bounds), those are surfaced as Path B warnings, so the policy keeps every constraint it reports.
Install, on-chain verify, simulate, and the Rust interpreter are later phases.
Venue permissioning gate
The venue permissioning gate controls which venues, markets, and counterparties an account can interact with. It is implemented across three packages:
| Package | Role |
|---|---|
packages/venue-wrapper | Holds restricted-asset wrappers (1:1 wrap of AUTH_REQUIRED + AUTH_REVOCABLE + AUTH_CLAWBACK_ENABLED classic assets) |
packages/venue-market | Facade between the venue-wrapper and a Blend v2 pool, needed because a single InvokeHostFunction cannot atomically wrap-then-supply |
apps/venue-demo-web | Browser UI demonstrating the full venue gate flow on Stellar testnet |
The permissioning itself lives in the wrapper's transfer gate. The venue-market is a pure facade that enforces nothing of its own.
Current state
OctoGate's custody contracts are live on Stellar mainnet through Prime, and an external audit is in progress. Prime contracts on Stellar describes the custody gate, the execution contract and the policy interpreter, and lists their mainnet code. Prime PayFi builds its settlement accounts from these contracts, using newer builds on testnet.
- The OZ Policy Builder is implemented and unit-test-covered: the recorder, the synthesizer, the OZ Accounts adapter (Path A), the MCP server and the CLI.
- The venue permissioning gate (venue-wrapper, venue-market and the Blend v2 integration) is implemented and demonstrated on testnet.
- Install, on-chain verify, simulate, and the Rust interpreter predicate are later phases.