Amped DeFi Plugin

DeFi operations plugin for OpenClaw enabling cross-chain swaps, bridging, and money market operations via the SODAX SDK.

Features

• •🔁 Cross-Chain Swaps — Execute token swaps across Ethereum, Arbitrum, Base, Optimism, Avalanche, BSC, Sonic
• •🌉 Token Bridging — Bridge assets between spoke chains and the Sonic hub chain
• •🏦 Cross-Chain Money Market — Supply on Chain A, borrow to Chain B (your collateral stays put!)
• •📊 Unified Portfolio View — Cross-chain position aggregator with health metrics, risk analysis & recommendations
• •📜 Intent History — Query complete swap/bridge history via SODAX API
• •🔐 Security First — Policy engine with spend limits, slippage caps, allowlists

Installation

openclaw plugins install amped-defi

Verify with:

openclaw plugins list
openclaw tools list | grep amped_oc

Wallet Setup

The plugin works without a wallet for read-only operations (quotes, balances, discovery). To execute transactions, install evm-wallet-skill:

git clone https://github.com/amped-finance/evm-wallet-skill.git ~/.openclaw/skills/evm-wallet-skill
cd ~/.openclaw/skills/evm-wallet-skill && npm install
node src/setup.js  # Generate a new wallet

Or use Bankr for managed key infrastructure:

export BANKR_API_KEY=your-bankr-api-key

Available Tools (24 Total)

Discovery

Swap & Bridge

Money Market

Wallet Management

⚠️ Critical: Money Market Architecture

Hub-Spoke Model

SODAX uses a hub-spoke architecture:

• •Hub chain: Sonic (chain ID: 146) — where reserves live
• •Spoke chains: Base, Arbitrum, Ethereum, Optimism, etc. — user interaction points

Rule: Money market operations (supply, borrow, withdraw, repay) must be initiated from spoke chains, NOT the hub chain (Sonic).

Per-Chain Health Factors

🚨 Each spoke chain maintains its OWN independent health factor.

• •Collateral on Base does NOT protect positions on Arbitrum
• •Each chain's positions are isolated for liquidation purposes
• •You MUST display health factor per chain, not aggregated

Example of dangerous misinterpretation:

❌ WRONG: "Combined health factor: 2.65" 
✅ RIGHT: "Base HF: 4.11 ✅ | Arbitrum HF: 1.2 ⚠️ (at risk!)"

When using amped_cross_chain_positions, always check the chainBreakdown array:

{
  "chainBreakdown": [
    { "chainId": "base", "healthFactor": "4.11", "supplyUsd": "17.25", "borrowUsd": "4.20" },
    { "chainId": "arbitrum", "healthFactor": "1.20", "supplyUsd": "100.00", "borrowUsd": "83.00" }
  ]
}

Never show an aggregated health factor — it could mislead users into thinking they're safe when one chain is at liquidation risk.

Example: Cross-Chain Swap

"Swap 1000 USDC on Ethereum to USDT on Arbitrum"

Or via tools:

// Get quote
const quote = await agent.call('amped_swap_quote', {
  walletId: 'main',
  srcChainId: 'ethereum',
  dstChainId: 'arbitrum',
  srcToken: 'USDC',
  dstToken: 'USDT',
  amount: '1000',
  type: 'exact_input',
  slippageBps: 50
});

// Execute
const result = await agent.call('amped_swap_execute', {
  walletId: 'main',
  quote: quote
});

Example: Cross-Chain Money Market

Supply on Base, borrow on Arbitrum:

// Supply on Base
await agent.call('amped_mm_supply', {
  walletId: 'main',
  chainId: 'base',
  token: 'USDC',
  amount: '1000',
  useAsCollateral: true
});

// Borrow to Arbitrum (different chain!)
await agent.call('amped_mm_borrow', {
  walletId: 'main',
  chainId: 'base',          // Where collateral lives
  dstChainId: 'arbitrum',   // Where borrowed tokens go
  token: 'USDT',
  amount: '500'
});

Example: Portfolio Display

When displaying portfolio data, always:

1. •Show balances per chain (not totaled)
2. •Show health factor per chain (not aggregated)
3. •Flag at-risk positions (HF < 1.5)

const positions = await agent.call('amped_cross_chain_positions', {
  walletId: 'main'
});

// Good display:
positions.chainBreakdown.forEach(chain => {
  console.log(`${chain.chainId}: Supply $${chain.supplyUsd} | Borrow $${chain.borrowUsd} | HF: ${chain.healthFactor}`);
});

Supported Chains

Ethereum, Arbitrum, Base, Optimism, Avalanche, BSC, Polygon, Sonic (hub), LightLink, HyperEVM, Kaia

Resources

• •npm: https://www.npmjs.com/package/amped-defi
• •GitHub: https://github.com/amped-finance/amped-defi
• •SODAX Docs: https://docs.sodax.com
• •Discord: https://discord.gg/amped

🧠 Agent Gotchas

Bankr Wallet Limitations

Bankr wallets have restricted chain support:

Example: Cross-chain swap from Base to Solana works with Bankr:

await agent.call('amped_swap_execute', {
  walletId: 'bankr',
  srcChainId: 'base',      // ✅ Bankr supports as source
  dstChainId: 'solana',    // ✅ Solana OK as destination
  recipient: '8qguBqM4UHQ...',  // Solana base58 address
  ...
});

Will fail: Trying to swap FROM Arbitrum using Bankr wallet.

Intent-Based Settlement

Swaps and bridges use intent-based execution:

• •Transactions are NOT instant
• •Settlement typically takes 30-60 seconds
• •Use amped_swap_status to check completion
• •The sodaxScanUrl in responses shows full intent lifecycle

Don't assume completion just because the tool returned success — that means the intent was submitted, not settled.

Solana Address Format

Solana addresses use base58 encoding, not hex:

• •✅ Correct: 8qguBqM4UHQNHgBm18NLPeonSSFEB3RWBdbih6FXhwZu
• •❌ Wrong: 0x8qguBqM4UHQ...

When specifying a Solana recipient for cross-chain swaps, use the base58 format.

Slippage in Volatile Markets

Default slippage (50 bps / 0.5%) may cause reverts during high volatility:

• •Normal conditions: 50 bps is fine
• •Volatile markets: Consider 100-200 bps
• •Very volatile: Up to 300 bps

await agent.call('amped_swap_quote', {
  ...
  slippageBps: 150  // 1.5% for volatile conditions
});

Token Decimals

The plugin handles decimals automatically, but be aware:

• •USDC, USDT: 6 decimals
• •Most ERC20s: 18 decimals
• •Native tokens (ETH, MATIC): 18 decimals

When displaying amounts, the plugin returns human-readable values (e.g., "100.5" not "100500000").

🎨 Chain Display Emoji

Use these emoji for consistent chain identification in portfolio displays:

Usage Example:

⚡ LightLink    │ 0.002 ETH + 5.49 USDC       │   $9.78
🟦 Base         │ 0.002 ETH + 0.39 USDC       │   $4.55
                │ 💰 Supply $21.93 Borrow $5.00
                │ 🏥 HF: 3.51 🟢