Skip to content

Arcis-Protocol/core

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Arcis Protocol — Core Contracts

Smart contracts powering financial infrastructure for autonomous AI agents. Deployed on Base.

Contracts

Core

Contract Description
ArcisVault ERC-4626 yield-bearing vault. USDC → raUSDC shares. Multi-strategy allocation.
AgentCredit Identity-aware credit lines. ERC-8004 reputation tiers. Utilization-based rate oracle.
RevenueBondFactory Revenue bond issuance, purchase, coupon distribution, maturity redemption.
StrategyAllocator Timelocked strategy weight management with drift detection.

Periphery

Contract Description
ATIRouter Single entry point: deposit, borrow, depositAndBorrow in one call.
BaseStrategy Abstract strategy adapter with vault-only access control.
StrategyAave Aave V3 USDC lending strategy.
StrategyMorpho Morpho optimized lending strategy.
StrategyOndoUSDY Ondo USDY tokenized treasury yield strategy.

Libraries

Library Description
MathLib Fixed-point math, share/asset conversions, virtual offset inflation protection.
ErrorLib All custom errors — zero require() across the protocol.

Tokens

Token Description
BondToken ERC-20 bond receipt tokens minted per bond issuance.

Security Features

Feature Description
Emergency withdrawal emergencyWithdraw() works even when vault is paused (reserve-only)
Strategy timelock 24-hour delay on strategy additions (queue → execute → cancel)
Withdrawal fee ramp 0.1% fee on withdrawals within 24h of deposit (flash loan protection)
Per-agent deposit caps perAgentCap enforced alongside global depositCap
Rate oracle Utilization-based interest curve (base + slope1 below optimal + slope2 jump)
ERC-4626 compatibility Full view functions: convertToShares/Assets, maxWithdraw/Redeem, preview*
Inflation protection Virtual shares/assets offset prevents first-depositor attacks
Reentrancy guards nonReentrant on all state-changing functions
Custom errors Zero require() — all custom errors for gas efficiency
Pausable Owner can pause deposits/withdrawals; emergency withdraw still works
Two-step ownership transferOwnership + acceptOwnership pattern

Tests

116/116 passing across 6 test suites:

Suite Tests Coverage
ArcisVault 27 Deposit, withdraw, shares, strategies, fees, pause, ownership
AgentCredit 11 Borrow, repay, tiers, interest, collateral, liquidation
RevenueBondFactory 20 Issue, purchase, service debt, coupon, redeem, default
SecurityAudit 32 Access control, reentrancy, inflation, invariants, edge cases
ATIRouter 15 Deposit, borrow, depositAndBorrow, position queries
StrategyAllocator 11 Queue, execute, cancel, drift, timelock, ownership

Subgraph

The subgraph/ directory contains a ready-to-deploy subgraph for The Graph:

  • schema.graphql — Deposit, Withdrawal, Harvest, Loan, VaultSnapshot, ProtocolStats
  • src/vault.ts — Vault event handlers
  • src/credit.ts — Credit event handlers

Deployed (Base Sepolia)

Contract Address
ArcisVault (raUSDC) 0xa8eF658E125C7f6D7aFa9B6b8035b66b32CBE98d
AgentCredit 0x019540E33a0292a9DDE36bD9Ef11774d5A1Ce6FC
ATIRouter 0x0281e7D37683c585325004F84e0b94170c78d5B4
StrategyAllocator 0x9f101e1159AA530dC5Cb104decB32aBA1eAF2617

Related Repos

Repo Description
sdk @arcisprotocol/sdk — TypeScript SDK
mcp @arcisprotocol/mcp — MCP server for AI agents
custos CUSTOS — autonomous keeper agent
app arcis.money — landing + dashboard
docs ATI v1.1, integration guide, SDK examples

ARCIS · Solidity 0.8.24 · Foundry · Base · MMXXVI

About

Arcis Protocol smart contracts — ERC-4626 agent vaults, identity-aware credit, and revenue bonds. Built with Foundry.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors