midnight-mcp 0.1.4 → 0.1.6

package/dist/pipeline/repository.js

@@ -147,7 +147,9 @@ const EXAMPLES = [
  * Resolve repository name alias to owner/repo
  */
 function resolveRepo(repoName) {
-    const normalized = repoName.toLowerCase().replace(/^midnightntwrk\//, "");
+    // Default to compact if not provided
+    const name = repoName || "compact";
+    const normalized = name.toLowerCase().replace(/^midnightntwrk\//, "");
     const alias = REPO_ALIASES[normalized];
     if (alias)
         return alias;
@@ -158,8 +160,8 @@ function resolveRepo(repoName) {
         }
     }
     // Assume it's a full org/repo name
-    if (repoName.includes("/")) {
-        const [owner, repo] = repoName.split("/");
+    if (name.includes("/")) {
+        const [owner, repo] = name.split("/");
         return { owner, repo };
     }
     return null;
@@ -278,7 +280,8 @@ export async function getLatestUpdates(input) {
 export async function getVersionInfo(input) {
     logger.debug("Getting version info", input);
     // Special handling for "midnight-examples" - redirect to listing examples
-    const normalizedRepo = input.repo.toLowerCase();
+    const repoName = input.repo || "compact";
+    const normalizedRepo = repoName.toLowerCase();
     if (normalizedRepo === "midnight-examples" || normalizedRepo === "examples") {
         const exampleRepos = ["example-counter", "example-bboard", "example-dex"];
         const versions = await Promise.all(exampleRepos.map(async (repoName) => {

package/dist/resources/content/docs-content.js

@@ -727,6 +727,167 @@ export function useWallet() {
 3. Store connection state in context
 4. Provide clear loading/error feedback
 5. Test with Midnight Lace extension
+`,
+    // Common Errors Reference - VERIFIED from official Midnight documentation
+    "midnight://docs/common-errors": `# Common Midnight Errors & Solutions
+
+Verified error messages from official Midnight documentation.
+
+## Version Mismatch Errors
+
+**Source:** [Fix version mismatch errors guide](https://docs.midnight.network/how-to/fix-version-mismatches)
+
+Version mismatches occur when Midnight components are out of sync:
+- Compact compiler
+- Runtime libraries (@midnight-ntwrk/compact-runtime, @midnight-ntwrk/ledger)
+- Proof server
+- Indexer
+
+### "Version mismatch" / CompactError
+\`\`\`javascript
+// The runtime checks version compatibility on startup
+throw new __compactRuntime.CompactError(\`Version mismatch...\`);
+\`\`\`
+
+**Fix:** Check versions and update all components together:
+\`\`\`bash
+# Check your versions
+compact --version
+npm list @midnight-ntwrk/compact-runtime
+npm list @midnight-ntwrk/ledger
+
+# Consult the compatibility matrix
+# https://docs.midnight.network/relnotes/support-matrix
+\`\`\`
+
+## Compact Compiler Errors
+
+### "invalid context for a ledger ADT type"
+**Source:** Compact 0.15/0.23 release notes
+
+Ledger ADT types (Counter, Map, etc.) cannot be used as Compact types in casts.
+
+\`\`\`compact
+// ❌ Wrong - casting to ledger ADT type
+const x = value as Counter;  // Error!
+
+// ✅ Correct - use the ledger field directly
+ledger.counter.increment(1);
+\`\`\`
+
+### "static type error" - argument count/type mismatch
+**Source:** Compact runtime type checks
+
+\`\`\`javascript
+// Runtime validates argument counts
+if (args_1.length !== 2)
+  throw new __compactRuntime.CompactError(
+    \`post: expected 2 arguments, received \${args_1.length}\`
+  );
+\`\`\`
+
+**Fix:** Ensure TypeScript calls match circuit signatures exactly.
+
+### assert() failures
+**Source:** [Compact language reference](https://docs.midnight.network/develop/reference/compact/lang-ref)
+
+\`\`\`compact
+// Assert syntax (Compact 0.16+)
+assert(condition, "error message");
+
+// Example from bboard tutorial
+assert(ledger.state == State.VACANT, "Attempted to post to an occupied board");
+\`\`\`
+
+**Note:** If assertion fails, the transaction fails without reaching the chain.
+
+## TypeScript SDK Errors
+
+### ContractTypeError
+**Source:** @midnight-ntwrk/midnight-js-contracts
+
+Thrown when there's a contract type mismatch between the given contract type
+and the initial state deployed at a contract address.
+
+\`\`\`typescript
+// Typically thrown by findDeployedContract()
+try {
+  const contract = await findDeployedContract(provider, address, MyContract);
+} catch (e) {
+  if (e instanceof ContractTypeError) {
+    // The contract at this address is a different type
+    console.error('Contract type mismatch:', e.circuitIds);
+  }
+}
+\`\`\`
+
+### type_error() - Runtime type errors
+**Source:** @midnight-ntwrk/compact-runtime
+
+Internal function for type errors with parameters: who, what, where, type, value.
+
+## DApp Connector Errors
+
+**Source:** @midnight-ntwrk/dapp-connector-api ErrorCodes
+
+\`\`\`typescript
+import { ErrorCodes } from '@midnight-ntwrk/dapp-connector-api';
+
+// ErrorCodes.Rejected - User rejected the request
+// ErrorCodes.InvalidRequest - Malformed transaction or request
+// ErrorCodes.InternalError - DApp connector couldn't process request
+
+try {
+  const api = await window.midnight.mnLace.enable();
+} catch (error) {
+  if (error.code === ErrorCodes.Rejected) {
+    console.log('User rejected wallet connection');
+  }
+}
+\`\`\`
+
+## Node.js Environment Errors
+
+### ERR_UNSUPPORTED_DIR_IMPORT
+**Source:** [BBoard tutorial troubleshooting](https://docs.midnight.network/develop/tutorial/3-creating/bboard-dapp)
+
+Occurs due to environment caching after modifying shell config or changing Node versions.
+
+**Fix:**
+\`\`\`bash
+# 1. Open a NEW terminal window (don't just source ~/.zshrc)
+# 2. Verify Node version
+nvm use 18
+
+# 3. Clear cached modules
+rm -rf node_modules/.cache
+\`\`\`
+
+## Transaction Errors
+
+### INSUFFICIENT_FUNDS / Not enough tDUST
+**Source:** Midnight documentation examples
+
+\`\`\`typescript
+try {
+  const result = await sdk.sendTransaction(options);
+} catch (error) {
+  if (error.code === 'INSUFFICIENT_FUNDS') {
+    console.error('Not enough tDUST in wallet');
+    // Direct user to testnet faucet
+  }
+}
+\`\`\`
+
+## Debugging Resources
+
+1. **Compatibility Matrix:** [/relnotes/support-matrix](https://docs.midnight.network/relnotes/support-matrix)
+2. **Discord:** #developer-support channel
+3. **Recompile after updates:**
+   \`\`\`bash
+   rm -rf contract/*.cjs contract/*.prover contract/*.verifier
+   compact compile src/contract.compact contract/
+   \`\`\`
 `,
 };
 //# sourceMappingURL=docs-content.js.map

package/dist/resources/docs.js

@@ -58,6 +58,12 @@ export const documentationResources = [
         description: "DApp Connector API for Midnight Lace wallet - React hooks, TypeScript types",
         mimeType: "text/markdown",
     },
+    {
+        uri: "midnight://docs/common-errors",
+        name: "Common Errors & Solutions",
+        description: "Troubleshooting guide: compiler errors, SDK errors, deployment issues with fixes",
+        mimeType: "text/markdown",
+    },
 ];
 /**
  * Get documentation content by URI

package/dist/server.js

@@ -7,10 +7,10 @@ import { allTools } from "./tools/index.js";
 import { allResources, getDocumentation, getCode, getSchema, } from "./resources/index.js";
 import { promptDefinitions, generatePrompt } from "./prompts/index.js";
 import { registerSamplingCallback } from "./services/index.js";
-// Server information
+// Server information - version should match package.json
 const SERVER_INFO = {
     name: "midnight-mcp",
-    version: "1.0.0",
+    version: "0.1.4",
     description: "MCP Server for Midnight Blockchain Development",
 };
 // Resource subscriptions tracking

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "midnight-mcp",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Model Context Protocol Server for Midnight Blockchain Development",
   "type": "module",
   "main": "dist/index.js",