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

Show User Creation and Login

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

Show Wallet Management

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

Show PreGen Wallet Management

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

Show Signing and Sending

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

Show State Management

useAccount

hook

Access current account state and connection status

useWallet

hook

Get current wallet information and state

Mutation Hooks

object

Show Account & Authentication

useCreateUser

hook

Create a new Para user account

useCheckIfUserExists

hook

Check if a user exists by email

Start the login process

useLogout

hook

Handle user logout

useKeepSessionAlive

hook

Maintain active user session

Show Wallet Operations

useWaitForPasskeyAndCreateWallet

hook

Create wallet after passkey verification

useSignMessage

hook

Sign messages with connected wallet

useSignTransaction

hook

Sign transactions with connected wallet

Show Setup & Configuration

Handle login flow and initial setup

useWaitForAccountCreation

hook

Monitor account creation process

Utility Hooks

object

Show Core Utilities

useClient

hook

Access Para client instance

Control Para modal visibility

useWalletState

hook

Manage wallet state

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