Skip to content

MixasV/aicetro-contracts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Aicetro Smart Contracts

Monad Solidity License Hackathon

Trustless AI-Powered Treasury Management for Corporate DeFi

Aicetro enables corporate smart accounts to delegate limited treasury management permissions to AI agents without introducing admin backdoors or trusted intermediaries. All delegation rules are enforced on-chain, and users retain full control with instant emergency stop and revocation capabilities.


πŸ† Built for Monad Builder's Cup

This project is submitted to the MetaMask Smart Accounts x Monad Dev Cook Off and utilizes all four required technologies:

  • βœ… Monad Testnet - Smart contracts deployed and verified
  • βœ… OpenRouter - Multi-provider AI integration (Claude, GPT-4, DeepSeek)
  • βœ… Envio - Real-time blockchain indexing via HyperIndex

πŸ“‹ Table of Contents


🎯 Overview

Traditional DeFi treasury management requires either:

  1. Manual operations - Time-consuming, requires 24/7 monitoring
  2. Multi-sig with AI - Introduces trusted parties and delays
  3. Admin keys - Centralization risk, potential for exploitation

Aicetro's Solution:

  • βœ… Trustless delegation - AI agent has limited permissions granted by user
  • βœ… On-chain enforcement - All limits and rules enforced by smart contracts
  • βœ… Zero admin keys - No one (including team) can override user decisions
  • βœ… Instant revocation - User can stop AI at any moment
  • βœ… Emergency stop - One-click pause for any suspicious activity

πŸ“œ Smart Contracts

Core Contracts

1. TrustlessDeFiTreasury.sol

Main delegation manager that enforces all trustless guarantees.

Key Functions:

// Grant limited permissions to AI agent
function grantDelegation(
    address aiAgent,
    uint256 dailyLimitUSD,
    address[] calldata allowedProtocols,
    uint256 validUntil
) external;

// AI agent executes on behalf of user (within limits)
function executeForUser(
    address user,
    address protocol,
    bytes calldata data,
    uint256 amountUSD
) external;

// User instantly revokes all permissions
function revokeDelegation() external;

// User pauses AI agent immediately
function emergencyStop() external;

Features:

  • Daily spending limits (reset every 24 hours)
  • Protocol whitelist (only approved DeFi protocols)
  • Time-based expiration (delegation auto-expires)
  • Spent amount tracking (transparent usage)

2. CorporateTreasuryManager.sol

Multi-account management for institutional users.

Key Functions:

// Create corporate account for delegation
function createAccount(
    string calldata name,
    address owner
) external returns (address);

// Get all accounts for an owner
function getAccountsByOwner(
    address owner
) external view returns (address[] memory);

Features:

  • Multiple treasury accounts per institution
  • Separate delegations per account
  • Unified management interface

3. EmergencyController.sol

Additional security layer for emergency situations.

Key Functions:

// Global emergency stop (user-controlled)
function triggerEmergency(address user) external;

// Check if account is in emergency mode
function isEmergency(address user) external view returns (bool);

Features:

  • User-initiated emergency mode
  • Cannot be triggered by admins or third parties
  • Prevents all AI executions until user resolves

Supporting Contracts

4. AIAgentExecutor.sol

Helper contract for AI agent transaction execution.

5. ProtocolWhitelist.sol

Manages approved DeFi protocols for delegation.

6. RiskLimiter.sol

Additional risk management and limit enforcement.


✨ Key Features

πŸ” Trustless Architecture

  • Zero admin keys - No one can override user decisions
  • On-chain enforcement - All limits verified by smart contracts
  • User sovereignty - Full control remains with account owner

⚑ Instant Control

  • Emergency stop - One-click pause for suspicious activity
  • Instant revocation - Remove all AI permissions immediately
  • Real-time monitoring - Track every AI action on-chain

πŸ“Š Transparent Operations

  • Daily limit tracking - See exactly how much AI has spent
  • Protocol whitelist - Control which DeFi protocols AI can use
  • Time-based expiration - Delegations automatically expire

πŸ›‘οΈ Risk Management

  • Daily spending caps - Prevent excessive losses
  • Protocol restrictions - Limit exposure to specific protocols
  • Automatic reset - Limits refresh every 24 hours

🌐 Deployed Contracts (Monad Testnet)

Contract Address Verified
TrustlessDeFiTreasury 0x98691ae190682dddBde3cd4c493B2249D2086E5B βœ… View
CorporateTreasuryManager 0x98691ae190682dddBde3cd4c493B2249D2086E5B βœ… View
EmergencyController 0x4BE4FE572bAce94aaFF05e4a0c03ff79212C20e5 βœ… View

Network Details:


πŸ—οΈ Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    User Smart Account                    β”‚
β”‚                  (Corporate Treasury)                    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚
                         β”‚ Grants Limited Delegation
                         β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚            TrustlessDeFiTreasury Contract               β”‚
β”‚                                                          β”‚
β”‚  β€’ Daily Limit: $50,000                                 β”‚
β”‚  β€’ Allowed Protocols: [Nabla, Lynx, Infinex]          β”‚
β”‚  β€’ Valid Until: 30 days                                 β”‚
β”‚  β€’ Emergency Stop: Active                               β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚
                         β”‚ AI Agent Executes (within limits)
                         β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  DeFi Protocols                         β”‚
β”‚                                                          β”‚
β”‚  β€’ Nabla Finance (Lending)                             β”‚
β”‚  β€’ Lynx (Yield Aggregator)                             β”‚
β”‚  β€’ Infinex (Perps Trading)                             β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Flow:

  1. User grants delegation with specific limits
  2. AI agent analyzes markets and generates recommendations
  3. AI executes approved strategies (contract validates limits)
  4. User monitors all actions and can stop/revoke at any time

πŸ”’ Security Guarantees

What Aicetro CANNOT Do:

  • ❌ Override user decisions
  • ❌ Bypass daily limits
  • ❌ Use non-whitelisted protocols
  • ❌ Continue after emergency stop
  • ❌ Prevent user revocation
  • ❌ Access funds after expiration

What Users CAN Do:

  • βœ… Revoke delegation instantly (1 transaction)
  • βœ… Emergency stop (1 transaction)
  • βœ… Change limits at any time
  • βœ… Add/remove protocols
  • βœ… Extend or shorten expiration
  • βœ… Monitor all AI actions on-chain

Verified Security Properties:

  • βœ… No admin keys - Code is immutable
  • βœ… No upgradability - No proxy patterns
  • βœ… No timelocks - Instant user control
  • βœ… No multi-sig required - Direct user actions
  • βœ… No off-chain dependencies - Pure on-chain logic

πŸ› οΈ Installation

Prerequisites

Setup

# Clone the repository
git clone https://github.com/MixasV/aicetro-contracts.git
cd aicetro-contracts

# Install dependencies
pnpm install

# Compile contracts
pnpm hardhat compile

πŸš€ Usage

Deploy to Monad Testnet

  1. Create .env file:
MONAD_RPC_URL=https://testnet-rpc.monad.xyz
DEPLOYER_PRIVATE_KEY=your_private_key_here
  1. Deploy contracts:
pnpm hardhat run scripts/deploy.ts --network monadTestnet
  1. Verify on MonadScan:
pnpm hardhat verify --network monadTestnet <CONTRACT_ADDRESS>

Grant Delegation (Example)

const treasury = await ethers.getContractAt(
  'TrustlessDeFiTreasury',
  TREASURY_ADDRESS
);

// Grant AI agent permission for 30 days
await treasury.grantDelegation(
  AI_AGENT_ADDRESS,
  ethers.parseUnits("50000", 18), // $50K daily limit
  [NABLA_ADDRESS, LYNX_ADDRESS],  // Allowed protocols
  Math.floor(Date.now() / 1000) + 30 * 24 * 60 * 60 // 30 days
);

Emergency Stop (Example)

// Instantly pause AI agent
await treasury.emergencyStop();

// Or completely revoke delegation
await treasury.revokeDelegation();

πŸ§ͺ Testing

# Run all tests
pnpm hardhat test

# Run with gas reporting
REPORT_GAS=true pnpm hardhat test

# Run coverage
pnpm hardhat coverage

πŸ“Š Contract Sizes

Contract Size Optimized
TrustlessDeFiTreasury ~10 KB βœ…
CorporateTreasuryManager ~4 KB βœ…
EmergencyController ~2 KB βœ…

All contracts are within the 24 KB deployment limit.


πŸ”— Related Links

  • Live Demo: [Coming Soon]
  • Full Platform: Private repository (backend + frontend)
  • Documentation: See main project README
  • Hackathon Submission: Monad Builder's Cup

🀝 Contributing

This repository contains only the smart contracts for transparency and security auditing. The full platform (backend AI engine and frontend) is in a private repository.

For security researchers:

  • Bug reports welcome via GitHub Issues
  • Responsible disclosure for critical vulnerabilities

πŸ“„ License

MIT License - See LICENSE file for details.

Note: Smart contracts are open-source for transparency and trustless verification. The AI execution logic and backend infrastructure are proprietary.


⚠️ Disclaimer

Testnet Deployment Only

These contracts are currently deployed on Monad Testnet for hackathon demonstration purposes.

DO NOT USE WITH REAL FUNDS.

A professional security audit is required before any mainnet deployment.


πŸ“ž Contact

  • Developer: @MixasV
  • Project: Aicetro (DeFiTreasury AI)
  • Hackathon: Monad Builder's Cup 2025

πŸ™ Acknowledgments

  • Monad Foundation - For the Builder's Cup hackathon and testnet infrastructure
  • OpenRouter - For AI provider aggregation
  • Envio - For blockchain indexing capabilities
  • OpenZeppelin - For battle-tested smart contract libraries

Built with ❀️ for trustless DeFi treasury management

Securing institutional treasuries without compromising decentralization

About

Trustless AI-Powered Treasury Management - Smart Contracts

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors