Prime contracts on Stellar
Untangled Prime runs on OctoGate contracts. A Prime Account is an OpenZeppelin smart account on Stellar; OctoGate adds the custody gate, the execution contract and the policy interpreter that let an agent use custody's funds under rules the account checks on chain. How Prime works explains what each one does for a user. This page lists the properties a reviewer needs and the code the contracts run on mainnet.
Custody gate
- Fixed at creation: the address list, the minimum wait and run window, and the optional recovery address. The gate has no admin and no settings, so a different list means a new gate.
- Changeable by custody at any time: the allowance for each asset, which custody can raise, lower or revoke. A move the allowance does not cover fails, whatever the account's rules allow.
- One caller: only one Prime Account's execution contract can call the gate.
Execution contract
- Atomic: a move's calls run as one transaction, so if one call fails none take effect.
- Stored moves: a move that has to wait is stored on chain, can be cancelled by custody or the account's signers, and lapses after the gate's run window.
- Paired with its gate: the gate answers only to this execution contract.
Policy interpreter
Spending limits and threshold approvals use OpenZeppelin's policy contracts. Conditions those cannot express, such as a venue, a method and an amount band per move, are judged by the policy interpreter, which is our own contract.
Recovery path
A recovery runs under the account's own authority, which no rule checks. The gate still pays only addresses on its list, which also holds the Prime Account, custody and the venues, so at the account's full approval count its signers can draw custody's funds to any of those, within custody's allowance. How Prime works covers the user side.
Prime PayFi
Prime PayFi builds its settlement account and POT Mint Account as OpenZeppelin smart accounts with the same custody gate design and a gated execution contract. On testnet it also uses two parts that are not on mainnet yet:
- a newer execution contract build that can run with no custody gate (the gate-free execution contract), which carries liquidations and the take inside a take-over;
- a newer policy interpreter version whose rules can read the lending market's debt, token balances and oracle prices while the account authorises a call.
Neither appears in the mainnet table below.
Third-party code
Spending limits and threshold approvals use OpenZeppelin's example contracts, built from OpenZeppelin's source and deployed by us. OpenZeppelin publishes them as experimental. Our internal review covered OctoGate, and these OpenZeppelin contracts sat outside its scope.
The policy interpreter that evaluates your rules is our own. Its address and code hash are in the table below, so you can check what the account is running.
Mainnet contracts
| Address or code hash | |
|---|---|
| Prime Account code (OpenZeppelin smart account) | 91a2cd56… |
| Policy interpreter address | CAOBQ4ZXANKXAGEJWJLIGQJDFCTHMEZVUPLPX277KSDMEU4MEWVVXO2R |
| Policy interpreter code | 5143e641… |
| Custody gate code | b01024f3… |
| Execution contract code | 3dd675c0… (earlier setups run 68d012e7…) |
| Spending limit policy (OpenZeppelin) | CA7IBD266HIHFDUIBZLPIAITJUA3DVY4JAG6K3QMGBKLZCXXLP5E2F7A |
| Simple threshold policy (OpenZeppelin) | CDOGPGUFGGUDG25P3TG6XIXJKRRYOZ3PXUZIEPVH74KXRZIDKZ5HYEOS |
| Weighted threshold policy (OpenZeppelin) | CDWPZ4YZ3YIJ64XSHRMERRF2L2H7XD6SPUZDP3KI56T7QXQCICC25V3J |
When you set up your Prime Account, gate and execution contract, each is created from this code and gets its own address. The app refuses a gate or execution contract that runs any other code. Full hashes and the deployment transactions are in the mainnet deployment record in the oz-policy-builder repository.
The interpreter, gate and execution contract have no admin and no upgrade function, so the wallet that uploaded their code and created the interpreter has no control over them.
Audit status
OctoGate has been through our internal adversarial review and threat modelling. An external audit is in progress.