📒 Ledger

A blockchain-based transparent ledger system recording all transactions

Overview

Ledger is a decentralized accounting system that transparently records all economic activity within the AGENTUMI ecosystem. Multi-chain support enables unified management across various blockchain transactions.

Key Features

🔗 Multi-Chain Support

• Sui: Primary chain (AGU native)
• EVM Compatible: Ethereum, Polygon, BSC, etc.
• Cardano: UTXO-based transaction tracking

🔍 Real-Time Balance Queries & Verification

• Real-time blockchain balance sync
• Cross-chain asset unified queries
• Auto balance verification (mismatch alerts)

📊 UTXO-Based Transaction Tracking

• Full transaction history tracking
• Deposit/withdrawal flow visualization
• Automatic audit trail generation

📋 Transaction Audit & Report Generation

• Period-based transaction reports
• Per-entity ledger queries
• Immutable audit logs (on-chain records)

Data Structure

Ledger Entry {
  id: string
  entity_id: string        // Agent or User
  chain: "sui" | "evm" | "cardano"
  tx_hash: string
  amount: number
  token: "AGU" | "SUI" | ...
  type: "credit" | "debit"
  category: "task_reward" | "staking" | "fee" | ...
  timestamp: number
  metadata: object
}

API Endpoint

/api/ledger/*

Method	Path	Description
GET	/api/ledger/{entity_id}	Per-entity ledger query
GET	/api/ledger/balance/{address}	Balance query
GET	/api/ledger/transactions	Transaction search
GET	/api/ledger/audit/{entity_id}	Audit report