@whistlex/sdk 0.1.0 → 0.1.1

package/README.md

@@ -36,6 +36,7 @@ const messageKit = await encryptWithTaco({
   poolAddress: "0xPoolAddressPlaceholder", // use actual pool address after createPool
   payload: keyBytes,
   privateKey: process.env.TACO_PRIVATE_KEY
+  // or: signer: walletSigner (MCP / injected signer)
 });
 
 // 3) On-chain create pool
@@ -53,6 +54,28 @@ await tx.wait();
 // 4) Store metadata via API (see /skill.md for API calls)
 ```
 
+## Dry Run (No On-chain Submission)
+
+```bash
+POOL_ADDRESS=0xYourPool TACO_PRIVATE_KEY=0xyourkey npm run dry-run
+```
+
+This will print:
+- `ciphertextHex` (ready for on-chain calldata)
+- `messageKit` (TACo wrapped DEK)
+
+### Using a Signer (MCP / Injected)
+
+If you have a signer (e.g., Phantom MCP), pass it directly:
+
+```ts
+const messageKit = await encryptWithTaco({
+  poolAddress,
+  payload: keyBytes,
+  signer // wallet signer
+});
+```
+
 ## Notes
 
 - **Intel is encrypted locally**. The SDK never sends plaintext to WhistleX.

package/dist/taco.d.ts

@@ -1,8 +1,10 @@
+import { providers, Wallet } from "ethers";
 export declare const DEFAULT_POLYGON_AMOY_RPC_URL = "https://polygon-amoy.drpc.org";
 export declare const DEFAULT_TACO_RITUAL_ID = 6;
 export declare const DEFAULT_CONDITION_CHAIN_ID = 80002;
 export interface TacoConfig {
     privateKey?: string;
+    signer?: providers.JsonRpcSigner | Wallet;
     dkgRpcUrl?: string;
     conditionRpcUrl?: string;
     conditionChainId?: number;

package/dist/taco.js

@@ -6,15 +6,18 @@ export const DEFAULT_CONDITION_CHAIN_ID = 80002;
 function resolveTacoConfig(config) {
     return {
         key: config.privateKey,
+        signer: config.signer,
         dkg: config.dkgRpcUrl || process.env.TACO_DKG_RPC_URL || DEFAULT_POLYGON_AMOY_RPC_URL,
         condition: config.conditionRpcUrl || process.env.TACO_CONDITION_RPC_URL || DEFAULT_POLYGON_AMOY_RPC_URL,
         conditionChain: config.conditionChainId || DEFAULT_CONDITION_CHAIN_ID,
         ritual: config.ritualId || DEFAULT_TACO_RITUAL_ID
     };
 }
-async function resolveConditionSigner(provider, key) {
+async function resolveConditionSigner(provider, key, signer) {
+    if (signer)
+        return signer;
     if (!key) {
-        throw new Error("TACo private key is required in Node SDK (no injected wallet). ");
+        throw new Error("TACo signer is required. Provide privateKey or signer.");
     }
     return new Wallet(key, provider);
 }
@@ -65,11 +68,11 @@ export async function encryptWithTaco(params) {
     if (!ContractCondition) {
         throw new Error("encryptWithTaco: ContractCondition not available");
     }
-    const { key, dkg, condition, conditionChain, ritual } = resolveTacoConfig(params);
+    const { key, signer, dkg, condition, conditionChain, ritual } = resolveTacoConfig(params);
     await initialize();
     const dkgProvider = new providers.JsonRpcProvider(dkg);
     const conditionProvider = new providers.JsonRpcProvider(condition);
-    const encryptorSigner = await resolveConditionSigner(conditionProvider, key);
+    const encryptorSigner = await resolveConditionSigner(conditionProvider, key, signer);
     const conditionInstance = new ContractCondition({
         method: "canDecrypt",
         parameters: [":contributor"],
@@ -101,10 +104,10 @@ export async function decryptWithTaco(params) {
     const ConditionContext = conditions?.context?.ConditionContext;
     if (!ConditionContext)
         throw new Error("decryptWithTaco: ConditionContext missing");
-    const { key, condition, conditionChain, ritual, dkg } = resolveTacoConfig(params);
+    const { key, signer, condition, conditionChain, ritual, dkg } = resolveTacoConfig(params);
     await initialize();
     const conditionProvider = new providers.JsonRpcProvider(condition);
-    const decryptorSigner = await resolveConditionSigner(conditionProvider, key);
+    const decryptorSigner = await resolveConditionSigner(conditionProvider, key, signer);
     const decryptorAddress = await decryptorSigner.getAddress();
     const kitBytes = Buffer.from(messageKit.replace(/^0x/, ""), "hex");
     const kit = ThresholdMessageKit.fromBytes(Uint8Array.from(kitBytes));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whistlex/sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "WhistleX SDK for local encryption, TACo wrapping, and on-chain pool calldata",
   "type": "module",
   "main": "dist/index.js",
@@ -11,10 +11,13 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "dry-run": "node ./scripts/dry-run.mjs"
   },
   "dependencies": {
     "@nucypher/taco": "0.6.0",