ipor-fusion 2.0.0

The IPOR Fusion SDK for Python

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])

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
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

poetry install                                              # Install dependencies
poetry run pytest tests/test_fuse_encoding.py -n auto -v    # Unit tests (fast, no Docker)
poetry run pytest -v -s                                     # All tests (needs Docker + .env)
poetry run black ./                                         # Format
poetry run pylint --rcfile=pylintrc.toml --verbose --recursive=y .  # Lint
poetry run mypy .                                           # Type check

Integration tests require Docker (Anvil) and provider URLs in .env:

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