@claritydao/midnight-agora-sdk 0.1.0

package/dist/utils/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Provides utility functions.
+ *
+ * @module
+ */
+/**
+ * Generates a buffer containing a series of randomly generated bytes.
+ *
+ * @param length The number of bytes to generate.
+ * @returns A `Uint8Array` representing `length` randomly generated bytes.
+ */
+export declare const randomBytes: (length: number) => Uint8Array;
+/**
+ * Converts a wallet address string to a Uint8Array (32 bytes).
+ *
+ * @param address The wallet address string.
+ * @returns A 32-byte Uint8Array representation of the address.
+ */
+export declare const addressToBytes: (address: string) => Uint8Array;
+/**
+ * Converts a Uint8Array to a hex string.
+ *
+ * @param bytes The bytes to convert.
+ * @returns Hex string representation.
+ */
+export declare const bytesToHex: (bytes: Uint8Array) => string;
+/**
+ * Converts a hex string to a Uint8Array.
+ *
+ * @param hex The hex string to convert.
+ * @returns Uint8Array representation.
+ */
+export declare const hexToBytes: (hex: string) => Uint8Array;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,UAI5C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,UAQhD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,UAAU,KAAG,MAI9C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,UAOxC,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,57 @@
+/**
+ * Provides utility functions.
+ *
+ * @module
+ */
+/**
+ * Generates a buffer containing a series of randomly generated bytes.
+ *
+ * @param length The number of bytes to generate.
+ * @returns A `Uint8Array` representing `length` randomly generated bytes.
+ */
+export const randomBytes = (length) => {
+    const bytes = new Uint8Array(length);
+    crypto.getRandomValues(bytes);
+    return bytes;
+};
+/**
+ * Converts a wallet address string to a Uint8Array (32 bytes).
+ *
+ * @param address The wallet address string.
+ * @returns A 32-byte Uint8Array representation of the address.
+ */
+export const addressToBytes = (address) => {
+    const addressBytes = new Uint8Array(32);
+    const addressStr = address.replace(/[^0-9a-f]/gi, "");
+    const addressHex = addressStr.slice(-64);
+    for (let i = 0; i < Math.min(32, addressHex.length / 2); i++) {
+        addressBytes[i] = parseInt(addressHex.substr(i * 2, 2), 16);
+    }
+    return addressBytes;
+};
+/**
+ * Converts a Uint8Array to a hex string.
+ *
+ * @param bytes The bytes to convert.
+ * @returns Hex string representation.
+ */
+export const bytesToHex = (bytes) => {
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+};
+/**
+ * Converts a hex string to a Uint8Array.
+ *
+ * @param hex The hex string to convert.
+ * @returns Uint8Array representation.
+ */
+export const hexToBytes = (hex) => {
+    const cleanHex = hex.replace(/^0x/, "");
+    const bytes = new Uint8Array(cleanHex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(cleanHex.substr(i * 2, 2), 16);
+    }
+    return bytes;
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAc,EAAE;IACxD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAc,EAAE;IAC5D,MAAM,YAAY,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7D,YAAY,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAiB,EAAU,EAAE;IACtD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAc,EAAE;IACpD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/validators.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Validation utilities for the Agora DAO Governor SDK.
+ *
+ * @module validators
+ */
+import type { GovernanceConfig, GovernorConfig, DeploymentConfig, TokenConfig } from "./types";
+import { VoteChoice } from "./types";
+/**
+ * Validates that a value is a non-empty string.
+ */
+export declare function validateNonEmptyString(value: string, parameterName: string): void;
+/**
+ * Validates that a string does not exceed a maximum length.
+ */
+export declare function validateMaxLength(value: string, maxLength: number, parameterName: string): void;
+/**
+ * Validates that a value is a valid Uint8Array address (32 bytes).
+ */
+export declare function validateAddress(address: Uint8Array, parameterName: string): void;
+/**
+ * Validates that a bigint is positive.
+ */
+export declare function validatePositiveBigInt(value: bigint, parameterName: string): void;
+/**
+ * Validates that a bigint is non-negative.
+ */
+export declare function validateNonNegativeBigInt(value: bigint, parameterName: string): void;
+/**
+ * Validates a vote choice value.
+ */
+export declare function validateVoteChoice(choice: VoteChoice): void;
+/**
+ * Validates proposal parameters.
+ */
+export declare function validateProposal(title: string, description: string, creator: Uint8Array): void;
+/**
+ * Validates governance configuration.
+ */
+export declare function validateGovernanceConfig(config: GovernanceConfig): void;
+/**
+ * Validates governor configuration.
+ */
+export declare function validateGovernorConfig(config: GovernorConfig): void;
+/**
+ * Validates token configuration.
+ */
+export declare function validateTokenConfig(config: TokenConfig): void;
+/**
+ * Validates complete deployment configuration.
+ */
+export declare function validateDeploymentConfig(config: DeploymentConfig): void;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAUrC;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,MAAM,GACpB,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAS3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,UAAU,GAClB,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAsBvE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAwCnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAc7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAiBvE"}

package/dist/validators.js

@@ -0,0 +1,160 @@
+/**
+ * Validation utilities for the Agora DAO Governor SDK.
+ *
+ * @module validators
+ */
+import { InvalidParameterError, InvalidConfigurationError } from "./errors";
+import { VoteChoice } from "./types";
+// Constants for validation limits
+const MAX_TITLE_LENGTH = 256;
+const MAX_DESCRIPTION_LENGTH = 10000;
+const MAX_TOKEN_NAME_LENGTH = 64;
+const MAX_TOKEN_SYMBOL_LENGTH = 16;
+const MAX_TOKEN_DECIMALS = 18n;
+const MIN_VOTING_PERIOD = 60n;
+/**
+ * Validates that a value is a non-empty string.
+ */
+export function validateNonEmptyString(value, parameterName) {
+    if (typeof value !== "string") {
+        throw new InvalidParameterError(parameterName, "must be a string");
+    }
+    if (value.trim().length === 0) {
+        throw new InvalidParameterError(parameterName, "cannot be empty");
+    }
+}
+/**
+ * Validates that a string does not exceed a maximum length.
+ */
+export function validateMaxLength(value, maxLength, parameterName) {
+    if (value.length > maxLength) {
+        throw new InvalidParameterError(parameterName, `cannot exceed ${maxLength} characters (got ${value.length})`);
+    }
+}
+/**
+ * Validates that a value is a valid Uint8Array address (32 bytes).
+ */
+export function validateAddress(address, parameterName) {
+    if (!(address instanceof Uint8Array)) {
+        throw new InvalidParameterError(parameterName, "must be a Uint8Array");
+    }
+    if (address.length !== 32) {
+        throw new InvalidParameterError(parameterName, `must be exactly 32 bytes (got ${address.length})`);
+    }
+}
+/**
+ * Validates that a bigint is positive.
+ */
+export function validatePositiveBigInt(value, parameterName) {
+    if (typeof value !== "bigint") {
+        throw new InvalidParameterError(parameterName, "must be a bigint");
+    }
+    if (value <= 0n) {
+        throw new InvalidParameterError(parameterName, "must be greater than 0");
+    }
+}
+/**
+ * Validates that a bigint is non-negative.
+ */
+export function validateNonNegativeBigInt(value, parameterName) {
+    if (typeof value !== "bigint") {
+        throw new InvalidParameterError(parameterName, "must be a bigint");
+    }
+    if (value < 0n) {
+        throw new InvalidParameterError(parameterName, "cannot be negative");
+    }
+}
+/**
+ * Validates a vote choice value.
+ */
+export function validateVoteChoice(choice) {
+    if (![VoteChoice.For, VoteChoice.Against, VoteChoice.Abstain].includes(choice)) {
+        throw new InvalidParameterError("choice", "must be VoteChoice.For, VoteChoice.Against, or VoteChoice.Abstain");
+    }
+}
+/**
+ * Validates proposal parameters.
+ */
+export function validateProposal(title, description, creator) {
+    validateNonEmptyString(title, "title");
+    validateMaxLength(title, MAX_TITLE_LENGTH, "title");
+    validateNonEmptyString(description, "description");
+    validateMaxLength(description, MAX_DESCRIPTION_LENGTH, "description");
+    validateAddress(creator, "creator");
+}
+/**
+ * Validates governance configuration.
+ */
+export function validateGovernanceConfig(config) {
+    validatePositiveBigInt(config.votingPeriod, "votingPeriod");
+    validatePositiveBigInt(config.quorumThreshold, "quorumThreshold");
+    validatePositiveBigInt(config.proposalThreshold, "proposalThreshold");
+    validatePositiveBigInt(config.proposalLifetime, "proposalLifetime");
+    validateNonNegativeBigInt(config.executionDelay, "executionDelay");
+    validateNonNegativeBigInt(config.gracePeriod, "gracePeriod");
+    validatePositiveBigInt(config.minStakeAmount, "minStakeAmount");
+    validateNonNegativeBigInt(config.stakingPeriod, "stakingPeriod");
+    // Logical validations
+    if (config.votingPeriod < MIN_VOTING_PERIOD) {
+        throw new InvalidConfigurationError(`votingPeriod must be at least ${MIN_VOTING_PERIOD} seconds`);
+    }
+    if (config.proposalThreshold > config.quorumThreshold) {
+        throw new InvalidConfigurationError("proposalThreshold cannot exceed quorumThreshold");
+    }
+}
+/**
+ * Validates governor configuration.
+ */
+export function validateGovernorConfig(config) {
+    validateGovernanceConfig(config.governance);
+    validateNonNegativeBigInt(config.executionDelay, "executionDelay");
+    validateNonNegativeBigInt(config.gracePeriod, "gracePeriod");
+    validatePositiveBigInt(config.maxActiveProposals, "maxActiveProposals");
+    validatePositiveBigInt(config.proposalLifetime, "proposalLifetime");
+    if (typeof config.emergencyVetoEnabled !== "boolean") {
+        throw new InvalidParameterError("emergencyVetoEnabled", "must be a boolean");
+    }
+    if (config.emergencyVetoEnabled) {
+        validatePositiveBigInt(config.emergencyVetoThreshold, "emergencyVetoThreshold");
+    }
+    // Check consistency
+    if (config.executionDelay !== config.governance.executionDelay) {
+        throw new InvalidConfigurationError("executionDelay must match governance.executionDelay");
+    }
+    if (config.gracePeriod !== config.governance.gracePeriod) {
+        throw new InvalidConfigurationError("gracePeriod must match governance.gracePeriod");
+    }
+    if (config.proposalLifetime !== config.governance.proposalLifetime) {
+        throw new InvalidConfigurationError("proposalLifetime must match governance.proposalLifetime");
+    }
+}
+/**
+ * Validates token configuration.
+ */
+export function validateTokenConfig(config) {
+    validateNonEmptyString(config.name, "token.name");
+    validateMaxLength(config.name, MAX_TOKEN_NAME_LENGTH, "token.name");
+    validateNonEmptyString(config.symbol, "token.symbol");
+    validateMaxLength(config.symbol, MAX_TOKEN_SYMBOL_LENGTH, "token.symbol");
+    validatePositiveBigInt(config.decimals, "token.decimals");
+    if (config.decimals > MAX_TOKEN_DECIMALS) {
+        throw new InvalidConfigurationError(`token.decimals cannot exceed ${MAX_TOKEN_DECIMALS}`);
+    }
+}
+/**
+ * Validates complete deployment configuration.
+ */
+export function validateDeploymentConfig(config) {
+    validateGovernorConfig(config.governor);
+    validateTokenConfig(config.token);
+    validateAddress(config.adminKey, "adminKey");
+    // Security check: warn about predictable admin keys
+    const allZeros = config.adminKey.every((byte) => byte === 0);
+    const allOnes = config.adminKey.every((byte) => byte === 1);
+    const sequential = config.adminKey[0] === 1 &&
+        config.adminKey.slice(1).every((byte) => byte === 0);
+    if (allZeros || allOnes || sequential) {
+        console.warn("WARNING: adminKey appears to be predictable. Use cryptographically secure random bytes in production.");
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

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

package/eslint.config.mjs

@@ -0,0 +1,48 @@
+import js from "@eslint/js";
+import plugin from "@typescript-eslint/eslint-plugin";
+import parser from "@typescript-eslint/parser";
+import pluginPrettier from "eslint-plugin-prettier";
+
+export default [
+  js.configs.recommended,
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    languageOptions: {
+      parser,
+      parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "module",
+        project: ["./tsconfig.json"]
+      },
+      globals: {
+        // Browser globals
+        window: "readonly",
+        fetch: "readonly",
+        crypto: "readonly",
+        console: "readonly",
+        Window: "readonly",
+        // Node globals (for type definitions)
+        Buffer: "readonly"
+      }
+    },
+    plugins: {
+      "@typescript-eslint": plugin,
+      prettier: pluginPrettier
+    },
+    rules: {
+      "prettier/prettier": "error",
+      "@typescript-eslint/no-misused-promises": "off",
+      "@typescript-eslint/no-floating-promises": "warn",
+      "@typescript-eslint/promise-function-async": "off",
+      "@typescript-eslint/no-redeclare": "off",
+      "@typescript-eslint/no-invalid-void-type": "off",
+      "@typescript-eslint/no-unsafe-call": "off",
+      "@typescript-eslint/no-unsafe-member-access": "off",
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/consistent-type-definitions": "off",
+      // Use TypeScript-aware no-unused-vars rule
+      "no-unused-vars": "off",
+      "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_", "varsIgnorePattern": "^_" }]
+    }
+  }
+];

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@claritydao/midnight-agora-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@midnight-ntwrk/compact-runtime": "0.11.0-rc.1",
+    "@midnight-ntwrk/dapp-connector-api": "4.0.0-beta.2",
+    "@midnight-ntwrk/ledger-v6": "6.2.0-rc.3",
+    "@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-types": "3.0.0-alpha.11",
+    "@midnight-ntwrk/midnight-js-utils": "3.0.0-alpha.11",
+    "@midnight-ntwrk/wallet-sdk-address-format": "3.0.0-beta.11",
+    "@midnight-ntwrk/zswap": "4.0.0",
+    "fp-ts": "^2.16.11",
+    "rxjs": "^7.8.2",
+    "semver": "^7.7.3",
+    "@agora-dao-midnight/contract": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/semver": "^7.7.1",
+    "pino": "^9.14.0",
+    "typescript": "^5.7.2",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src"
+  }
+}