@geoprotocol/geo-sdk 0.19.0 → 0.19.1

package/dist/src/client/dao-spaces.d.ts

@@ -20,6 +20,7 @@ export type CreateProposalParams = {
     proposalId?: string;
     votingMode?: VotingMode;
     actions: ProposalAction[];
+    updateProposal?: boolean;
 };
 export type ProposeEditParams = {
     name: string;
@@ -30,11 +31,14 @@ export type ProposeEditParams = {
     daoSpaceId: string;
     votingMode?: VotingMode;
     proposalId?: string;
+    updateProposal?: boolean;
+    versionId?: number;
 };
 export type VoteProposalParams = {
     authorSpaceId: string;
     spaceId: string;
     proposalId: string;
+    versionId?: number;
     vote: VoteOption;
 };
 export type ExecuteProposalParams = {
@@ -69,6 +73,15 @@ export type ProposeRequestMembershipParams = {
     spaceId: string;
     proposalId?: string;
 };
+export type ProposeArchiveSpaceParams = {
+    authorSpaceId: string;
+    spaceId: string;
+    proposalId?: string;
+    votingMode?: 'SLOW';
+};
+export type ProposeUpdateVotingSettingsParams = SlowDaoSpaceRoleProposalBaseParams & {
+    votingSettings: VotingSettingsInput;
+};
 declare function encodePublishEditProposalAction(daoSpaceAddress: `0x${string}`, cid: string): ProposalAction;
 declare function encodeUpdateVotingSettingsAction(daoSpaceAddress: `0x${string}`, votingSettings: VotingSettingsInput): ProposalAction;
 /**
@@ -87,10 +100,13 @@ declare function encodeUpdateVotingSettingsAction(daoSpaceAddress: `0x${string}`
  *   author: authorSpaceId,
  *   initialEditorSpaceIds: [authorSpaceId],
  *   votingSettings: {
- *     slowPathPercentageThreshold: 50,
- *     fastPathFlatThreshold: 1,
+ *     partialPercentageSupportThreshold: 50,
+ *     universalPercentageSupportThreshold: 90,
+ *     flatSupportThreshold: 1,
  *     quorum: 1,
- *     durationInDays: 3,
+ *     durationInDays: 2,
+ *     disableFastPathAccessForNewMembers: true,
+ *     executionGracePeriodInDays: 14,
  *   },
  * });
  *
@@ -112,28 +128,20 @@ export declare function create(context: GeoClientContext, params: CreateDaoSpace
     cid: `ipfs://${string}`;
 }>;
 /**
- * Builds calldata for creating a DAO proposal from prebuilt proposal actions.
+ * Builds calldata for creating or updating a DAO proposal from prebuilt proposal actions.
  *
  * This uses the configured `SPACE_REGISTRY_ADDRESS` and encodes a
- * `GOVERNANCE.PROPOSAL_CREATED` `SpaceRegistry.enter(...)` call.
+ * `GOVERNANCE.PROPOSAL_CREATED` or `GOVERNANCE.PROPOSAL_UPDATED`
+ * `SpaceRegistry.enter(...)` call. Prefer the high-level
+ * `geo.daoSpaces.propose*` helpers for public client code.
  *
  * @example
  * ```ts
- * const actions = [
- *   geo.daoSpaces.proposals.actions.addMember(daoSpaceAddress, memberSpaceId),
- *   geo.daoSpaces.proposals.actions.updateVotingSettings(daoSpaceAddress, {
- *     slowPathPercentageThreshold: 60,
- *     fastPathFlatThreshold: 2,
- *     quorum: 3,
- *     durationInDays: 5,
- *   }),
- * ];
- *
- * const tx = geo.daoSpaces.proposals.create({
- *   fromSpaceId: authorSpaceId,
- *   daoSpaceId,
- *   votingMode: 'SLOW',
- *   actions,
+ * const tx = geo.daoSpaces.proposeAddMember({
+ *   authorSpaceId,
+ *   spaceId: daoSpaceId,
+ *   daoSpaceAddress,
+ *   newMemberSpaceId,
  * });
  * ```
  *
@@ -141,6 +149,7 @@ export declare function create(context: GeoClientContext, params: CreateDaoSpace
  * @param params Caller space, DAO space, voting mode, optional proposal ID, and actions.
  * @returns Target registry address, calldata, and proposal ID.
  * @throws When IDs are invalid or the configured network is missing `SPACE_REGISTRY_ADDRESS`.
+ * @internal
  */
 export declare function createProposal(context: GeoClientContext, params: CreateProposalParams): {
     to: `0x${string}`;
@@ -151,7 +160,7 @@ export declare function createProposal(context: GeoClientContext, params: Create
  * Publishes an edit and wraps it in a DAO-space proposal.
  *
  * This helper validates the proposal shape before upload, publishes the edit
- * through the configured API, creates a DAO `publish(...)` action with the
+ * through the configured API, creates a DAO `ping(...)` action with the
  * resulting CID, and returns calldata for proposal creation.
  *
  * @example
@@ -177,6 +186,7 @@ export declare function proposeEdit(context: GeoClientContext, params: ProposeEd
     proposalId: `0x${string}`;
     editId: Id;
     cid: `ipfs://${string}`;
+    versionId: number;
 }>;
 /**
  * Builds calldata for a DAO proposal that adds a member space.
@@ -257,6 +267,37 @@ export declare function proposeRemoveEditor(context: GeoClientContext, params: P
     calldata: `0x${string}`;
     proposalId: `0x${string}`;
 };
+/**
+ * Builds calldata for a DAO proposal that updates voting settings.
+ *
+ * Updating voting settings only supports SLOW voting.
+ * The client validates deterministic numeric bounds before encoding; the DAO
+ * contract still enforces flat threshold and quorum against the current editor
+ * count when the proposal executes.
+ *
+ * @example
+ * ```ts
+ * const tx = geo.daoSpaces.proposeUpdateVotingSettings({
+ *   authorSpaceId,
+ *   spaceId: daoSpaceId,
+ *   daoSpaceAddress,
+ *   votingSettings: {
+ *     partialPercentageSupportThreshold: 50,
+ *     universalPercentageSupportThreshold: 90,
+ *     flatSupportThreshold: 1,
+ *     quorum: 1,
+ *     durationInDays: 2,
+ *     disableFastPathAccessForNewMembers: true,
+ *     executionGracePeriodInDays: 14,
+ *   },
+ * });
+ * ```
+ */
+export declare function proposeUpdateVotingSettings(context: GeoClientContext, params: ProposeUpdateVotingSettingsParams): {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+    proposalId: `0x${string}`;
+};
 /**
  * Builds calldata for requesting membership in a DAO space.
  *
@@ -276,15 +317,37 @@ export declare function proposeRequestMembership(context: GeoClientContext, para
     calldata: `0x${string}`;
     proposalId: `0x${string}`;
 };
+/**
+ * Builds calldata for a DAO proposal that archives the DAO space.
+ *
+ * The proposal action targets the Space Registry and calls `archiveSpaceId()`.
+ * When the proposal executes, the DAO space contract is `msg.sender`, so the
+ * registry archives the DAO space's registered ID. Archiving is a destructive
+ * governance action and only supports SLOW voting.
+ *
+ * @example
+ * ```ts
+ * const tx = geo.daoSpaces.proposeArchiveSpace({
+ *   authorSpaceId,
+ *   spaceId: daoSpaceId,
+ * });
+ * ```
+ */
+export declare function proposeArchiveSpace(context: GeoClientContext, params: ProposeArchiveSpaceParams): {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+    proposalId: `0x${string}`;
+};
 /**
  * Builds calldata for voting on a DAO proposal.
  *
  * @example
  * ```ts
- * const tx = geo.daoSpaces.proposals.vote({
+ * const tx = geo.daoSpaces.voteProposal({
  *   authorSpaceId,
  *   spaceId: daoSpaceId,
  *   proposalId,
+ *   versionId: 1,
  *   vote: 'YES',
  * });
  * ```
@@ -303,7 +366,7 @@ export declare function voteProposal(context: GeoClientContext, params: VoteProp
  *
  * @example
  * ```ts
- * const tx = geo.daoSpaces.proposals.execute({
+ * const tx = geo.daoSpaces.executeProposal({
  *   authorSpaceId,
  *   spaceId: daoSpaceId,
  *   proposalId,
@@ -320,24 +383,21 @@ export declare function executeProposal(context: GeoClientContext, params: Execu
     calldata: `0x${string}`;
 };
 /**
- * Helpers for constructing DAO proposal actions.
+ * Internal helpers for constructing DAO proposal actions.
  *
- * These helpers only encode DAO-space action payloads. Pass their results to
- * `geo.daoSpaces.proposals.create(...)` when building a proposal from explicit actions.
+ * These helpers only encode DAO-space action payloads for the higher-level
+ * proposal helpers in this module.
  *
  * @example
  * ```ts
- * const action = geo.daoSpaces.proposals.actions.addEditor(daoSpaceAddress, editorSpaceId);
- * const proposal = geo.daoSpaces.proposals.create({
- *   fromSpaceId: authorSpaceId,
- *   daoSpaceId,
- *   votingMode: 'SLOW',
- *   actions: [action],
- * });
+ * const action = actions.addEditor(daoSpaceAddress, editorSpaceId);
  * ```
+ *
+ * @internal
  */
 export declare const actions: {
     publishEdit: typeof encodePublishEditProposalAction;
+    archiveSpace: (spaceRegistryAddress: `0x${string}`) => ProposalAction;
     addEditor: (daoSpaceAddress: `0x${string}`, spaceId: string) => ProposalAction;
     removeEditor: (daoSpaceAddress: `0x${string}`, spaceId: string) => ProposalAction;
     addMember: (daoSpaceAddress: `0x${string}`, spaceId: string) => ProposalAction;

package/dist/src/client/dao-spaces.d.ts.map

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

package/dist/src/client/dao-spaces.js

@@ -1,9 +1,9 @@
 import { v4 as uuidv4 } from 'uuid';
-import { encodeAbiParameters, encodeFunctionData } from 'viem';
+import { createPublicClient, encodeAbiParameters, encodeFunctionData, http, toHex } from 'viem';
 import { DaoSpaceAbi, SpaceRegistryAbi } from '../abis/index.js';
 import { SPACE_TYPE } from '../core/ids/system.js';
-import { bytes16ToBytes32LeftAligned, EMPTY_SIGNATURE, EMPTY_TOPIC, ensure0xPrefix, isBytes16Hex, MEMBERSHIP_REQUESTED_ACTION, PROPOSAL_CREATED_ACTION, PROPOSAL_EXECUTED_ACTION, PROPOSAL_VOTED_ACTION, VOTE_OPTION_VALUES, } from '../dao-space/constants.js';
-import { getCreateDaoSpaceCalldata, toContractVotingSettings, validateIpfsUri, } from '../encodings/get-create-dao-space-calldata.js';
+import { bytes16ToBytes32LeftAligned, EDITS_PUBLISHED_ACTION, EMPTY_SIGNATURE, EMPTY_TOPIC, ensure0xPrefix, isBytes16Hex, MEMBERSHIP_REQUESTED_ACTION, PROPOSAL_CREATED_ACTION, PROPOSAL_EXECUTED_ACTION, PROPOSAL_UPDATED_ACTION, PROPOSAL_VOTED_ACTION, VOTE_OPTION_VALUES, } from '../dao-space/constants.js';
+import { getCreateDaoSpaceCalldata, toContractVotingSettings, validateIpfsUri, validateVotingSettingsInput, } from '../encodings/get-create-dao-space-calldata.js';
 import * as IdUtils from '../id-utils.js';
 import { assertValid } from '../id-utils.js';
 import { requireGeoContract } from '../networks.js';
@@ -31,6 +31,43 @@ function requireDaoSpaceAddress(daoSpaceAddress) {
     }
     return daoSpaceAddress;
 }
+function validateProposalVersion(versionId, fallback = 1) {
+    const version = versionId ?? fallback;
+    if (!Number.isInteger(version) || version < 1 || version > 255) {
+        throw new Error('versionId must be an integer between 1 and 255');
+    }
+    return version;
+}
+async function resolveProposalVersion(context, params) {
+    if (!params.updateProposal) {
+        if (params.versionId !== undefined) {
+            throw new Error('versionId can only be provided when updateProposal is true');
+        }
+        return 1;
+    }
+    const requestedVersion = params.versionId === undefined ? undefined : validateProposalVersion(params.versionId);
+    const rpcUrl = context.network.chain?.rpcUrl;
+    if (!rpcUrl) {
+        if (requestedVersion !== undefined) {
+            return requestedVersion;
+        }
+        throw new Error('versionId is required when updateProposal is true and the network has no RPC URL');
+    }
+    const publicClient = createPublicClient({
+        transport: http(rpcUrl),
+    });
+    const latestVersion = await publicClient.readContract({
+        address: params.daoSpaceAddress,
+        abi: DaoSpaceAbi,
+        functionName: 'latestProposalVersion',
+        args: [params.proposalId],
+    });
+    const nextVersion = validateProposalVersion(Number(latestVersion) + 1);
+    if (requestedVersion !== undefined && requestedVersion !== nextVersion) {
+        throw new Error(`versionId ${requestedVersion} does not match next on-chain proposal version ${nextVersion}`);
+    }
+    return nextVersion;
+}
 function encodeCreateProposal(params) {
     const fromSpaceId = bytes16Id(params.fromSpaceId, 'fromSpaceId');
     const daoSpaceId = bytes16Id(params.daoSpaceId, 'daoSpaceId');
@@ -60,7 +97,7 @@ function encodeCreateProposal(params) {
         args: [
             fromSpaceId,
             daoSpaceId,
-            PROPOSAL_CREATED_ACTION,
+            params.updateProposal ? PROPOSAL_UPDATED_ACTION : PROPOSAL_CREATED_ACTION,
             bytes16ToBytes32LeftAligned(proposalId),
             data,
             EMPTY_SIGNATURE,
@@ -82,8 +119,15 @@ function encodePublishEditProposalAction(daoSpaceAddress, cid) {
         value: 0n,
         data: encodeFunctionData({
             abi: DaoSpaceAbi,
-            functionName: 'publish',
-            args: [EMPTY_TOPIC, encodeAbiParameters([{ type: 'string' }], [cid]), '0x'],
+            functionName: 'ping',
+            args: [
+                EDITS_PUBLISHED_ACTION,
+                EMPTY_TOPIC,
+                encodeAbiParameters([
+                    { type: 'bytes', name: 'editsContentUri' },
+                    { type: 'bytes', name: 'editsMetadata' },
+                ], [toHex(cid), '0x']),
+            ],
         }),
     };
 }
@@ -99,6 +143,10 @@ function encodeDaoRoleAction(daoSpaceAddress, functionName, spaceId) {
     };
 }
 function encodeUpdateVotingSettingsAction(daoSpaceAddress, votingSettings) {
+    const validationError = validateVotingSettingsInput(votingSettings);
+    if (validationError) {
+        throw new Error(validationError);
+    }
     const contractVotingSettings = toContractVotingSettings(votingSettings);
     return {
         to: daoSpaceAddress,
@@ -108,15 +156,28 @@ function encodeUpdateVotingSettingsAction(daoSpaceAddress, votingSettings) {
             functionName: 'updateVotingSettings',
             args: [
                 {
-                    slowPathPercentageThreshold: contractVotingSettings.slowPathPercentageThreshold,
-                    fastPathFlatThreshold: contractVotingSettings.fastPathFlatThreshold,
+                    partialPercentageSupportThreshold: contractVotingSettings.partialPercentageSupportThreshold,
+                    universalPercentageSupportThreshold: contractVotingSettings.universalPercentageSupportThreshold,
+                    flatSupportThreshold: contractVotingSettings.flatSupportThreshold,
                     quorum: contractVotingSettings.quorum,
                     duration: contractVotingSettings.duration,
+                    disableFastPathAccessForNewMembers: contractVotingSettings.disableFastPathAccessForNewMembers,
+                    executionGracePeriod: contractVotingSettings.executionGracePeriod,
                 },
             ],
         }),
     };
 }
+function encodeSpaceRegistryLifecycleAction(spaceRegistryAddress, functionName) {
+    return {
+        to: spaceRegistryAddress,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: SpaceRegistryAbi,
+            functionName,
+        }),
+    };
+}
 /**
  * Publishes the initial DAO edit and returns calldata for creating a DAO space.
  *
@@ -133,10 +194,13 @@ function encodeUpdateVotingSettingsAction(daoSpaceAddress, votingSettings) {
  *   author: authorSpaceId,
  *   initialEditorSpaceIds: [authorSpaceId],
  *   votingSettings: {
- *     slowPathPercentageThreshold: 50,
- *     fastPathFlatThreshold: 1,
+ *     partialPercentageSupportThreshold: 50,
+ *     universalPercentageSupportThreshold: 90,
+ *     flatSupportThreshold: 1,
  *     quorum: 1,
- *     durationInDays: 3,
+ *     durationInDays: 2,
+ *     disableFastPathAccessForNewMembers: true,
+ *     executionGracePeriodInDays: 14,
  *   },
  * });
  *
@@ -191,28 +255,20 @@ export async function create(context, params) {
     };
 }
 /**
- * Builds calldata for creating a DAO proposal from prebuilt proposal actions.
+ * Builds calldata for creating or updating a DAO proposal from prebuilt proposal actions.
  *
  * This uses the configured `SPACE_REGISTRY_ADDRESS` and encodes a
- * `GOVERNANCE.PROPOSAL_CREATED` `SpaceRegistry.enter(...)` call.
+ * `GOVERNANCE.PROPOSAL_CREATED` or `GOVERNANCE.PROPOSAL_UPDATED`
+ * `SpaceRegistry.enter(...)` call. Prefer the high-level
+ * `geo.daoSpaces.propose*` helpers for public client code.
  *
  * @example
  * ```ts
- * const actions = [
- *   geo.daoSpaces.proposals.actions.addMember(daoSpaceAddress, memberSpaceId),
- *   geo.daoSpaces.proposals.actions.updateVotingSettings(daoSpaceAddress, {
- *     slowPathPercentageThreshold: 60,
- *     fastPathFlatThreshold: 2,
- *     quorum: 3,
- *     durationInDays: 5,
- *   }),
- * ];
- *
- * const tx = geo.daoSpaces.proposals.create({
- *   fromSpaceId: authorSpaceId,
- *   daoSpaceId,
- *   votingMode: 'SLOW',
- *   actions,
+ * const tx = geo.daoSpaces.proposeAddMember({
+ *   authorSpaceId,
+ *   spaceId: daoSpaceId,
+ *   daoSpaceAddress,
+ *   newMemberSpaceId,
  * });
  * ```
  *
@@ -220,6 +276,7 @@ export async function create(context, params) {
  * @param params Caller space, DAO space, voting mode, optional proposal ID, and actions.
  * @returns Target registry address, calldata, and proposal ID.
  * @throws When IDs are invalid or the configured network is missing `SPACE_REGISTRY_ADDRESS`.
+ * @internal
  */
 export function createProposal(context, params) {
     return encodeCreateProposal({
@@ -231,7 +288,7 @@ export function createProposal(context, params) {
  * Publishes an edit and wraps it in a DAO-space proposal.
  *
  * This helper validates the proposal shape before upload, publishes the edit
- * through the configured API, creates a DAO `publish(...)` action with the
+ * through the configured API, creates a DAO `ping(...)` action with the
  * resulting CID, and returns calldata for proposal creation.
  *
  * @example
@@ -253,15 +310,25 @@ export function createProposal(context, params) {
  */
 export async function proposeEdit(context, params) {
     assertValid(String(params.author), '`author` in `proposeEdit`');
+    if (params.updateProposal && !params.proposalId) {
+        throw new Error('proposalId is required when updateProposal is true');
+    }
     const spaceRegistryAddress = requireGeoContract(context.network, 'SPACE_REGISTRY_ADDRESS');
     const validated = encodeCreateProposal({
         fromSpaceId: params.callerSpaceId,
         daoSpaceId: params.daoSpaceId,
         proposalId: params.proposalId,
         votingMode: params.votingMode ?? 'FAST',
+        updateProposal: params.updateProposal,
         actions: [encodePublishEditProposalAction(params.daoSpaceAddress, VALIDATION_CID)],
         spaceRegistryAddress,
     });
+    const versionId = await resolveProposalVersion(context, {
+        daoSpaceAddress: params.daoSpaceAddress,
+        proposalId: validated.proposalId,
+        updateProposal: params.updateProposal,
+        versionId: params.versionId,
+    });
     const { publish } = await import('./edits.js');
     const { cid, editId } = await publish(context, {
         name: params.name,
@@ -273,12 +340,14 @@ export async function proposeEdit(context, params) {
         daoSpaceId: params.daoSpaceId,
         proposalId: validated.proposalId,
         votingMode: params.votingMode ?? 'FAST',
+        updateProposal: params.updateProposal,
         actions: [encodePublishEditProposalAction(params.daoSpaceAddress, cid)],
         spaceRegistryAddress,
     });
     return {
         editId,
         cid,
+        versionId,
         ...result,
     };
 }
@@ -361,6 +430,39 @@ export function proposeRemoveEditor(context, params) {
     }
     return createRoleProposal(context, params, actions.removeEditor(requireDaoSpaceAddress(params.daoSpaceAddress), params.editorToRemoveSpaceId));
 }
+/**
+ * Builds calldata for a DAO proposal that updates voting settings.
+ *
+ * Updating voting settings only supports SLOW voting.
+ * The client validates deterministic numeric bounds before encoding; the DAO
+ * contract still enforces flat threshold and quorum against the current editor
+ * count when the proposal executes.
+ *
+ * @example
+ * ```ts
+ * const tx = geo.daoSpaces.proposeUpdateVotingSettings({
+ *   authorSpaceId,
+ *   spaceId: daoSpaceId,
+ *   daoSpaceAddress,
+ *   votingSettings: {
+ *     partialPercentageSupportThreshold: 50,
+ *     universalPercentageSupportThreshold: 90,
+ *     flatSupportThreshold: 1,
+ *     quorum: 1,
+ *     durationInDays: 2,
+ *     disableFastPathAccessForNewMembers: true,
+ *     executionGracePeriodInDays: 14,
+ *   },
+ * });
+ * ```
+ */
+export function proposeUpdateVotingSettings(context, params) {
+    const votingMode = params.votingMode ?? 'SLOW';
+    if (votingMode !== 'SLOW') {
+        throw new Error('proposeUpdateVotingSettings only supports SLOW voting mode');
+    }
+    return createRoleProposal(context, params, actions.updateVotingSettings(requireDaoSpaceAddress(params.daoSpaceAddress), params.votingSettings));
+}
 /**
  * Builds calldata for requesting membership in a DAO space.
  *
@@ -396,15 +498,46 @@ export function proposeRequestMembership(context, params) {
         proposalId,
     };
 }
+/**
+ * Builds calldata for a DAO proposal that archives the DAO space.
+ *
+ * The proposal action targets the Space Registry and calls `archiveSpaceId()`.
+ * When the proposal executes, the DAO space contract is `msg.sender`, so the
+ * registry archives the DAO space's registered ID. Archiving is a destructive
+ * governance action and only supports SLOW voting.
+ *
+ * @example
+ * ```ts
+ * const tx = geo.daoSpaces.proposeArchiveSpace({
+ *   authorSpaceId,
+ *   spaceId: daoSpaceId,
+ * });
+ * ```
+ */
+export function proposeArchiveSpace(context, params) {
+    const votingMode = params.votingMode ?? 'SLOW';
+    if (votingMode !== 'SLOW') {
+        throw new Error('proposeArchiveSpace only supports SLOW voting mode');
+    }
+    const spaceRegistryAddress = requireGeoContract(context.network, 'SPACE_REGISTRY_ADDRESS');
+    return createProposal(context, {
+        fromSpaceId: params.authorSpaceId,
+        daoSpaceId: params.spaceId,
+        proposalId: params.proposalId,
+        votingMode,
+        actions: [actions.archiveSpace(spaceRegistryAddress)],
+    });
+}
 /**
  * Builds calldata for voting on a DAO proposal.
  *
  * @example
  * ```ts
- * const tx = geo.daoSpaces.proposals.vote({
+ * const tx = geo.daoSpaces.voteProposal({
  *   authorSpaceId,
  *   spaceId: daoSpaceId,
  *   proposalId,
+ *   versionId: 1,
  *   vote: 'YES',
  * });
  * ```
@@ -418,11 +551,13 @@ export function voteProposal(context, params) {
     const authorSpaceId = bytes16Id(params.authorSpaceId, 'authorSpaceId');
     const spaceId = bytes16Id(params.spaceId, 'spaceId');
     const proposalId = bytes16Id(params.proposalId, 'proposalId');
+    const versionId = validateProposalVersion(params.versionId, 1);
     const topic = bytes16ToBytes32LeftAligned(proposalId);
     const data = encodeAbiParameters([
         { type: 'bytes16', name: 'proposalId' },
+        { type: 'uint8', name: 'versionId' },
         { type: 'uint8', name: 'voteOption' },
-    ], [proposalId, VOTE_OPTION_VALUES[params.vote]]);
+    ], [proposalId, versionId, VOTE_OPTION_VALUES[params.vote]]);
     const calldata = encodeFunctionData({
         abi: SpaceRegistryAbi,
         functionName: 'enter',
@@ -438,7 +573,7 @@ export function voteProposal(context, params) {
  *
  * @example
  * ```ts
- * const tx = geo.daoSpaces.proposals.execute({
+ * const tx = geo.daoSpaces.executeProposal({
  *   authorSpaceId,
  *   spaceId: daoSpaceId,
  *   proposalId,
@@ -467,24 +602,21 @@ export function executeProposal(context, params) {
     };
 }
 /**
- * Helpers for constructing DAO proposal actions.
+ * Internal helpers for constructing DAO proposal actions.
  *
- * These helpers only encode DAO-space action payloads. Pass their results to
- * `geo.daoSpaces.proposals.create(...)` when building a proposal from explicit actions.
+ * These helpers only encode DAO-space action payloads for the higher-level
+ * proposal helpers in this module.
  *
  * @example
  * ```ts
- * const action = geo.daoSpaces.proposals.actions.addEditor(daoSpaceAddress, editorSpaceId);
- * const proposal = geo.daoSpaces.proposals.create({
- *   fromSpaceId: authorSpaceId,
- *   daoSpaceId,
- *   votingMode: 'SLOW',
- *   actions: [action],
- * });
+ * const action = actions.addEditor(daoSpaceAddress, editorSpaceId);
  * ```
+ *
+ * @internal
  */
 export const actions = {
     publishEdit: encodePublishEditProposalAction,
+    archiveSpace: (spaceRegistryAddress) => encodeSpaceRegistryLifecycleAction(spaceRegistryAddress, 'archiveSpaceId'),
     addEditor: (daoSpaceAddress, spaceId) => encodeDaoRoleAction(daoSpaceAddress, 'addEditor', spaceId),
     removeEditor: (daoSpaceAddress, spaceId) => encodeDaoRoleAction(daoSpaceAddress, 'removeEditor', spaceId),
     addMember: (daoSpaceAddress, spaceId) => encodeDaoRoleAction(daoSpaceAddress, 'addMember', spaceId),