nucypher · Muhammad-Altabba · Aug 12, 2025 · Aug 13, 2025 · Aug 13, 2025 · Aug 13, 2025
diff --git a/examples/taco/react-viem/README.md b/examples/taco/react-viem/README.md
@@ -0,0 +1,17 @@
+# `react-viem-taco` integration example
+
+Shows how to integrate `@nucypher/taco` into a React application using viem.
+## Usage
+
+```bash
+pnpm install
+pnpm start
+```
+
+Next, go to [http://127.0.0.1:3000/](http://127.0.0.1:8080/) in your browser and
+inspect the UI and the JS console.
+
+## Learn more
+
+Please find developer documentation for
+TACo [here](https://docs.taco.build/).
diff --git a/examples/taco/react-viem/package.json b/examples/taco/react-viem/package.json
@@ -0,0 +1,42 @@
+{
+  "name": "taco-react-example",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "build": "react-scripts build",
+    "check": "pnpm type-check && pnpm build",
+    "eject": "react-scripts eject",
+    "start": "react-scripts start",
+    "test": "react-scripts test",
+    "type-check": "tsc -p tsconfig.build.json"
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 1 chrome version",
+      "last 1 firefox version",
+      "last 1 safari version"
+    ]
+  },
+  "dependencies": {
+    "@nucypher/shared": "workspace:*",
+    "@nucypher/taco": "workspace:*",
+    "@nucypher/taco-auth": "workspace:*",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.28",
+    "@types/react": "^18.3.20",
+    "@types/react-dom": "^18.3.5",
+    "react-scripts": "^5.0.1"
+  },
+  "peerDependencies": {
+    "ethers": "^5.7.2",
+    "viem": "^2.0.0"
+  }
+}
diff --git a/examples/taco/react-viem/public/favicon.ico b/examples/taco/react-viem/public/favicon.ico
diff --git a/examples/taco/react-viem/public/index.html b/examples/taco/react-viem/public/index.html
@@ -0,0 +1,43 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" href="%PUBLIC_URL%/favicon.ico" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="theme-color" content="#000000" />
+    <meta
+      name="description"
+      content="Web site created using create-react-app"
+    />
+    <link rel="apple-touch-icon" href="%PUBLIC_URL%/logo192.png" />
+    <!--
+      manifest.json provides metadata used when your web app is installed on a
+      user's mobile device or desktop. See https://developers.google.com/web/fundamentals/web-app-manifest/
+    -->
+    <link rel="manifest" href="%PUBLIC_URL%/manifest.json" />
+    <!--
+      Notice the use of %PUBLIC_URL% in the tags above.
+      It will be replaced with the URL of the `public` folder during the build.
+      Only files inside the `public` folder can be referenced from the HTML.
+
+      Unlike "/favicon.ico" or "favicon.ico", "%PUBLIC_URL%/favicon.ico" will
+      work correctly both with client-side routing and a non-root public URL.
+      Learn how to configure a non-root public URL by running `npm run build`.
+    -->
+    <title>React App</title>
+  </head>
+  <body>
+    <noscript>You need to enable JavaScript to run this app.</noscript>
+    <div id="root"></div>
+    <!--
+      This HTML file is a template.
+      If you open it directly in the browser, you will see an empty page.
+
+      You can add webfonts, meta tags, or analytics to this file.
+      The build step will place the bundled scripts into the <body> tag.
+
+      To begin the development, run `npm start` or `yarn start`.
+      To create a production bundle, use `npm run build` or `yarn build`.
+    -->
+  </body>
+</html>
diff --git a/examples/taco/react-viem/public/logo192.png b/examples/taco/react-viem/public/logo192.png
diff --git a/examples/taco/react-viem/public/logo512.png b/examples/taco/react-viem/public/logo512.png
diff --git a/examples/taco/react-viem/public/manifest.json b/examples/taco/react-viem/public/manifest.json
@@ -0,0 +1,25 @@
+{
+  "short_name": "React App",
+  "name": "Create React App Sample",
+  "icons": [
+    {
+      "src": "favicon.ico",
+      "sizes": "64x64 32x32 24x24 16x16",
+      "type": "image/x-icon"
+    },
+    {
+      "src": "logo192.png",
+      "type": "image/png",
+      "sizes": "192x192"
+    },
+    {
+      "src": "logo512.png",
+      "type": "image/png",
+      "sizes": "512x512"
+    }
+  ],
+  "start_url": ".",
+  "display": "standalone",
+  "theme_color": "#000000",
+  "background_color": "#ffffff"
+}
diff --git a/examples/taco/react-viem/public/robots.txt b/examples/taco/react-viem/public/robots.txt
@@ -0,0 +1,3 @@
+# https://www.robotstxt.org/robotstxt.html
+User-agent: *
+Disallow:
diff --git a/examples/taco/react-viem/src/App.tsx b/examples/taco/react-viem/src/App.tsx
@@ -0,0 +1,164 @@
+import { fromHexString } from '@nucypher/shared';
+import { conditions, domains, fromBytes, toHexString } from '@nucypher/taco';
+import { hexlify } from 'ethers/lib/utils';
+import { useEffect, useState } from 'react';
+import { 
+  createPublicClient, 
+  createWalletClient, 
+  custom, 
+  PublicClient,
+  WalletClient
+} from 'viem';
+import { polygonAmoy } from 'viem/chains';
+
+import useTaco from './hooks/useTaco';
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+declare const window: any;
+
+const ritualId = 6; // Replace with your own ritual ID
+const domain = domains.TESTNET;
+
+function App() {
+  const [publicClient, setPublicClient] = useState<PublicClient>();
+  const [walletClient, setWalletClient] = useState<WalletClient>();
+  const [message, setMessage] = useState('this is a secret');
+  const [encrypting, setEncrypting] = useState(false);
+  const [encryptedText, setEncryptedText] = useState<string | undefined>('');
+  const [decrypting, setDecrypting] = useState(false);
+  const [decryptedMessage, setDecryptedMessage] = useState<string | undefined>(
+    '',
+  );
+
+  const loadWeb3Provider = async () => {
+    if (!window.ethereum) {
+      console.error('You need to connect to your wallet first');
+      return;
+    }
+
+    // Request account access
+    await window.ethereum.request({ method: 'eth_requestAccounts' });
+
+    // Create public client for reading data
+    const publicClient = createPublicClient({
+      chain: polygonAmoy,
+      transport: custom(window.ethereum),
+    });
+
+    // Get the accounts from the provider
+    const [account] = await window.ethereum.request({
+      method: 'eth_accounts'
+    });
+    // Create wallet client for signing the message
+    const walletClient = createWalletClient({
+      account,
+      chain: polygonAmoy,
+      transport: custom(window.ethereum),
+    });
+
+    const chainId = await publicClient.getChainId();
+    const amoyChainId = 80002;
+    if (chainId !== amoyChainId) {
+      // Switch to Polygon Amoy testnet
+      await window.ethereum.request({
+        method: 'wallet_switchEthereumChain',
+        params: [{ chainId: hexlify(amoyChainId) }],
+      });
+    }
+
+    setPublicClient(publicClient);
+    setWalletClient(walletClient);
+  };
+
+  useEffect(() => {
+    loadWeb3Provider();
+  }, []);
+
+  const { isInit, encryptDataToBytes, decryptDataFromBytes } = useTaco({
+    domain,
+    publicClient,
+    walletClient,
+    ritualId,
+  });
+
+  if (!isInit || !publicClient || !walletClient) {
+    return <div>Loading...</div>;
+  }
+
+  const encryptMessage = async () => {
+    if (!walletClient) {
+      return;
+    }
+    setEncrypting(true);
+    try {
+      const hasPositiveBalance = new conditions.base.rpc.RpcCondition({
+        chain: 80002,
+        method: 'eth_getBalance',
+        parameters: [':userAddress', 'latest'],
+        returnValueTest: {
+          comparator: '>=',
+          value: 0,
+        },
+      });
+
+      console.log('Encrypting message...');
+      const encryptedBytes = await encryptDataToBytes(
+        message,
+        hasPositiveBalance,
+      );
+      if (encryptedBytes) {
+        setEncryptedText(toHexString(encryptedBytes));
+      }
+    } catch (e) {
+      console.log(e);
+    }
+    setEncrypting(false);
+  };
+
+  const decryptMessage = async () => {
+    if (!encryptedText || !walletClient) {
+      return;
+    }
+    try {
+      setDecrypting(true);
+
+      console.log('Decrypting message...');
+      const decryptedMessage = await decryptDataFromBytes(
+        fromHexString(encryptedText),
+      );
+      if (decryptedMessage) {
+        setDecryptedMessage(fromBytes(decryptedMessage));
+      }
+    } catch (e) {
+      console.log(e);
+    }
+    setDecrypting(false);
+  };
+
+  return (
+    <div>
+      <h2>
+        Secret message:{' '}
+        <input
+          value={message}
+          onChange={(e) => setMessage(e.target.value)}
+          onClick={encryptMessage}
+        />{' '}
+        <button onClick={encryptMessage}>Encrypt</button>{' '}
+        {encrypting && 'Encrypting...'}
+      </h2>
+      <h2>
+        Encrypted message:{' '}
+        <input
+          value={encryptedText}
+          onChange={(e) => setEncryptedText(e.target.value)}
+        />{' '}
+        <button onClick={decryptMessage}>Decrypt</button>{' '}
+        {decrypting && 'Decrypting...'}
+      </h2>
+      {decryptedMessage && <h2>Decrypted message: {decryptedMessage}</h2>}
+    </div>
+  );
+}
+
+export default App;