@geoprotocol/geo-sdk 0.18.3 → 0.19.1

package/dist/src/client/spaces.test.js

@@ -0,0 +1,175 @@
+import { decodeFunctionData, encodeAbiParameters, hexToString } from 'viem';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { EMPTY_SPACE_ID } from '../../contracts.js';
+import { DaoSpaceFactoryAbi, SpaceRegistryAbi } from '../abis/index.js';
+import { createGeoClient } from '../client.js';
+import { ACCOUNT_TYPE, PERSON_TYPE, SPACE_TYPE, TYPES_PROPERTY } from '../core/ids/system.js';
+import { getCreatePersonalSpaceCalldata } from '../encodings/get-create-personal-space-calldata.js';
+import { toGrcId } from '../id-utils.js';
+import { defineGeoNetworkConfig } from '../networks.js';
+import { EMPTY_SIGNATURE, TOPIC_SET } from '../personal-space/constants.js';
+const CID = 'ipfs://bafkreigwfjixq5cm3s4youhshorkpqh3ykpviyv76c2ei6gaalujtlqz5i';
+const AUTHOR_ID = '5cade5757ecd41ae83481b22ffc2f94e';
+const EDITOR_SPACE_ID = '0x11111111111111111111111111111111';
+const ACCOUNT_ADDRESS = '0x1234567890123456789012345678901234567890';
+const PERSONAL_SPACE_ID = '0x22222222222222222222222222222222';
+const SPACE_REGISTRY_ADDRESS = '0x0000000000000000000000000000000000000001';
+const DAO_SPACE_FACTORY_ADDRESS = '0x0000000000000000000000000000000000000002';
+function customNetwork() {
+    return defineGeoNetworkConfig({
+        id: 'LOCAL',
+        name: 'Local Geo',
+        apiOrigin: 'http://localhost:3000',
+        chain: {
+            id: 31337,
+            name: 'Anvil',
+            rpcUrl: 'http://localhost:8545',
+        },
+        contracts: {
+            SPACE_REGISTRY_ADDRESS,
+            DAO_SPACE_FACTORY_ADDRESS,
+        },
+    });
+}
+function mockUploadFetch() {
+    return vi.fn().mockResolvedValue(new Response(JSON.stringify({ cid: CID })));
+}
+function mockRpcFetch(spaceId) {
+    return vi.fn().mockImplementation(async (_url, init) => {
+        const body = typeof init?.body === 'string' ? JSON.parse(init.body) : { id: 1 };
+        return new Response(JSON.stringify({
+            jsonrpc: '2.0',
+            id: body.id,
+            result: encodeAbiParameters([{ type: 'bytes16' }], [spaceId]),
+        }), { headers: { 'Content-Type': 'application/json' } });
+    });
+}
+function decodeEnter(calldata) {
+    const decoded = decodeFunctionData({
+        abi: SpaceRegistryAbi,
+        data: calldata,
+    });
+    expect(decoded.functionName).toBe('enter');
+    const [fromSpaceId, toSpaceId, action, topic, data, signature] = decoded.args;
+    return {
+        fromSpaceId,
+        toSpaceId,
+        action,
+        topic,
+        data,
+        signature,
+    };
+}
+describe('geo space clients', () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('creates personal space calldata and initial profile ops for the configured registry', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        const result = geo.personalSpaces.create({
+            name: 'Alice',
+            accountAddress: ACCOUNT_ADDRESS,
+        });
+        expect(result.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(result.calldata).toBe(getCreatePersonalSpaceCalldata());
+        expect(result.spaceEntityId).toHaveLength(32);
+        expect(result.accountId).toHaveLength(32);
+        expect(result.ops).toHaveLength(6);
+        const spaceEntityOp = result.ops.find((op) => op.type === 'createEntity' && op.id.every((b, i) => b === toGrcId(result.spaceEntityId)[i]));
+        expect(spaceEntityOp).toBeDefined();
+        const accountTypeOp = result.ops.find((op) => op.type === 'createRelation' &&
+            op.from.every((b, i) => b === toGrcId(result.accountId)[i]) &&
+            op.to.every((b, i) => b === toGrcId(ACCOUNT_TYPE)[i]) &&
+            op.relationType.every((b, i) => b === toGrcId(TYPES_PROPERTY)[i]));
+        expect(accountTypeOp).toBeDefined();
+        const spaceTypeOp = result.ops.find((op) => op.type === 'createRelation' &&
+            op.from.every((b, i) => b === toGrcId(result.spaceEntityId)[i]) &&
+            op.to.every((b, i) => b === toGrcId(SPACE_TYPE)[i]) &&
+            op.relationType.every((b, i) => b === toGrcId(TYPES_PROPERTY)[i]));
+        expect(spaceTypeOp).toBeDefined();
+        const personTypeOp = result.ops.find((op) => op.type === 'createRelation' &&
+            op.from.every((b, i) => b === toGrcId(result.spaceEntityId)[i]) &&
+            op.to.every((b, i) => b === toGrcId(PERSON_TYPE)[i]) &&
+            op.relationType.every((b, i) => b === toGrcId(TYPES_PROPERTY)[i]));
+        expect(personTypeOp).toBeDefined();
+    });
+    it('sets a personal space topic with the configured registry', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        const result = geo.personalSpaces.setTopic({
+            spaceId: PERSONAL_SPACE_ID,
+            topicId: '33333333333333333333333333333333',
+        });
+        const decoded = decodeEnter(result.calldata);
+        expect(result.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(decoded.fromSpaceId).toBe(PERSONAL_SPACE_ID);
+        expect(decoded.toSpaceId).toBe(PERSONAL_SPACE_ID);
+        expect(decoded.action).toBe(TOPIC_SET);
+        expect(decoded.topic).toBe(`0x33333333333333333333333333333333${'0'.repeat(32)}`);
+        expect(decoded.data).toBe('0x');
+        expect(decoded.signature).toBe(EMPTY_SIGNATURE);
+    });
+    it('creates personal space archive, recover, and clear calldata for the configured registry', () => {
+        const geo = createGeoClient({ network: customNetwork() });
+        const archive = geo.personalSpaces.archiveSpace();
+        const recover = geo.personalSpaces.recoverSpace();
+        const clear = geo.personalSpaces.clearSpace();
+        expect(archive.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(recover.to).toBe(SPACE_REGISTRY_ADDRESS);
+        expect(clear.to).toBe(SPACE_REGISTRY_ADDRESS);
+        const decodedArchive = decodeFunctionData({ abi: SpaceRegistryAbi, data: archive.calldata });
+        const decodedRecover = decodeFunctionData({ abi: SpaceRegistryAbi, data: recover.calldata });
+        const decodedClear = decodeFunctionData({ abi: SpaceRegistryAbi, data: clear.calldata });
+        expect(decodedArchive.functionName).toBe('archiveSpaceId');
+        expect(decodedRecover.functionName).toBe('recoverSpaceId');
+        expect(decodedClear.functionName).toBe('clearSpaceId');
+        expect(decodedArchive.args ?? []).toEqual([]);
+        expect(decodedRecover.args ?? []).toEqual([]);
+        expect(decodedClear.args ?? []).toEqual([]);
+    });
+    it('checks whether an address has a personal space using the configured registry', async () => {
+        const fetch = mockRpcFetch(PERSONAL_SPACE_ID);
+        vi.stubGlobal('fetch', fetch);
+        const geo = createGeoClient({ network: customNetwork() });
+        await expect(geo.personalSpaces.hasSpace({ address: ACCOUNT_ADDRESS })).resolves.toBe(true);
+        const body = JSON.parse(String(fetch.mock.calls[0]?.[1]?.body));
+        expect(body.params[0].to).toBe(SPACE_REGISTRY_ADDRESS.toLowerCase());
+    });
+    it('returns false when the registry has no personal space for the address', async () => {
+        vi.stubGlobal('fetch', mockRpcFetch(EMPTY_SPACE_ID));
+        const geo = createGeoClient({ network: customNetwork() });
+        await expect(geo.personalSpaces.hasSpace({ address: ACCOUNT_ADDRESS })).resolves.toBe(false);
+    });
+    it('creates DAO space calldata after publishing the initial edit', async () => {
+        const fetch = mockUploadFetch();
+        const geo = createGeoClient({ network: customNetwork(), fetch });
+        const result = await geo.daoSpaces.create({
+            name: 'Test DAO',
+            author: AUTHOR_ID,
+            votingSettings: {
+                partialPercentageSupportThreshold: 50,
+                universalPercentageSupportThreshold: 90,
+                flatSupportThreshold: 1,
+                quorum: 1,
+                durationInDays: 2,
+                disableFastPathAccessForNewMembers: true,
+                executionGracePeriodInDays: 14,
+            },
+            initialEditorSpaceIds: [EDITOR_SPACE_ID],
+        });
+        const decoded = decodeFunctionData({
+            abi: DaoSpaceFactoryAbi,
+            data: result.calldata,
+        });
+        const [, initialEditors, initialMembers, initialEditsContentUri, , initialTopicId] = decoded.args;
+        expect(result.to).toBe(DAO_SPACE_FACTORY_ADDRESS);
+        expect(result.cid).toBe(CID);
+        expect(result.spaceEntityId).toHaveLength(32);
+        expect(decoded.functionName).toBe('createDAOSpaceProxy');
+        expect(initialEditors).toEqual([EDITOR_SPACE_ID]);
+        expect(initialMembers).toEqual([]);
+        expect(hexToString(initialEditsContentUri)).toBe(CID);
+        expect(initialTopicId).toBe(`0x${result.spaceEntityId}`);
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/ipfs/upload-edit', expect.objectContaining({ method: 'POST' }));
+    });
+});
+//# sourceMappingURL=spaces.test.js.map

package/dist/src/client/spaces.test.js.map

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

package/dist/src/client/storage.d.ts

@@ -0,0 +1,52 @@
+import { type PublishImageParams } from '../ipfs-core.js';
+import type { GeoClientContext } from './context.js';
+/**
+ * Uploads an image file or remote image URL through the configured Geo API.
+ *
+ * This helper performs the upload only. It does not create graph ops. Use
+ * `geo.images.create(...)` when you want upload plus image entity ops.
+ *
+ * @example
+ * ```ts
+ * const uploaded = await geo.storage.uploadImage({
+ *   url: 'https://example.com/photo.png',
+ * });
+ *
+ * console.log(uploaded.cid);
+ * console.log(uploaded.dimensions);
+ * ```
+ *
+ * @param context Client context containing the API origin and fetch implementation.
+ * @param params Image source and optional upload route options.
+ * @returns The uploaded IPFS URI and detected dimensions when available.
+ * @throws When fetch is unavailable, the source URL cannot be fetched, upload fails, or the CID response is invalid.
+ */
+export declare function uploadImage(context: GeoClientContext, params: PublishImageParams & {
+    alternativeGateway?: boolean;
+}): Promise<{
+    cid: `ipfs://${string}`;
+    dimensions: {
+        width: number;
+        height: number;
+    };
+} | {
+    cid: `ipfs://${string}`;
+    dimensions?: undefined;
+}>;
+/**
+ * Compresses and uploads CSV content through the configured Geo API.
+ *
+ * @example
+ * ```ts
+ * const cid = await geo.storage.uploadCSV(`name,score
+ * Alice,10
+ * Bob,8`);
+ * ```
+ *
+ * @param context Client context containing the API origin and fetch implementation.
+ * @param csvString Raw CSV text to gzip and upload.
+ * @returns The uploaded IPFS URI.
+ * @throws When fetch is unavailable, upload fails, or the CID response is invalid.
+ */
+export declare function uploadCSV(context: GeoClientContext, csvString: string): Promise<`ipfs://${string}`>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/src/client/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/client/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAkC,MAAM,iBAAiB,CAAC;AAC1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;GAMnH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,MAAM,EAAE,CAAC,CAMnG"}

package/dist/src/client/storage.js

@@ -0,0 +1,53 @@
+import { uploadCSVCore, uploadImageCore } from '../ipfs-core.js';
+import { requireFetch } from './context.js';
+/**
+ * Uploads an image file or remote image URL through the configured Geo API.
+ *
+ * This helper performs the upload only. It does not create graph ops. Use
+ * `geo.images.create(...)` when you want upload plus image entity ops.
+ *
+ * @example
+ * ```ts
+ * const uploaded = await geo.storage.uploadImage({
+ *   url: 'https://example.com/photo.png',
+ * });
+ *
+ * console.log(uploaded.cid);
+ * console.log(uploaded.dimensions);
+ * ```
+ *
+ * @param context Client context containing the API origin and fetch implementation.
+ * @param params Image source and optional upload route options.
+ * @returns The uploaded IPFS URI and detected dimensions when available.
+ * @throws When fetch is unavailable, the source URL cannot be fetched, upload fails, or the CID response is invalid.
+ */
+export function uploadImage(context, params) {
+    return uploadImageCore({
+        ...params,
+        apiOrigin: context.network.apiOrigin,
+        fetch: requireFetch(context, 'Image uploads'),
+    });
+}
+/**
+ * Compresses and uploads CSV content through the configured Geo API.
+ *
+ * @example
+ * ```ts
+ * const cid = await geo.storage.uploadCSV(`name,score
+ * Alice,10
+ * Bob,8`);
+ * ```
+ *
+ * @param context Client context containing the API origin and fetch implementation.
+ * @param csvString Raw CSV text to gzip and upload.
+ * @returns The uploaded IPFS URI.
+ * @throws When fetch is unavailable, upload fails, or the CID response is invalid.
+ */
+export function uploadCSV(context, csvString) {
+    return uploadCSVCore({
+        csvString,
+        apiOrigin: context.network.apiOrigin,
+        fetch: requireFetch(context, 'CSV uploads'),
+    });
+}
+//# sourceMappingURL=storage.js.map

package/dist/src/client/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/client/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE1F,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,OAAyB,EAAE,MAA6D;IAClH,OAAO,eAAe,CAAC;QACrB,GAAG,MAAM;QACT,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;QACpC,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,OAAyB,EAAE,SAAiB;IACpE,OAAO,aAAa,CAAC;QACnB,SAAS;QACT,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;QACpC,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,aAAa,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC"}

package/dist/src/client.d.ts

@@ -0,0 +1,338 @@
+import type { Op } from '@geoprotocol/grc-20';
+import type { Address, Hex } from 'viem';
+import type { Id } from './id.js';
+import type { GeoNetworkConfig } from './types.js';
+export type FetchLike = typeof fetch;
+export type GraphQlResponse<T> = {
+    data?: T;
+    errors?: unknown;
+};
+export type EditCalldataParams = {
+    spaceId: string;
+    cid: string;
+};
+export type ApiCalldataResult = {
+    to: `0x${string}`;
+    data: `0x${string}`;
+};
+export type ImageSource = {
+    blob: Blob;
+} | {
+    url: string;
+};
+export type UploadImageParams = ImageSource & {
+    alternativeGateway?: boolean;
+};
+export type UploadImageResult = {
+    cid: `ipfs://${string}`;
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+};
+export type CreateImageParams = ImageSource & {
+    name?: string;
+    description?: string;
+    id?: Id | string;
+    alternativeGateway?: boolean;
+};
+export type CreateResult = {
+    id: Id;
+    ops: Op[];
+};
+export type CreateImageResult = CreateResult & {
+    cid: string;
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+};
+export type DeleteEntityParams = {
+    id: Id | string;
+    spaceId: Id | string;
+};
+export type CreateCommentParams = {
+    id?: Id | string;
+    content: string;
+    replyTo: {
+        entityId: Id | string;
+        spaceId: Id | string;
+    };
+    resolved?: boolean;
+};
+export type UpdateCommentParams = {
+    id: Id | string;
+    content?: string;
+    resolved?: boolean;
+};
+export type CalldataResult = {
+    to: `0x${string}`;
+    calldata: `0x${string}`;
+};
+export type CreatePersonalSpaceParams = {
+    name: string;
+    accountAddress: Address;
+};
+export type CreatePersonalSpaceResult = CalldataResult & {
+    spaceEntityId: Id;
+    accountId: string;
+    ops: Op[];
+};
+export type SetPersonalSpaceTopicParams = {
+    spaceId: Id | string;
+    topicId: Id | string;
+    authorSpaceId?: Id | string;
+};
+export type HasPersonalSpaceParams = {
+    address: Hex;
+    rpcUrl?: string;
+};
+export type PublishEditParams = {
+    name: string;
+    ops: Op[];
+    author: Id | string;
+};
+export type PublishEditResult = {
+    cid: `ipfs://${string}`;
+    editId: Id;
+};
+export type PublishPersonalSpaceEditParams = PublishEditParams & {
+    spaceId: Id | string;
+};
+export type PublishPersonalSpaceEditResult = PublishEditResult & CalldataResult;
+export type VotingSettingsInput = {
+    partialPercentageSupportThreshold: number;
+    universalPercentageSupportThreshold: number;
+    flatSupportThreshold: number;
+    quorum: number;
+    durationInDays: number;
+    disableFastPathAccessForNewMembers: boolean;
+    executionGracePeriodInDays: number;
+};
+export type VotingMode = 'SLOW' | 'FAST';
+export type VoteOption = 'YES' | 'NO' | 'ABSTAIN';
+export type CreateDaoSpaceParams = {
+    name: string;
+    author: Id | string;
+    votingSettings: VotingSettingsInput;
+    initialEditorSpaceIds: `0x${string}`[];
+    initialMemberSpaceIds?: `0x${string}`[];
+    initialTopicId?: string;
+    ops?: Op[];
+};
+export type CreateDaoSpaceResult = CalldataResult & {
+    spaceEntityId: Id;
+    cid: `ipfs://${string}`;
+};
+export type ProposalAction = {
+    to: `0x${string}`;
+    value: bigint;
+    data: `0x${string}`;
+};
+export type CreateProposalParams = {
+    fromSpaceId: string;
+    daoSpaceId: string;
+    proposalId?: string;
+    votingMode?: VotingMode;
+    actions: ProposalAction[];
+    updateProposal?: boolean;
+};
+export type ProposalResult = CalldataResult & {
+    proposalId: `0x${string}`;
+};
+export type ProposeEditParams = PublishEditParams & {
+    daoSpaceAddress: `0x${string}`;
+    callerSpaceId: string;
+    daoSpaceId: string;
+    votingMode?: VotingMode;
+    proposalId?: string;
+    updateProposal?: boolean;
+    versionId?: number;
+};
+export type ProposeEditResult = PublishEditResult & ProposalResult & {
+    versionId: number;
+};
+export type DaoSpaceRoleProposalBaseParams = {
+    authorSpaceId: string;
+    spaceId: string;
+    daoSpaceAddress: `0x${string}`;
+    votingMode?: VotingMode;
+    proposalId?: string;
+};
+export type ProposeAddMemberParams = DaoSpaceRoleProposalBaseParams & {
+    newMemberSpaceId: string;
+};
+export type ProposeRemoveMemberParams = DaoSpaceRoleProposalBaseParams & {
+    memberToRemoveSpaceId: string;
+};
+export type ProposeAddEditorParams = Omit<DaoSpaceRoleProposalBaseParams, 'votingMode'> & {
+    votingMode?: 'SLOW';
+    newEditorSpaceId: string;
+};
+export type ProposeRemoveEditorParams = Omit<DaoSpaceRoleProposalBaseParams, 'votingMode'> & {
+    votingMode?: 'SLOW';
+    editorToRemoveSpaceId: string;
+};
+export type ProposeRequestMembershipParams = {
+    authorSpaceId: string;
+    spaceId: string;
+    proposalId?: string;
+};
+export type ProposeArchiveSpaceParams = {
+    authorSpaceId: string;
+    spaceId: string;
+    proposalId?: string;
+    votingMode?: 'SLOW';
+};
+export type VoteProposalParams = {
+    authorSpaceId: string;
+    spaceId: string;
+    proposalId: string;
+    versionId?: number;
+    vote: VoteOption;
+};
+export type ExecuteProposalParams = {
+    authorSpaceId: string;
+    spaceId: string;
+    proposalId: string;
+};
+export type ProposeUpdateVotingSettingsParams = Omit<DaoSpaceRoleProposalBaseParams, 'votingMode'> & {
+    votingMode?: 'SLOW';
+    votingSettings: VotingSettingsInput;
+};
+export type EntityVoteParams = {
+    authorSpaceId: Id | string;
+    spaceId: Id | string;
+    entityId: Id | string;
+};
+export type Client = {
+    network: GeoNetworkConfig;
+    api: {
+        graphql<T>(query: string): Promise<GraphQlResponse<T>>;
+        getEditCalldata(params: EditCalldataParams): Promise<ApiCalldataResult>;
+    };
+    storage: {
+        uploadImage(params: UploadImageParams): Promise<UploadImageResult>;
+        uploadCSV(csvString: string): Promise<`ipfs://${string}`>;
+    };
+    entities: {
+        delete(params: DeleteEntityParams): Promise<CreateResult>;
+    };
+    images: {
+        create(params: CreateImageParams): Promise<CreateImageResult>;
+    };
+    comments: {
+        create(params: CreateCommentParams): Promise<CreateResult>;
+        update(params: UpdateCommentParams): CreateResult;
+    };
+    personalSpaces: {
+        create(params: CreatePersonalSpaceParams): CreatePersonalSpaceResult;
+        setTopic(params: SetPersonalSpaceTopicParams): CalldataResult;
+        archiveSpace(): CalldataResult;
+        recoverSpace(): CalldataResult;
+        clearSpace(): CalldataResult;
+        hasSpace(params: HasPersonalSpaceParams): Promise<boolean>;
+        publishEdit(params: PublishPersonalSpaceEditParams): Promise<PublishPersonalSpaceEditResult>;
+    };
+    daoSpaces: {
+        create(params: CreateDaoSpaceParams): Promise<CreateDaoSpaceResult>;
+        proposeEdit(params: ProposeEditParams): Promise<ProposeEditResult>;
+        proposeAddMember(params: ProposeAddMemberParams): ProposalResult;
+        proposeRemoveMember(params: ProposeRemoveMemberParams): ProposalResult;
+        proposeAddEditor(params: ProposeAddEditorParams): ProposalResult;
+        proposeRemoveEditor(params: ProposeRemoveEditorParams): ProposalResult;
+        proposeUpdateVotingSettings(params: ProposeUpdateVotingSettingsParams): ProposalResult;
+        proposeRequestMembership(params: ProposeRequestMembershipParams): ProposalResult;
+        proposeArchiveSpace(params: ProposeArchiveSpaceParams): ProposalResult;
+        voteProposal(params: VoteProposalParams): CalldataResult;
+        executeProposal(params: ExecuteProposalParams): CalldataResult;
+    };
+    entityVotes: {
+        upvote(params: EntityVoteParams): CalldataResult;
+        downvote(params: EntityVoteParams): CalldataResult;
+        withdraw(params: EntityVoteParams): CalldataResult;
+    };
+};
+export type CreateGeoClientParams = {
+    /**
+     * Built-in or custom network configuration.
+     *
+     * Pass `GeoTestnetConfig` for the built-in testnet config, or
+     * `defineGeoNetworkConfig(...)` when running against a local or custom
+     * deployment. The network config is required so callers make an explicit
+     * environment choice. String IDs such as `"TESTNET"` are intentionally not
+     * accepted by the client.
+     *
+     * @example
+     * ```ts
+     * import { GeoTestnetConfig } from '@geoprotocol/geo-sdk';
+     *
+     * const geo = createGeoClient({ network: GeoTestnetConfig });
+     * ```
+     */
+    network: GeoNetworkConfig;
+    /**
+     * Fetch implementation used by API, IPFS, and GraphQL-backed helpers.
+     *
+     * Async helpers that upload or query data use this value, then fall back to
+     * `globalThis.fetch`.
+     *
+     * @example
+     * ```ts
+     * const geo = createGeoClient({
+     *   network: GeoTestnetConfig,
+     *   fetch: customFetch,
+     * });
+     * ```
+     */
+    fetch?: FetchLike;
+};
+/**
+ * Creates a configured Geo SDK client.
+ *
+ * The client groups the SDK into namespaces by workflow:
+ * - `api`, `storage`, `images`, `comments`, and delete helpers use the
+ *   configured API origin and fetch implementation.
+ * - transaction/calldata helpers use contract addresses from the configured
+ *   network.
+ *
+ * @example
+ * ```ts
+ * import { createGeoClient, GeoTestnetConfig } from '@geoprotocol/geo-sdk';
+ * import * as Ops from '@geoprotocol/geo-sdk/ops';
+ *
+ * const geo = createGeoClient({ network: GeoTestnetConfig });
+ * const { ops } = Ops.entities.create({ name: 'Geo entity' });
+ * const edit = await geo.personalSpaces.publishEdit({
+ *   name: 'Create entity',
+ *   spaceId,
+ *   author,
+ *   ops,
+ * });
+ * ```
+ *
+ * @example
+ * Create a client for a custom deployment.
+ *
+ * ```ts
+ * import { createGeoClient, defineGeoNetworkConfig } from '@geoprotocol/geo-sdk';
+ *
+ * const local = defineGeoNetworkConfig({
+ *   id: 'LOCAL',
+ *   name: 'Local Geo',
+ *   apiOrigin: 'http://localhost:3000',
+ *   chain: { id: 31337, name: 'Anvil', rpcUrl: 'http://localhost:8545' },
+ *   contracts: {
+ *     SPACE_REGISTRY_ADDRESS: '0x...',
+ *     DAO_SPACE_FACTORY_ADDRESS: '0x...',
+ *   },
+ * });
+ *
+ * const geo = createGeoClient({ network: local });
+ * ```
+ *
+ * @param params Network and fetch configuration for context-aware helpers.
+ * @returns A configured client with API helpers and transaction workflows.
+ */
+export declare function createGeoClient(params: CreateGeoClientParams): Client;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAQzC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,UAAU,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,EAAE,CAAC;IACP,GAAG,EAAE,EAAE,EAAE,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;IAChB,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC;QACtB,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,cAAc,GAAG;IACvD,aAAa,EAAE,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,EAAE,EAAE,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;IACrB,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,EAAE,EAAE,CAAC;IACV,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,UAAU,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,EAAE,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,GAAG;IAC/D,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAEhF,MAAM,MAAM,mBAAmB,GAAG;IAChC,iCAAiC,EAAE,MAAM,CAAC;IAC1C,mCAAmC,EAAE,MAAM,CAAC;IAC5C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC,EAAE,OAAO,CAAC;IAC5C,0BAA0B,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC;IACpB,cAAc,EAAE,mBAAmB,CAAC;IACpC,qBAAqB,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC;IACvC,qBAAqB,CAAC,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,aAAa,EAAE,EAAE,CAAC;IAClB,GAAG,EAAE,UAAU,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG;IAClD,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAC/C,cAAc,GAAG;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEJ,MAAM,MAAM,8BAA8B,GAAG;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,8BAA8B,GAAG;IACpE,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,8BAA8B,GAAG;IACvE,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,8BAA8B,EAAE,YAAY,CAAC,GAAG;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,8BAA8B,EAAE,YAAY,CAAC,GAAG;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC,8BAA8B,EAAE,YAAY,CAAC,GAAG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,mBAAmB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,EAAE,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;IACrB,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,GAAG,EAAE;QACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;KACzE,CAAC;IACF,OAAO,EAAE;QACP,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACnE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;KAC3D,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;KAC3D,CAAC;IACF,MAAM,EAAE;QACN,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;KAC/D,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,YAAY,CAAC;KACnD,CAAC;IACF,cAAc,EAAE;QACd,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,yBAAyB,CAAC;QACrE,QAAQ,CAAC,MAAM,EAAE,2BAA2B,GAAG,cAAc,CAAC;QAC9D,YAAY,IAAI,cAAc,CAAC;QAC/B,YAAY,IAAI,cAAc,CAAC;QAC/B,UAAU,IAAI,cAAc,CAAC;QAC7B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3D,WAAW,CAAC,MAAM,EAAE,8BAA8B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;KAC9F,CAAC;IACF,SAAS,EAAE;QACT,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACpE,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACnE,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,cAAc,CAAC;QACjE,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,CAAC;QACvE,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,cAAc,CAAC;QACjE,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,CAAC;QACvE,2BAA2B,CAAC,MAAM,EAAE,iCAAiC,GAAG,cAAc,CAAC;QACvF,wBAAwB,CAAC,MAAM,EAAE,8BAA8B,GAAG,cAAc,CAAC;QACjF,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,CAAC;QACvE,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC;QACzD,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,CAAC;KAChE,CAAC;IACF,WAAW,EAAE;QACX,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAAC;QACjD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAAC;QACnD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAAC;KACpD,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CA+brE"}