@hybrd/xmtp 1.0.0 → 1.0.3

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+
+> @hybrd/xmtp@1.0.3 build /Users/ian/Projects/01/hybrid/packages/xmtp
+> tsc
+

package/.turbo/turbo-lint$colon$fix.log

@@ -0,0 +1,6 @@
+
+
+> @hybrd/xmtp@1.0.2 lint:fix /Users/ian/Projects/01/hybrid/packages/xmtp
+> biome lint --write --unsafe
+
+Checked 23 files in 24ms. No fixes applied.

package/dist/scripts/generate-keys.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/generate-keys.js

@@ -0,0 +1,19 @@
+import { generateEncryptionKeyHex } from "@hybrd/xmtp";
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+// Check Node.js version
+const nodeVersion = process.versions.node;
+const [major] = nodeVersion?.split(".").map(Number) || [0];
+if (major && major < 20) {
+    console.error("Error: Node.js version 20 or higher is required");
+    process.exit(1);
+}
+console.log("Generating XMTP keys...");
+const walletKey = generatePrivateKey();
+const account = privateKeyToAccount(walletKey);
+const encryptionKeyHex = generateEncryptionKeyHex();
+const publicKey = account.address;
+console.log("\n# === Generated Keys ===");
+console.log(`# Public Address: ${publicKey}`);
+console.log(`XMTP_WALLET_KEY=${walletKey}`);
+console.log(`XMTP_ENCRYPTION_KEY=${encryptionKeyHex}`);
+console.log("\nCopy the above environment variables to your .env file");

package/dist/scripts/refresh-identity.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/refresh-identity.js

@@ -0,0 +1,93 @@
+import { createXMTPClient, logAgentDetails, validateEnvironment } from "../src/client";
+/**
+ * Refresh XMTP Identity Script
+ *
+ * This script refreshes the bot's XMTP identity on the production network
+ * to resolve association errors and missing identity updates
+ */
+async function refreshXMTPIdentity() {
+    console.log("🔄 XMTP Identity Refresh");
+    console.log("========================");
+    // Validate environment
+    const { XMTP_WALLET_KEY } = validateEnvironment(["XMTP_WALLET_KEY"]);
+    if (!XMTP_WALLET_KEY) {
+        console.error("❌ XMTP_WALLET_KEY is required");
+        process.exit(1);
+    }
+    try {
+        console.log(`🌐 Environment: ${process.env.XMTP_ENV || "dev"}`);
+        // Step 1: Create client with persistence to force identity refresh
+        console.log("\n📋 Step 1: Creating client with persistence...");
+        const persistentClient = await createXMTPClient(XMTP_WALLET_KEY, {
+            persist: true
+        });
+        console.log(`🔑 Wallet Address: ${persistentClient.accountIdentifier?.identifier}`);
+        console.log(`🌐 XMTP Environment: ${process.env.XMTP_ENV || "dev"}`);
+        // Step 2: Force full sync
+        console.log("\n📋 Step 2: Forcing full conversation sync...");
+        await persistentClient.conversations.sync();
+        // Step 3: List conversations
+        const conversations = await persistentClient.conversations.list();
+        console.log(`📬 Found ${conversations.length} conversations`);
+        // Step 4: Display agent details
+        console.log("\n📋 Step 3: Displaying refreshed identity details...");
+        await logAgentDetails(persistentClient);
+        // Step 5: Test identity resolution
+        console.log("\n📋 Step 4: Testing identity resolution...");
+        if (conversations.length > 0) {
+            const testConv = conversations[0];
+            if (!testConv) {
+                console.log("❌ No valid conversation found");
+                return;
+            }
+            try {
+                // Get all participants
+                const members = await testConv.members();
+                console.log(`👥 Conversation members: ${members.length}`);
+                for (const member of members) {
+                    console.log(`   - Inbox ID: ${member.inboxId}`);
+                    console.log(`   - Installation IDs: ${member.installationIds.length}`);
+                    // Try to resolve addresses
+                    try {
+                        const inboxState = await persistentClient.preferences.inboxStateFromInboxIds([
+                            member.inboxId
+                        ]);
+                        if (inboxState.length > 0 &&
+                            inboxState[0] &&
+                            inboxState[0].identifiers.length > 0) {
+                            const identifier = inboxState[0]?.identifiers[0]?.identifier;
+                            console.log(`   - Address: ${identifier || "Unable to resolve"}`);
+                        }
+                        else {
+                            console.log(`   - Address: Unable to resolve`);
+                        }
+                    }
+                    catch (error) {
+                        const err = error;
+                        console.log(`   - Address: Error resolving - ${err.message}`);
+                    }
+                }
+            }
+            catch (error) {
+                const err = error;
+                console.log(`❌ Error testing conversation: ${err.message}`);
+            }
+        }
+        console.log("\n✅ Identity refresh completed successfully!");
+        console.log("🔄 Try processing messages again");
+    }
+    catch (error) {
+        const err = error;
+        console.error("❌ Identity refresh failed:", err);
+        if (err.message.includes("XMTP_ENCRYPTION_KEY")) {
+            console.log("\n💡 Add XMTP_ENCRYPTION_KEY to your environment:");
+            console.log("   export XMTP_ENCRYPTION_KEY=your_key_here");
+            console.log("   Or run: pnpm with-env pnpm --filter @hybrd/xmtp refresh:identity");
+        }
+        process.exit(1);
+    }
+}
+// Run the refresh
+if (require.main === module) {
+    refreshXMTPIdentity().catch(console.error);
+}

package/dist/scripts/register-wallet.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/register-wallet.js

@@ -0,0 +1,75 @@
+import { createSigner, createXMTPClient, getDbPath, logAgentDetails, validateEnvironment } from "../src/client";
+async function registerOnProduction() {
+    console.log("🚀 Starting XMTP Production Network Registration...");
+    // Validate required environment variables
+    const { XMTP_WALLET_KEY } = validateEnvironment([
+        "XMTP_WALLET_KEY",
+        "XMTP_ENCRYPTION_KEY"
+    ]);
+    if (!XMTP_WALLET_KEY) {
+        console.error("❌ XMTP_WALLET_KEY is required for registration");
+        process.exit(1);
+    }
+    try {
+        console.log("🔑 Creating signer...");
+        const signer = createSigner(XMTP_WALLET_KEY);
+        // Get wallet address for logging
+        const identifier = await signer.getIdentifier();
+        const address = identifier.identifier;
+        console.log(`📍 Wallet Address: ${address}`);
+        console.log("🌐 Connecting to XMTP Production Network...");
+        console.log("⚠️  This will prompt you to sign messages in your wallet");
+        console.log("   - 'XMTP : Authenticate to inbox' message");
+        console.log("   - 'Grant messaging access to app' message");
+        console.log("   - 'Create inbox' message (if first time)");
+        // Use getDbPath to ensure directory creation and proper path handling
+        const dbPath = getDbPath(`production-${address}`);
+        console.log(`📁 Database path: ${dbPath}`);
+        // Connect to production network
+        const client = await createXMTPClient(XMTP_WALLET_KEY);
+        console.log("✅ Successfully connected to XMTP Production Network!");
+        // Log client details
+        await logAgentDetails(client);
+        console.log("📡 Syncing conversations...");
+        await client.conversations.sync();
+        const conversations = await client.conversations.list();
+        console.log(`💬 Found ${conversations.length} existing conversations`);
+        console.log("🎉 Registration Complete!");
+        console.log(`
+✓ Wallet ${address} is now registered on XMTP Production Network
+✓ Inbox ID: ${client.inboxId}
+✓ Database: production-${address}.db3
+✓ Ready to receive messages on production network
+
+Next steps:
+1. Update your environment: XMTP_ENV=production
+2. Start your listener service
+3. Share your address for others to message: ${address}
+4. Test messaging at: https://xmtp.chat/dm/${address}
+    `);
+    }
+    catch (error) {
+        console.error("❌ Registration failed:", error);
+        if (error instanceof Error) {
+            if (error.message.includes("User rejected")) {
+                console.log("📝 Registration was cancelled. You need to approve the wallet signatures to complete registration.");
+            }
+            else if (error.message.includes("network")) {
+                console.log("🌐 Network connection issue. Please check your internet connection and try again.");
+            }
+            else if (error.message.includes("database") ||
+                error.message.includes("Unable to open")) {
+                console.log("💾 Database access issue. Please check file permissions and ensure the directory exists.");
+            }
+            else {
+                console.log("💡 Make sure your wallet is connected and try again.");
+            }
+        }
+        process.exit(1);
+    }
+}
+// Run registration
+registerOnProduction().catch((error) => {
+    console.error("💥 Fatal error during registration:", error);
+    process.exit(1);
+});

package/dist/scripts/revoke-all-installations.d.ts

@@ -0,0 +1,2 @@
+declare function revokeAllInstallations(): Promise<void>;
+export { revokeAllInstallations };

package/dist/scripts/revoke-all-installations.js

@@ -0,0 +1,68 @@
+import { createXMTPClient, validateEnvironment } from "../src/client";
+import { revokeOldInstallations } from "./revoke-installations";
+async function revokeAllInstallations() {
+    console.log("🔄 Revoking ALL XMTP Installations");
+    console.log("==================================");
+    // Validate environment
+    const { XMTP_WALLET_KEY } = validateEnvironment(["XMTP_WALLET_KEY"]);
+    if (!XMTP_WALLET_KEY) {
+        console.error("❌ XMTP_WALLET_KEY is required");
+        process.exit(1);
+    }
+    try {
+        console.log(`🌐 Environment: ${process.env.XMTP_ENV || "dev"}`);
+        // Try to create client to get current inbox ID
+        try {
+            const client = await createXMTPClient(XMTP_WALLET_KEY);
+            const currentInboxId = client.inboxId;
+            console.log(`📧 Current Inbox ID: ${currentInboxId}`);
+            console.log("🔧 Attempting to revoke all installations for this inbox...");
+            const success = await revokeOldInstallations(client.signer, currentInboxId);
+            // Create signer
+            console.log(`🔑 Wallet Address: ${client.accountIdentifier?.identifier}`);
+            if (success) {
+                console.log("✅ Successfully revoked all installations");
+            }
+            else {
+                console.log("❌ Failed to revoke installations");
+                process.exit(1);
+            }
+        }
+        catch (clientError) {
+            console.log("⚠️ Could not create client, attempting alternative approach...");
+            // If we can't create a client, it might be because of installation limits
+            // Try to manually construct possible inbox IDs or use a different approach
+            console.log("🔍 This might indicate installation limit issues");
+            console.log("💡 You may need to:");
+            console.log("   1. Wait a few minutes and try again");
+            console.log("   2. Use the specific inbox ID if you know it");
+            console.log("   3. Try switching XMTP environments (dev <-> production)");
+            throw clientError;
+        }
+    }
+    catch (error) {
+        console.error("💥 Error revoking installations:", error);
+        if (error instanceof Error) {
+            if (error.message.includes("5/5 installations")) {
+                console.log("\n💡 Installation limit reached. Possible solutions:");
+                console.log("   1. Wait 24 hours for installations to expire");
+                console.log("   2. Try switching XMTP environments (dev <-> production)");
+                console.log("   3. Use a different wallet");
+            }
+            else if (error.message.includes("Missing existing member")) {
+                console.log("\n💡 This inbox ID may not exist or may be on a different environment");
+                console.log("   1. Check if you're using the correct XMTP_ENV (dev vs production)");
+                console.log("   2. Verify the inbox ID is correct");
+            }
+        }
+        process.exit(1);
+    }
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    revokeAllInstallations().catch((error) => {
+        console.error("💥 Fatal error:", error);
+        process.exit(1);
+    });
+}
+export { revokeAllInstallations };

package/dist/scripts/revoke-installations.d.ts

@@ -0,0 +1,2 @@
+import { Signer } from "../src/index";
+export declare function revokeOldInstallations(signer: Signer, inboxId?: string): Promise<boolean>;

package/dist/scripts/revoke-installations.js

@@ -0,0 +1,62 @@
+import { Client, createSigner } from "../src/index";
+// Function to revoke old installations when hitting the limit
+export async function revokeOldInstallations(signer, inboxId) {
+    console.log("🔧 Attempting to revoke old installations...");
+    try {
+        // If we don't have the inboxId, we need to extract it from a temporary client attempt
+        if (!inboxId) {
+            console.log("ℹ️ No inboxId provided, cannot revoke installations");
+            return false;
+        }
+        const inboxStates = await Client.inboxStateFromInboxIds([inboxId], process.env.XMTP_ENV);
+        if (!inboxStates[0]) {
+            console.log("❌ No inbox state found for the provided inboxId");
+            return false;
+        }
+        const toRevokeInstallationBytes = inboxStates[0].installations.map((i) => i.bytes);
+        await Client.revokeInstallations(signer, inboxId, toRevokeInstallationBytes, process.env.XMTP_ENV);
+        const resultingStates = await Client.inboxStateFromInboxIds([inboxId], process.env.XMTP_ENV);
+        console.log(`📋 Revoked installations: ${toRevokeInstallationBytes.length} installations`);
+        console.log(`📋 Resulting state: ${resultingStates[0]?.installations.length || 0} installations`);
+        return true;
+    }
+    catch (error) {
+        console.error("❌ Error during installation revocation:", error);
+        return false;
+    }
+}
+// CLI script to revoke installations
+async function main() {
+    const { XMTP_WALLET_KEY } = process.env;
+    const inboxId = process.argv[2];
+    if (!XMTP_WALLET_KEY) {
+        console.error("❌ XMTP_WALLET_KEY is required");
+        process.exit(1);
+    }
+    if (!inboxId) {
+        console.error("❌ InboxID is required as CLI argument");
+        console.error("Usage: tsx revoke-installations.ts <inboxId>");
+        process.exit(1);
+    }
+    const signer = createSigner(XMTP_WALLET_KEY);
+    const identifier = await signer.getIdentifier();
+    const address = identifier.identifier;
+    console.log(`🔑 Wallet Address: ${address}`);
+    console.log(`📋 Inbox ID: ${inboxId}`);
+    // Try to revoke installations
+    const success = await revokeOldInstallations(signer, inboxId);
+    if (success) {
+        console.log("✅ Successfully revoked installations");
+    }
+    else {
+        console.log("❌ Failed to revoke installations");
+        process.exit(1);
+    }
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((error) => {
+        console.error("💥 Fatal error:", error);
+        process.exit(1);
+    });
+}