@agenticprimitives/agent-relationships 0.1.0-alpha.2

package/dist/abis.js

@@ -0,0 +1,197 @@
+// Relationships-contract ABIs — source of truth:
+// packages/contracts/src/relationships/*.sol (spec 216 / RL Phase 3).
+// Hand-typed against `forge inspect` output. Phase 3 lands the
+// contracts on chain; SDK clients wire up reads/writes against these
+// in Phase 4.
+export const agentRelationshipAbi = [
+    // ─── Errors ─────────────────────────────────────────────────────
+    { type: 'error', name: 'InvalidEdge', inputs: [] },
+    { type: 'error', name: 'EdgeAlreadyExists', inputs: [] },
+    { type: 'error', name: 'EdgeNotFound', inputs: [] },
+    { type: 'error', name: 'RoleAlreadyExists', inputs: [] },
+    { type: 'error', name: 'RoleNotFound', inputs: [] },
+    { type: 'error', name: 'NotAuthorized', inputs: [] },
+    { type: 'error', name: 'InvalidTransition', inputs: [] },
+    // ─── Events ─────────────────────────────────────────────────────
+    {
+        type: 'event', name: 'EdgeProposed',
+        inputs: [
+            { name: 'edgeId', type: 'bytes32', indexed: true },
+            { name: 'subject', type: 'address', indexed: true },
+            { name: 'object_', type: 'address', indexed: true },
+            { name: 'relationshipType', type: 'bytes32', indexed: false },
+            { name: 'createdBy', type: 'address', indexed: false },
+        ],
+    },
+    {
+        type: 'event', name: 'EdgeConfirmed',
+        inputs: [{ name: 'edgeId', type: 'bytes32', indexed: true }, { name: 'confirmedBy', type: 'address', indexed: true }],
+    },
+    {
+        type: 'event', name: 'EdgeActivated',
+        inputs: [{ name: 'edgeId', type: 'bytes32', indexed: true }, { name: 'activatedBy', type: 'address', indexed: true }],
+    },
+    {
+        type: 'event', name: 'EdgeRevoked',
+        inputs: [{ name: 'edgeId', type: 'bytes32', indexed: true }, { name: 'revokedBy', type: 'address', indexed: true }],
+    },
+    {
+        type: 'event', name: 'RoleAdded',
+        inputs: [
+            { name: 'edgeId', type: 'bytes32', indexed: true },
+            { name: 'role', type: 'bytes32', indexed: true },
+            { name: 'updater', type: 'address', indexed: true },
+        ],
+    },
+    {
+        type: 'event', name: 'RoleRemoved',
+        inputs: [
+            { name: 'edgeId', type: 'bytes32', indexed: true },
+            { name: 'role', type: 'bytes32', indexed: true },
+            { name: 'updater', type: 'address', indexed: true },
+        ],
+    },
+    {
+        type: 'event', name: 'EdgeMetadataUpdated',
+        inputs: [
+            { name: 'edgeId', type: 'bytes32', indexed: true },
+            { name: 'metadataURI', type: 'string', indexed: false },
+            { name: 'metadataHash', type: 'bytes32', indexed: false },
+            { name: 'updater', type: 'address', indexed: true },
+        ],
+    },
+    // ─── Edge-ID derivation ─────────────────────────────────────────
+    {
+        type: 'function', name: 'computeEdgeId', stateMutability: 'pure',
+        inputs: [
+            { name: 'subject', type: 'address' },
+            { name: 'object_', type: 'address' },
+            { name: 'relationshipType', type: 'bytes32' },
+        ], outputs: [{ type: 'bytes32' }],
+    },
+    // ─── Writes ─────────────────────────────────────────────────────
+    {
+        type: 'function', name: 'proposeEdge', stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'subject', type: 'address' },
+            { name: 'object_', type: 'address' },
+            { name: 'relationshipType', type: 'bytes32' },
+            { name: 'initialRoles', type: 'bytes32[]' },
+            { name: 'metadataURI', type: 'string' },
+            { name: 'metadataHash', type: 'bytes32' },
+        ],
+        outputs: [{ name: 'edgeId', type: 'bytes32' }],
+    },
+    { type: 'function', name: 'confirmEdge', stateMutability: 'nonpayable',
+        inputs: [{ name: 'edgeId', type: 'bytes32' }], outputs: [] },
+    { type: 'function', name: 'activateEdge', stateMutability: 'nonpayable',
+        inputs: [{ name: 'edgeId', type: 'bytes32' }], outputs: [] },
+    { type: 'function', name: 'revokeEdge', stateMutability: 'nonpayable',
+        inputs: [{ name: 'edgeId', type: 'bytes32' }], outputs: [] },
+    { type: 'function', name: 'addRole', stateMutability: 'nonpayable',
+        inputs: [{ name: 'edgeId', type: 'bytes32' }, { name: 'role', type: 'bytes32' }], outputs: [] },
+    { type: 'function', name: 'removeRole', stateMutability: 'nonpayable',
+        inputs: [{ name: 'edgeId', type: 'bytes32' }, { name: 'role', type: 'bytes32' }], outputs: [] },
+    {
+        type: 'function', name: 'setMetadata', stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'edgeId', type: 'bytes32' },
+            { name: 'metadataURI', type: 'string' },
+            { name: 'metadataHash', type: 'bytes32' },
+        ], outputs: [],
+    },
+    // ─── Reads ──────────────────────────────────────────────────────
+    {
+        type: 'function', name: 'getEdge', stateMutability: 'view',
+        inputs: [{ name: 'edgeId', type: 'bytes32' }],
+        outputs: [{
+                type: 'tuple',
+                components: [
+                    { name: 'edgeId', type: 'bytes32' },
+                    { name: 'subject', type: 'address' },
+                    { name: 'object_', type: 'address' },
+                    { name: 'relationshipType', type: 'bytes32' },
+                    { name: 'status', type: 'uint8' },
+                    { name: 'createdBy', type: 'address' },
+                    { name: 'createdAt', type: 'uint64' },
+                    { name: 'updatedAt', type: 'uint64' },
+                    { name: 'metadataURI', type: 'string' },
+                    { name: 'metadataHash', type: 'bytes32' },
+                ],
+            }],
+    },
+    { type: 'function', name: 'getRoles', stateMutability: 'view',
+        inputs: [{ name: 'edgeId', type: 'bytes32' }], outputs: [{ type: 'bytes32[]' }] },
+    { type: 'function', name: 'hasRole', stateMutability: 'view',
+        inputs: [{ name: 'edgeId', type: 'bytes32' }, { name: 'role', type: 'bytes32' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'getEdgesBySubject', stateMutability: 'view',
+        inputs: [{ name: 'subject', type: 'address' }], outputs: [{ type: 'bytes32[]' }] },
+    { type: 'function', name: 'getEdgesByObject', stateMutability: 'view',
+        inputs: [{ name: 'object_', type: 'address' }], outputs: [{ type: 'bytes32[]' }] },
+    {
+        type: 'function', name: 'getEdgeByTriple', stateMutability: 'view',
+        inputs: [
+            { name: 'subject', type: 'address' },
+            { name: 'object_', type: 'address' },
+            { name: 'relationshipType', type: 'bytes32' },
+        ], outputs: [{ type: 'bytes32' }],
+    },
+    { type: 'function', name: 'edgeExists', stateMutability: 'view',
+        inputs: [{ name: 'edgeId', type: 'bytes32' }], outputs: [{ type: 'bool' }] },
+];
+export const relationshipTypeRegistryAbi = [
+    { type: 'error', name: 'NotGovernor', inputs: [] },
+    { type: 'error', name: 'TypeExists', inputs: [] },
+    { type: 'error', name: 'TypeNotFound', inputs: [] },
+    { type: 'error', name: 'ZeroGovernor', inputs: [] },
+    {
+        type: 'event', name: 'TypeRegistered',
+        inputs: [
+            { name: 'relationshipType', type: 'bytes32', indexed: true },
+            { name: 'label', type: 'string', indexed: false },
+            { name: 'isHierarchical', type: 'bool', indexed: false },
+            { name: 'isTransitive', type: 'bool', indexed: false },
+            { name: 'isSymmetric', type: 'bool', indexed: false },
+        ],
+    },
+    { type: 'function', name: 'governor', stateMutability: 'view', inputs: [], outputs: [{ type: 'address' }] },
+    {
+        type: 'function', name: 'registerType', stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'relationshipType', type: 'bytes32' },
+            { name: 'label', type: 'string' },
+            { name: 'hierarchical', type: 'bool' },
+            { name: 'transitive', type: 'bool' },
+            { name: 'symmetric', type: 'bool' },
+        ], outputs: [],
+    },
+    { type: 'function', name: 'isRegistered', stateMutability: 'view',
+        inputs: [{ name: 'relationshipType', type: 'bytes32' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'isActive', stateMutability: 'view',
+        inputs: [{ name: 'relationshipType', type: 'bytes32' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'isHierarchical', stateMutability: 'view',
+        inputs: [{ name: 'relationshipType', type: 'bytes32' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'isTransitive', stateMutability: 'view',
+        inputs: [{ name: 'relationshipType', type: 'bytes32' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'isSymmetric', stateMutability: 'view',
+        inputs: [{ name: 'relationshipType', type: 'bytes32' }], outputs: [{ type: 'bool' }] },
+    {
+        type: 'function', name: 'getTypeSemantics', stateMutability: 'view',
+        inputs: [{ name: 'relationshipType', type: 'bytes32' }],
+        outputs: [{
+                type: 'tuple',
+                components: [
+                    { name: 'relationshipType', type: 'bytes32' },
+                    { name: 'label', type: 'string' },
+                    { name: 'isHierarchical', type: 'bool' },
+                    { name: 'isTransitive', type: 'bool' },
+                    { name: 'isSymmetric', type: 'bool' },
+                    { name: 'active', type: 'bool' },
+                    { name: 'registeredAt', type: 'uint256' },
+                ],
+            }],
+    },
+    { type: 'function', name: 'typeCount', stateMutability: 'view', inputs: [], outputs: [{ type: 'uint256' }] },
+    { type: 'function', name: 'getAllTypeIds', stateMutability: 'view', inputs: [], outputs: [{ type: 'bytes32[]' }] },
+];
+//# sourceMappingURL=abis.js.map

package/dist/abis.js.map

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

package/dist/calls.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Pure encoded call builders for AgentRelationship writes
+ * (RL Phase 4).
+ *
+ * Subpath: `@agenticprimitives/agent-relationships/calls`.
+ *
+ * Each builder returns a `ContractCall` (`{ to, value, data }`) so
+ * callers can submit via any path — direct walletClient.sendTransaction
+ * (see AgentRelationshipsClient), AgentAccount.execute, CustodyPolicy
+ * ceremony, ERC-4337 UserOp, etc.
+ *
+ * The package boundary (spec 216 § 3) forbids importing custody /
+ * delegation / mcp-runtime here — these builders stay pure encode-only.
+ */
+import type { Address, Hex } from '@agenticprimitives/types';
+import type { RelationshipType, Role } from './types';
+/** Minimal call-shape: the standard `{ to, value, data }` triple. */
+export interface ContractCall {
+    to: Address;
+    value: bigint;
+    data: Hex;
+}
+/**
+ * Build a call to propose a new edge. The caller MUST be the subject
+ * (msg.sender == subject on chain).
+ */
+export declare function buildProposeEdgeCall(args: {
+    relationships: Address;
+    subject: Address;
+    object: Address;
+    relationshipType: RelationshipType;
+    initialRoles?: Role[];
+    metadataURI?: string;
+    metadataHash?: Hex;
+}): ContractCall;
+/**
+ * Build a call to confirm a PROPOSED edge. The caller MUST be the
+ * object side.
+ */
+export declare function buildConfirmEdgeCall(args: {
+    relationships: Address;
+    edgeId: Hex;
+}): ContractCall;
+/**
+ * Build a call to activate a CONFIRMED edge. Either party may activate.
+ */
+export declare function buildActivateEdgeCall(args: {
+    relationships: Address;
+    edgeId: Hex;
+}): ContractCall;
+/**
+ * Build a call to revoke an edge. Either party may revoke unilaterally.
+ */
+export declare function buildRevokeEdgeCall(args: {
+    relationships: Address;
+    edgeId: Hex;
+}): ContractCall;
+/** Build a call to add a role to an existing edge. */
+export declare function buildAddRoleCall(args: {
+    relationships: Address;
+    edgeId: Hex;
+    role: Role;
+}): ContractCall;
+/** Build a call to remove a role from an existing edge. */
+export declare function buildRemoveRoleCall(args: {
+    relationships: Address;
+    edgeId: Hex;
+    role: Role;
+}): ContractCall;
+/** Build a call to set / update an edge's off-chain metadata anchor. */
+export declare function buildSetMetadataCall(args: {
+    relationships: Address;
+    edgeId: Hex;
+    metadataURI: string;
+    metadataHash: Hex;
+}): ContractCall;
+//# sourceMappingURL=calls.d.ts.map

package/dist/calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../src/calls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEtD,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;CACX;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB,GAAG,YAAY,CAiBf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;CACb,GAAG,YAAY,CAUf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;CACb,GAAG,YAAY,CAUf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;CACb,GAAG,YAAY,CAUf;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,YAAY,CAUf;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,YAAY,CAUf;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,GAAG,CAAC;CACnB,GAAG,YAAY,CAUf"}

package/dist/calls.js

@@ -0,0 +1,119 @@
+/**
+ * Pure encoded call builders for AgentRelationship writes
+ * (RL Phase 4).
+ *
+ * Subpath: `@agenticprimitives/agent-relationships/calls`.
+ *
+ * Each builder returns a `ContractCall` (`{ to, value, data }`) so
+ * callers can submit via any path — direct walletClient.sendTransaction
+ * (see AgentRelationshipsClient), AgentAccount.execute, CustodyPolicy
+ * ceremony, ERC-4337 UserOp, etc.
+ *
+ * The package boundary (spec 216 § 3) forbids importing custody /
+ * delegation / mcp-runtime here — these builders stay pure encode-only.
+ */
+import { encodeFunctionData } from 'viem';
+import { agentRelationshipAbi } from './abis';
+const ZERO_BYTES32 = '0x0000000000000000000000000000000000000000000000000000000000000000';
+/**
+ * Build a call to propose a new edge. The caller MUST be the subject
+ * (msg.sender == subject on chain).
+ */
+export function buildProposeEdgeCall(args) {
+    return {
+        to: args.relationships,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentRelationshipAbi,
+            functionName: 'proposeEdge',
+            args: [
+                args.subject,
+                args.object,
+                args.relationshipType,
+                (args.initialRoles ?? []),
+                args.metadataURI ?? '',
+                args.metadataHash ?? ZERO_BYTES32,
+            ],
+        }),
+    };
+}
+/**
+ * Build a call to confirm a PROPOSED edge. The caller MUST be the
+ * object side.
+ */
+export function buildConfirmEdgeCall(args) {
+    return {
+        to: args.relationships,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentRelationshipAbi,
+            functionName: 'confirmEdge',
+            args: [args.edgeId],
+        }),
+    };
+}
+/**
+ * Build a call to activate a CONFIRMED edge. Either party may activate.
+ */
+export function buildActivateEdgeCall(args) {
+    return {
+        to: args.relationships,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentRelationshipAbi,
+            functionName: 'activateEdge',
+            args: [args.edgeId],
+        }),
+    };
+}
+/**
+ * Build a call to revoke an edge. Either party may revoke unilaterally.
+ */
+export function buildRevokeEdgeCall(args) {
+    return {
+        to: args.relationships,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentRelationshipAbi,
+            functionName: 'revokeEdge',
+            args: [args.edgeId],
+        }),
+    };
+}
+/** Build a call to add a role to an existing edge. */
+export function buildAddRoleCall(args) {
+    return {
+        to: args.relationships,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentRelationshipAbi,
+            functionName: 'addRole',
+            args: [args.edgeId, args.role],
+        }),
+    };
+}
+/** Build a call to remove a role from an existing edge. */
+export function buildRemoveRoleCall(args) {
+    return {
+        to: args.relationships,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentRelationshipAbi,
+            functionName: 'removeRole',
+            args: [args.edgeId, args.role],
+        }),
+    };
+}
+/** Build a call to set / update an edge's off-chain metadata anchor. */
+export function buildSetMetadataCall(args) {
+    return {
+        to: args.relationships,
+        value: 0n,
+        data: encodeFunctionData({
+            abi: agentRelationshipAbi,
+            functionName: 'setMetadata',
+            args: [args.edgeId, args.metadataURI, args.metadataHash],
+        }),
+    };
+}
+//# sourceMappingURL=calls.js.map

package/dist/calls.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,96 @@
+import { type Address, type Hex, type WalletClient } from 'viem';
+import { computeEdgeId } from './edge-id';
+import type { AgentRelationshipsClientOpts, ConfirmEdgeInput, Edge, ProposeEdgeInput, RelationshipType, RevokeEdgeInput, SetRolesInput } from './types';
+import { EdgeStatus } from './types';
+/**
+ * Optional per-call submission context. When provided, the write
+ * method submits the encoded call via `walletClient.sendTransaction`.
+ * Callers who want to compose into AgentAccount.execute / CustodyPolicy
+ * ceremonies / ERC-4337 UserOps should use the pure builders in
+ * `./calls` directly.
+ */
+export interface WriteContext {
+    walletClient: WalletClient;
+}
+/**
+ * Read + write client for the agent-relationships trust fabric.
+ *
+ * Phase 2 lands the read paths (`getEdge`, `listEdgesFor`,
+ * `getEdgesByObject`) against the live AgentRelationship contract.
+ * Writes still throw `R Phase 4` — proposeEdge / confirmEdge /
+ * revokeEdge need ERC-1271 auth through the actor's CustodyPolicy.
+ *
+ * Configuration: `opts.relationships` MUST be the deployed
+ * AgentRelationship contract address (recorded in
+ * packages/contracts/deployments-<network>.json).
+ */
+export interface AgentRelationshipsClientOptsLive extends AgentRelationshipsClientOpts {
+    relationships: Address;
+}
+export declare class AgentRelationshipsClient {
+    readonly opts: AgentRelationshipsClientOptsLive;
+    private readonly publicClient;
+    private readonly relationships;
+    constructor(opts: AgentRelationshipsClientOptsLive);
+    /** Fetch a single edge by ID. Returns `null` when no such edge. */
+    getEdge(edgeId: Hex): Promise<Edge | null>;
+    /**
+     * List edges where `subject` appears on the subject side. Optional
+     * client-side filter by `relationshipType` and/or `status`.
+     *
+     * Order is contract-insertion order. Each edge is fetched in
+     * parallel via getEdge.
+     */
+    listEdgesFor(subject: Address, filter?: {
+        relationshipType?: RelationshipType;
+        status?: EdgeStatus;
+    }): Promise<Edge[]>;
+    /** Same as `listEdgesFor` but on the object side. */
+    listEdgesPointingAt(object: Address, filter?: {
+        relationshipType?: RelationshipType;
+        status?: EdgeStatus;
+    }): Promise<Edge[]>;
+    /**
+     * Propose a new edge. The walletClient's account MUST equal
+     * `input.subject` — the contract enforces `msg.sender == subject`.
+     * Returns the propose tx hash. The edgeId can be computed
+     * off-chain via `computeEdgeId(subject, object, relationshipType)`
+     * (matches the on-chain `keccak256(abi.encodePacked(...))`
+     * derivation).
+     *
+     * For PSA-controlled proposals (subject is a Smart Agent gated by
+     * CustodyPolicy), use `buildProposeEdgeCall` directly and compose
+     * into your AgentAccount.execute / CustodyPolicy ceremony.
+     */
+    proposeEdge(input: ProposeEdgeInput, ctx: WriteContext): Promise<Hex>;
+    /**
+     * Confirm a PROPOSED edge. The walletClient's account MUST equal
+     * the object side (msg.sender == object on chain).
+     */
+    confirmEdge(input: ConfirmEdgeInput, ctx: WriteContext): Promise<Hex>;
+    /**
+     * Revoke an edge. Either party may revoke unilaterally (contract
+     * checks `msg.sender == subject || msg.sender == object`).
+     */
+    revokeEdge(input: RevokeEdgeInput, ctx: WriteContext): Promise<Hex>;
+    /**
+     * Add / remove roles on an existing edge. Either party may modify
+     * the edge's role bag.
+     *
+     * Note: the on-chain `Edge` has a single role bag (no subject/object
+     * separation in storage); `SetRolesInput.subjectRoles` +
+     * `objectRoles` are coalesced into the same bag. The current set
+     * is computed via `getRoles(edgeId)` and the diff is submitted as
+     * N add / remove txs.
+     */
+    setRoles(input: SetRolesInput, ctx: WriteContext): Promise<Hex[]>;
+    /**
+     * Submit a single ContractCall via the bound walletClient. Uses
+     * explicit nonce fetch + retry on "replacement underpriced" to
+     * tolerate Base Sepolia's read-after-write lag.
+     */
+    private _submit;
+}
+/** Re-export for callers that want to compute edge IDs off-chain. */
+export { computeEdgeId };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,OAAO,EAAE,KAAK,GAAG,EAAqB,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAS9G,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EACV,4BAA4B,EAC5B,gBAAgB,EAChB,IAAI,EACJ,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAKD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gCAAiC,SAAQ,4BAA4B;IACpF,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,wBAAwB;IAIvB,QAAQ,CAAC,IAAI,EAAE,gCAAgC;IAH3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAEnB,IAAI,EAAE,gCAAgC;IAc3D,mEAAmE;IAC7D,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAwBhD;;;;;;OAMG;IACG,YAAY,CAChB,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QAAC,MAAM,CAAC,EAAE,UAAU,CAAA;KAAE,GACpE,OAAO,CAAC,IAAI,EAAE,CAAC;IAiBlB,qDAAqD;IAC/C,mBAAmB,CACvB,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QAAC,MAAM,CAAC,EAAE,UAAU,CAAA;KAAE,GACpE,OAAO,CAAC,IAAI,EAAE,CAAC;IAmBlB;;;;;;;;;;;OAWG;IACG,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAa3E;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAK3E;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAKzE;;;;;;;;;OASG;IACG,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAmCvE;;;;OAIG;YACW,OAAO;CAiCtB;AAED,qEAAqE;AACrE,OAAO,EAAE,aAAa,EAAE,CAAC"}