ipor-fusion

IPOR Fusion Python SDK

ipor_fusion is the official Python SDK for IPOR Fusion Plasma Vaults — typed abstractions for DeFi protocol interactions on EVM chains through a fuse adapter pattern.

Maintained by IPOR Labs AG.

Workflow
Social
Code

Quickstart

Install

pip install ipor-fusion

Connect and execute

from ipor_fusion import Web3Context, PlasmaVault, AaveV3SupplyFuse
from web3 import Web3

# 1. Create a Web3 context with your provider and private key
ctx = Web3Context.from_url(
    url="https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY",
    private_key="0x...",
)

# 2. Wrap the PlasmaVault contract
vault = PlasmaVault(ctx, Web3.to_checksum_address("0xVAULT_ADDRESS"))

# 3. Build a fuse action (e.g. supply USDC to Aave V3)
fuse = AaveV3SupplyFuse(Web3.to_checksum_address("0xFUSE_ADDRESS"))
action = fuse.supply(
    asset=Web3.to_checksum_address("0xUSDC_ADDRESS"),
    amount=1_000_000,  # 1 USDC (6 decimals)
)

# 4. Execute on-chain
receipt = vault.execute([action])

CLI Quickstart

The SDK ships with a fusion CLI for inspecting and managing Plasma Vaults from the terminal.

You need an RPC provider URL — get a free key at Alchemy or Infura.

# Install with CLI extras (pipx keeps dependencies isolated)
pipx install 'ipor-fusion[cli]'

# Configure an RPC provider (auto-detects chain ID)
fusion config set-provider https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY

# Inspect a vault (auto-saves to config on first use)
fusion vault info 0xB8a451107A9f87FDe481D4D686247D6e43Ed715e --chain-id ethereum

# List saved vaults
fusion vault list

MCP Server

The SDK includes an MCP server that exposes CLI tools to any MCP-compatible AI assistant (Claude Code, Cursor, Windsurf, etc.).

# Install with MCP extras (pipx keeps dependencies isolated)
pipx install 'ipor-fusion[mcp]'

Add to your MCP client configuration (e.g. .mcp.json):

{
  "mcpServers": {
    "ipor-fusion": {
      "command": "fusion-mcp",
      "type": "stdio"
    }
  }
}

Available tools:

Tool	Description
`config_show`	Show current configuration (providers, vaults, API key status)
`config_set_provider`	Set RPC provider URL for a chain (auto-detects chain ID)
`config_set_etherscan_key`	Set Etherscan API key (enables contract name resolution)
`vault_info`	Full on-chain vault state — assets, fuses, balances, fees, lending health, reconciliation
`vault_list`	List all saved vaults
`vault_add`	Save a vault to the local config (auto-fetches on-chain name)
`vault_remove`	Remove a vault from the local config

Configure providers and vaults via fusion config or the MCP config tools first.

Architecture

The SDK uses a fuse adapter pattern:

Fuses encode protocol-specific calls into FuseAction objects (pure calldata, no state)
PlasmaVault batches and executes FuseAction sequences on-chain via execute()
Web3Context manages provider connections, signing, and transaction dispatch

Fuse.method()  -->  FuseAction  -->  PlasmaVault.execute([actions])  -->  on-chain tx

Core modules (`ipor_fusion.core`)

Module	Purpose
`Web3Context`	Provider connection, signing, tx dispatch
`PlasmaVault`	ERC-4626 vault — execute, deposit, withdraw
`AccessManager`	Role-based access control
`RewardsManager`	Claim and vest rewards
`WithdrawManager`	Time-windowed withdrawal requests
`FeeManager`	Deposit, performance, and management fee configuration
`FeeAccount`	Fee escrow account, resolves its `FeeManager`
`PriceOracleMiddleware`	Asset price feeds

Supported protocols (`ipor_fusion.fuses`)

Protocol	Fuses
Aave V3	`AaveV3SupplyFuse`, `AaveV3BorrowFuse`
Morpho	`MorphoSupplyFuse`, `MorphoCollateralFuse`, `MorphoBorrowFuse`, `MorphoFlashLoanFuse`, `MorphoClaimFuse`
Uniswap V3	`UniswapV3SwapFuse`, `UniswapV3NewPositionFuse`, `UniswapV3ModifyPositionFuse`, `UniswapV3CollectFuse`
Ramses V2	`RamsesV2NewPositionFuse`, `RamsesV2ModifyPositionFuse`, `RamsesV2CollectFuse`, `RamsesClaimFuse`
Compound V3	`CompoundV3SupplyFuse`
Gearbox V3	`GearboxSupplyFuse`, `GearboxStakeFuse`
ERC-4626	`ERC4626SupplyFuse`
Fluid Instadapp	`FluidInstadappSupplyFuse`, `FluidInstadappStakingFuse`
Universal	`UniversalTokenSwapperFuse`

Supported networks

Ethereum mainnet
Arbitrum One
Base

Development

uv sync --all-extras                                       # Install dependencies
uv run pytest tests/test_fuse_encoding.py -n auto -v       # Unit tests (fast, offline)
uv run pytest -v -s                                        # All tests (needs `.*_PROVIDER_URL` variables in `.env`)
uv run ruff format ./                                      # Format
uv run ruff check ./                                       # Lint
uv run pyright                                             # Type check

Integration tests need provider URLs in .env (eth_simulateV1 at a pinned fork block — no local node):

cp .env.example .env
# Edit .env with ARBITRUM_PROVIDER_URL, ETHEREUM_PROVIDER_URL, BASE_PROVIDER_URL

Examples

For full usage patterns, see the example repository: ipor-fusion-alpha-example

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ipor_fusion-3.4.0.tar.gz (465.5 kB view details)

Uploaded Jul 29, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ipor_fusion-3.4.0-py3-none-any.whl (144.2 kB view details)

Uploaded Jul 29, 2026 Python 3

File details

Details for the file ipor_fusion-3.4.0.tar.gz.

File metadata

Download URL: ipor_fusion-3.4.0.tar.gz
Upload date: Jul 29, 2026
Size: 465.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for ipor_fusion-3.4.0.tar.gz
Algorithm	Hash digest
SHA256	`4619f04317480c70950a28f021501df5375f4fb1f4812f2ea97b3fbd58340303`
MD5	`08ac9d6801b5b34fcd9c8f50c0d91b10`
BLAKE2b-256	`d99e7de6836e9866d06efbaeda7e06c7638e16fba2c74e8427973e3c41480fa0`

See more details on using hashes here.

File details

Details for the file ipor_fusion-3.4.0-py3-none-any.whl.

File metadata

Download URL: ipor_fusion-3.4.0-py3-none-any.whl
Upload date: Jul 29, 2026
Size: 144.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for ipor_fusion-3.4.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`8c432438a499ea4a98432569eac6152af2fed8734880c42d20006f824df3ad7c`
MD5	`ed8c7197d951d6b14b3b2d83cf71f201`
BLAKE2b-256	`3116c4e2542583918e346a2a63150425d321572e8a0540b86fdacb762af3c274`