strata-vault-kit

White-label tokenized vault on Stellar. An approved investor deposits USDC and receives a share token representing their position; they return it and get their USDC back.

Two rules the contract enforces:

1. Only approved addresses can enter — an allowlist maintained post-KYC.
2. Exit is always allowed, even for a de-listed holder. Funds are never trapped.

Status

Milestone 1 is in progress: no yield, 1 in / 1 out. Testnet only.

Work is tracked in milestone M1 — White-label vault. Nothing here is production-ready, and nothing here has been audited.

This README is a placeholder. The product README, architecture.md and the operator runbook land in issue #18.

Development

Two ways to get a working toolchain.

With Nix (recommended)

nix develop              # pinned Rust + stellar-cli + wabt/twiggy/tlaplus + prek
stellar contract build   # build the contract wasms (not `cargo build` — OZ spec-shaking)
cargo test               # run the workspace unit tests

With direnv + nix-direnv, echo 'use flake' > .envrc && direnv allow loads the shell — and your editor's language server — automatically.

Without Nix

rustup show                                # installs the toolchain pinned in rust-toolchain.toml
rustup target add wasm32v1-none            # Soroban's wasm target
cargo install --locked stellar-cli@27.0.0  # or: brew install stellar-cli
stellar contract build && cargo test

Formatting and secret-scanning run on commit via a prek hook — see .pre-commit-config.yaml and run prek install once.

Reference base

Built on our own stellar-vault-demo-dapp, a working testnet demo. This repo is the productized version of it: code moves across deliberately, with the roles, pause and configuration the demo never had.