Covenant, from zero.

Covenant is a conditional treasury platform. Money is deposited into a shared vault and only moves when a real-world condition is verifiably met — a milestone being delivered, a payroll check-in happening, an insurance incident being declared.

Think of it as programmable escrow. Instead of trusting one person to hold funds and “do the right thing,” the rules for how money is locked, split, and released are enforced on-chain and recorded on a public ledger anyone can audit.

FlowVault is a programmable asset-routing layer on Stacks. It provides a single contract (flowvault-v2) with per-wallet routing rules. When you deposit tokens, FlowVault can automatically:

• Lock an amount until a future block height (a time-lock).
• Split an amount to another address on deposit (auto-routing).
• Hold the remainder as your withdrawable balance.

Covenant uses these primitives — set-routing-rules, deposit, withdraw — as the on-chain engine underneath every vault type.

Here’s the honest, important design detail. FlowVault’s routing rules are fixed at the moment of deposit, and withdraw always pays the depositor back. So the contract cannot natively branch “if the milestone succeeds send here, otherwise refund there.”

Covenant solves this at the application layer with a per-program escrow custodian:

Every one of those steps produces a real transaction id with a clickable Stacks explorer link, so the whole lifecycle is auditable.

git clone <your-repo-url>
cd covenant
npm install
cp .env.example .env       # then edit values (see below)
npm run db:push            # local SQLite; for Vercel use Turso (step 7)
npm run dev

NEXT_PUBLIC_FLOWVAULT_NETWORK=testnet
NEXT_PUBLIC_FLOWVAULT_CONTRACT_ADDRESS=STD7QG84VQQ0C35SZM2EYTHZV4M8FQ0R7YNSQWPD
NEXT_PUBLIC_FLOWVAULT_CONTRACT_NAME=flowvault-v2
NEXT_PUBLIC_FLOWVAULT_TOKEN_CONTRACT_ADDRESS=ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM
NEXT_PUBLIC_FLOWVAULT_TOKEN_CONTRACT_NAME=usdcx
STACKS_PRIVATE_KEY=your_custodian_private_key_here
DATABASE_URL="file:./dev.db"

turso auth signup
turso db create covenant
turso db shell covenant < schema.sql   # creates all tables

# In Vercel -> Settings -> Environment Variables:
TURSO_DATABASE_URL   (turso db show covenant --url)
TURSO_AUTH_TOKEN     (turso db tokens create covenant)
STACKS_PRIVATE_KEY   (your funded custodian key)

No custom smart contract is deployed by you — Covenant consumes the already-deployed flowvault-v2contract. The only “deployment” you do is funding the custodian account. See the custodian pattern above.