@no-witness-labs/midday-sdk 0.1.2 → 0.2.1

package/dist/wallet/provider.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Provider factory for wallet-connected clients.
+ *
+ * Creates WalletProvider and MidnightProvider from a connected wallet.
+ * Provides dual API: Effect-based and Promise-based.
+ *
+ * @since 0.2.0
+ * @module
+ */
+import { Context, Effect, Layer } from 'effect';
+import type { WalletProvider, MidnightProvider, BalancedProvingRecipe } from '@midnight-ntwrk/midnight-js-types';
+import { type FinalizedTransaction, type TransactionId, type UnprovenTransaction } from '@midnight-ntwrk/ledger-v6';
+import type { ConnectedAPI, ShieldedAddresses } from './connector.js';
+import { ProviderError } from '../providers/errors.js';
+/**
+ * Wallet keys needed for provider creation.
+ */
+export interface WalletKeys {
+    /** Coin public key (Bech32m string) */
+    coinPublicKey: string;
+    /** Encryption public key (Bech32m string) */
+    encryptionPublicKey: string;
+}
+/**
+ * Providers created from wallet connection.
+ */
+export interface WalletProviders {
+    /** Provider for transaction balancing */
+    walletProvider: WalletProvider;
+    /** Provider for transaction submission */
+    midnightProvider: MidnightProvider;
+}
+/**
+ * Effect-based interface for wallet provider operations.
+ */
+export interface WalletProviderEffect {
+    readonly balanceTx: (wallet: ConnectedAPI, tx: UnprovenTransaction) => Effect.Effect<BalancedProvingRecipe, ProviderError>;
+    readonly submitTx: (wallet: ConnectedAPI, tx: FinalizedTransaction) => Effect.Effect<TransactionId, ProviderError>;
+}
+declare function balanceTxEffect(wallet: ConnectedAPI, tx: UnprovenTransaction): Effect.Effect<BalancedProvingRecipe, ProviderError>;
+declare function submitTxEffect(wallet: ConnectedAPI, tx: FinalizedTransaction): Effect.Effect<TransactionId, ProviderError>;
+/**
+ * Effect-based API for wallet provider operations.
+ */
+export declare const WalletProviderEffectAPI: WalletProviderEffect;
+/**
+ * Create providers from a connected wallet (v4 API).
+ *
+ * These providers use the wallet extension to balance and submit transactions.
+ *
+ * @param wallet - Connected wallet API from DAppConnector v4
+ * @param addresses - Shielded addresses from wallet
+ * @returns WalletProvider and MidnightProvider
+ *
+ * @example
+ * ```typescript
+ * const connection = await connectWallet('testnet');
+ * const { walletProvider, midnightProvider } = createWalletProviders(
+ *   connection.wallet,
+ *   connection.addresses,
+ * );
+ * ```
+ */
+export declare function createWalletProviders(wallet: ConnectedAPI, addresses: ShieldedAddresses): WalletProviders;
+/**
+ * Raw Effect APIs for advanced users.
+ *
+ * @since 0.2.0
+ * @category effect
+ */
+export declare const effect: {
+    balanceTx: typeof balanceTxEffect;
+    submitTx: typeof submitTxEffect;
+};
+/**
+ * Service interface for WalletProvider operations.
+ *
+ * @since 0.2.0
+ * @category service
+ */
+export interface WalletProviderServiceImpl {
+    readonly balanceTx: (wallet: ConnectedAPI, tx: UnprovenTransaction) => Effect.Effect<BalancedProvingRecipe, ProviderError>;
+    readonly submitTx: (wallet: ConnectedAPI, tx: FinalizedTransaction) => Effect.Effect<TransactionId, ProviderError>;
+}
+declare const WalletProviderService_base: Context.TagClass<WalletProviderService, "WalletProviderService", WalletProviderServiceImpl>;
+/**
+ * Context.Tag for WalletProviderService dependency injection.
+ *
+ * @since 0.2.0
+ * @category service
+ */
+export declare class WalletProviderService extends WalletProviderService_base {
+}
+/**
+ * Live Layer for WalletProviderService.
+ *
+ * @since 0.2.0
+ * @category layer
+ */
+export declare const WalletProviderLive: Layer.Layer<WalletProviderService>;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/wallet/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/wallet/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEjH,OAAO,EAAe,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGjI,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAIvD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,cAAc,EAAE,cAAc,CAAC;IAC/B,0CAA0C;IAC1C,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,mBAAmB,KAAK,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC,CAAC;IAC3H,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,oBAAoB,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;CACpH;AAMD,iBAAS,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC,CAkC3H;AAED,iBAAS,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAmBnH;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,oBAGrC,CAAC;AAMF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,GAAG,eAAe,CAqBzG;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM;;;CAGlB,CAAC;AAMF;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,CAClB,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,mBAAmB,KACpB,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,oBAAoB,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;CACpH;;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,0BAGxC;CAAG;AAMN;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAGhE,CAAC"}

package/dist/wallet/provider.js

@@ -0,0 +1,139 @@
+/**
+ * Provider factory for wallet-connected clients.
+ *
+ * Creates WalletProvider and MidnightProvider from a connected wallet.
+ * Provides dual API: Effect-based and Promise-based.
+ *
+ * @since 0.2.0
+ * @module
+ */
+import { Context, Effect, Layer } from 'effect';
+import { NOTHING_TO_PROVE } from '@midnight-ntwrk/midnight-js-types';
+import { Transaction } from '@midnight-ntwrk/ledger-v6';
+import { getNetworkId } from '@midnight-ntwrk/midnight-js-network-id';
+import { ProviderError } from '../providers/errors.js';
+import { bytesToHex, hexToBytes } from '../utils/hex.js';
+import { runEffectPromise } from '../utils/effect-runtime.js';
+// =============================================================================
+// Effect API
+// =============================================================================
+function balanceTxEffect(wallet, tx) {
+    return Effect.tryPromise({
+        try: async () => {
+            // Serialize the transaction to hex string
+            const txBytes = tx.serialize();
+            const serializedTx = bytesToHex(txBytes);
+            // Use wallet's balance API
+            const result = await wallet.balanceUnsealedTransaction(serializedTx);
+            // Deserialize the returned transaction - markers for FinalizedTransaction
+            const resultBytes = hexToBytes(result.tx);
+            const networkId = getNetworkId();
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const transaction = Transaction.deserialize({ SignatureEnabled: true }, { Proof: true }, { Binding: true }, resultBytes, networkId);
+            // Return as NothingToProve since the wallet handles proving
+            return {
+                type: NOTHING_TO_PROVE,
+                transaction,
+            };
+        },
+        catch: (cause) => new ProviderError({
+            cause,
+            message: `Failed to balance transaction: ${cause instanceof Error ? cause.message : String(cause)}`,
+        }),
+    });
+}
+function submitTxEffect(wallet, tx) {
+    return Effect.tryPromise({
+        try: async () => {
+            // Serialize the transaction to hex string
+            const txBytes = tx.serialize();
+            const serializedTx = bytesToHex(txBytes);
+            // Submit via wallet
+            await wallet.submitTransaction(serializedTx);
+            // Return the hex string as TransactionId
+            return serializedTx;
+        },
+        catch: (cause) => new ProviderError({
+            cause,
+            message: `Failed to submit transaction: ${cause instanceof Error ? cause.message : String(cause)}`,
+        }),
+    });
+}
+/**
+ * Effect-based API for wallet provider operations.
+ */
+export const WalletProviderEffectAPI = {
+    balanceTx: balanceTxEffect,
+    submitTx: submitTxEffect,
+};
+// =============================================================================
+// Promise API (backwards compatible)
+// =============================================================================
+/**
+ * Create providers from a connected wallet (v4 API).
+ *
+ * These providers use the wallet extension to balance and submit transactions.
+ *
+ * @param wallet - Connected wallet API from DAppConnector v4
+ * @param addresses - Shielded addresses from wallet
+ * @returns WalletProvider and MidnightProvider
+ *
+ * @example
+ * ```typescript
+ * const connection = await connectWallet('testnet');
+ * const { walletProvider, midnightProvider } = createWalletProviders(
+ *   connection.wallet,
+ *   connection.addresses,
+ * );
+ * ```
+ */
+export function createWalletProviders(wallet, addresses) {
+    const walletProvider = {
+        getCoinPublicKey: () => addresses.shieldedCoinPublicKey,
+        getEncryptionPublicKey: () => addresses.shieldedEncryptionPublicKey,
+        async balanceTx(tx, _newCoins, _ttl) {
+            return runEffectPromise(balanceTxEffect(wallet, tx));
+        },
+    };
+    const midnightProvider = {
+        async submitTx(tx) {
+            return runEffectPromise(submitTxEffect(wallet, tx));
+        },
+    };
+    return {
+        walletProvider,
+        midnightProvider,
+    };
+}
+/**
+ * Raw Effect APIs for advanced users.
+ *
+ * @since 0.2.0
+ * @category effect
+ */
+export const effect = {
+    balanceTx: balanceTxEffect,
+    submitTx: submitTxEffect,
+};
+/**
+ * Context.Tag for WalletProviderService dependency injection.
+ *
+ * @since 0.2.0
+ * @category service
+ */
+export class WalletProviderService extends Context.Tag('WalletProviderService')() {
+}
+// =============================================================================
+// Effect DI - Live Layer
+// =============================================================================
+/**
+ * Live Layer for WalletProviderService.
+ *
+ * @since 0.2.0
+ * @category layer
+ */
+export const WalletProviderLive = Layer.succeed(WalletProviderService, {
+    balanceTx: balanceTxEffect,
+    submitTx: submitTxEffect,
+});
+//# sourceMappingURL=provider.js.map

package/dist/wallet/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/wallet/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,WAAW,EAA2E,MAAM,2BAA2B,CAAC;AACjI,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAGtE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AA8B9D,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,SAAS,eAAe,CAAC,MAAoB,EAAE,EAAuB;IACpE,OAAO,MAAM,CAAC,UAAU,CAAC;QACvB,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,0CAA0C;YAC1C,MAAM,OAAO,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YAEzC,2BAA2B;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC;YAErE,0EAA0E;YAC1E,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;YACjC,8DAA8D;YAC9D,MAAM,WAAW,GAAI,WAAmB,CAAC,WAAW,CAClD,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAC1B,EAAE,KAAK,EAAE,IAAI,EAAE,EACf,EAAE,OAAO,EAAE,IAAI,EAAE,EACjB,WAAW,EACX,SAAS,CACc,CAAC;YAE1B,4DAA4D;YAC5D,OAAO;gBACL,IAAI,EAAE,gBAAgB;gBACtB,WAAW;aACa,CAAC;QAC7B,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,aAAa,CAAC;YAChB,KAAK;YACL,OAAO,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACpG,CAAC;KACL,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,MAAoB,EAAE,EAAwB;IACpE,OAAO,MAAM,CAAC,UAAU,CAAC;QACvB,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,0CAA0C;YAC1C,MAAM,OAAO,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YAEzC,oBAAoB;YACpB,MAAM,MAAM,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAE7C,yCAAyC;YACzC,OAAO,YAA6B,CAAC;QACvC,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,aAAa,CAAC;YAChB,KAAK;YACL,OAAO,EAAE,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACnG,CAAC;KACL,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAyB;IAC3D,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,cAAc;CACzB,CAAC;AAEF,gFAAgF;AAChF,qCAAqC;AACrC,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB,EAAE,SAA4B;IACtF,MAAM,cAAc,GAAmB;QACrC,gBAAgB,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,qBAAkF;QACpH,sBAAsB,EAAE,GAAG,EAAE,CAC3B,SAAS,CAAC,2BAA8F;QAE1G,KAAK,CAAC,SAAS,CAAC,EAAuB,EAAE,SAAqB,EAAE,IAAW;YACzE,OAAO,gBAAgB,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;IAEF,MAAM,gBAAgB,GAAqB;QACzC,KAAK,CAAC,QAAQ,CAAC,EAAwB;YACrC,OAAO,gBAAgB,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC;KACF,CAAC;IAEF,OAAO;QACL,cAAc;QACd,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,cAAc;CACzB,CAAC;AAoBF;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAG5E;CAAG;AAEN,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAuC,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE;IACzG,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,cAAc;CACzB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@no-witness-labs/midday-sdk",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "Developer-friendly SDK for building dapps on Midnight Network",
   "type": "module",
   "main": "dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./devnet": {
+      "types": "./dist/devnet/index.d.ts",
+      "import": "./dist/devnet/index.js"
     }
   },
   "files": [
@@ -17,36 +21,44 @@
     "README.md"
   ],
   "dependencies": {
+    "@effect/platform": "^0.77.0",
+    "@effect/schema": "^0.75.0",
+    "@midnight-ntwrk/dapp-connector-api": "4.0.0-beta.2",
     "@midnight-ntwrk/ledger-v6": "6.1.0-alpha.6",
     "@midnight-ntwrk/midnight-js-contracts": "3.0.0-alpha.11",
+    "@midnight-ntwrk/midnight-js-fetch-zk-config-provider": "3.0.0-alpha.11",
     "@midnight-ntwrk/midnight-js-http-client-proof-provider": "3.0.0-alpha.11",
     "@midnight-ntwrk/midnight-js-indexer-public-data-provider": "3.0.0-alpha.11",
-    "@midnight-ntwrk/midnight-js-level-private-state-provider": "3.0.0-alpha.11",
     "@midnight-ntwrk/midnight-js-network-id": "3.0.0-alpha.11",
-    "@midnight-ntwrk/midnight-js-node-zk-config-provider": "3.0.0-alpha.11",
     "@midnight-ntwrk/midnight-js-types": "3.0.0-alpha.11",
     "@midnight-ntwrk/wallet-sdk-dust-wallet": "1.0.0-beta.11",
     "@midnight-ntwrk/wallet-sdk-facade": "1.0.0-beta.12",
     "@midnight-ntwrk/wallet-sdk-hd": "3.0.0-beta.7",
     "@midnight-ntwrk/wallet-sdk-shielded": "1.0.0-beta.12",
     "@midnight-ntwrk/wallet-sdk-unshielded-wallet": "1.0.0-beta.14",
+    "browser-level": "^1.0.1",
+    "dockerode": "^4.0.7",
+    "effect": "^3.19.15",
     "pino": "^8.16.0",
     "pino-pretty": "^10.2.3",
-    "rxjs": "^7.8.1"
+    "rxjs": "^7.8.1",
+    "ws": "^8.18.0"
   },
   "devDependencies": {
     "@changesets/cli": "^2.28.1",
-    "typedoc": "^0.28.7",
-    "typedoc-plugin-markdown": "^4.6.3",
     "@eslint/js": "^9.34.0",
+    "@types/dockerode": "^3.3.43",
     "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.10",
     "eslint": "^9.34.0",
+    "typedoc": "^0.28.7",
+    "typedoc-plugin-markdown": "^4.6.3",
     "typescript": "^5.6.0",
     "typescript-eslint": "^8.33.0",
     "vitest": "^3.2.4"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=18.0.0"
   },
   "keywords": [
     "midnight",
@@ -54,7 +66,9 @@
     "zk-proof",
     "blockchain",
     "privacy",
-    "sdk"
+    "sdk",
+    "browser",
+    "wallet"
   ],
   "author": "No Witness Labs",
   "license": "MIT",
@@ -76,6 +90,7 @@
     "docgen:html": "typedoc --options typedoc.html.json",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:devnet": "vitest run test/devnet.integration.test.ts",
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "changeset:publish": "pnpm build && changeset publish"