@claritydao/midnight-agora-sdk 0.1.0

package/dist/browser-providers.d.ts

@@ -0,0 +1,21 @@
+import { type GovernorProviders } from "./common-types";
+import { type Logger } from "pino";
+import { type InitialAPI } from "@midnight-ntwrk/dapp-connector-api";
+/**
+ * Initializes and returns the providers required for Governor contract interactions in a browser environment.
+ *
+ * @param logger The logger instance for logging.
+ * @param networkId The network ID to connect to (e.g., 'testnet', 'mainnet').
+ * @returns A promise that resolves to configured GovernorProviders.
+ *
+ * @remarks
+ * This function connects to the Midnight Lace wallet extension and retrieves network configuration
+ * from the wallet. The network ID is specified by the caller.
+ */
+export declare const initializeProviders: (logger: Logger, networkId?: string) => Promise<GovernorProviders>;
+declare global {
+    interface Window {
+        midnight?: Record<string, InitialAPI>;
+    }
+}
+//# sourceMappingURL=browser-providers.d.ts.map

package/dist/browser-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-providers.d.ts","sourceRoot":"","sources":["../src/browser-providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAyB,MAAM,gBAAgB,CAAC;AAe/E,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,oCAAoC,CAAC;AAgC5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,EACd,YAAW,MAAkB,KAC5B,OAAO,CAAC,iBAAiB,CAoC3B,CAAC;AAuKF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KACvC;CACF"}

package/dist/browser-providers.js

@@ -0,0 +1,147 @@
+import { concatMap, filter, firstValueFrom, interval, map, of, take, tap, throwError, timeout, catchError } from "rxjs";
+import { pipe as fnPipe } from "fp-ts/function";
+import { levelPrivateStateProvider } from "@midnight-ntwrk/midnight-js-level-private-state-provider";
+import { FetchZkConfigProvider } from "@midnight-ntwrk/midnight-js-fetch-zk-config-provider";
+import { httpClientProofProvider } from "@midnight-ntwrk/midnight-js-http-client-proof-provider";
+import { indexerPublicDataProvider } from "@midnight-ntwrk/midnight-js-indexer-public-data-provider";
+import semver from "semver";
+import { getNetworkId, setNetworkId } from "@midnight-ntwrk/midnight-js-network-id";
+// Helper functions for hex encoding/decoding
+const toHexString = (bytes) => Array.from(bytes)
+    .map((b) => b.toString(16).padStart(2, "0"))
+    .join("");
+const _fromHexString = (hex) => new Uint8Array(hex.match(/.{1,2}/g).map((byte) => parseInt(byte, 16)));
+/**
+ * Initializes and returns the providers required for Governor contract interactions in a browser environment.
+ *
+ * @param logger The logger instance for logging.
+ * @param networkId The network ID to connect to (e.g., 'testnet', 'mainnet').
+ * @returns A promise that resolves to configured GovernorProviders.
+ *
+ * @remarks
+ * This function connects to the Midnight Lace wallet extension and retrieves network configuration
+ * from the wallet. The network ID is specified by the caller.
+ */
+export const initializeProviders = async (logger, networkId = "testnet") => {
+    const { wallet, config } = await connectToWallet(logger, networkId);
+    const zkConfigPath = window.location.origin;
+    logger.info(`Connecting to wallet with network ID: ${getNetworkId()}`);
+    // Get wallet addresses
+    const addresses = await wallet.getShieldedAddresses();
+    return {
+        privateStateProvider: levelPrivateStateProvider({
+            privateStateStoreName: "governor-private-state"
+        }),
+        zkConfigProvider: new FetchZkConfigProvider(zkConfigPath, fetch.bind(window)),
+        proofProvider: config.proverServerUri
+            ? httpClientProofProvider(config.proverServerUri)
+            : httpClientProofProvider(""), // Fallback - proving may be done by wallet
+        publicDataProvider: indexerPublicDataProvider(config.indexerUri, config.indexerWsUri),
+        walletProvider: createWalletProvider(wallet, addresses),
+        midnightProvider: {
+            async submitTx(tx) {
+                // Convert transaction to hex string for the connector API
+                const serialized = tx.serialize();
+                const hexString = toHexString(serialized);
+                await wallet.submitTransaction(hexString);
+                // Return the transaction hash as the ID
+                return tx.transactionHash();
+            }
+        }
+    };
+};
+/**
+ * Creates a WalletProvider from the connected wallet API.
+ */
+const createWalletProvider = (wallet, addresses) => {
+    // Note: The bech32m addresses need to be converted to the expected key types
+    // This conversion may need adjustment based on the actual key format expected
+    const coinPublicKey = addresses.shieldedCoinPublicKey;
+    const encryptionPublicKey = addresses.shieldedEncryptionPublicKey;
+    return {
+        getCoinPublicKey() {
+            return coinPublicKey;
+        },
+        getEncryptionPublicKey() {
+            return encryptionPublicKey;
+        },
+        async balanceTx(tx, _newCoins, _ttl) {
+            // Use the wallet's balancing capability
+            // Convert Uint8Array to hex string for the connector API
+            const serialized = tx.serialize();
+            const hexString = toHexString(serialized);
+            const _result = await wallet.balanceUnsealedTransaction(hexString);
+            // The wallet returns a balanced transaction as a hex string
+            // We need to convert it back and return as NothingToProve
+            // Note: The actual deserialization may need the Transaction.deserialize with proper markers
+            // For now, we return the original transaction as the wallet handles proving internally
+            return {
+                type: "NothingToProve",
+                transaction: tx // The wallet should have balanced this
+            };
+        }
+    };
+};
+/**
+ * Connects to the Midnight Lace wallet extension.
+ *
+ * @param logger The logger instance for logging.
+ * @param networkId The network ID to connect to.
+ * @returns A promise that resolves to the wallet API and configuration.
+ */
+const connectToWallet = (logger, networkId) => {
+    const COMPATIBLE_CONNECTOR_API_VERSION = "4.x";
+    return firstValueFrom(fnPipe(interval(100), map(() => {
+        // Find wallet in window.midnight
+        const midnight = window.midnight;
+        if (!midnight)
+            return undefined;
+        // The new API uses rdns keys instead of named keys like mnLace
+        // Look for any available wallet
+        const walletKeys = Object.keys(midnight).filter((key) => key !== "addEventListener");
+        if (walletKeys.length === 0)
+            return undefined;
+        return midnight[walletKeys[0]];
+    }), tap((connectorAPI) => {
+        logger.info(connectorAPI, "Check for wallet connector API");
+    }), filter((connectorAPI) => !!connectorAPI), concatMap((connectorAPI) => semver.satisfies(connectorAPI.apiVersion, COMPATIBLE_CONNECTOR_API_VERSION)
+        ? of(connectorAPI)
+        : throwError(() => {
+            logger.error({
+                expected: COMPATIBLE_CONNECTOR_API_VERSION,
+                actual: connectorAPI.apiVersion
+            }, "Incompatible version of wallet connector API");
+            return new Error(`Incompatible version of Midnight Lace wallet found. Require '${COMPATIBLE_CONNECTOR_API_VERSION}', got '${connectorAPI.apiVersion}'.`);
+        })), tap((connectorAPI) => {
+        logger.info(connectorAPI, "Compatible wallet connector API found. Connecting.");
+    }), take(1), timeout({
+        first: 1_000,
+        with: () => throwError(() => {
+            logger.error("Could not find wallet connector API");
+            return new Error("Could not find Midnight Lace wallet. Extension installed?");
+        })
+    }), concatMap(async (connectorAPI) => {
+        // Connect to the wallet with the specified network ID
+        const connectedAPI = await connectorAPI.connect(networkId);
+        // Set the network ID globally
+        setNetworkId(networkId);
+        logger.info("Connected to wallet");
+        return { walletConnectorAPI: connectedAPI, connectorAPI };
+    }), timeout({
+        first: 30_000, // Increased timeout for user approval
+        with: () => throwError(() => {
+            logger.error("Wallet connector API has failed to respond");
+            return new Error("Midnight Lace wallet has failed to respond. Extension enabled?");
+        })
+    }), catchError((error, apis) => error
+        ? throwError(() => {
+            logger.error("Unable to connect to wallet");
+            return new Error("Application is not authorized or connection failed");
+        })
+        : apis), concatMap(async ({ walletConnectorAPI }) => {
+        const config = await walletConnectorAPI.getConfiguration();
+        logger.info("Connected to wallet connector API and retrieved service configuration");
+        return { wallet: walletConnectorAPI, config };
+    })));
+};
+//# sourceMappingURL=browser-providers.js.map

package/dist/browser-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-providers.js","sourceRoot":"","sources":["../src/browser-providers.ts"],"names":[],"mappings":"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"}

package/dist/common-types.d.ts

@@ -0,0 +1,29 @@
+import type { ImpureCircuitId, MidnightProviders, Contract } from "@midnight-ntwrk/midnight-js-types";
+import type { DeployedContract, FoundContract } from "@midnight-ntwrk/midnight-js-contracts";
+export type GovernorContract = Contract;
+export type GovernorCircuits = ImpureCircuitId<GovernorContract>;
+export declare const GovernorPrivateStateId = "governorPrivateState";
+export type GovernorPrivateState = {
+    secretKey: Uint8Array | null;
+    currentTime: bigint;
+    userStake: {
+        amount: bigint;
+        delegatedTo: Uint8Array;
+        stakedAt: bigint;
+    };
+    votingHistory: any[];
+    proposalHistory: any[];
+    governanceConfig: {
+        votingPeriod: bigint;
+        quorumThreshold: bigint;
+        proposalThreshold: bigint;
+        proposalLifetime: bigint;
+        executionDelay: bigint;
+        gracePeriod: bigint;
+        minStakeAmount: bigint;
+        stakingPeriod: bigint;
+    };
+};
+export type GovernorProviders = MidnightProviders<GovernorCircuits, typeof GovernorPrivateStateId, GovernorPrivateState>;
+export type DeployedGovernorContract = DeployedContract<GovernorContract> | FoundContract<GovernorContract>;
+//# sourceMappingURL=common-types.d.ts.map

package/dist/common-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-types.d.ts","sourceRoot":"","sources":["../src/common-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACT,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACd,MAAM,uCAAuC,CAAC;AAI/C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;AAEjE,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAI7D,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,UAAU,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,aAAa,EAAE,GAAG,EAAE,CAAC;IACrB,eAAe,EAAE,GAAG,EAAE,CAAC;IACvB,gBAAgB,EAAE;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAC/C,gBAAgB,EAChB,OAAO,sBAAsB,EAC7B,oBAAoB,CACrB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,CAAC,gBAAgB,CAAC,GAClC,aAAa,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/common-types.js

@@ -0,0 +1,2 @@
+export const GovernorPrivateStateId = "governorPrivateState";
+//# sourceMappingURL=common-types.js.map

package/dist/common-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-types.js","sourceRoot":"","sources":["../src/common-types.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Custom error classes for the Agora DAO Governor SDK.
+ *
+ * @module errors
+ */
+/**
+ * Base error class for all SDK errors.
+ */
+export declare class GovernorSDKError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when wallet is not connected.
+ */
+export declare class WalletNotConnectedError extends GovernorSDKError {
+    constructor();
+}
+/**
+ * Thrown when user has insufficient stake for an operation.
+ */
+export declare class InsufficientStakeError extends GovernorSDKError {
+    constructor(required: bigint, actual: bigint);
+}
+/**
+ * Thrown when a parameter is invalid.
+ */
+export declare class InvalidParameterError extends GovernorSDKError {
+    constructor(parameterName: string, reason: string);
+}
+/**
+ * Thrown when a contract is not found at the specified address.
+ */
+export declare class ContractNotFoundError extends GovernorSDKError {
+    constructor(address: string);
+}
+/**
+ * Thrown when a proposal is not found.
+ */
+export declare class ProposalNotFoundError extends GovernorSDKError {
+    constructor(proposalId: bigint);
+}
+/**
+ * Thrown when a transaction fails.
+ */
+export declare class TransactionError extends GovernorSDKError {
+    readonly txHash?: string | undefined;
+    constructor(message: string, txHash?: string | undefined);
+}
+/**
+ * Thrown when contract deployment fails.
+ */
+export declare class DeploymentError extends GovernorSDKError {
+    constructor(message: string);
+}
+/**
+ * Thrown when configuration is invalid.
+ */
+export declare class InvalidConfigurationError extends GovernorSDKError {
+    constructor(message: string);
+}
+/**
+ * Thrown when network ID is not set.
+ */
+export declare class NetworkNotConfiguredError extends GovernorSDKError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,gBAAgB;;CAQ5D;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;gBAC9C,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK7C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC7C,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAKlD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC7C,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC7C,UAAU,EAAE,MAAM;CAK/B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;aAGlC,MAAM,CAAC,EAAE,MAAM;gBAD/B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA;CAQlC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;gBACjD,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;;CAQ9D"}

package/dist/errors.js

@@ -0,0 +1,108 @@
+/**
+ * Custom error classes for the Agora DAO Governor SDK.
+ *
+ * @module errors
+ */
+/**
+ * Base error class for all SDK errors.
+ */
+export class GovernorSDKError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GovernorSDKError";
+        Object.setPrototypeOf(this, GovernorSDKError.prototype);
+    }
+}
+/**
+ * Thrown when wallet is not connected.
+ */
+export class WalletNotConnectedError extends GovernorSDKError {
+    constructor() {
+        super("Wallet not connected. Please ensure Lace wallet is installed and connected.");
+        this.name = "WalletNotConnectedError";
+        Object.setPrototypeOf(this, WalletNotConnectedError.prototype);
+    }
+}
+/**
+ * Thrown when user has insufficient stake for an operation.
+ */
+export class InsufficientStakeError extends GovernorSDKError {
+    constructor(required, actual) {
+        super(`Insufficient stake. Required: ${required}, Actual: ${actual}`);
+        this.name = "InsufficientStakeError";
+        Object.setPrototypeOf(this, InsufficientStakeError.prototype);
+    }
+}
+/**
+ * Thrown when a parameter is invalid.
+ */
+export class InvalidParameterError extends GovernorSDKError {
+    constructor(parameterName, reason) {
+        super(`Invalid parameter '${parameterName}': ${reason}`);
+        this.name = "InvalidParameterError";
+        Object.setPrototypeOf(this, InvalidParameterError.prototype);
+    }
+}
+/**
+ * Thrown when a contract is not found at the specified address.
+ */
+export class ContractNotFoundError extends GovernorSDKError {
+    constructor(address) {
+        super(`Contract not found at address: ${address}`);
+        this.name = "ContractNotFoundError";
+        Object.setPrototypeOf(this, ContractNotFoundError.prototype);
+    }
+}
+/**
+ * Thrown when a proposal is not found.
+ */
+export class ProposalNotFoundError extends GovernorSDKError {
+    constructor(proposalId) {
+        super(`Proposal not found with ID: ${proposalId}`);
+        this.name = "ProposalNotFoundError";
+        Object.setPrototypeOf(this, ProposalNotFoundError.prototype);
+    }
+}
+/**
+ * Thrown when a transaction fails.
+ */
+export class TransactionError extends GovernorSDKError {
+    txHash;
+    constructor(message, txHash) {
+        super(`Transaction failed: ${message}${txHash ? ` (txHash: ${txHash})` : ""}`);
+        this.txHash = txHash;
+        this.name = "TransactionError";
+        Object.setPrototypeOf(this, TransactionError.prototype);
+    }
+}
+/**
+ * Thrown when contract deployment fails.
+ */
+export class DeploymentError extends GovernorSDKError {
+    constructor(message) {
+        super(`Contract deployment failed: ${message}`);
+        this.name = "DeploymentError";
+        Object.setPrototypeOf(this, DeploymentError.prototype);
+    }
+}
+/**
+ * Thrown when configuration is invalid.
+ */
+export class InvalidConfigurationError extends GovernorSDKError {
+    constructor(message) {
+        super(`Invalid configuration: ${message}`);
+        this.name = "InvalidConfigurationError";
+        Object.setPrototypeOf(this, InvalidConfigurationError.prototype);
+    }
+}
+/**
+ * Thrown when network ID is not set.
+ */
+export class NetworkNotConfiguredError extends GovernorSDKError {
+    constructor() {
+        super("Network ID not configured. Set window.midnight.mnLace.networkId before initializing providers.");
+        this.name = "NetworkNotConfiguredError";
+        Object.setPrototypeOf(this, NetworkNotConfiguredError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}