portal_flutter 0.1.0-alpha.13

Flutter SDK for Portal - Stablecoin wallet infrastructure

0.1.0-alpha.13

iOS Dependency Setup

• The iOS implementation is now a Swift package, so PortalSwift is resolved by the plugin itself when Swift Package Manager is enabled (the Flutter default from 3.44 onward). If your app has SPM enabled and a pod 'PortalSwift' line in ios/Podfile, remove it. Declaring it in both places resolves PortalSwift twice, and the module and the Mpc.xcframework it vendors are built and linked twice.

• Apps on CocoaPods (Flutter before 3.44, or with flutter config --no-enable-swift-package-manager) still need the dependency declared themselves, since PortalSwift is not published to the CocoaPods trunk:

  pod 'PortalSwift', :git => 'https://github.com/portal-hq/PortalSwift.git', :tag => '7.3.0'
  

  The tag must match the PortalSwift version in portal_flutter_ios.podspec.

New APIs

• One-call delegation helpers that build, sign, and broadcast in a single step, each returning the broadcast transaction hashes in submission order:

  • portal.delegations.approveAndSubmit({chain, token, delegateAddress, amount, onProgress})
  • portal.delegations.revokeAndSubmit({chain, token, delegateAddress, onProgress})
  • portal.delegations.transferAndSubmit({chain, token, fromAddress, toAddress, amount, onProgress})

  Transactions are submitted sequentially and network confirmation is not awaited — use the returned hashes to track confirmations yourself. The optional onProgress callback receives a DelegationSubmitProgress (new, with step, index, total, and hash) as each transaction is signed and submitted, where step is a DelegationSubmitStep of signing or submitted.

Improvements

• portal_flutter_ios ships an SPM manifest (ios/portal_flutter_ios/Package.swift) pinning PortalSwift to 7.3.0 and AnyCodable to 0.6.7, matching the podspec so the two dependency graphs cannot drift.

Notes

• Native SDK versions are unchanged from 0.1.0-alpha.12 (PortalSwift 7.3.0, portal-android 9.1.1).

0.1.0-alpha.12

Breaking Changes

• Removed the useMultiBackup parameter from portal.initialize(). Multi-backup is no longer configurable through the Flutter SDK.

New APIs

• Feature flags at initialization: portal.initialize() now accepts a featureFlags parameter of the new PortalFeatureFlags type. All flags are optional:
  • useEnclaveMpcApi — Run MPC operations through Portal's Enclave MPC API.
  • usePresignatures — Pre-generate signatures in the background and use them at signing time for reduced latency.
  • usePreGeneratedWallet — Fetch pre-generated MPC shares from the Enclave API instead of running on-device key generation, with automatic fallback to on-device generation on transient server errors.
• portal.featureFlags — Read-only access to the feature flags passed at initialization. Flags are immutable after initialization; reinitialize the SDK to change them.
• enclaveMpcHost parameter on portal.initialize() — Optional custom Enclave MPC host (e.g. mpc-client.portalhq.dev for staging).

Improvements

• Yield.xyz enums (YieldXyzMechanicsType, YieldXyzRewardSchedule, YieldXyzRewardClaiming, YieldXyzSource, YieldXyzArgumentFieldName, YieldXyzArgumentFieldType) now include an unknown value so unrecognized values returned by the Yield.xyz API can be surfaced instead of dropped, and YieldXyzSource gained a lending value.
• Bumped PortalSwift to 7.3.0:
  • Adds pre-generated wallet support (see usePreGeneratedWallet above).
  • All Portal API requests now carry an X-Portal-Trace-Id header, and multi-step flows share a single trace ID for end-to-end request correlation.
• Bumped portal-android to 9.1.1:
  • Fixed a presignature signing issue by updating the MPC binary from 1.3.9 to 1.4.0.
  • Adds pre-generated wallet support (see usePreGeneratedWallet above).
  • All Portal API requests now carry an X-Portal-Trace-Id header, and multi-step flows share a single trace ID for end-to-end request correlation.
  • portal.isWalletOnDevice() now returns false on a device with no wallet instead of throwing.

0.1.0-alpha.11

Breaking Changes

• portal.backupWallet() now returns a PendingBackup instead of PortalBackupResponse (removed). Read the encrypted payload from pendingBackup.cipherText, persist it, then call pendingBackup.confirm() (or pendingBackup.discard() if your storage step fails).
• Removed portal.swap() and its PortalSwapRequest / PortalSwapResult types. Use portal.trading.zeroX (0x DEX aggregator) or portal.trading.lifi (cross-chain) instead.

New APIs

• portal.buildEip155Transaction({chainId, to, token, amount}) — Build an unsigned EIP-155 transaction.
• portal.buildSolanaTransaction({chainId, to, token, amount}) — Build an unsigned Solana transaction.
• portal.evmAccountType.buildAuthorizationList() and portal.evmAccountType.build7702UpgradeTx() — Manual EIP-7702 upgrade flow. Both accept an optional subsidize flag. See the EIP-7702 tab in the example app for the full three-step flow.
• Portal.configureGoogleStorage(...) now accepts backupOption, folderName, signOutAfterUse, and useNewExperimentalGoogleAuthApi — full parity with native SDK config knobs.
• New PortalGDriveBackupOption enum: appDataFolder, appDataFolderWithFallback, customFolder.
• portal.apiKey exposed as a public getter.
• Portal native events exposed as a broadcast Stream<PortalEventData> via portal.events, with portal.emit(event, [data]) to emit events back to the SDK (e.g. approving or rejecting a manual signing request from your listener).
• Backup + signing share metadata accessors: portal.getBackupShareMetadata() and portal.getSigningSharesMetadata().
• Share management: portal.storedClientBackupShare(...) and portal.updateShareStatus(...) for reporting custodian-stored backup shares and updating share-pair status.
• Portal-managed backups: portal.backupWallet() and portal.recoverWallet() now support custodian-managed cipherText storage, returning a PendingBackup you confirm once your storage step succeeds.
• ZeroX (0x) DEX aggregator submodule: portal.trading.zeroX.getSources(), portal.trading.zeroX.getQuote(), and portal.trading.zeroX.getPrice().

Deprecations

• Portal.configureGoogleStorage(applicationName: ...) is deprecated; use folderName instead. Will be removed in the next minor.

Bug Fixes

• iOS: Pigeon completion handlers that return structured or list responses (getAssets, getBalances, getTransactions, getNftAssets, getTransactionDetails, getBackupShareMetadata, getSigningSharesMetadata, getAddresses, getClient, buildEip155Transaction, buildSolanaTransaction, evmAccountType.buildAuthorizationList, evmAccountType.build7702UpgradeTx) are now dispatched to the main thread, preventing a stack overflow crash during codec serialization of nested responses.
• iOS: configureGoogleStorage now auto-resolves the top UIViewController so the Google Sign-In sheet has a presenter without callers wiring it manually.
• Android: FlutterError in coroutine handlers is now caught and surfaced as a PortalException instead of crashing.
• Android: Fixed Hypernative.scanEip712Tx URL path (eip712 → eip-712).
• iOS & Android: Manual signing approve/reject events now fail fast with a NO_PENDING_REQUEST error when no matching pending request exists, and rejected events emit the payload type the provider expects — fixing cases where a manual signing request could hang indefinitely.
• Android: request() now serializes non-string RPC results (objects and arrays) as JSON instead of relying on toString(), fixing malformed responses for methods that return structured data.
• Android: configurePasskeyStorage now prepends https:// to webAuthnHost when the scheme is omitted, so passkey WebAuthn flows work with a bare host.
• Android: Yield discovery (portal.yieldIntegrations.yieldxyz.discover()) now skips opportunities and reward-rate components containing enum values the SDK doesn't recognize yet, instead of throwing.
• Android: availableRecoveryMethods() no longer throws on an unrecognized recovery method; unknown methods are filtered out.
• Android: Backup/signing metadata accessors and 0x trading methods now surface a NOT_INITIALIZED error immediately when Portal isn't initialized.
• PendingBackup.confirm() and discard() now clear the internal backup id so a pending backup can't be resolved twice.

Improvements

• Bumped PortalSwift to 7.2.1.
• Bumped portal-android to 9.0.0:
  • HTTP 400 backend errors now include the raw response body in PortalException.details across all API methods, providing clearer diagnostics on failures.
  • portal.security.blockaid.scanUrl() — rawResponseJson no longer contains a modals field (removed by the Blockaid backend).
  • portal.security.hypernative.scanSolanaTx() — within findingsJson, each trace's funcId changed from a plain string to {"type": "StringValue" | "BytesValue", "value": "..."} to handle both string and byte-array formats returned by the Hypernative API.
  • portal.security.hypernative.scanTransaction() / scanEip712Tx() — within findingsJson, each trace's status changed from an integer to a boolean, matching the Hypernative API.

0.1.0-alpha.10

Bug Fixes

• Android: HTTP 400 responses now surface errors as PortalException:
  • portal.delegations.approve
  • portal.delegations.revoke
  • portal.delegations.getStatus
  • portal.delegations.transferFrom
  • portal.getTransactionDetails
• Android: Fixed release builds with proper proguard rules for response body fields.

Improvements

• Bumped portal-android to 8.4.0

0.1.0-alpha.9

Improvements

• Adding release automation

0.1.0-alpha.8

Firebase Auth Backup

• portal.configureFirebaseStorage({required getToken}) - Configure Firebase as a backup storage method with a token callback
• portal.backupWallet(method: PortalBackupMethod.firebase) - Backup wallet using Firebase auth
• portal.recoverWallet(method: PortalBackupMethod.firebase) - Recover wallet using Firebase auth

0.1.0-alpha.7

New APIs

Transaction Details

• portal.getTransactionDetails(chain, txHash) - Get transaction details for a given chain and transaction hash

0.1.0-alpha.6

Bug Fixes

• Fixed Android Hypernative scan crash

0.1.0-alpha.5

New APIs

Security Scanning

• portal.security.blockaid.scanTransaction() - Scan a transaction for security risks using Blockaid
• portal.security.blockaid.scanAddress() - Scan an address for security risks using Blockaid
• portal.security.hypernative.scanTransaction() - Scan a transaction for security risks using Hypernative
• portal.security.hypernative.scanAddress() - Scan an address for security risks using Hypernative

ERC-4337 Account Abstraction

• eth_signUserOperation support via portal.request() - Sign UserOperations for Account Abstracted wallets

LiFi Cross-Chain Swaps

• portal.trading.lifi.getQuote() - Get a quote for a cross-chain swap
• portal.trading.lifi.getRoutes() - Get available routes for a swap
• portal.trading.lifi.getRouteStep() - Get a specific step from a route
• portal.trading.lifi.sendRouteTransaction() - Execute a route step transaction
• portal.trading.lifi.sendSequentialSteps() - Execute all steps in a route sequentially
• portal.trading.lifi.getStatus() - Check the status of a cross-chain transaction

EVM Account Type (EIP-7702)

• portal.evmAccountType.getStatus() - Query the current EVM account type status
• portal.evmAccountType.getAddresses() - Get EOA and smart contract addresses
• portal.evmAccountType.upgradeTo7702() - Upgrade an EOA to EIP-7702 smart account

MPC Progress Stream

• portal.onProgress - Stream of MPC operation progress events (create, backup, recover)

Balance API

• portal.getBalances() - Get native and token balances for a chain

Log Level

• portal.setLogLevel() - Set the SDK log level at runtime
• logLevel parameter in portal.initialize() - Set log level during initialization

Bug Fixes

• Fixed iOS yield crash caused by Pigeon completion handlers running off main thread
• Fixed Android delegation getStatus null pointer when no delegations exist

Improvements

• Dispatched MPC progress callbacks to main thread on iOS for thread safety
• Used tokenAddress metadata key consistently in Android getBalances implementation
• Added isClosed guard on progress stream controller to prevent crashes after dispose
• Fixed dispose() ordering: unregister handler before closing stream controller
• Added release automation CI/CD workflows for pub.dev publishing

0.1.0-alpha.4

New APIs

Yield.xyz Integration

• portal.yieldIntegrations.yieldxyz.discover() - Find yield opportunities
• portal.yieldIntegrations.yieldxyz.enter() - Enter yield positions
• portal.yieldIntegrations.yieldxyz.exit() - Exit yield positions
• portal.yieldIntegrations.yieldxyz.manage() - Manage pending actions
• portal.yieldIntegrations.yieldxyz.getBalances() - Query active balances
• portal.yieldIntegrations.yieldxyz.getHistoricalActions() - View historical actions
• portal.yieldIntegrations.yieldxyz.getTransaction() - Get transaction status
• portal.yieldIntegrations.yieldxyz.track() - Track transaction on-chain

Delegation API

• portal.delegations.approve() - Approve token delegation
• portal.delegations.revoke() - Revoke token delegation
• portal.delegations.getStatus() - Get delegation status
• portal.delegations.transferFrom() - Transfer from delegated allowance

Bug Fixes

• Fixed Solana sol_signMessage on Android (platform-specific encoding)

0.1.0-alpha.3

• Updated iOS podspec metadata

0.1.0-alpha.2

• Updated README

0.1.0-alpha.1

• Initial alpha release of Portal Flutter SDK
• Stablecoin wallet infrastructure for Flutter apps
• Support for iOS and Android platforms