@zodiac-os/sdk 1.1.1 → 1.3.0

package/dist/index.d.mts

@@ -0,0 +1,212 @@
+/// <reference path="./zodiac-os-codegen.d.ts" />
+import { a as EVERYTHING, c as Scoping, i as ConditionFunction, l as TargetPermission, n as ChainPrefix, o as FunctionPermission, s as Options, u as buildAllowKit } from "./index-DTBaxN7b.mjs";
+import { c, forAll } from "zodiac-roles-sdk";
+import { Address, ApplyConstellationPayload, ApplyConstellationResult, ChainId, ListUsersResult, ListVaultsResult, ResolveConstellationPayload, ResolveConstellationResult } from "@zodiac-os/api-types";
+import * as ZodiacOsCodegen from ".zodiac-os";
+import { UUID } from "crypto";
+
+//#region src/types.d.ts
+type ApiNewRolesSpec = Extract<ApplyConstellationPayload['specification'][number], {
+  type: 'ROLES';
+  nonce: string;
+}>;
+/** A role definition in the API's serialized format (bigints as template literal strings). */
+type ApiRoleSpec = Extract<NonNullable<ApiNewRolesSpec['roles']>, readonly any[]>[number];
+/** An allowance definition in the API's serialized format (bigints as template literal strings). */
+type ApiAllowanceSpec = Extract<NonNullable<ApiNewRolesSpec['allowances']>, readonly any[]>[number];
+/** Recursively converts `${bigint}` template literal strings to `bigint`. */
+type RealBigints<T> = T extends `${bigint}` ? bigint : T extends readonly (infer U)[] ? RealBigints<U>[] : T extends Record<string, any> ? { [K in keyof T]: RealBigints<T[K]> } : T;
+/** A role definition with bigint fields as actual bigints. */
+type RoleSpec = RealBigints<ApiRoleSpec>;
+/** An allowance definition with bigint fields as actual bigints. */
+type AllowanceSpec = RealBigints<ApiAllowanceSpec>;
+//#endregion
+//#region src/constellation.d.ts
+type User = {
+  id: UUID;
+  fullName: string;
+  personalSafes: Record<number, {
+    address: Lowercase<Address>;
+    active: boolean;
+  }>;
+};
+type Vault = {
+  id: UUID;
+  label: string;
+  address: Lowercase<Address>;
+  chain: ChainId;
+  threshold: number;
+  owners: readonly string[];
+  modules: readonly string[];
+};
+type WorkspaceVaults = {
+  workspaceId: UUID;
+  workspaceName: string;
+  vaults: Readonly<Record<string, Vault>>;
+};
+/** Shape of the codegen data produced by `zodiac-os pull-org`. */
+type CodegenData = {
+  users: Readonly<Record<string, User>>;
+  vaults: Readonly<Record<string, WorkspaceVaults>>;
+};
+type GeneratedCodegen = {
+  users: typeof ZodiacOsCodegen.users;
+  vaults: typeof ZodiacOsCodegen.vaults;
+};
+type ConstellationOpts<C extends CodegenData> = {
+  /** Workspace to scope vaults and roles to. */workspace: keyof C['vaults'] & string; /** Human-readable label for this constellation. */
+  label: string; /** Target chain for all nodes in this constellation. */
+  chain: ChainId;
+};
+type ConstellationInternalOpts<C extends CodegenData> = {
+  /** Injected codegen data (used for testing). */codegen?: C;
+};
+type Prettify<T> = { readonly [K in keyof T]: T[K] } & {};
+type WorkspaceVaultEntries<C extends CodegenData, W extends keyof C['vaults']> = C['vaults'][W]['vaults'];
+type NodeType = 'SAFE' | 'ROLES' | 'DELAY';
+/** A reference to a node used in `owners`, `modules`, `target`, etc. */
+type NodeRef = Readonly<{
+  type: NodeType;
+  label: string;
+  chain: ChainId;
+}>;
+/** A blockchain address or a reference to another node in the constellation. */
+type AddressOrRef = Lowercase<Address> | NodeRef;
+type NodeBase = Readonly<{
+  /** Human-readable identifier, unique within the constellation. */label: string; /** Chain the node is deployed on. */
+  chain: ChainId; /** Set for existing nodes from codegen, absent for new nodes. */
+  address?: Lowercase<Address>; /** Deployment nonce — required for new nodes, optional for existing. */
+  nonce?: bigint;
+}>;
+/** A safe node spec — existing vault ref or new safe with required config. */
+type SafeNode = NodeBase & Readonly<{
+  /** Discriminator identifying this node as a Safe. */type: 'SAFE'; /** Number of owner signatures required to execute a transaction. */
+  threshold: number; /** Safe owner addresses or node references. */
+  owners: readonly (string | NodeRef)[]; /** Module addresses or node references enabled on the safe. */
+  modules?: readonly (string | NodeRef)[]; /** Whether this safe shall appear as a vault in the workspace. @default false */
+  vault?: boolean;
+}>;
+/** A roles modifier node spec — existing vault ref or new roles with modifier config. */
+type RolesNode = NodeBase & Readonly<{
+  /** Discriminator identifying this node as a Roles modifier. */type: 'ROLES'; /** The safe that this roles modifier controls. */
+  target?: AddressOrRef; /** The account that is allowed to update the configuration of the Roles mod. */
+  owner?: AddressOrRef; /** The account that calls will be executed from. */
+  avatar?: AddressOrRef; /** MultiSend contract addresses for batched transactions. */
+  multisend?: readonly Lowercase<Address>[]; /** Role definitions configured on this modifier. */
+  roles?: readonly RoleSpec[]; /** Spending allowances configured on this modifier. */
+  allowances?: readonly AllowanceSpec[];
+}>;
+/** Any complete node that can be passed to `apply()`. */
+type ConstellationNode = SafeNode | RolesNode;
+type NewSafeProps = {
+  /** Deployment nonce for CREATE2 address derivation. */nonce: bigint; /** Number of owner signatures required to execute a transaction. */
+  threshold: number; /** Safe owner addresses or node references. */
+  owners: readonly AddressOrRef[]; /** Module addresses or node references to enable on the safe. */
+  modules?: readonly AddressOrRef[]; /** Whether this safe is a workspace vault. @default false */
+  vault?: boolean;
+};
+type NewRolesProps = {
+  /** Deployment nonce for CREATE2 address derivation. Defaults to `0n` when omitted. */nonce?: bigint; /** The safe that this roles modifier controls. Defaults to the new safe with the same label, when one exists. */
+  target?: AddressOrRef; /** The account that calls will be executed from. Defaults to `target` value */
+  avatar?: AddressOrRef; /** The account that is allowed to update the configuration of the Roles Mod. Defaults to `target` value */
+  owner?: AddressOrRef; /** MultiSend contract addresses for batched transactions. Defaults to `['0x38869bf66a61cf6bdb996a6ae40d5853fd43b526', '0x9641d764fc13c8b624c04430c7356c1c7c8102e2']` */
+  multisend?: readonly Lowercase<Address>[]; /** Role definitions to configure on this modifier. */
+  roles?: readonly RoleSpec[]; /** Spending allowances to configure on this modifier. */
+  allowances?: readonly AllowanceSpec[];
+};
+type EntityAccessor<Type extends string, Entries extends Record<string, any>, Ch extends ChainId = ChainId, NP extends Record<string, any> = Record<string, any>> = { readonly [K in (keyof Entries & string) | (string & {})]: K extends keyof Entries & string ? Readonly<Prettify<Entries[K] & {
+  type: Type;
+  label: K;
+  chain: Ch;
+}>> & (<O extends { [P in Exclude<keyof Entries[K] & string, 'id' | 'label'>]?: any } & Partial<NP> = {}>(overrides?: { [P in Exclude<keyof Entries[K] & string, 'id' | 'label'>]?: any } & Partial<NP> & O) => Readonly<Prettify<Omit<Entries[K], keyof O> & O & Partial<NP> & {
+  type: Type;
+  label: K;
+  chain: Ch;
+}>>) : Readonly<Prettify<{
+  type: Type;
+  label: string;
+  chain: Ch;
+}>> & ((props: NP) => Readonly<Prettify<NP & {
+  type: Type;
+  label: string;
+  chain: Ch;
+}>>) };
+type UserAccessor<C extends CodegenData, Ch extends number> = { readonly [K in keyof C['users'] & string]: C['users'][K]['personalSafes'][Ch]['address'] };
+type ConstellationResult<C extends CodegenData, W extends keyof C['vaults'] = keyof C['vaults'], Ch extends ChainId = ChainId> = {
+  /** Access existing safes by label or create new ones with a new label. */safe: EntityAccessor<'SAFE', WorkspaceVaultEntries<C, W>, Ch, NewSafeProps>; /** Access existing roles modifiers by label or create new ones with a new label. */
+  roles: EntityAccessor<'ROLES', WorkspaceVaultEntries<C, W>, Ch, NewRolesProps>; /** Resolve a user's personal safe address on the constellation's chain. */
+  user: UserAccessor<C, Ch>;
+};
+/** @internal */
+/**
+ * Creates a constellation scoped to a workspace and chain.
+ *
+ * Use bracket access to reference existing vaults or define new nodes:
+ * ```ts
+ * const eth = constellation({ workspace: 'GG', label: 'my constellation', chain: 1 })
+ *
+ * const dao = eth.safe['GG DAO']              // existing vault ref
+ * const roles = eth.roles['GG DAO']           // existing roles ref
+ * const newSafe = eth.safe['New Safe']({ nonce: 0n, threshold: 2, owners: [...], modules: [...] })
+ * ```
+ */
+declare function constellation<const C extends CodegenData = GeneratedCodegen, const W extends keyof C['vaults'] & string = keyof C['vaults'] & string, const Ch extends ChainId = ChainId>(opts: ConstellationOpts<C> & {
+  workspace: W;
+  chain: Ch;
+}, internal?: ConstellationInternalOpts<C>): ConstellationResult<C, W, Ch>;
+//#endregion
+//#region src/api.d.ts
+type Options$1 = {
+  workspace?: string;
+  apiKey?: string;
+  baseUrl?: string;
+  fetch?: typeof globalThis.fetch;
+  headers?: Record<string, string>;
+};
+declare class ApiClient {
+  private apiKey;
+  private baseUrl;
+  private _fetch;
+  private headers;
+  constructor({
+    baseUrl,
+    fetch: customFetch,
+    headers,
+    apiKey
+  }?: Options$1);
+  protected postJson(endpoint: string, payload: unknown): Promise<any>;
+  protected get(endpoint: string): Promise<any>;
+  listVaults(): Promise<ListVaultsResult>;
+  listUsers(): Promise<ListUsersResult>;
+  /**
+   * Applies an accounts specification to Zodiac OS.
+   */
+  applyConstellation(workspaceId: UUID, payload: ApplyConstellationPayload): Promise<ApplyConstellationResult>;
+  /**
+   * Resolves an accounts specification to Zodiac OS.
+   */
+  resolveConstellation(workspaceId: UUID, payload: ResolveConstellationPayload): Promise<ResolveConstellationResult>;
+}
+//#endregion
+//#region src/apply.d.ts
+type ApplyOpts = {
+  /** API client instance. Defaults to a client configured from environment variables. */api?: ApiClient;
+};
+/**
+ * Resolves node references and applies the constellation specification via the API.
+ *
+ *
+ * ```ts
+ * const eth = constellation({ workspace: 'GG', label: 'my constellation', chain: 1 })
+ * const dao = eth.safe['GG DAO']
+ * const roles = eth.roles['New Roles']({ nonce: 0n, target: dao, owner: dao, avatar: dao })
+ *
+ * await apply([dao, roles])
+ * ```
+ */
+declare function apply(nodes: ConstellationNode[] | {
+  [key: string]: ConstellationNode;
+}, opts?: ApplyOpts): Promise<ApplyConstellationResult[]>;
+//#endregion
+export { type ChainPrefix, type ConditionFunction, EVERYTHING, type FunctionPermission, type Options, type Scoping, type TargetPermission, apply, buildAllowKit, c, constellation, forAll };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,208 @@
+import { t as ApiClient } from "./api-D6ee2Q2b.mjs";
+import { n as EVERYTHING, t as buildAllowKit } from "./allow-Dzh6t_l8.mjs";
+import { createRequire } from "module";
+import { invariant } from "@epic-web/invariant";
+import { c, forAll } from "zodiac-roles-sdk";
+//#region src/constellation.ts
+function loadCodegen() {
+	return createRequire(import.meta.url)(".zodiac-os");
+}
+/**
+* Creates a constellation scoped to a workspace and chain.
+*
+* Use bracket access to reference existing vaults or define new nodes:
+* ```ts
+* const eth = constellation({ workspace: 'GG', label: 'my constellation', chain: 1 })
+*
+* const dao = eth.safe['GG DAO']              // existing vault ref
+* const roles = eth.roles['GG DAO']           // existing roles ref
+* const newSafe = eth.safe['New Safe']({ nonce: 0n, threshold: 2, owners: [...], modules: [...] })
+* ```
+*/
+function constellation(opts, internal) {
+	const codegen = internal?.codegen ?? loadCodegen();
+	const ws = codegen.vaults[opts.workspace];
+	const vaultsByLabel = {};
+	if (ws) for (const [label, vault] of Object.entries(ws.vaults)) vaultsByLabel[label] = vault;
+	const meta = {
+		label: opts.label,
+		chain: opts.chain,
+		workspaceId: ws?.workspaceId ?? ""
+	};
+	const newSafes = /* @__PURE__ */ new Map();
+	function makeNodeRef(data) {
+		const ref = Object.freeze({
+			...data,
+			chain: opts.chain,
+			_constellation: meta
+		});
+		if (ref.type === "SAFE" && typeof ref.label === "string") newSafes.set(ref.label, ref);
+		return ref;
+	}
+	function entityAccessor(registry, type, resolveCanonicalSafe) {
+		const cache = /* @__PURE__ */ new Map();
+		return new Proxy({}, { get(_target, name) {
+			if (typeof name !== "string") return void 0;
+			const cached = cache.get(name);
+			if (cached) return cached;
+			const existing = registry[name];
+			const fn = (overrides) => {
+				const canonicalSafe = resolveCanonicalSafe && !overrides?.target ? resolveCanonicalSafe(name) : void 0;
+				if (canonicalSafe) return makeNodeRef({
+					type,
+					nonce: 0n,
+					target: canonicalSafe,
+					owner: canonicalSafe,
+					avatar: canonicalSafe,
+					...overrides,
+					label: name
+				});
+				return makeNodeRef({
+					type,
+					...existing || {},
+					...overrides,
+					label: name
+				});
+			};
+			Object.assign(fn, {
+				type,
+				...existing || {},
+				label: name,
+				chain: opts.chain,
+				_constellation: meta
+			});
+			cache.set(name, fn);
+			return fn;
+		} });
+	}
+	function userAccessor() {
+		return new Proxy({}, { get(_target, name) {
+			const user = codegen.users[name];
+			if (!user) throw new Error(`Unknown user: ${name}`);
+			const personalSafe = user.personalSafes[opts.chain];
+			if (!personalSafe) throw new Error(`User ${name} has no personal safe on chain ${opts.chain}`);
+			return personalSafe.address;
+		} });
+	}
+	const safe = entityAccessor(vaultsByLabel, "SAFE");
+	return {
+		safe,
+		roles: entityAccessor(vaultsByLabel, "ROLES", (name) => {
+			const invoked = newSafes.get(name);
+			if (invoked) return invoked;
+			if (name in vaultsByLabel) return safe[name];
+		}),
+		user: userAccessor()
+	};
+}
+//#endregion
+//#region src/apply.ts
+/**
+* Resolves node references and applies the constellation specification via the API.
+*
+*
+* ```ts
+* const eth = constellation({ workspace: 'GG', label: 'my constellation', chain: 1 })
+* const dao = eth.safe['GG DAO']
+* const roles = eth.roles['New Roles']({ nonce: 0n, target: dao, owner: dao, avatar: dao })
+*
+* await apply([dao, roles])
+* ```
+*/
+async function apply(nodes, opts) {
+	const api = opts?.api ?? new ApiClient();
+	const refs = deriveRefs(nodes);
+	const groups = /* @__PURE__ */ new Map();
+	for (const node of refs.byIdentity.keys()) {
+		const meta = node._constellation;
+		invariant(meta, `Node "${node.label}" is not associated with a constellation`);
+		const key = `${meta.workspaceId}:${meta.chain}:${meta.label}`;
+		let group = groups.get(key);
+		if (!group) {
+			group = {
+				meta,
+				nodes: []
+			};
+			groups.set(key, group);
+		}
+		group.nodes.push(node);
+	}
+	const results = [];
+	for (const { meta, nodes: groupNodes } of groups.values()) {
+		const specification = groupNodes.map((n) => nodeToSpec(n, refs));
+		const result = await api.applyConstellation(meta.workspaceId, {
+			label: meta.label,
+			chain: meta.chain,
+			specification
+		});
+		results.push(result);
+	}
+	return results;
+}
+function labelKey(node) {
+	return `${node._constellation.workspaceId}:${node.type}:${node.label}`;
+}
+function deriveRefs(nodes) {
+	const byIdentity = /* @__PURE__ */ new Map();
+	const byLabel = /* @__PURE__ */ new Map();
+	const register = (node, ref) => {
+		byIdentity.set(node, ref);
+		byLabel.set(labelKey(node), ref);
+	};
+	if (Array.isArray(nodes)) for (let i = 0; i < nodes.length; i++) {
+		const node = nodes[i];
+		invariant(isConstellationNode(node), `unexpected node input at index: ${i}`);
+		register(node, `${i}`);
+	}
+	else for (const [key, node] of Object.entries(nodes)) {
+		invariant(isConstellationNode(node), `unexpected node input under key: ${key}`);
+		register(node, key);
+	}
+	return {
+		byIdentity,
+		byLabel
+	};
+}
+function nodeToSpec(node, refs) {
+	const { id, _constellation, ...rest } = node;
+	const spec = {};
+	for (const [key, value] of Object.entries(rest)) spec[key] = resolveRefs(value, refs);
+	spec.ref = refs.byIdentity.get(node);
+	invariant(spec.ref != null, "ref not found");
+	return stringifyBigints(spec);
+}
+function resolveRefs(value, refs) {
+	if (isConstellationNode(value)) {
+		const ref = refs.byIdentity.get(value) ?? refs.byLabel.get(labelKey(value));
+		invariant(ref != null, `Node "${value.label}" is referenced not included in the apply() call`);
+		return `$${ref}`;
+	}
+	if (Array.isArray(value)) return value.map((v) => resolveRefs(v, refs));
+	if (typeof value === "object" && value !== null) {
+		const resolved = {};
+		for (const [k, v] of Object.entries(value)) resolved[k] = resolveRefs(v, refs);
+		return resolved;
+	}
+	return value;
+}
+function stringifyBigints(value) {
+	if (typeof value === "bigint") return value.toString();
+	if (Array.isArray(value)) return value.map(stringifyBigints);
+	if (typeof value === "object" && value !== null) {
+		const result = {};
+		for (const [k, v] of Object.entries(value)) result[k] = stringifyBigints(v);
+		return result;
+	}
+	return value;
+}
+function isConstellationNode(value) {
+	if (typeof value === "function" || typeof value === "object") {
+		const obj = value;
+		return obj != null && typeof obj.type === "string" && typeof obj.chain === "number" && typeof obj._constellation === "object";
+	}
+	return false;
+}
+//#endregion
+export { EVERYTHING, apply, buildAllowKit, c, constellation, forAll };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/constellation.ts","../src/apply.ts"],"sourcesContent":["/// <reference path=\"./zodiac-os-codegen.d.ts\" />\nimport type { Address, ChainId } from '@zodiac-os/api-types'\nimport type { AllowanceSpec, RoleSpec } from './types'\nimport { createRequire } from 'module'\nimport type * as ZodiacOsCodegen from '.zodiac-os'\nimport { UUID } from 'crypto'\n\ntype User = {\n  id: UUID\n  fullName: string\n  personalSafes: Record<\n    number,\n    { address: Lowercase<Address>; active: boolean }\n  >\n}\n\ntype Vault = {\n  id: UUID\n  label: string\n  address: Lowercase<Address>\n  chain: ChainId\n  threshold: number\n  owners: readonly string[]\n  modules: readonly string[]\n}\n\ntype WorkspaceVaults = {\n  workspaceId: UUID\n  workspaceName: string\n  vaults: Readonly<Record<string, Vault>>\n}\n\n/** Shape of the codegen data produced by `zodiac-os pull-org`. */\nexport type CodegenData = {\n  users: Readonly<Record<string, User>>\n  vaults: Readonly<Record<string, WorkspaceVaults>>\n}\n\ntype GeneratedCodegen = {\n  users: typeof ZodiacOsCodegen.users\n  vaults: typeof ZodiacOsCodegen.vaults\n}\n\ntype ConstellationOpts<C extends CodegenData> = {\n  /** Workspace to scope vaults and roles to. */\n  workspace: keyof C['vaults'] & string\n  /** Human-readable label for this constellation. */\n  label: string\n  /** Target chain for all nodes in this constellation. */\n  chain: ChainId\n}\n\ntype ConstellationInternalOpts<C extends CodegenData> = {\n  /** Injected codegen data (used for testing). */\n  codegen?: C\n}\n\ntype Prettify<T> = { readonly [K in keyof T]: T[K] } & {}\n\ntype WorkspaceVaultEntries<\n  C extends CodegenData,\n  W extends keyof C['vaults'],\n> = C['vaults'][W]['vaults']\n\ntype NodeType = 'SAFE' | 'ROLES' | 'DELAY'\n\n/** A reference to a node used in `owners`, `modules`, `target`, etc. */\ntype NodeRef = Readonly<{ type: NodeType; label: string; chain: ChainId }>\n\n/** A blockchain address or a reference to another node in the constellation. */\ntype AddressOrRef = Lowercase<Address> | NodeRef\n\ntype NodeBase = Readonly<{\n  /** Human-readable identifier, unique within the constellation. */\n  label: string\n  /** Chain the node is deployed on. */\n  chain: ChainId\n  /** Set for existing nodes from codegen, absent for new nodes. */\n  address?: Lowercase<Address>\n  /** Deployment nonce — required for new nodes, optional for existing. */\n  nonce?: bigint\n}>\n\n/** A safe node spec — existing vault ref or new safe with required config. */\nexport type SafeNode = NodeBase &\n  Readonly<{\n    /** Discriminator identifying this node as a Safe. */\n    type: 'SAFE'\n    /** Number of owner signatures required to execute a transaction. */\n    threshold: number\n    /** Safe owner addresses or node references. */\n    owners: readonly (string | NodeRef)[]\n    /** Module addresses or node references enabled on the safe. */\n    modules?: readonly (string | NodeRef)[]\n    /** Whether this safe shall appear as a vault in the workspace. @default false */\n    vault?: boolean\n  }>\n\n/** A roles modifier node spec — existing vault ref or new roles with modifier config. */\nexport type RolesNode = NodeBase &\n  Readonly<{\n    /** Discriminator identifying this node as a Roles modifier. */\n    type: 'ROLES'\n    /** The safe that this roles modifier controls. */\n    target?: AddressOrRef\n    /** The account that is allowed to update the configuration of the Roles mod. */\n    owner?: AddressOrRef\n    /** The account that calls will be executed from. */\n    avatar?: AddressOrRef\n    /** MultiSend contract addresses for batched transactions. */\n    multisend?: readonly Lowercase<Address>[]\n    /** Role definitions configured on this modifier. */\n    roles?: readonly RoleSpec[]\n    /** Spending allowances configured on this modifier. */\n    allowances?: readonly AllowanceSpec[]\n  }>\n\n/** Any complete node that can be passed to `apply()`. */\nexport type ConstellationNode = SafeNode | RolesNode\nexport type ConstellationNodeInternal = ConstellationNode & {\n  _constellation: ConstellationMeta\n}\n\ntype NewSafeProps = {\n  /** Deployment nonce for CREATE2 address derivation. */\n  nonce: bigint\n  /** Number of owner signatures required to execute a transaction. */\n  threshold: number\n  /** Safe owner addresses or node references. */\n  owners: readonly AddressOrRef[]\n  /** Module addresses or node references to enable on the safe. */\n  modules?: readonly AddressOrRef[]\n  /** Whether this safe is a workspace vault. @default false */\n  vault?: boolean\n}\n\ntype NewRolesProps = {\n  /** Deployment nonce for CREATE2 address derivation. Defaults to `0n` when omitted. */\n  nonce?: bigint\n  /** The safe that this roles modifier controls. Defaults to the new safe with the same label, when one exists. */\n  target?: AddressOrRef\n  /** The account that calls will be executed from. Defaults to `target` value */\n  avatar?: AddressOrRef\n  /** The account that is allowed to update the configuration of the Roles Mod. Defaults to `target` value */\n  owner?: AddressOrRef\n  /** MultiSend contract addresses for batched transactions. Defaults to `['0x38869bf66a61cf6bdb996a6ae40d5853fd43b526', '0x9641d764fc13c8b624c04430c7356c1c7c8102e2']` */\n  multisend?: readonly Lowercase<Address>[]\n  /** Role definitions to configure on this modifier. */\n  roles?: readonly RoleSpec[]\n  /** Spending allowances to configure on this modifier. */\n  allowances?: readonly AllowanceSpec[]\n}\n\ntype EntityAccessor<\n  Type extends string,\n  Entries extends Record<string, any>,\n  Ch extends ChainId = ChainId,\n  NP extends Record<string, any> = Record<string, any>,\n> = {\n  readonly [K in\n    | (keyof Entries & string)\n    | (string & {})]: K extends keyof Entries & string\n    ? Readonly<Prettify<Entries[K] & { type: Type; label: K; chain: Ch }>> &\n        (<\n          O extends {\n            [P in Exclude<keyof Entries[K] & string, 'id' | 'label'>]?: any\n          } & Partial<NP> = {},\n        >(\n          overrides?: {\n            [P in Exclude<keyof Entries[K] & string, 'id' | 'label'>]?: any\n          } & Partial<NP> &\n            O\n        ) => Readonly<\n          Prettify<\n            Omit<Entries[K], keyof O> &\n              O &\n              Partial<NP> & { type: Type; label: K; chain: Ch }\n          >\n        >)\n    : Readonly<Prettify<{ type: Type; label: string; chain: Ch }>> &\n        ((\n          props: NP\n        ) => Readonly<Prettify<NP & { type: Type; label: string; chain: Ch }>>)\n}\n\ntype UserAccessor<C extends CodegenData, Ch extends number> = {\n  readonly [K in keyof C['users'] &\n    string]: C['users'][K]['personalSafes'][Ch]['address']\n}\n\ntype ConstellationResult<\n  C extends CodegenData,\n  W extends keyof C['vaults'] = keyof C['vaults'],\n  Ch extends ChainId = ChainId,\n> = {\n  /** Access existing safes by label or create new ones with a new label. */\n  safe: EntityAccessor<'SAFE', WorkspaceVaultEntries<C, W>, Ch, NewSafeProps>\n  /** Access existing roles modifiers by label or create new ones with a new label. */\n  roles: EntityAccessor<'ROLES', WorkspaceVaultEntries<C, W>, Ch, NewRolesProps>\n  /** Resolve a user's personal safe address on the constellation's chain. */\n  user: UserAccessor<C, Ch>\n}\n\n/** @internal */\nexport type ConstellationMeta = {\n  label: string\n  chain: ChainId\n  workspaceId: UUID\n}\n\nfunction loadCodegen(): CodegenData {\n  const require = createRequire(import.meta.url)\n  return require('.zodiac-os') as CodegenData\n}\n\n/**\n * Creates a constellation scoped to a workspace and chain.\n *\n * Use bracket access to reference existing vaults or define new nodes:\n * ```ts\n * const eth = constellation({ workspace: 'GG', label: 'my constellation', chain: 1 })\n *\n * const dao = eth.safe['GG DAO']              // existing vault ref\n * const roles = eth.roles['GG DAO']           // existing roles ref\n * const newSafe = eth.safe['New Safe']({ nonce: 0n, threshold: 2, owners: [...], modules: [...] })\n * ```\n */\nexport function constellation<\n  const C extends CodegenData = GeneratedCodegen,\n  const W extends keyof C['vaults'] & string = keyof C['vaults'] & string,\n  const Ch extends ChainId = ChainId,\n>(\n  opts: ConstellationOpts<C> & { workspace: W; chain: Ch },\n  internal?: ConstellationInternalOpts<C>\n): ConstellationResult<C, W, Ch> {\n  const codegen: CodegenData = internal?.codegen ?? loadCodegen()\n\n  const ws = codegen.vaults[opts.workspace]\n  const vaultsByLabel: Record<string, Vault> = {}\n  if (ws) {\n    for (const [label, vault] of Object.entries(ws.vaults)) {\n      vaultsByLabel[label] = vault\n    }\n  }\n\n  const meta: ConstellationMeta = {\n    label: opts.label,\n    chain: opts.chain,\n    workspaceId: (ws?.workspaceId ?? '') as UUID,\n  }\n\n  const newSafes = new Map<string, Readonly<Record<string, any>>>()\n\n  function makeNodeRef(\n    data: Record<string, any>\n  ): Readonly<Record<string, any>> {\n    const ref: Record<string, any> = Object.freeze({\n      ...data,\n      chain: opts.chain,\n      _constellation: meta,\n    })\n    if (ref.type === 'SAFE' && typeof ref.label === 'string') {\n      newSafes.set(ref.label, ref)\n    }\n    return ref\n  }\n\n  function entityAccessor(\n    registry: Record<string, Record<string, any>>,\n    type: string,\n    resolveCanonicalSafe?: (name: string) => Record<string, any> | undefined\n  ) {\n    const cache = new Map<string, Record<string, any>>()\n    return new Proxy({} as Record<string, any>, {\n      get(_target: any, name: string) {\n        if (typeof name !== 'string') return undefined\n        const cached = cache.get(name)\n        if (cached) return cached\n        const existing = registry[name]\n        const fn = (overrides?: Record<string, any>) => {\n          const canonicalSafe =\n            resolveCanonicalSafe && !overrides?.target\n              ? resolveCanonicalSafe(name)\n              : undefined\n          if (canonicalSafe) {\n            return makeNodeRef({\n              type,\n              nonce: 0n,\n              target: canonicalSafe,\n              owner: canonicalSafe,\n              avatar: canonicalSafe,\n              ...overrides,\n              label: name,\n            })\n          }\n          return makeNodeRef({\n            type,\n            ...(existing || {}),\n            ...overrides,\n            label: name,\n          })\n        }\n        Object.assign(fn, {\n          type,\n          ...(existing || {}),\n          label: name,\n          chain: opts.chain,\n          _constellation: meta,\n        })\n        cache.set(name, fn)\n        return fn\n      },\n    })\n  }\n\n  function userAccessor() {\n    return new Proxy(\n      {},\n      {\n        get(_target: any, name: string) {\n          const user = codegen.users[name]\n          if (!user) throw new Error(`Unknown user: ${name}`)\n          const personalSafe = user.personalSafes[opts.chain]\n          if (!personalSafe) {\n            throw new Error(\n              `User ${name} has no personal safe on chain ${opts.chain}`\n            )\n          }\n          return personalSafe.address\n        },\n      }\n    )\n  }\n\n  const safe = entityAccessor(vaultsByLabel, 'SAFE')\n  const roles = entityAccessor(vaultsByLabel, 'ROLES', (name) => {\n    const invoked = newSafes.get(name)\n    if (invoked) return invoked\n    if (name in vaultsByLabel) return safe[name]\n    return undefined\n  })\n\n  return {\n    safe,\n    roles,\n    user: userAccessor(),\n  } as ConstellationResult<C, W, Ch>\n}\n","import type {\n  ApplyConstellationPayload,\n  ApplyConstellationResult,\n} from '@zodiac-os/api-types'\nimport { invariant } from '@epic-web/invariant'\nimport { ApiClient } from './api'\nimport type {\n  ConstellationMeta,\n  ConstellationNode,\n  ConstellationNodeInternal,\n} from './constellation'\n\ntype ApplyOpts = {\n  /** API client instance. Defaults to a client configured from environment variables. */\n  api?: ApiClient\n}\n\n/**\n * Resolves node references and applies the constellation specification via the API.\n *\n *\n * ```ts\n * const eth = constellation({ workspace: 'GG', label: 'my constellation', chain: 1 })\n * const dao = eth.safe['GG DAO']\n * const roles = eth.roles['New Roles']({ nonce: 0n, target: dao, owner: dao, avatar: dao })\n *\n * await apply([dao, roles])\n * ```\n */\nexport async function apply(\n  nodes: ConstellationNode[] | { [key: string]: ConstellationNode },\n  opts?: ApplyOpts\n): Promise<ApplyConstellationResult[]> {\n  const api = opts?.api ?? new ApiClient()\n  const refs = deriveRefs(nodes)\n\n  // Group nodes by constellation (multiple constellations can be applied with a single call)\n  const groups = new Map<\n    string,\n    { meta: ConstellationMeta; nodes: ConstellationNodeInternal[] }\n  >()\n\n  for (const node of refs.byIdentity.keys()) {\n    const meta = node._constellation\n    invariant(\n      meta,\n      `Node \"${node.label}\" is not associated with a constellation`\n    )\n    const key = `${meta.workspaceId}:${meta.chain}:${meta.label}`\n    let group = groups.get(key)\n    if (!group) {\n      group = { meta, nodes: [] }\n      groups.set(key, group)\n    }\n    group.nodes.push(node)\n  }\n\n  const results: ApplyConstellationResult[] = []\n  for (const { meta, nodes: groupNodes } of groups.values()) {\n    const specification = groupNodes.map((n) => nodeToSpec(n, refs))\n    const result = await api.applyConstellation(meta.workspaceId, {\n      label: meta.label,\n      chain: meta.chain,\n      specification,\n    })\n    results.push(result)\n  }\n\n  return results\n}\n\ntype RefsIndex = {\n  byIdentity: Map<ConstellationNodeInternal, string>\n  byLabel: Map<string, string>\n}\n\nfunction labelKey(node: ConstellationNodeInternal): string {\n  return `${node._constellation.workspaceId}:${node.type}:${node.label}`\n}\n\nfunction deriveRefs(\n  nodes: ConstellationNode[] | { [key: string]: ConstellationNode }\n): RefsIndex {\n  const byIdentity = new Map<ConstellationNodeInternal, string>()\n  const byLabel = new Map<string, string>()\n\n  const register = (node: ConstellationNodeInternal, ref: string) => {\n    byIdentity.set(node, ref)\n    byLabel.set(labelKey(node), ref)\n  }\n\n  if (Array.isArray(nodes)) {\n    for (let i = 0; i < nodes.length; i++) {\n      const node = nodes[i]\n      invariant(\n        isConstellationNode(node),\n        `unexpected node input at index: ${i}`\n      )\n      register(node, `${i}`)\n    }\n  } else {\n    for (const [key, node] of Object.entries(nodes)) {\n      invariant(\n        isConstellationNode(node),\n        `unexpected node input under key: ${key}`\n      )\n      register(node, key)\n    }\n  }\n\n  return { byIdentity, byLabel }\n}\n\nfunction nodeToSpec(\n  node: ConstellationNodeInternal,\n  refs: RefsIndex\n): ApplyConstellationPayload['specification'][number] {\n  const { id, _constellation, ...rest } = node as Record<string, any>\n  const spec: Record<string, any> = {}\n\n  for (const [key, value] of Object.entries(rest)) {\n    spec[key] = resolveRefs(value, refs)\n  }\n\n  spec.ref = refs.byIdentity.get(node)\n  invariant(spec.ref != null, 'ref not found')\n\n  return stringifyBigints(\n    spec\n  ) as ApplyConstellationPayload['specification'][number]\n}\n\nfunction resolveRefs(value: unknown, refs: RefsIndex): unknown {\n  if (isConstellationNode(value)) {\n    const ref = refs.byIdentity.get(value) ?? refs.byLabel.get(labelKey(value))\n    invariant(\n      ref != null,\n      `Node \"${value.label}\" is referenced not included in the apply() call`\n    )\n    return `$${ref}`\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((v) => resolveRefs(v, refs))\n  }\n\n  if (typeof value === 'object' && value !== null) {\n    const resolved: Record<string, unknown> = {}\n    for (const [k, v] of Object.entries(value)) {\n      resolved[k] = resolveRefs(v, refs)\n    }\n    return resolved\n  }\n\n  return value\n}\n\nfunction stringifyBigints(value: unknown): unknown {\n  if (typeof value === 'bigint') {\n    return value.toString()\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(stringifyBigints)\n  }\n\n  if (typeof value === 'object' && value !== null) {\n    const result: Record<string, unknown> = {}\n    for (const [k, v] of Object.entries(value)) {\n      result[k] = stringifyBigints(v)\n    }\n    return result\n  }\n\n  return value\n}\n\nfunction isConstellationNode(\n  value: unknown\n): value is ConstellationNodeInternal {\n  if (typeof value === 'function' || typeof value === 'object') {\n    const obj = value as any\n    return (\n      obj != null &&\n      typeof obj.type === 'string' &&\n      typeof obj.chain === 'number' &&\n      typeof obj._constellation === 'object'\n    )\n  }\n  return false\n}\n"],"mappings":"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"}

package/dist/networks-BTW1qAAa.mjs

@@ -0,0 +1,77 @@
+import fs from "node:fs";
+import path from "node:path";
+//#region src/allow/abi.ts
+function* walkContracts(config) {
+	for (const [chain, contracts] of Object.entries(config)) yield* walkLevel(chain, [], contracts);
+}
+function* walkLevel(chain, segments, node) {
+	if (typeof node === "string") {
+		if (segments.length === 0) throw new Error(`Contract at ${chain} is missing a name`);
+		if (!node.startsWith("0x")) throw new Error(`Invalid address for ${chain}.${segments.join(".")}: ${node}`);
+		yield {
+			chain,
+			segments,
+			address: node
+		};
+		return;
+	}
+	if (node && typeof node === "object") {
+		for (const [key, value] of Object.entries(node)) yield* walkLevel(chain, [...segments, key], value);
+		return;
+	}
+	throw new Error(`Invalid contracts entry at ${chain}.${segments.join(".")}: ${JSON.stringify(node)}`);
+}
+const abiFilePath = (abisDir, node) => path.join(abisDir, node.chain, ...node.segments) + ".json";
+const readAbi = (abisDir, node) => {
+	const file = abiFilePath(abisDir, node);
+	if (!fs.existsSync(file)) return null;
+	const raw = fs.readFileSync(file, "utf8");
+	const parsed = JSON.parse(raw);
+	if (!Array.isArray(parsed)) throw new Error(`ABI at ${file} is not a JSON array`);
+	return parsed;
+};
+const writeAbi = (abisDir, node, abi) => {
+	const file = abiFilePath(abisDir, node);
+	fs.mkdirSync(path.dirname(file), { recursive: true });
+	fs.writeFileSync(file, JSON.stringify(abi, null, 2) + "\n", "utf8");
+};
+//#endregion
+//#region src/allow/networks.ts
+const CHAIN_IDS = {
+	eth: 1,
+	oeth: 10,
+	gno: 100,
+	sep: 11155111,
+	matic: 137,
+	zkevm: 1101,
+	arb1: 42161,
+	avax: 43114,
+	base: 8453,
+	basesep: 84532,
+	bnb: 56,
+	celo: 42220,
+	sonic: 146,
+	berachain: 80094,
+	unichain: 130,
+	worldchain: 480,
+	bob: 60808,
+	mantle: 5e3,
+	hemi: 43111,
+	katana: 747474,
+	linea: 59144,
+	ink: 57073,
+	hyperevm: 999,
+	flare: 14,
+	scroll: 534352,
+	plasma: 9745,
+	megaeth: 4326
+};
+const chainIdFor = (prefix) => {
+	const id = CHAIN_IDS[prefix];
+	if (id === void 0) throw new Error(`Unknown chain prefix: ${prefix}`);
+	return id;
+};
+//#endregion
+export { walkContracts as a, readAbi as i, chainIdFor as n, writeAbi as o, abiFilePath as r, CHAIN_IDS as t };
+
+//# sourceMappingURL=networks-BTW1qAAa.mjs.map

package/dist/networks-BTW1qAAa.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks-BTW1qAAa.mjs","names":[],"sources":["../src/allow/abi.ts","../src/allow/networks.ts"],"sourcesContent":["import fs from 'node:fs'\nimport path from 'node:path'\nimport type { Abi } from './fetch'\n\nexport type ContractAddress = `0x${string}`\n\nexport type ContractNode = {\n  chain: string\n  segments: string[]\n  address: ContractAddress\n}\n\nexport function* walkContracts(\n  config: Record<string, any>\n): Generator<ContractNode> {\n  for (const [chain, contracts] of Object.entries(config)) {\n    yield* walkLevel(chain, [], contracts)\n  }\n}\n\nfunction* walkLevel(\n  chain: string,\n  segments: string[],\n  node: unknown\n): Generator<ContractNode> {\n  if (typeof node === 'string') {\n    if (segments.length === 0) {\n      throw new Error(`Contract at ${chain} is missing a name`)\n    }\n    if (!node.startsWith('0x')) {\n      throw new Error(\n        `Invalid address for ${chain}.${segments.join('.')}: ${node}`\n      )\n    }\n    yield { chain, segments, address: node as ContractAddress }\n    return\n  }\n  if (node && typeof node === 'object') {\n    for (const [key, value] of Object.entries(node as Record<string, any>)) {\n      yield* walkLevel(chain, [...segments, key], value)\n    }\n    return\n  }\n  throw new Error(\n    `Invalid contracts entry at ${chain}.${segments.join('.')}: ${JSON.stringify(node)}`\n  )\n}\n\nexport const abiFilePath = (abisDir: string, node: ContractNode): string =>\n  path.join(abisDir, node.chain, ...node.segments) + '.json'\n\nexport const readAbi = (abisDir: string, node: ContractNode): Abi | null => {\n  const file = abiFilePath(abisDir, node)\n  if (!fs.existsSync(file)) return null\n  const raw = fs.readFileSync(file, 'utf8')\n  const parsed = JSON.parse(raw)\n  if (!Array.isArray(parsed)) {\n    throw new Error(`ABI at ${file} is not a JSON array`)\n  }\n  return parsed as Abi\n}\n\nexport const writeAbi = (\n  abisDir: string,\n  node: ContractNode,\n  abi: Abi\n): void => {\n  const file = abiFilePath(abisDir, node)\n  fs.mkdirSync(path.dirname(file), { recursive: true })\n  fs.writeFileSync(file, JSON.stringify(abi, null, 2) + '\\n', 'utf8')\n}\n","export const CHAIN_IDS = {\n  eth: 1,\n  oeth: 10,\n  gno: 100,\n  sep: 11155111,\n  matic: 137,\n  zkevm: 1101,\n  arb1: 42161,\n  avax: 43114,\n  base: 8453,\n  basesep: 84532,\n  bnb: 56,\n  celo: 42220,\n  sonic: 146,\n  berachain: 80094,\n  unichain: 130,\n  worldchain: 480,\n  bob: 60808,\n  mantle: 5000,\n  hemi: 43111,\n  katana: 747474,\n  linea: 59144,\n  ink: 57073,\n  hyperevm: 999,\n  flare: 14,\n  scroll: 534352,\n  plasma: 9745,\n  megaeth: 4326,\n} as const satisfies Record<string, number>\n\nexport type ChainPrefix = keyof typeof CHAIN_IDS\n\nexport const chainIdFor = (prefix: string): number => {\n  const id = (CHAIN_IDS as Record<string, number>)[prefix]\n  if (id === undefined) {\n    throw new Error(`Unknown chain prefix: ${prefix}`)\n  }\n  return id\n}\n"],"mappings":";;;AAYA,UAAiB,cACf,QACyB;AACzB,MAAK,MAAM,CAAC,OAAO,cAAc,OAAO,QAAQ,OAAO,CACrD,QAAO,UAAU,OAAO,EAAE,EAAE,UAAU;;AAI1C,UAAU,UACR,OACA,UACA,MACyB;AACzB,KAAI,OAAO,SAAS,UAAU;AAC5B,MAAI,SAAS,WAAW,EACtB,OAAM,IAAI,MAAM,eAAe,MAAM,oBAAoB;AAE3D,MAAI,CAAC,KAAK,WAAW,KAAK,CACxB,OAAM,IAAI,MACR,uBAAuB,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC,IAAI,OACxD;AAEH,QAAM;GAAE;GAAO;GAAU,SAAS;GAAyB;AAC3D;;AAEF,KAAI,QAAQ,OAAO,SAAS,UAAU;AACpC,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAA4B,CACpE,QAAO,UAAU,OAAO,CAAC,GAAG,UAAU,IAAI,EAAE,MAAM;AAEpD;;AAEF,OAAM,IAAI,MACR,8BAA8B,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC,IAAI,KAAK,UAAU,KAAK,GACnF;;AAGH,MAAa,eAAe,SAAiB,SAC3C,KAAK,KAAK,SAAS,KAAK,OAAO,GAAG,KAAK,SAAS,GAAG;AAErD,MAAa,WAAW,SAAiB,SAAmC;CAC1E,MAAM,OAAO,YAAY,SAAS,KAAK;AACvC,KAAI,CAAC,GAAG,WAAW,KAAK,CAAE,QAAO;CACjC,MAAM,MAAM,GAAG,aAAa,MAAM,OAAO;CACzC,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,KAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,IAAI,MAAM,UAAU,KAAK,sBAAsB;AAEvD,QAAO;;AAGT,MAAa,YACX,SACA,MACA,QACS;CACT,MAAM,OAAO,YAAY,SAAS,KAAK;AACvC,IAAG,UAAU,KAAK,QAAQ,KAAK,EAAE,EAAE,WAAW,MAAM,CAAC;AACrD,IAAG,cAAc,MAAM,KAAK,UAAU,KAAK,MAAM,EAAE,GAAG,MAAM,OAAO;;;;ACrErE,MAAa,YAAY;CACvB,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACN,SAAS;CACT,KAAK;CACL,MAAM;CACN,OAAO;CACP,WAAW;CACX,UAAU;CACV,YAAY;CACZ,KAAK;CACL,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,OAAO;CACP,KAAK;CACL,UAAU;CACV,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACV;AAID,MAAa,cAAc,WAA2B;CACpD,MAAM,KAAM,UAAqC;AACjD,KAAI,OAAO,KAAA,EACT,OAAM,IAAI,MAAM,yBAAyB,SAAS;AAEpD,QAAO"}

package/dist/zodiac-os-codegen.d.ts

@@ -0,0 +1,52 @@
+// Fallback ambient declarations for the .zodiac-os codegen module and for
+// the AllowKit interface. When `pull-org` / `pull-contracts` have been run,
+// the files under node_modules/.zodiac-os/ provide narrow types that take
+// precedence over these empty fallbacks.
+
+declare global {
+  // Augmented by node_modules/.zodiac-os/allow.d.ts when `pull-contracts` runs.
+  interface AllowKit {}
+}
+
+declare module '.zodiac-os' {
+  import { Address, ChainId } from '@zodiac-os/api-types'
+  import { UUID } from 'crypto'
+
+  export const users: Readonly<
+    Record<
+      string,
+      {
+        id: UUID
+        fullName: string
+        personalSafes: Record<
+          number,
+          { address: Lowercase<Address>; active: boolean }
+        >
+      }
+    >
+  >
+
+  export const vaults: Readonly<
+    Record<
+      string,
+      {
+        workspaceId: UUID
+        workspaceName: string
+        vaults: Readonly<
+          Record<
+            string,
+            {
+              id: UUID
+              label: string
+              address: Lowercase<Address>
+              chain: ChainId
+              threshold: number
+              owners: readonly string[]
+              modules: readonly string[]
+            }
+          >
+        >
+      }
+    >
+  >
+}