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.

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
createWalletPreGen({
  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

Framework Setup

Customization

SDK Integrations

Account Abstraction

Core Concepts

Media Resources

Troubleshooting

Full API Reference

Migrating from Capsule to Para

Overview

Package Changes

Breaking Changes

Method Updates

New Features: React Hooks

Available Hooks

Para React Hooks

Next Steps

Introduction

Framework Setup

Customization

SDK Integrations

Account Abstraction

Core Concepts

Media Resources

Troubleshooting

Full API Reference

​Overview

​Package Changes

​Breaking Changes

​Method Updates

​New Features: React Hooks

​Available Hooks

Para React Hooks

​Next Steps

Overview

Package Changes

Breaking Changes

Method Updates

New Features: React Hooks

Available Hooks

Next Steps