EOA Authentication

EOA Auth demonstrates direct EOA usage for PKP management. Your EOA owns and directly manages PKPs, including minting, setting permissions, and viewing permissions. This approach gives you full control over PKP management.

Prerequisites

💰 Need Test Tokens? Visit the Chronicle Yellowstone Faucet to get test tokens for your EOA account.

---

PKPs minted with mintWithEoa require manual permission setup before they can be used for signing operations.

1. Create Account

   Use your connected wallet account to own and manage PKPs.

   import { useWalletClient } from "wagmi";
   
   const { data: myAccount } = useWalletClient();
   

2. Mint PKP with EOA

   Mint a new Programmable Key Pair (PKP) using your EOA. The PKP will be owned by your EOA account.

   You will need to manually add permissions to the PKP before it can be used for signing.

   const mintedPkpWithEoa = await litClient.mintWithEoa({
     account: myAccount,
   });
   

3. Get PKP Permissions Manager

   Instantiate a PKP permissions manager to control your PKP permissions. This manager allows you to add, remove, and modify permissions for your PKP.

   const pkpPermissionsManager = await litClient.getPKPPermissionsManager({
     pkpIdentifier: {
       tokenId: mintedPkpWithEoa.data.tokenId,
     },
     account: myAccount,
   });
   

4. View PKP Permissions

   View all current permissions associated with your PKP. This shows what actions and scopes are currently allowed.

   const res = await litClient.viewPKPPermissions({
     tokenId: mintedPkpWithEoa.data.tokenId,
   });
   
   console.log("✅ viewPKPPermissions:", res);
   

5. Add Signing Permissions

   Add permissions to allow your PKP to be used for signing operations. This adds the “sign anything” scope which enables general signing functionality.

   // Add permissions to allow the PKP to be used for signing
   const addPermissionsTx = await pkpPermissionsManager.addPermittedAction({
     ipfsId: "QmWGkjZKcfsE9nabey7cXf8ViZ5Mf5CvLFTHbsYa79s3ER",
     scopes: ["sign-anything"],
   });
   

EOA-Based Authentications

Key Differences:

• EOA Native: Direct EOA ownership and management of PKPs with manual permission setup
• EOA Auth Method: EOA used as authentication mechanism, similar to Google/Discord auth patterns