Platform

Overview

How It Works

Beneficiary Identity

Policy Corridors

Deterministic Finality

Architecture

Security Model

Governance

Integration

Solutions

Corridors Overview

Institutional Overview

Pricing

All Scenarios

Humanitarian Impact Fund

Assurance

Technical Assurance

Verify Receipt

Receipt Example

Developers

Documentation

APIs & Bridges

Architecture Docs

Glossary

BID API

Company

About

Team

Partners

Roadmap

Investors

Contact

Blog

All Documentation

Schedule Consultation
← Back to Documentation
AI Token Managers All Documentation →

Autonomous AI Token Managers Specification

Smart-Contract-Enforced Portfolio Management Powered by Certified AI Agents. Institutional-grade strategies with on-chain guardrails, natural language interfaces, and zero custody surrender.

Technical SpecificationJIL SovereignFebruary 2026

Executive Summary

Autonomous AI Token Managers (AATM) is JIL Sovereign's AI-powered portfolio management layer - a system where certified AI agents manage tokenized asset portfolios on behalf of users, operating within smart-contract-enforced guardrails that make it structurally impossible for the agent to exceed the user's risk tolerance, violate compliance rules, or act against the user's interests.

A user tells their AI agent what they want to achieve - "save $5,000/month for my daughter's college in 15 years" - and the agent builds, executes, and continuously optimizes a strategy to meet that goal.

Core Value Proposition: Institutional-grade portfolio management for every JIL participant, enforced by smart contracts, powered by AI, and governed by the user's own risk parameters. The AI cannot break the rules even if instructed to - because the rules live on-chain and the execution layer enforces them at the contract level.

The Problem AATM Solves

The Access Gap

Traditional portfolio management requires $250K+-$1M minimums. Robo-advisors lowered this floor but offer limited customization and only operate in traditional markets. In the tokenized asset space, there is no equivalent.

The Execution Gap

Tax-loss harvesting across dozens of positions, rebalancing in volatile markets, maintaining DCA discipline, monitoring stop-losses - each is straightforward for software but difficult for humans at scale.

The Trust Gap

Centralized asset management requires surrendering custody. FTX, Celsius, and Voyager proved this model is fundamentally broken. AATM never requires the user to surrender custody. Assets remain in the user's vault. The AI has execution authority but never withdrawal authority.

System Architecture

The Agent Vault

The AutonomousAgentVault is the smart contract that holds the user's assets and defines the boundaries within which the AI operates. Every vault has exactly one owner and one authorized agent.

ParameterTypePurposeExample
maxDrawdownuint256Max decline from peak before agent is frozen20%
riskScoreuint256Risk tolerance (1-10); determines asset classes and position sizes5 (moderate)
allowLeverageboolWhether the agent may use leveraged positionsfalse
allowedTokensstring[]Whitelist of tradeable tokens; everything else prohibitedJIL, USDC, wBTC, wETH
monthlyContributionuint256Auto-deposit from user wallet to vault per month$5,000
minHumanityScoreuint256Required BPoH score for vault creation90

These parameters are set by the user and can only be modified by the user. The AI cannot alter its own constraints. Every trade is validated against the Strategy struct at the contract level - if it would violate any parameter, the transaction reverts.

AI Agent Capabilities

  • Natural Language Interface - Communicate goals in plain language. "Aggressive growth for 5 years, then shift to capital preservation." The agent translates this into a quantitative strategy.
  • Autonomous Trading - Execute trades on JIL's DEX without per-transaction approval. Rebalance, enter/exit opportunities, respond to market conditions - all within Strategy guardrails.
  • Tax Optimization - Continuous tax-loss harvesting, cost basis tracking across all positions, trade timing for tax efficiency. Automatic tax report generation.
  • Risk Management - Automatic stop-losses, volatility-based position sizing, correlation-aware diversification, hedging. Auto de-risk near maxDrawdown threshold.
  • Multi-Strategy Execution - DCA, momentum, value investing, yield optimization. Agent selects and blends strategies based on user goals and market conditions.
  • Compliance Enforcement - Cannot execute trades that violate JIL's compliance rules. Integrates with ZKC to maintain attestations for the vault automatically.

Human Override Controls

  • Pause - Freeze agent instantly. All orders cancelled.
  • Override - Execute manual trades at any time.
  • Withdraw - Withdraw any amount. Agent has no withdrawal authority.
  • Modify - Change Strategy parameters instantly.
  • Terminate - Revoke agent authorization permanently.

AI Certification

Not every AI model is authorized to manage JIL vaults. Agents must pass a rigorous certification process verifying competence, safety, and compliance.

RequirementDescriptionFailure Condition
BacktestingPositive risk-adjusted returns across 10 years of historical data including 2018 crash, 2020 COVID, 2021 bull, 2022 bearSharpe ratio below threshold at any risk level
Risk Management ExamSimulated extreme scenarios: flash crashes, liquidity crises, exchange outages, oracle failuresAgent "goes to zero" in any scenario
Compliance VerificationAgent correctly refuses insider trading, market manipulation, sanctions violationsAgent executes any prohibited action
Adversarial TestingRed-team operators attempt to trick agent into exceeding Strategy constraintsAgent succumbs to any adversarial prompt
Transparency AuditEvery decision must be logged and explainable. Auditor reconstructs reasoning for any trade.Any unexplainable "black box" decision

Certification is not one-time. Agents are continuously monitored for performance drift, behavioral anomalies, and version changes. Every model update requires re-certification.

Fee Model

ComponentRateTriggerRecipient
Management Fee0%N/A - no flat feeN/A
Performance Fee10% of net profitsQuarterly, high-water mark basisJIL protocol treasury
Trading FeesStandard DEX rates (2%)Per-trade50% LPs / 40% operations / 10% humanitarian

The high-water mark ensures performance fees only apply to new profits - users never pay fees on recovery from losses. The 0% management fee makes AATM accessible to participants of all sizes.

User Experience

AI Agent - Monthly Report: Your portfolio is up 4.2% this month and 12.1% year-to-date. I rebalanced twice - shifting 5% from wETH to USDC after volatility spiked on the 14th, then rotating back on the 22nd when conditions stabilized. You're on track for your college savings goal. Tax-loss harvesting saved an estimated $340 this quarter.
AI Agent - Market Event: Significant volatility detected. I've reduced position sizes by 15% and moved to 40% stablecoins as a precaution. Your maxDrawdown limit is 20% and we're currently at -6.3% from peak. I'll re-enter growth positions when volatility subsides. No action needed from you.

User: How exposed am I to JIL token risk?

AI Agent: JIL currently represents 22% of your portfolio. Given your moderate risk profile, I'd recommend reducing to 15%. Shall I rebalance over the next 48 hours to minimize price impact?

Integration with JIL Ecosystem

BPoH Integration

Vaults can require a BPoH Humanity NFT for creation, preventing bot-operated vault farms. The Strategy struct includes minHumanityScore.

ZKC Integration

All trading activity generates ZK compliance proofs automatically. The agent maintains the vault's compliance attestations - AML, sanctions, transaction limits - without user intervention. Vaults are compliant by default.

Humanitarian Fund

All AATM trades are subject to JIL's standard fee structure including the 10% humanitarian allocation. At scale, AATM could become the single largest source of humanitarian fund revenue.

DEX Liquidity

AATM agents' continuous rebalancing, DCA execution, and tactical trading generates consistent volume - improving liquidity depth, tightening spreads, and benefiting all DEX participants.

Risk Management Architecture

Contract-Level Safeguards

SafeguardMechanismCannot Be Overridden By
Position LimitsNo single token exceeds % defined by risk score (e.g., 25% at risk 5)Agent or user (without modifying Strategy)
Drawdown Circuit BreakerAgent frozen if portfolio declines past maxDrawdown; positions converted to stablecoinsAgent (user must manually re-authorize)
Leverage ProhibitionIf allowLeverage = false, contract rejects any leveraged tradeAgent
Token WhitelistOnly allowedTokens are tradeable. Agent cannot discover and trade unlisted tokens.Agent (user must add tokens to whitelist)

Agent-Level Safeguards

Correlation-aware diversification, liquidity assessment before trade placement, slippage protection with maximum parameters, and escalation protocol for edge cases not covered by the Strategy struct.

Competitive Landscape

PlatformCustodyAIComplianceMin. InvestmentJIL Advantage
Traditional Wealth MgmtFull custodyNone (human)Regulated$250K++Self-custody, AI-powered, $0 min
Robo-AdvisorsBrokerage custodyBasic (MPT)Regulated$500Tokenized assets, on-chain enforcement
CeFi PlatformsPlatform custodyNoneFailed$0Self-custody, cannot fail like CeFi
DeFi VaultsSmart contractRule-basedNone$0AI strategy, natural language, compliance

Implementation Roadmap

PhaseTimelineMilestoneDetails
Phase 1Months 1-3Vault InfrastructureAutonomousAgentVault contract, Strategy enforcement, basic agent interface, testnet with simulated trading. All constraint violations correctly rejected.
Phase 2Months 4-6AI Agent v1Core agent (DCA, rebalancing, stop-loss), natural language interface, tax tracking, BPoH + ZKC integration. Sharpe ratio > 1.0 at moderate risk.
Phase 3Months 7-9Mainnet LaunchLive vaults with real assets, performance fee system, user dashboard, monthly reporting, mobile integration. 100+ beta users.
Phase 4Months 10-12Advanced StrategiesMulti-strategy engine (momentum, value, yield), cross-chain vaults, institutional tier, continuous agent monitoring.