Migrating from Capsule to Para

Overview

This guide covers the migration process from Capsule to Para SDKs. The migration includes package namespace changes, method signature updates to use object parameters, and introduces new React hooks for state management.

Package Changes

All packages have been migrated from the @usecapsule namespace to @getpara. Update your dependencies by replacing @usecapsule with @getpara in your package.json:

{
  "dependencies": {
-   "@usecapsule/react-sdk": "^3.0.0",
-   "@usecapsule/evm-wallet-connectors": "^3.0.0"
+   "@getpara/react-sdk": "^1.0.0",
+   "@getpara/evm-wallet-connectors": "^1.0.0"
  }
}

All packages have been reset to version 1.0.0 under the new namespace. The functionality and package names remain the same - only the organization prefix has changed from @usecapsule to @getpara.

npm install @getpara/[package-name]

Mobile SDK Updates

Flutter

The Flutter package has moved from capsule to para on pub.dev:

dependencies:
-  capsule: 0.7.0
+  para: ^1.0.0

Create instances using Para() instead of Capsule(). All method signatures remain unchanged.

Swift

The Swift SDK package is now available at github.com/getpara/swift-sdk. The main class has been renamed from CapsuleManager to ParaManager, while maintaining the same method signatures:

- let manager = CapsuleManager()
+ let manager = ParaManager()

Method signatures and functionality remain identical for both mobile SDKs - only the package names and main class names have changed.

Breaking Changes

Method Updates

All methods have been updated to use object parameters instead of multiple arguments. This change improves extensibility, type safety, and reflects our commitment to consistent API design.

Authentication Methods

object

createUser

method

// Old
createUser(email: string)
// New
createUser({ email: string })

createUserByPhone

method

// Old
createUserByPhone(phone: string, countryCode: string)
// New
createUserByPhone({ phone: string, countryCode: string })

// Old
externalWalletLogin(address: string, type: string, provider?: string, addressBech32?: string)
// New
externalWalletLogin({
  address: string,
  type: string,
  provider?: string,
  addressBech32?: string
})

Wallet Operations

object

createWallet

method

// Old
createWallet(type: WalletType, skipDistribute?: boolean)
// New
createWallet({ 
  type: WalletType, 
  skipDistribute?: boolean = false 
})

createWalletPerType

method

// Old
createWalletPerType(skipDistribute?: boolean, types?: WalletType[])
// New. Note: Function name changed, default value added, and types is now required
createWalletPerType({
  skipDistribute?: boolean = false,
  types: WalletType[]
})

// Old
distributeNewWalletShare(
  walletId: string,
  userShare?: string,
  skipBiometricShareCreation?: boolean,
  forceRefreshRecovery?: boolean
)
// New
distributeNewWalletShare({
  walletId: string,
  userShare?: string,
  skipBiometricShareCreation?: boolean = false,
  forceRefresh?: boolean = false
})

PreGen Wallet Operations

object

createWalletPreGen

method

// Old
createWalletPreGen(
  type: WalletType,
  pregenIdentifier: string,
  pregenIdentifierType?: PregenIdentifierType
)
// New
createPregenWallet({
  type: WalletType,
  pregenIdentifier: string,
  pregenIdentifierType?: PregenIdentifierType
})

updatePregenWalletIdentifier

method

// Old - Note: Function name changed
updateWalletIdentifierPreGen(
  newIdentifier: string,
  walletId: string,
  newType?: PregenIdentifierType
)
// New
updatePregenWalletIdentifier({
  walletId: string,
  newPregenIdentifier: string,
  newPregenIdentifierType?: PregenIdentifierType
})

Transaction Methods

object

signMessage

method

// Old
signMessage(
  walletId: string,
  messageBase64: string,
  timeoutMs?: number,
  cosmosSignDocBase64?: string
)
// New
signMessage({
  walletId: string,
  messageBase64: string,
  timeoutMs?: number,
  cosmosSignDocBase64?: string
})

signTransaction

method

// Old
signTransaction(
  walletId: string,
  rlpEncodedTxBase64: string,
  timeoutMs?: number,
  chainId: string
)
// New
signTransaction({
  walletId: string,
  rlpEncodedTxBase64: string,
  timeoutMs?: number,
  chainId: string
})

All methods now use object parameters with optional properties defaulting to reasonable values. This change makes the SDK more maintainable and easier to extend in the future.

New Features: React Hooks

Para now includes React hooks for easier state management and SDK interaction. Here’s a basic setup:

import { ParaProvider, ParaModal } from "@getpara/react-sdk";

function App() {
  return (
    <ParaProvider
      paraClientConfig={{
        env: Environment.DEV,
        apiKey: "your-api-key",
      }}>
      <ParaModal />
      <YourApp />
    </ParaProvider>
  );
}

Available Hooks

Query Hooks

object

Mutation Hooks

object

Utility Hooks

object

Para React Hooks

Explore the new React hooks for managing Para modal state and interactions.

Next Steps

Update your package dependencies to use @getpara/* packages
Migrate method calls to use new object parameters
Consider implementing React hooks for simpler state management
Review framework-specific integration guides for detailed setup instructions

Introduction

Core Concepts

General Guides

Troubleshooting

Resources

Migrating from Capsule to Para

Overview

Package Changes

Mobile SDK Updates

Flutter

Swift

Breaking Changes

Method Updates

New Features: React Hooks

Available Hooks

Para React Hooks

Next Steps

Introduction

Core Concepts

General Guides

Troubleshooting

Resources

​Overview

​Package Changes

​Mobile SDK Updates

​Flutter

​Swift

​Breaking Changes

​Method Updates

​New Features: React Hooks

​Available Hooks

Para React Hooks

​Next Steps

Overview

Package Changes

Mobile SDK Updates

Flutter

Swift

Breaking Changes

Method Updates

New Features: React Hooks

Available Hooks

Next Steps