fhevm-universal-sdk

Universal SDK untuk integrasi FHEVM di aplikasi web dan React.

Instalasi

pnpm add fhevm-universal-sdk

Peer dependencies:

• ethers (v6)
• @zama-fhe/relayer-sdk (>= 0.2.0)
• react (v18 atau v19) untuk adapter React

Core Usage (tanpa React)

import { createInstanceWithRelayer } from "fhevm-universal-sdk";
import { ethers } from "ethers";

async function main() {
  const rpcUrl = process.env.RPC_URL!; // set environment
  const relayerUrl = process.env.RELAYER_URL!; // URL relayer Zama
  const aclAddress = process.env.ACL_ADDRESS; // opsional, jika ada

  const provider = new ethers.JsonRpcProvider(rpcUrl);
  const chainId = (await provider.getNetwork()).chainId;

  const fhevm = await createInstanceWithRelayer({
    ethersProvider: provider,
    relayerUrl,
    chainId,
    aclContractAddress: aclAddress,
  });

  // Contoh membuat input terenkripsi untuk kontrak
  const contractAddress = "0xYourContract";
  const encrypted = await fhevm
    .createEncryptedInput(contractAddress)
    .add(123n)
    .encrypt();

  console.log("ciphertext:", encrypted);
}

React Usage (hooks)

import { useEffect } from "react";
import { ethers } from "ethers";
import { useFhevm, useFHEEncryption, useFHEDecrypt } from "fhevm-universal-sdk/react";

export default function Page() {
  const rpcUrl = process.env.NEXT_PUBLIC_RPC_URL!;
  const relayerUrl = process.env.NEXT_PUBLIC_RELAYER_URL!;
  const contractAddress = process.env.NEXT_PUBLIC_CONTRACT_ADDRESS!;

  const provider = new ethers.JsonRpcProvider(rpcUrl);

  const { status, message, error, fhevm, init } = useFhevm({
    ethersProvider: provider,
    relayerUrl,
  });

  const { canEncrypt, encryptWith } = useFHEEncryption({
    fhevm,
    contractAddress,
    // gunakan signer dari wallet (contoh: window.ethereum)
    ethersSigner: new ethers.Wallet("<private-key>", provider),
  });

  const { state, requestDecrypt } = useFHEDecrypt({
    fhevm,
    relayerUrl,
    contractAddress,
    ethersSigner: new ethers.Wallet("<private-key>", provider),
  });

  useEffect(() => {
    if (status === "idle") init();
  }, [status, init]);

  return (
    <div>
      <p>Status: {status}</p>
      {message && <p>{message}</p>}
      {error && <p>Error: {String(error)}</p>}

      <button
        disabled={!canEncrypt}
        onClick={async () => {
          const input = await encryptWith((builder) => builder.add(42n).encrypt());
          console.log("encrypted input", input);
        }}
      >
        Encrypt 42
      </button>

      <button
        onClick={async () => {
          const res = await requestDecrypt({
            // payload/result ciphertext dari kontrak
            ciphertext: "0x...",
            // domain & types EIP-712 sesuai kontrak
            domain: { name: "FHEVM", version: "1", chainId: 1337 },
            types: { /* isi EIP-712 types */ },
          });
          console.log("decrypted:", res);
        }}
      >
        Request Decrypt
      </button>
    </div>
  );
}

Publish

1. Build paket: pnpm --filter ./packages/fhevm-universal-sdk build
2. Login npm (sekali saja, interaktif): npm login
3. Atur token via PowerShell (opsional):

$env:NPM_TOKEN = "<your-token>"
npm config set //registry.npmjs.org/:_authToken $env:NPM_TOKEN

4. Publish scoped package: npm publish --access public (jalankan di folder paket)