@poa-box/core 0.1.0 → 1.0.0

package/dist/tx/vote.js

@@ -145,7 +145,7 @@ exports.MODULE_LABELS = [
     { key: 'educationHubAddress', label: 'EducationHub', abi: 'EducationHubNew' },
     { key: 'executorAddress', label: 'Executor', abi: 'Executor' },
     { key: 'quickJoinAddress', label: 'QuickJoin', abi: 'QuickJoinNew' },
-    { key: 'eligibilityModuleAddress', label: 'EligibilityModule', abi: 'EligibilityModuleNew' },
+    { key: 'membershipAuthorityAddress', label: 'MembershipAuthority', abi: 'MembershipAuthority' },
     { key: 'paymentManagerAddress', label: 'PaymentManager', abi: 'PaymentManager' },
     { key: 'zkEmailInvitesAddress', label: 'ZkEmailInvites', abi: 'ZkEmailInvites' },
 ];
@@ -257,7 +257,9 @@ async function createProposalIntent(ctx, params) {
     if (numOptions < 2) {
         throw new errors_1.CliError('At least 2 options are required', exit_codes_1.EXIT.USAGE);
     }
-    const hatIds = (params.hatIds ?? []).map(h => ethers_1.ethers.BigNumber.from(typeof h === 'string' ? h.trim() : h));
+    if (params.subjectIds !== undefined && params.hatIds !== undefined)
+        throw new errors_1.CliError('Specify subjectIds or hatIds, not both.', exit_codes_1.EXIT.USAGE);
+    const hatIds = (params.subjectIds ?? params.hatIds ?? []).map(h => ethers_1.ethers.BigNumber.from(typeof h === 'string' ? h.trim() : h));
     // Hat-restriction cap: both voting contracts reject more than MAX_POLL_HATS
     // restricted hats. Read the live constant — an older contract has no getter
     // and no cap, so the check simply does not apply there.
@@ -297,7 +299,6 @@ async function createProposalIntent(ctx, params) {
         optionNames,
         createdAt: params.createdAt,
     });
-    const { cid, descriptionHash } = await pinProposalMetadata(ctx, metadata);
     const summary = {
         type: params.type,
         title: params.name,
@@ -309,20 +310,26 @@ async function createProposalIntent(ctx, params) {
             summary[`call ${i + 1}/${params.calls.length}`] = line;
         });
     }
-    return (0, governance_1.buildGovernanceProposal)({
+    // Build and validate before publishing proposal metadata.
+    const intent = (0, governance_1.buildGovernanceProposal)({
         votingAddress,
         votingAbiName,
         title: params.name,
-        descriptionHash,
+        descriptionHash: ethers_1.ethers.constants.HashZero,
         durationMinutes: params.durationMinutes,
         numOptions,
         batches,
         hatIds,
+        quorumOverride: params.quorumOverride,
+        equalWeight: params.equalWeight,
         orgId: modules.orgId,
         action: 'create',
         summary,
-        ipfs: { cid, metadata },
     });
+    const { cid, descriptionHash } = await pinProposalMetadata(ctx, metadata);
+    intent.args[1] = descriptionHash;
+    intent.meta.ipfs = { cid, metadata };
+    return intent;
 }
 /**
  * Port of `pop vote cast` — src/commands/vote/cast.ts.
@@ -419,8 +426,8 @@ exports.DD_QUORUM_KEY = 4;
 async function proposeQuorumIntent(ctx, params) {
     const newQuorum = params.quorum;
     const durationMinutes = params.durationMinutes ?? 60;
-    if (newQuorum < 1)
-        throw new errors_1.CliError('Quorum must be at least 1', exit_codes_1.EXIT.USAGE);
+    if (!Number.isInteger(newQuorum) || newQuorum < 0 || newQuorum > 4294967295)
+        throw new errors_1.CliError('Quorum must be a uint32 voter count (0 disables)', exit_codes_1.EXIT.USAGE);
     const modules = await (0, resolve_1.resolveOrgModules)(ctx.client, params.org, ctx.chainId);
     if (!modules.hybridVotingAddress)
         throw new errors_1.CliError('HybridVoting not deployed', exit_codes_1.EXIT.USAGE);
@@ -465,10 +472,10 @@ exports.CONFIG_PARAMS = {
         ddKey: 0,
         valueType: 'uint8',
         description: 'Support threshold percentage (1-100)',
-        encode: (v) => ethers_1.ethers.utils.defaultAbiCoder.encode(['uint8'], [parseInt(v, 10)]),
+        encode: (v) => ethers_1.ethers.utils.defaultAbiCoder.encode(['uint8'], [Number(v)]),
         validate: (v) => {
-            const n = parseInt(v, 10);
-            if (isNaN(n) || n < 1 || n > 100)
+            const n = Number(v);
+            if (!Number.isInteger(n) || n < 1 || n > 100)
                 throw new Error('Threshold must be 1-100');
         },
     },
@@ -478,7 +485,7 @@ exports.CONFIG_PARAMS = {
         ddKey: 4,
         valueType: 'uint32',
         description: 'Minimum voter count for validity (0 disables)',
-        encode: (v) => ethers_1.ethers.utils.defaultAbiCoder.encode(['uint32'], [parseInt(v, 10)]),
+        encode: (v) => ethers_1.ethers.utils.defaultAbiCoder.encode(['uint32'], [Number(v)]),
         validate: (v) => {
             const n = Number(v);
             if (!Number.isInteger(n) || n < 0 || n > 4294967295) {
@@ -521,25 +528,6 @@ exports.CONFIG_PARAMS = {
                 throw new Error('Cannot set executor to zero address');
         },
     },
-    'hat-allowed': {
-        name: 'hat-allowed',
-        hybridKey: -1, // not available on Hybrid
-        ddKey: 3,
-        hybridUnavailableReason: 'HAT_ALLOWED is not a HybridVoting config key; this key only applies to DirectDemocracyVoting',
-        valueType: 'uint256,bool',
-        description: 'Allow/disallow a hat ID for DD voting (format: hatId,true/false)',
-        encode: (v) => {
-            const [hatId, allowed] = v.split(',');
-            return ethers_1.ethers.utils.defaultAbiCoder.encode(['uint256', 'bool'], [hatId.trim(), allowed.trim() === 'true']);
-        },
-        validate: (v) => {
-            const parts = v.split(',');
-            if (parts.length !== 2)
-                throw new Error('Format: hatId,true/false');
-            if (!['true', 'false'].includes(parts[1].trim()))
-                throw new Error('Second value must be true or false');
-        },
-    },
 };
 /**
  * Port of `pop vote propose-config` — src/commands/vote/propose-config.ts.
@@ -652,6 +640,10 @@ function parseClassConfigs(doc) {
         let minBalance;
         try {
             minBalance = ethers_1.ethers.BigNumber.from(String(entry.minBalance ?? 0));
+            if (minBalance.lt(0) || minBalance.gt(ethers_1.ethers.constants.MaxUint256))
+                throw new Error('uint256 overflow');
+            if (typeof entry.minBalance === 'number' && !Number.isSafeInteger(entry.minBalance))
+                throw new Error('unsafe integer');
         }
         catch {
             throw usageError(`Class ${i}: invalid minBalance ${JSON.stringify(entry.minBalance)} — pass a base-unit integer string.`);
@@ -663,18 +655,38 @@ function parseClassConfigs(doc) {
         if (strategy === exports.CLASS_STRATEGY.ERC20_BAL && asset === ethers_1.ethers.constants.AddressZero) {
             throw usageError(`Class ${i}: ERC20_BAL strategy requires a non-zero asset address (the contract reverts ZeroAddress).`);
         }
-        const rawHatIds = entry.hatIds ?? [];
+        if (entry.subjectIds !== undefined && entry.hatIds !== undefined)
+            throw usageError(`Class ${i}: specify subjectIds or hatIds, not both.`);
+        const rawHatIds = entry.subjectIds ?? entry.hatIds ?? [];
         if (!Array.isArray(rawHatIds))
-            throw usageError(`Class ${i}: hatIds must be an array.`);
+            throw usageError(`Class ${i}: subjectIds (hatIds) must be an array.`);
         const hatIds = rawHatIds.map((h) => {
             try {
-                return ethers_1.ethers.BigNumber.from(String(h).trim());
+                if (typeof h === 'number' && !Number.isSafeInteger(h))
+                    throw new Error('unsafe integer');
+                const id = ethers_1.ethers.BigNumber.from(String(h).trim());
+                if (id.lt(0) || id.gt(ethers_1.ethers.constants.MaxUint256))
+                    throw new Error('uint256 overflow');
+                return id;
             }
             catch {
                 throw usageError(`Class ${i}: invalid hat ID ${JSON.stringify(h)}.`);
             }
         });
-        return { strategy, slicePct, quadratic: Boolean(entry.quadratic), minBalance, asset, hatIds };
+        let subjectId;
+        if (entry.subjectId !== undefined) {
+            try {
+                subjectId = ethers_1.ethers.BigNumber.from(entry.subjectId);
+                if (subjectId.lt(0) || subjectId.gt(ethers_1.ethers.constants.MaxUint256))
+                    throw new Error('uint256 overflow');
+            }
+            catch {
+                throw usageError(`Class ${i}: subjectId must be a uint256 integer string (0 clears the binding).`);
+            }
+        }
+        if (entry.quadratic !== undefined && typeof entry.quadratic !== 'boolean')
+            throw usageError(`Class ${i}: quadratic must be a boolean.`);
+        return { strategy, slicePct, quadratic: entry.quadratic ?? false, minBalance, asset, hatIds, ...(subjectId !== undefined ? { subjectId } : {}) };
     });
     const sliceSum = classes.reduce((sum, c) => sum + c.slicePct, 0);
     if (sliceSum !== 100) {
@@ -696,13 +708,12 @@ function describeClass(c) {
         parts.push(`min balance ${(0, format_1.formatToken)(c.minBalance)}`);
     if (c.asset !== ethers_1.ethers.constants.AddressZero)
         parts.push(`asset ${(0, encoding_1.formatAddress)(c.asset)}`);
+    if (c.subjectId !== undefined)
+        parts.push(c.subjectId.isZero() ? 'clear subject binding' : `subject binding ${c.subjectId.toString()}`);
     if (c.hatIds.length > 0)
-        parts.push(`hats ${c.hatIds.map(h => h.toString()).join(',')}`);
+        parts.push(`subjects ${c.hatIds.map(h => h.toString()).join(',')}`);
     return parts.join(', ');
 }
-function isParsedClassConfigs(value) {
-    return Array.isArray(value) && value.every((c) => c && typeof c === 'object' && ethers_1.ethers.BigNumber.isBigNumber(c.minBalance));
-}
 /**
  * Port of `pop vote classes propose` — src/commands/vote/classes.ts
  * (classesProposeHandler).
@@ -715,9 +726,7 @@ function isParsedClassConfigs(value) {
  */
 async function proposeClassesIntent(ctx, params) {
     const durationMinutes = params.durationMinutes ?? 60;
-    const classes = isParsedClassConfigs(params.classes)
-        ? params.classes
-        : parseClassConfigs(params.classes);
+    const classes = parseClassConfigs(params.classes);
     const modules = await (0, resolve_1.resolveOrgModules)(ctx.client, params.org, ctx.chainId);
     const hybridVotingAddress = modules.hybridVotingAddress;
     if (!hybridVotingAddress) {
@@ -727,7 +736,9 @@ async function proposeClassesIntent(ctx, params) {
         classes.map(c => [c.strategy, c.slicePct, c.quadratic, c.minBalance, c.asset, c.hatIds]),
     ]);
     const batches = [
-        [setClassesCall], // option 0: apply
+        [setClassesCall, ...classes.flatMap((c, index) => c.subjectId === undefined ? [] : [
+                (0, governance_1.encodeExecutorCall)('HybridVotingNew', hybridVotingAddress, 'setClassSubject', [index, c.subjectId]),
+            ])], // option 0: update classes and explicitly requested stable bindings
         [], // option 1: keep current
     ];
     const classLines = classes.map(describeClass);

package/dist/version.d.ts

@@ -58,11 +58,6 @@ export interface TaskManagerFeatures {
  * requiresApplication, absoluteDeadline, completionWindow).
  */
 export declare const TM_FEATURE_FRAGMENTS: Record<keyof TaskManagerFeatures, string>;
-/**
- * Legacy (pre-v6) TaskManager write fragments, for building a fallback
- * Interface when the org's implementation predates the deadline fields.
- */
-export declare const LEGACY_TM_FRAGMENTS: string[];
 /**
  * Compute the 4-byte selector for a human-readable function fragment at
  * runtime (never hardcode selector hex — signatures drift, keccak does not).

package/dist/version.js

@@ -31,7 +31,7 @@
  *      table can only ever remove work — never invent a feature.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KNOWN_TM_IMPLEMENTATION_FEATURES = exports.TASK_MANAGER_TYPE_ID = exports.LEGACY_TM_FRAGMENTS = exports.TM_FEATURE_FRAGMENTS = exports.EIP1967_IMPLEMENTATION_SLOT = exports.EIP1967_BEACON_SLOT = void 0;
+exports.KNOWN_TM_IMPLEMENTATION_FEATURES = exports.TASK_MANAGER_TYPE_ID = exports.TM_FEATURE_FRAGMENTS = exports.EIP1967_IMPLEMENTATION_SLOT = exports.EIP1967_BEACON_SLOT = void 0;
 exports.computeSelector = computeSelector;
 exports.getImplementation = getImplementation;
 exports.featuresFromBytecode = featuresFromBytecode;
@@ -62,18 +62,6 @@ exports.TM_FEATURE_FRAGMENTS = {
     legacyCreate7: 'function createTask(uint256 payout, bytes title, bytes32 metadataHash, bytes32 pid, address bountyToken, uint256 bountyPayout, bool requiresApplication)',
     unclaim: 'function unclaimTask(uint256 id)',
 };
-/**
- * Legacy (pre-v6) TaskManager write fragments, for building a fallback
- * Interface when the org's implementation predates the deadline fields.
- */
-exports.LEGACY_TM_FRAGMENTS = [
-    exports.TM_FEATURE_FRAGMENTS.legacyCreate7,
-    'function updateTask(uint256 id, uint256 newPayout, bytes newTitle, bytes32 newMetadataHash, address newBountyToken, uint256 newBountyPayout)',
-    // TaskCreated event (identical shape pre-v6 and v6 — verified against the
-    // pre-sync ABI at f3b7216~1) so executeTx's receipt log parsing can still
-    // extract the created task id on the legacy path.
-    'event TaskCreated(uint256 indexed id, bytes32 indexed project, uint256 payout, address bountyToken, uint256 bountyPayout, bool requiresApplication, bytes title, bytes32 metadataHash)',
-];
 const selectorCache = new Map();
 /**
  * Compute the 4-byte selector for a human-readable function fragment at

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poa-box/core",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Browser-and-Node core for the POP (Proof of Participation) protocol: transaction intent builders, subgraph reads, canonical metadata, ABIs, and chain config. The stable layer the CLI, frontends, and integrators share.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/abis/ToggleModule.d.ts

@@ -1,193 +0,0 @@
-export declare const ToggleModuleAbi: readonly [{
-    readonly type: "constructor";
-    readonly inputs: readonly [];
-    readonly stateMutability: "nonpayable";
-}, {
-    readonly type: "function";
-    readonly name: "admin";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "batchSetHatStatus";
-    readonly inputs: readonly [{
-        readonly name: "hatIds";
-        readonly type: "uint256[]";
-        readonly internalType: "uint256[]";
-    }, {
-        readonly name: "actives";
-        readonly type: "bool[]";
-        readonly internalType: "bool[]";
-    }];
-    readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
-}, {
-    readonly type: "function";
-    readonly name: "eligibilityModule";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "getHatStatus";
-    readonly inputs: readonly [{
-        readonly name: "hatId";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "status";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "hatActive";
-    readonly inputs: readonly [{
-        readonly name: "hatId";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "bool";
-        readonly internalType: "bool";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "initialize";
-    readonly inputs: readonly [{
-        readonly name: "_admin";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
-}, {
-    readonly type: "function";
-    readonly name: "setEligibilityModule";
-    readonly inputs: readonly [{
-        readonly name: "_eligibilityModule";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
-}, {
-    readonly type: "function";
-    readonly name: "setHatStatus";
-    readonly inputs: readonly [{
-        readonly name: "hatId";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }, {
-        readonly name: "_active";
-        readonly type: "bool";
-        readonly internalType: "bool";
-    }];
-    readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
-}, {
-    readonly type: "function";
-    readonly name: "transferAdmin";
-    readonly inputs: readonly [{
-        readonly name: "newAdmin";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
-}, {
-    readonly type: "event";
-    readonly name: "AdminTransferred";
-    readonly inputs: readonly [{
-        readonly name: "oldAdmin";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }, {
-        readonly name: "newAdmin";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }];
-    readonly anonymous: false;
-}, {
-    readonly type: "event";
-    readonly name: "EligibilityModuleSet";
-    readonly inputs: readonly [{
-        readonly name: "oldModule";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }, {
-        readonly name: "newModule";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }];
-    readonly anonymous: false;
-}, {
-    readonly type: "event";
-    readonly name: "HatToggled";
-    readonly inputs: readonly [{
-        readonly name: "hatId";
-        readonly type: "uint256";
-        readonly indexed: true;
-        readonly internalType: "uint256";
-    }, {
-        readonly name: "newStatus";
-        readonly type: "bool";
-        readonly indexed: false;
-        readonly internalType: "bool";
-    }];
-    readonly anonymous: false;
-}, {
-    readonly type: "event";
-    readonly name: "Initialized";
-    readonly inputs: readonly [{
-        readonly name: "version";
-        readonly type: "uint64";
-        readonly indexed: false;
-        readonly internalType: "uint64";
-    }];
-    readonly anonymous: false;
-}, {
-    readonly type: "event";
-    readonly name: "ToggleModuleInitialized";
-    readonly inputs: readonly [{
-        readonly name: "admin";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }];
-    readonly anonymous: false;
-}, {
-    readonly type: "error";
-    readonly name: "InvalidInitialization";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "NotInitializing";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "NotToggleAdmin";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "ZeroAddress";
-    readonly inputs: readonly [];
-}];
-export default ToggleModuleAbi;