Imperium

IMPERIUM

Multi-Chain Financial Command Center

Monitor, protect, and rebalance your crypto portfolio across all chains in one place. Powered by MoonPay CLI and OpenWallet Standard.

13 MoonPay Tools Real MCP Protocol 7-Chain OWS Wallet 40 Tests The Synthesis Hackathon

The Problem

Crypto portfolios are scattered across Ethereum, Base, Polygon, and Arbitrum with no unified view. You can't detect rug pulls, can't see total allocation, and rebalancing means hours of manual swaps across different UIs and bridge interfaces.

The Solution

One command center for everything: portfolio tracking, risk scoring with HOLD/WATCH/SELL recommendations, smart money discovery, trending analysis, and policy-gated rebalancing with cross-chain bridge detection.


At a Glance

Built with real integrations, not stubs or mocks

13
MoonPay CLI
Tools
7
Chains
Supported
40
Tests
Passing
4
Core
Modules

Architecture

Clean separation of concerns with MCP client at the core

User (CLI / Interactive REPL) | v index.ts (command router) | +---> core/portfolio.ts ---+ +---> core/risk.ts ---+ +--> MoonPay CLI (MCP stdio) +---> core/rebalance.ts ---+-- policy gate ---+ +---> core/discovery.ts ---+ (wallet/policy) +--> OWS Wallet (sign/verify) | ~/.imperium/config.json

Core Modules

Four modules covering the full portfolio lifecycle

Portfolio

Holdings across chains, allocation percentages, PnL tracking, transaction history, fiat onramp via MoonPay

Risk Scanner

Token safety analysis: holder concentration, liquidity depth, community warnings. Scores 0-100 with HOLD / WATCH / SELL

Rebalance

Set target allocation, preview drift, auto-generate swap and bridge actions. Policy-gated execution with OWS signing

Discovery

Trending tokens per chain, smart money wallets ranked by PnL, token search. All real data from MoonPay

Policy Engine

Daily spending limits, per-transaction caps, token blocklists, max slippage guards. OWS-signed attestation for audit

OWS Wallet

Real HD wallet via OpenWallet Standard. 7 chains: EVM, Solana, Bitcoin, Cosmos, Tron, TON, Filecoin


13 MoonPay CLI Tools

Connected via real MCP protocol using @modelcontextprotocol/sdk

#ToolModulePurpose
1token_balance_listPortfolioAll holdings + USD value
2token_retrievePortfolioDetailed token market data
3wallet_pnl_retrievePortfolioProfit & loss summary
4wallet_activity_listPortfolioRecent transactions
5buyPortfolioFiat to crypto onramp
6deposit_createPortfolioMulti-chain deposit link
7token_checkRiskSafety scan (rug pull, liquidity)
8token_holder_listRiskHolder concentration analysis
9token_swapRebalanceSwap tokens on same chain
10token_bridgeRebalanceBridge tokens cross-chain
11token_trending_listDiscoveryTrending tokens per chain
12wallet_discoverDiscoverySmart money wallets by PnL
13token_searchDiscoverySearch tokens by name/symbol

Interactive Demo

Try Imperium right here. Type a command or click one below.

help portfolio risk trending whales analyze ai-rebalance rebalance execute watch init

imperium --demo interactive
imperium>

On-Chain Decision Log

Every AI decision committed on-chain as immutable proof - Base Sepolia

#DecisionActionTX
1DeployAgent initialized on Base Sepolia0x4e1a...
2AI AlertPOL risk 75/100 - recommend SELL0x2ea1...
3AI RebalanceETH:50 USDC:40 VVV:10 POL:00x37da...

Contract: 0x98e0af...c512c78


Tech Stack

Production-grade tools, no toy frameworks

MCP Client

@modelcontextprotocol/sdk with stdio transport to MoonPay CLI process

OWS Wallet

@open-wallet-standard/core, NAPI-RS native binary, real HD wallet creation

Testing

Vitest with 40 tests across 9 files (portfolio, risk, rebalance, policy, MCP, AI, chain, integration)

TypeScript

Strict mode with ESM modules and clean type definitions

CLI Framework

Commander.js + chalk + cli-table3 for rich, colored terminal output

Fixture Data

14 JSON files captured from real MoonPay API responses for demo mode


Quick Start

Up and running in under a minute

# Clone and install $ git clone https://github.com/jordi-stack/imperium.git $ cd imperium && npm install # Demo mode (no funds needed, no login required) $ ./imp --demo portfolio $ ./imp --demo risk scan $ ./imp --demo discover trending base $ ./imp --demo interactive # Real mode (live MoonPay data) $ npm install -g @moonpay/cli $ moonpay login --email you@example.com $ ./imp discover trending base