Client Overview

Privora provides client SDKs for Rust, TypeScript, and React, enabling you to build applications that interact with FHE-enabled Solana programs.

SDK Comparison

Feature	Rust SDK	TypeScript SDK	React SDK
Package	`privora-sdk-client`	`@privora/sdk`	`@privora/react`
Environment	Native, CLI, Backend	Browser, Node.js	React Apps
Async	Tokio async/await	Promise-based	React Hooks
State Management	Manual	Manual	Built-in (Context)
User Recovery UI	Manual	Manual	`useDecryptReveal` hook

Quick Start

React
TypeScript
Rust

npm install @privora/react @privora/sdk

import { PrivoraProvider, usePrivoraContext, useEncrypt } from '@privora/react';

function App() {
  const { signMessage } = useWallet();

  return (
    <PrivoraProvider
      rpcUrl="http://localhost:8899"
      autoInitialize
      signMessage={signMessage}
    >
      <MyComponent />
    </PrivoraProvider>
  );
}

function MyComponent() {
  const { privora, userCrypto, isInitialized } = usePrivoraContext();
  const { encryptAndSubmit } = useEncrypt(privora, userCrypto);

  const handleSubmit = async () => {
    const result = await encryptAndSubmit(100, 'u8');
    console.log('Hash:', result?.hash);
  };

  if (!isInitialized) return <div>Loading...</div>;
  return <button onClick={handleSubmit}>Submit</button>;
}

npm install @privora/sdk

import { Privora } from '@privora/sdk';

const privora = await Privora.connect('http://localhost:8899');
const encrypted = privora.encrypt(100, 'u8');
const hash = await privora.submit(encrypted);
console.log('Submitted:', hash);

[dependencies]
privora-sdk-client = { git = "https://github.com/privora-xyz/privora" }
tokio = { version = "1", features = ["full"] }

use privora_sdk_client::prelude::*;

#[tokio::main]
async fn main() -> Result<()> {
    let privora = PrivoraClient::new("http://localhost:8899").await?;
    let encrypted = privora.encryptor().encrypt(100u8)?;
    let hash = privora.submit(&encrypted).await?;
    println!("Submitted: {:?}", hash);
    Ok(())
}

Core Functionality

1. FHE Encryption

Encrypt values with the network’s FHE public key:

React
TypeScript
Rust

const { encrypt, encryptAndSubmit } = useEncrypt(privora, userCrypto);

// With user recovery (recommended)
const result = await encryptAndSubmit(100, 'u8');

const encrypted = privora.encrypt(100, 'u8');

let price: ClientEncrypted<u8> = encryptor.encrypt(100u8)?;

2. Data Submission

Submit encrypted data to the sequencer:

const hash = await privora.submit(encrypted);

3. User Recovery

Add user-recoverable encryption:

React
TypeScript
Rust

// encryptAndSubmit automatically includes user recovery
const result = await encryptAndSubmit(100, 'u8');
// result.userCiphertext and result.userNonce contain recovery data

const userCrypto = privora.userCrypto(keypair);
const encrypted = privora.encrypt(100, 'u8').withUserRecovery(userCrypto);

let with_recovery = user_crypto.add_recovery(encrypted, &plaintext_bytes)?;

4. Transaction Building

Build and send transactions with FHE data:

const signature = await privora
    .transaction()
    .add(instruction)
    .withFheData([hash])
    .sign(keypair)
    .send();

Next Steps

React Integration

React hooks and components

TypeScript Client

Core TypeScript SDK

Rust Client

Native Rust SDK

Getting Started

Core Concepts

Program Development

Client Integration

Testing

Client Overview

SDK Comparison

Quick Start

Core Functionality

1. FHE Encryption

2. Data Submission

3. User Recovery

4. Transaction Building

Next Steps

React Integration

TypeScript Client

Rust Client

Getting Started

Core Concepts

Program Development

Client Integration

Testing

​SDK Comparison

​Quick Start

​Core Functionality

​1. FHE Encryption

​2. Data Submission

​3. User Recovery

​4. Transaction Building

​Next Steps

React Integration

TypeScript Client

Rust Client

SDK Comparison

Quick Start

Core Functionality

1. FHE Encryption

2. Data Submission

3. User Recovery

4. Transaction Building

Next Steps