AegisAEGIS
Allium Realtime

Allium Integration

On-chain transaction verification, wallet analytics, and batch settlement checks — trust but verify every agent payment.

Why Allium for Agents?

Transaction Verification

Confirm payments landed on-chain with block number and timestamp

🔗

6-Chain Support

Ethereum, Base, Polygon, Arbitrum, Optimism, and Solana

📦

Batch Verification

Verify multiple transactions in a single call

💰

USD-Priced Balances

Token balances with real-time USD pricing


What Aegis Uses Allium For

Payment Verification

Confirm agent-to-agent payments settled on-chain before granting API access via verifyTransaction().

Wallet Balance Queries

Additional balance data source via getAlliumBalances() — deduped with Zerion and Uniblock.

Batch Settlement

Verify multiple payments at once for multi-agent supply chain workflows via verifyTransactions().


Use Cases

\u2705

Payment Verification

Confirm agent-to-agent payments settled on-chain before delivering data or granting API access.

verifyTransaction(txHash, "eip155:8453")

\uD83D\uDCCB

Audit Trail

Verify historical transactions for compliance. Get block number, timestamp, and success status.

status: confirmed, block: 12345678

\uD83D\uDD0D

Multi-Chain Analytics

Track agent activity across 6 chains. Identify patterns, verify settlements, detect anomalies.

verifyTransactions([{tx1}, {tx2}, {tx3}])

\uD83D\uDCE6

Batch Settlement

Verify multiple payments in one call. Essential for supply chain workflows with cascading payments.

buyer→analyst→miner: 3 tx verify


Transaction Verification

Verify a single transaction
import { verifyTransaction } from "@aegis-ows/integrations";

const result = await verifyTransaction(
  "0xabc123def456...",     // transaction hash
  "eip155:8453"            // chain ID (Base)
);

// Returns:
// {
//   txHash: "0xabc123def456...",
//   chain: "eip155:8453",
//   status: "confirmed",        // "confirmed" | "pending" | "not_found" | "error"
//   blockNumber: 12345678,
//   timestamp: "2024-01-15T10:30:00Z",
//   source: "allium-realtime"
// }

Uses POST /wallet/transactions with a transaction_hash filter. Internally maps CAIP-2 chain IDs to Allium chain names.


Batch Verification

Verify multiple transactions at once
import { verifyTransactions } from "@aegis-ows/integrations";

const results = await verifyTransactions([
  { txHash: "0xabc...", chain: "eip155:1" },       // Ethereum
  { txHash: "0xdef...", chain: "eip155:8453" },     // Base
  { txHash: "0xghi...", chain: "solana:5eykt4..." } // Solana
]);

// Returns: TxVerification[] — one result per transaction
// All verified in parallel via Promise.all

Balance Queries

Query wallet balances via Allium
import { getAlliumBalances } from "@aegis-ows/integrations";

const balances = await getAlliumBalances(
  "0x1234...",      // wallet address
  "eip155:1"        // chain ID (Ethereum)
);

// Returns: ChainBalance[] with USD pricing
// Handles raw balance + decimals conversion
// Filters dust balances (<0.0001)

Supported Chains

ChainCAIP-2 IDAllium Key
Ethereumeip155:1ethereum
Baseeip155:8453base
Polygoneip155:137polygon
Arbitrumeip155:42161arbitrum
Optimismeip155:10optimism
Solanasolana:5eykt4...solana

Setup Guide

.env
# Required — get from allium.so
ALLIUM_API_KEY=your_api_key_here
ConfigValue
AuthX-API-Key header
Base URLhttps://api.allium.so/api/v1/developer
Env VarALLIUM_API_KEY

Hackathon Ideas

Data Track

On-chain analytics dashboard for AI agent economies with real-time verification

Compliance

Automated transaction auditing and reporting for regulated agent operations

Security

Real-time payment verification and fraud detection for agent marketplaces

Analytics

Agent economy health monitoring with cross-chain settlement tracking


API Reference

FunctionParametersReturns
verifyTransactiontxHash, chainTxVerification
verifyTransactions{txHash, chain}[]TxVerification[]
getAlliumBalanceswalletAddress, chainChainBalance[]