TreasuryOS

AI Treasury Intelligence with Owner-Controlled Execution

Analyze treasury risk, generate deterministic execution plans, execute supported onchain actions, and retain verified execution records.

Live Demo • Architecture • Features • Quick Start

---

Overview

TreasuryOS is an AI-native treasury operating system for onchain organizations.

It combines treasury analytics, deterministic execution planning, and verified transaction records into a single workflow.

TreasuryOS is designed around a simple operating model:

Scan
→ Analyze
→ Plan
→ Execute
→ Verify

Unlike autonomous AI agents, TreasuryOS is non-custodial.

Every execution requires explicit wallet approval from the treasury owner.

---

Why TreasuryOS?

Most treasury dashboards stop at reporting.

TreasuryOS extends treasury intelligence into execution by combining portfolio analysis, deterministic execution planning, owner-controlled transactions, and verifiable onchain proof within a single workflow.

Instead of switching between multiple tools, treasury operators can:

• Discover treasury positions
• Understand portfolio risk
• Review AI-assisted recommendations
• Execute supported onchain actions
• Produce verifiable proof of execution

—all from one platform.

---

---

Screenshots

Landing Experience

Choose between analyzing any public treasury or managing your own treasury with owner-controlled execution.

---

Treasury Command Center

Analyze portfolio health, understand risk, and review AI-powered treasury recommendations from a unified dashboard.

---

Execution Workflow

Review deterministic execution plans, simulate transactions, and execute supported treasury actions through explicit wallet approval.

---

Portfolio & Positions

View wallet balances and protocol positions discovered across supported integrations.

---

Proof Trail

Every completed execution is linked to a report hash and verified transaction receipt for an inspectable audit trail.

---

Features

Treasury Intelligence

• Wallet asset discovery
• Protocol position discovery
• Unified treasury portfolio
• Portfolio valuation
• Risk scoring
• Stress simulation
• AI treasury briefing

---

Owner-Controlled Execution

• Deterministic execution planning
• Wallet ownership verification
• Execution simulation
• Wallet-signed execution
• Receipt verification

---

Execution Verification

• Report hashing
• Transaction verification
• Execution history
• Audit trail

---

Current Stage

TreasuryOS Stage 1 is complete.

Current capabilities include:

• Wallet Intelligence
• Uniswap V3 Position Discovery
• Uniswap V3 Swap Execution
• Risk Engine
• Recommendation Engine
• Execution Planner
• Execution Adapter Registry
• Execution verification records

Current network:

• Ethereum Sepolia

---

Architecture

Wallet Adapter
        │
        ▼
Protocol Position Adapters
        │
        ▼
Unified Portfolio
        │
        ▼
Risk Engine
        │
        ▼
Recommendation Engine
        │
        ▼
Execution Planner
        │
        ▼
Execution Adapter Registry
        │
        ▼
Uniswap V3 Execution Adapter
        │
        ▼
Simulation
        │
        ▼
Wallet Signature
        │
        ▼
Execution
        │
        ▼
Receipt Verification
        │
        ▼
Execution History

---

Execution Flow

TreasuryOS follows an owner-controlled execution model.

Connect Wallet
        │
        ▼
Scan Treasury
        │
        ▼
Risk Analysis
        │
        ▼
Recommendation
        │
        ▼
Execution Plan
        │
        ▼
Simulation
        │
        ▼
Wallet Signature
        │
        ▼
Execute Transaction
        │
        ▼
Verify Receipt
        │
        ▼
Save Execution Record

TreasuryOS never executes autonomously.

The connected wallet remains the only transaction signer.

---

Supported Integrations

Wallet Adapter

• Native ETH
• ERC20 balances

Position Adapters

Protocol	Status
Wallet	✅
Uniswap V3 Positions	✅

Execution Adapters

Adapter	Status
Uniswap V3 Router	✅

---

Tech Stack

Layer	Technology
Frontend	Next.js, React, TypeScript, Tailwind CSS
Backend	Next.js Route Handlers
Blockchain	Ethereum Sepolia, Viem
Smart Contracts	Solidity
Database	PostgreSQL, Drizzle ORM
AI	OpenAI
Verification	Viem receipt verification

---

Quick Start

Clone

git clone https://github.com/pk1427/treasuryos.git

cd treasuryos

Install

npm install

Configure

cp apps/web/.env.example apps/web/.env.local

Configure:

SEPOLIA_RPC_URL=

DATABASE_URL=

OPENAI_API_KEY=

NEXT_PUBLIC_CHAIN=sepolia

Run

npm run dev

Open

http://localhost:3000

---

Project Structure

apps/
└── web/
    ├── app/
    ├── components/
    ├── lib/
    └── server/

packages/
├── contracts/
├── indexer/
├── risk-engine/
├── simulator/
└── shared/

---

Roadmap

✅ Stage 1

• Wallet Intelligence
• Unified Portfolio
• Risk Engine
• Recommendation Engine
• Uniswap Position Adapter
• Uniswap Execution Adapter
• Execution Planner
• Execution verification records

---

🚧 Stage 2

• Additional Position Adapters
• Additional Execution Adapters
• Cross-protocol treasury management

---

📈 Stage 3

• Treasury PnL
• Treasury Accounting
• x402 API Monetization

---

Security Principles

TreasuryOS follows four principles.

• Non-custodial
• Owner-controlled execution
• Deterministic planning
• Verifiable onchain proof

TreasuryOS never holds user funds.

---

License

MIT