Skip to content

v0.6.1

Latest
Latest

Choose a tag to compare

View all tags
@iamalwaysuncomfortable iamalwaysuncomfortable released this 02 Oct 03:40
v0.6.1
fbd9950
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

This release extends the bridge package: ten new Hyperlane warp routes for BAT, USDG and ZEC between Aleo, Ethereum and Solana (including SPL-collateral transfers on Solana), and signing the Ethereum and Solana legs with Privy or Dynamic server wallets. The core SDK, the ABI generator and the Shield Swap SDK are version bumps only.

python -m pip install aleo-sdk==0.6.1
python -m pip install aleo-contract-abi-generator==0.6.1
python -m pip install "shield-swap-sdk[async,mcp]==0.6.1"
python -m pip install "aleo-bridge-sdk[mcp]==0.6.1"

Aleo Bridge SDK

BAT, USDG and ZEC Hyperlane warp routes

Port of Veil #169.

  • Registry version 2026-09-30.hyperlane-bat-usdg-zec.1 adds eight assets (Aleo BAT/USDG/ZEC as ARC-22 tokens with their shield_arc22_* programs, Ethereum BAT/USDG, Solana BAT/USDG/ZEC mints) and ten active mainnet routes, pinned from hyperlane-registry dd03567. Plans and checkpoints saved under the previous 2026-09-28.cctp-arc.1 snapshot stay valid for unchanged routes; an older client still rejects a newer registry version, so upgrade recovery services first.
  • Solana routes gain a native | spl-collateral router type. SPL transfers use the 18-account TransferRemote layout (token program, mint, sender associated token account and escrow PDA), reproduced byte-for-byte from a recorded ZEC deposit, with escrow PDAs re-derived from each warp program.
  • bridge.sol.quote / send / balance / status take asset= (SOL by default) and follow the plan's route. SPL quotes report fees in SOL and keep the token amount out of total_lamports; send() checks the sender's token account before broadcasting; Aleo-to-Solana SPL delivery is tracked through the recipient's associated token account.
  • Because BAT and USDG leave Aleo towards both Ethereum and Solana, Aleo-origin legs now resolve by route instead of by asset. bridge.hyperlane.quote_gas_payment and transfer_remote accept an asset ref, a Route or a route id. Hyperlane approval steps apply to EVM token sources only.
  • examples/bridge_arc22_hyperlane.py --route <id> covers all ten directions with quote, execute, journal and recovery. Read-only live checks cover SPL quotes, Ethereum collateral routers and Solana program/mint/escrow layouts.
  • All ten routes were delivered end to end on mainnet before merge. Solana SPL legs cost about 0.0056 SOL each; Aleo-origin legs paid roughly 7.7 (to Solana) and 9.1 (to Ethereum) credits in interchain gas.

Privy and Dynamic server wallets

Port of Veil #170. A backend can now bridge without holding a chain private key by letting an existing server wallet sign the Ethereum or Solana leg. Both adapters use the providers' official Python SDKs (privy-client, dynamic-wallet-sdk), which install with the package; dynamic-wallet-sdk needs Python 3.11 or newer.

  • aleo_bridge.privy: PrivyEvmSigner and PrivySolanaSigner. EVM signs via eth_signTransaction (type 2, or legacy when the connection prepared gasPrice) and recovers the sender from the returned transaction, refusing a mismatch. Solana wraps the compiled message in a wire transaction, rejects a response whose message changed, and verifies only the wallet's signature slot. Optional authorization_private_keys support owner policies.
  • aleo_bridge.dynamic: DynamicEvmSigner and DynamicSolanaSigner. The Dynamic SDK is async-only, so the signers run it on a private loop thread, resolve the wallet by address (chain and optional wallet_id checked), and re-authenticate hourly. Dynamic signs legacy EVM transactions only, so Ethereum.send_transaction honours a legacy_transactions_only signer flag and prepares gasPrice with the same tip floor.
  • Both plug into the existing Ethereum(rpc, signer=...) / Solana(rpc, signer=...) seam. The Bridge lifecycle, journal and recovery are unchanged, and signer.resolve() is an optional fail-fast identity check. The adapters add no signing or broadcast retries.
  • Examples privy_wallets.py and dynamic_wallets.py (--chain ethereum|solana, quote by default, --execute to submit), README sections and a regenerated agent guide. Four mainnet transfers (ETH and SOL to Aleo, one per provider and chain) reached done.

Core SDK, ABI generator, Shield Swap SDK

  • Version bump only (#77).

The release contains BAT, USDG and ZEC Hyperlane warp routes #75, Privy and Dynamic server wallets #76 and the 0.6.1 version bump #77.

Full diff: v0.6.0...v0.6.1

Assets 2
Loading