@elizaos/plugin-para

A seamless integration between Para wallet infrastructure and Eliza OS, enabling autonomous agents to manage user wallets and transactions.

Features

• 🔐 Full Para wallet integration with Eliza agents
• 💰 EVM-based transaction support using Viem
• 📝 Message signing capabilities
• 💼 Pre-generated wallet support
• 🔄 Seamless wallet claiming process
• 🛡️ Secure user share management
• 🌐 Multi-chain support (Ethereum, Polygon, Arbitrum, etc.)
• 📋 Built-in wallet status monitoring
• 🤖 Auto-configuration with Eliza agents
• 📱 Session management for persistent authentication

Installation

You can install the plugin using your preferred package manager:

# npm
npm install @elizaos/plugin-para

# pnpm
pnpm add @elizaos/plugin-para

# yarn
yarn add @elizaos/plugin-para

# bun
bun add @elizaos/plugin-para

Configuration

1. Add required environment variables to your .env file:

# Para Configuration
PARA_API_KEY=your-para-api-key
PARA_ENV=production

2. Register the plugin in your Eliza character configuration:

import { paraPlugin } from '@elizaos/plugin-para';

export const characterConfig = {
  // ... other config
  plugins: [paraPlugin],
  settings: {
    secrets: {
      PARA_API_KEY: process.env.PARA_API_KEY,
      PARA_ENV: process.env.PARA_ENV || 'production'
    }
  }
};

Usage

The plugin adds several capabilities to your Eliza agent:

Creating Wallets

// The agent can create wallets in response to user requests
await runtime.triggerAction("CREATE_PARA_WALLET", {
  type: "EVM"
});

Pre-generating Wallets

// Create a wallet for a user before they sign up
await runtime.triggerAction("CREATE_PREGEN_WALLET", {
  pregenIdentifier: "user@example.com",
  pregenIdentifierType: "EMAIL"
});

Signing Messages

// Sign a message with a user's wallet
await runtime.triggerAction("SIGN_PARA_MESSAGE", {
  walletId: "wallet-id",
  message: "Hello, World!"
});

Signing Transactions

// Sign and submit an EVM transaction
await runtime.triggerAction("SIGN_PARA_TRANSACTION", {
  walletId: "wallet-id",
  transaction: {
    to: "0x1234567890123456789012345678901234567890",
    value: "0.01"
  },
  chainId: "1" // Ethereum mainnet
});

Claiming Pre-generated Wallets

// Users can claim their pre-generated wallets
await runtime.triggerAction("CLAIM_PARA_WALLET", {
  pregenIdentifier: "user@example.com",
  pregenIdentifierType: "EMAIL"
});

Checking Wallet Status

// Get current wallet status through the provider
const walletInfo = await runtime.getContextFromProvider("paraWalletProvider");

Actions

The plugin provides the following actions:

Providers

Available providers for context and status:

Services

The plugin registers the following services in the Eliza runtime:

Viem Integration

The plugin uses Viem for Ethereum transactions, offering:

• 🚀 Modern and efficient transaction handling
• 🔧 Type-safe API for Ethereum interactions
• ⚡ Multi-chain support out of the box
• 🔄 Compatible with the Para Viem connector

// Example of transaction handling with Viem
await runtime.triggerAction("SIGN_PARA_TRANSACTION", {
  walletId: "wallet-id",
  transaction: {
    to: "0x1234567890123456789012345678901234567890",
    value: "0.05",
    data: "0x..." // Optional contract interaction data
  },
  chainId: "137" // Polygon
});

Session Management

The plugin implements Para's session management for maintaining authenticated states:

const paraService = runtime.getService<ParaWalletService>(ExtendedServiceType.PARA_WALLET);

// Check if session is active
const isActive = await paraService.isSessionActive();

// Keep session alive
if (isActive) {
  await paraService.keepSessionAlive();
} else {
  await paraService.refreshSession();
}

User Share Management

Secure handling of user shares for pre-generated wallets:

// Get user share after wallet creation
const { wallet, userShare } = await paraService.createPregenWallet({
  pregenIdentifier: "user@example.com",
  pregenIdentifierType: "EMAIL"
});

// Store user share securely
await secureStorage.set(`user-share-${wallet.id}`, userShare);

// Restore user share when needed
await paraService.setUserShare({
  userShare: await secureStorage.get(`user-share-${walletId}`)
});

Error Handling

The plugin implements comprehensive error handling following Eliza's patterns:

try {
  await runtime.triggerAction("SIGN_PARA_TRANSACTION", params);
} catch (error) {
  if (error instanceof TransactionReviewDenied) {
    // Handle user denial
    console.log("User denied the transaction");
  } else if (error instanceof TransactionReviewTimeout) {
    // Handle timeout
    console.log("Transaction review timed out", error.transactionReviewUrl);
  } else {
    // Handle other errors
    console.error("Transaction error:", error);
  }
}

Multi-Chain Support

The plugin supports a variety of EVM-compatible networks:

Additional networks can be added by extending the chain configuration.

Best Practices

1. Security

   • Store API keys securely in environment variables
   • Implement proper user authentication before wallet operations
   • Use secure storage for user shares
   • Follow Para's recommendations for session management

2. Error Handling

   • Implement proper error handling for all wallet operations
   • Handle transaction rejections and timeouts gracefully
   • Provide clear feedback to users when operations fail
   • Log errors appropriately for debugging

3. Performance

   • Keep track of session status to avoid unnecessary refreshes
   • Implement proper caching for wallet information
   • Use appropriate gas parameters for transactions
   • Handle network congestion scenarios with retry logic

4. User Experience

   • Guide users through the wallet creation process
   • Provide clear status updates during operations
   • Implement proper loading states during transaction signing
   • Give feedback on transaction progress and confirmations

Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT License - see the LICENSE file for details.

Related

• Eliza Documentation
• Para Documentation
• Plugin Examples
• Viem Documentation