graphprotocol · nikgraf · Jan 21, 2026 · Jan 21, 2026 · Jan 21, 2026 · Jan 21, 2026
diff --git a/.changeset/rename-grcop-to-op.md b/.changeset/rename-grcop-to-op.md
@@ -0,0 +1,5 @@
+---
+"@graphprotocol/grc-20": minor
+---
+
+Rename `GrcOp` to `Op` as the primary export. The `GrcOp` type is now deprecated but still available for backwards compatibility.
diff --git a/README.md b/README.md
@@ -168,9 +168,9 @@ const { id: personId, ops: createPersonOps } = Graph.createEntity({
 #### Example Flow
 
 ```ts
-import { Graph, type GrcOp } from '@graphprotocol/grc-20';
+import { Graph, type Op } from '@graphprotocol/grc-20';
 
-const ops: Array<GrcOp> = [];
+const ops: Array<Op> = [];
 
 // create an age property
 const { id: agePropertyId, ops: createAgePropertyOps } = Graph.createProperty({

diff --git a/scripts/setup-rank-types.ts b/scripts/setup-rank-types.ts
@@ -11,7 +11,7 @@
  * Usage: import { ops } from './scripts/setup-rank-types.js'
  */
 
-import type { Op as GrcOp } from '@geoprotocol/grc-20';
+import type { Op } from '@geoprotocol/grc-20';
 import {
   RANK_TYPE,
   RANK_TYPE_PROPERTY,
@@ -22,8 +22,8 @@ import {
 import { createProperty } from '../src/graph/create-property.js';
 import { createType } from '../src/graph/create-type.js';
 
-const generateRankTypeOps = (): GrcOp[] => {
-  const ops: GrcOp[] = [];
+const generateRankTypeOps = (): Op[] => {
+  const ops: Op[] = [];
 
   // 1. Create RANK_TYPE_PROPERTY - A TEXT property storing ORDINAL/WEIGHTED
   const rankTypeProperty = createProperty({

diff --git a/src/core/account.ts b/src/core/account.ts
@@ -5,7 +5,7 @@
  * @since 0.0.6
  */
 
-import type { Op as GrcOp } from '@geoprotocol/grc-20';
+import type { Op } from '@geoprotocol/grc-20';
 import { createEntity } from '../graph/create-entity.js';
 import { createRelation } from '../graph/create-relation.js';
 import { generate } from '../id-utils.js';
@@ -15,7 +15,7 @@ import { ACCOUNT_TYPE, ADDRESS_PROPERTY, NAME_PROPERTY, NETWORK_PROPERTY, TYPES_
 
 type MakeAccountReturnType = {
   accountId: string;
-  ops: GrcOp[];
+  ops: Op[];
 };
 
 /**
@@ -36,7 +36,7 @@ export function make(address: string): MakeAccountReturnType {
   const accountId = generate();
   const checkedAddress: string = getChecksumAddress(address);
 
-  const ops: GrcOp[] = [];
+  const ops: Op[] = [];
 
   const { ops: entityOps } = createEntity({
     id: accountId,

diff --git a/src/core/blocks/data.ts b/src/core/blocks/data.ts
@@ -5,7 +5,7 @@
  * @since 0.0.6
  */
 
-import type { Op as GrcOp } from '@geoprotocol/grc-20';
+import type { Op } from '@geoprotocol/grc-20';
 import { createRelation } from '../../graph/create-relation.js';
 import { updateEntity } from '../../graph/update-entity.js';
 import { Id } from '../../id.js';
@@ -48,12 +48,12 @@ type DataBlockParams = {
  * ```
  *
  * @param param args {@link TextBlockParams}
- * @returns ops – The ops for the Data Block entity: {@link GrcOp}[]
+ * @returns ops – The ops for the Data Block entity: {@link Op}[]
  */
-export function make({ fromId, sourceType, position, name }: DataBlockParams): GrcOp[] {
+export function make({ fromId, sourceType, position, name }: DataBlockParams): Op[] {
   const newBlockId = generate();
 
-  const ops: GrcOp[] = [];
+  const ops: Op[] = [];
   const { ops: dataBlockTypeOps } = createRelation({
     fromEntity: newBlockId,
     type: TYPES_PROPERTY,

diff --git a/src/core/blocks/text.ts b/src/core/blocks/text.ts
@@ -5,7 +5,7 @@
  * @since 0.0.6
  */
 
-import type { Op as GrcOp } from '@geoprotocol/grc-20';
+import type { Op } from '@geoprotocol/grc-20';
 import { createRelation } from '../../graph/create-relation.js';
 import { updateEntity } from '../../graph/update-entity.js';
 import { Id } from '../../id.js';
@@ -28,12 +28,12 @@ type TextBlockParams = { fromId: string; text: string; position?: string };
  * ```
  *
  * @param param args {@link TextBlockParams}
- * @returns ops – The ops for the Text Block entity: {@link GrcOp}[]
+ * @returns ops – The ops for the Text Block entity: {@link Op}[]
  */
-export function make({ fromId, text, position }: TextBlockParams): GrcOp[] {
+export function make({ fromId, text, position }: TextBlockParams): Op[] {
   const newBlockId = generate();
 
-  const ops: GrcOp[] = [];
+  const ops: Op[] = [];
 
   const { ops: textBlockTypeOps } = createRelation({
     fromEntity: newBlockId,

diff --git a/src/encoding.test.ts b/src/encoding.test.ts
@@ -4,7 +4,7 @@ import {
   formatId,
   type Edit as GrcEdit,
   type Id as GrcId,
-  type Op as GrcOp,
+  type Op,
   parseId,
 } from '@geoprotocol/grc-20';
 import { describe, expect, it } from 'vitest';
@@ -55,7 +55,7 @@ describe('GRC-20 v2 Encoding', () => {
       expect(decoded.ops.length).toBe(1);
       expect(decoded.ops[0]?.type).toBe('createEntity');
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createEntity' }>;
       expect(formatId(op.id)).toBe('3af3e22d21694a078681516710b7ecf1');
       expect(op.values.length).toBe(1);
       expect(op.values[0]?.value.type).toBe('text');
@@ -100,7 +100,7 @@ describe('GRC-20 v2 Encoding', () => {
       expect(decoded.name).toBe('test');
       expect(decoded.ops.length).toBe(1);
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createEntity' }>;
       expect(op.values[0]?.value.type).toBe('float64');
       if (op.values[0]?.value.type === 'float64') {
         expect(op.values[0].value.value).toBe(42.5);
@@ -138,7 +138,7 @@ describe('GRC-20 v2 Encoding', () => {
       const binary = encodeEdit(edit);
       const decoded = decodeEdit(binary);
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createEntity' }>;
       expect(op.values[0]?.value.type).toBe('bool');
       if (op.values[0]?.value.type === 'bool') {
         expect(op.values[0].value.value).toBe(true);
@@ -178,7 +178,7 @@ describe('GRC-20 v2 Encoding', () => {
       const binary = encodeEdit(edit);
       const decoded = decodeEdit(binary);
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createEntity' }>;
       expect(op.values[0]?.value.type).toBe('point');
       if (op.values[0]?.value.type === 'point') {
         expect(op.values[0].value.lon).toBeCloseTo(-122.4194, 4);
@@ -218,7 +218,7 @@ describe('GRC-20 v2 Encoding', () => {
       const binary = encodeEdit(edit);
       const decoded = decodeEdit(binary);
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createEntity' }>;
       expect(op.values[0]?.value.type).toBe('date');
       if (op.values[0]?.value.type === 'date') {
         expect(op.values[0].value.value).toBe('2024-01-15');
@@ -256,7 +256,7 @@ describe('GRC-20 v2 Encoding', () => {
       const binary = encodeEdit(edit);
       const decoded = decodeEdit(binary);
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createEntity' }>;
       expect(op.values[0]?.value.type).toBe('time');
       if (op.values[0]?.value.type === 'time') {
         expect(op.values[0].value.value).toBe('14:30:00Z');
@@ -294,7 +294,7 @@ describe('GRC-20 v2 Encoding', () => {
       const binary = encodeEdit(edit);
       const decoded = decodeEdit(binary);
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createEntity' }>;
       expect(op.values[0]?.value.type).toBe('datetime');
       if (op.values[0]?.value.type === 'datetime') {
         expect(op.values[0].value.value).toBe('2024-01-15T14:30:00Z');
@@ -332,7 +332,7 @@ describe('GRC-20 v2 Encoding', () => {
       const binary = encodeEdit(edit);
       const decoded = decodeEdit(binary);
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createEntity' }>;
       expect(op.values[0]?.value.type).toBe('schedule');
       if (op.values[0]?.value.type === 'schedule') {
         expect(op.values[0].value.value).toBe('FREQ=WEEKLY;BYDAY=MO,WE,FR');
@@ -375,7 +375,7 @@ describe('GRC-20 v2 Encoding', () => {
       expect(decoded.ops.length).toBe(1);
       expect(decoded.ops[0]?.type).toBe('createRelation');
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createRelation' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createRelation' }>;
       expect(formatId(op.id)).toBe('765564cac7e54c61b1dcc28ab77ec6b7');
       expect(formatId(op.relationType)).toBe('cf518eafef744aadbc87fe09c2631fcd');
       expect(formatId(op.from)).toBe('3af3e22d21694a078681516710b7ecf1');
@@ -414,7 +414,7 @@ describe('GRC-20 v2 Encoding', () => {
       const binary = encodeEdit(edit);
       const decoded = decodeEdit(binary);
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'createRelation' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'createRelation' }>;
       expect(op.fromSpace).toBeDefined();
       expect(op.toSpace).toBeDefined();
       if (op.fromSpace) expect(formatId(op.fromSpace)).toBe('aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa');
@@ -445,7 +445,7 @@ describe('GRC-20 v2 Encoding', () => {
       expect(decoded.ops.length).toBe(1);
       expect(decoded.ops[0]?.type).toBe('deleteRelation');
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'deleteRelation' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'deleteRelation' }>;
       expect(formatId(op.id)).toBe('765564cac7e54c61b1dcc28ab77ec6b7');
     });
 
@@ -475,7 +475,7 @@ describe('GRC-20 v2 Encoding', () => {
       expect(decoded.ops.length).toBe(1);
       expect(decoded.ops[0]?.type).toBe('updateRelation');
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'updateRelation' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'updateRelation' }>;
       expect(formatId(op.id)).toBe('765564cac7e54c61b1dcc28ab77ec6b7');
       expect(op.position).toBe('new-position');
     });
@@ -502,7 +502,7 @@ describe('GRC-20 v2 Encoding', () => {
       const binary = encodeEdit(edit);
       const decoded = decodeEdit(binary);
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'updateRelation' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'updateRelation' }>;
       expect(op.unset).toContain('fromSpace');
       expect(op.unset).toContain('toSpace');
       expect(op.unset).toContain('position');
@@ -551,7 +551,7 @@ describe('GRC-20 v2 Encoding', () => {
       expect(decoded.ops.length).toBe(1);
       expect(decoded.ops[0]?.type).toBe('updateEntity');
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'updateEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'updateEntity' }>;
       expect(formatId(op.id)).toBe('3af3e22d21694a078681516710b7ecf1');
       expect(op.set.length).toBe(1);
       expect(op.unset.length).toBe(1);
@@ -581,7 +581,7 @@ describe('GRC-20 v2 Encoding', () => {
       expect(decoded.ops.length).toBe(1);
       expect(decoded.ops[0]?.type).toBe('deleteEntity');
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'deleteEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'deleteEntity' }>;
       expect(formatId(op.id)).toBe('3af3e22d21694a078681516710b7ecf1');
     });
 
@@ -609,7 +609,7 @@ describe('GRC-20 v2 Encoding', () => {
       expect(decoded.ops.length).toBe(1);
       expect(decoded.ops[0]?.type).toBe('restoreEntity');
 
-      const op = decoded.ops[0] as Extract<GrcOp, { type: 'restoreEntity' }>;
+      const op = decoded.ops[0] as Extract<Op, { type: 'restoreEntity' }>;
       expect(formatId(op.id)).toBe('3af3e22d21694a078681516710b7ecf1');
     });
   });

diff --git a/src/graph/create-entity.ts b/src/graph/create-entity.ts
@@ -1,9 +1,9 @@
 import {
-  type Op as GrcOp,
   type PropertyValue as GrcPropertyValue,
   createEntity as grcCreateEntity,
   createRelation as grcCreateRelation,
   languages,
+  type Op,
 } from '@geoprotocol/grc-20';
 import { COVER_PROPERTY, DESCRIPTION_PROPERTY, NAME_PROPERTY, TYPES_PROPERTY } from '../core/ids/system.js';
 import { Id } from '../id.js';
@@ -114,7 +114,7 @@ export const createEntity = ({
   }
 
   const id = providedId ?? generate();
-  let ops: Array<GrcOp> = [];
+  let ops: Array<Op> = [];
 
   const newValues: Array<GrcPropertyValue> = [];
   if (name) {

diff --git a/src/graph/create-property.ts b/src/graph/create-property.ts
@@ -1,4 +1,4 @@
-import { type Op as GrcOp, createRelation as grcCreateRelation } from '@geoprotocol/grc-20';
+import { createRelation as grcCreateRelation, type Op } from '@geoprotocol/grc-20';
 import {
   BOOLEAN,
   BYTES,
@@ -75,7 +75,7 @@ export const createProperty = (params: CreatePropertyParams): CreateResult => {
   }
   const entityId = id ?? generate();
 
-  const ops: Array<GrcOp> = [];
+  const ops: Array<Op> = [];
 
   // Create the property entity
   const { ops: entityOps } = createEntity({

diff --git a/src/graph/create-relation.test.ts b/src/graph/create-relation.test.ts
@@ -1,16 +1,16 @@
-import type { CreateEntity, CreateRelation, Op as GrcOp } from '@geoprotocol/grc-20';
+import type { CreateEntity, CreateRelation, Op } from '@geoprotocol/grc-20';
 import { describe, expect, it } from 'vitest';
 import { CLAIM_TYPE, NEWS_STORY_TYPE } from '../core/ids/content.js';
 import { COVER_PROPERTY, DESCRIPTION_PROPERTY, NAME_PROPERTY, TYPES_PROPERTY } from '../core/ids/system.js';
 import { Id } from '../id.js';
 import { toGrcId } from '../id-utils.js';
 import { createRelation } from './create-relation.js';
 
-const isCreateRelationOp = (op: GrcOp): op is CreateRelation => {
+const isCreateRelationOp = (op: Op): op is CreateRelation => {
   return op.type === 'createRelation';
 };
 
-const isCreateEntityOp = (op: GrcOp): op is CreateEntity => {
+const isCreateEntityOp = (op: Op): op is CreateEntity => {
   return op.type === 'createEntity';
 };
 

diff --git a/src/graph/create-relation.ts b/src/graph/create-relation.ts
@@ -1,4 +1,4 @@
-import { type Op as GrcOp, createRelation as grcCreateRelation } from '@geoprotocol/grc-20';
+import { createRelation as grcCreateRelation, type Op } from '@geoprotocol/grc-20';
 import { Id } from '../id.js';
 import { assertValid, generate, toGrcId } from '../id-utils.js';
 import type { CreateResult, RelationParams } from '../types.js';
@@ -91,7 +91,7 @@ export const createRelation = ({
   const id = providedId ?? generate();
   const entityId = providedEntityId ?? generate();
 
-  const ops: Array<GrcOp> = [];
+  const ops: Array<Op> = [];
 
   ops.push(
     grcCreateRelation({

diff --git a/src/graph/create-space.ts b/src/graph/create-space.ts
@@ -1,4 +1,4 @@
-import type { Op as GrcOp } from '@geoprotocol/grc-20';
+import type { Op } from '@geoprotocol/grc-20';
 import { IdUtils } from '../../index.js';
 import { Id } from '../id.js';
 import { getApiOrigin, type Network } from './constants.js';
@@ -7,7 +7,7 @@ type CreateSpaceParams = {
   editorAddress: string;
   name: string;
   network?: Network;
-  ops?: GrcOp[];
+  ops?: Op[];
   spaceEntityId?: string;
 
   /**
@@ -19,7 +19,7 @@ type CreateSpaceParams = {
 
 type BaseDeployParams = {
   spaceName: string;
-  ops?: GrcOp[];
+  ops?: Op[];
   spaceEntityId?: string;
 };
 

diff --git a/src/graph/create-type.ts b/src/graph/create-type.ts
@@ -1,4 +1,4 @@
-import { type Op as GrcOp, createRelation as grcCreateRelation } from '@geoprotocol/grc-20';
+import { createRelation as grcCreateRelation, type Op } from '@geoprotocol/grc-20';
 import { PROPERTIES, SCHEMA_TYPE, TYPES_PROPERTY } from '../core/ids/system.js';
 import { Id } from '../id.js';
 import { assertValid, generate, toGrcId } from '../id-utils.js';
@@ -48,7 +48,7 @@ export const createType = ({
 
   // set property "Types" to "Type"
   assertValid(id);
-  (ops as GrcOp[]).push(
+  (ops as Op[]).push(
     grcCreateRelation({
       id: toGrcId(generate()),
       entity: toGrcId(generate()),
@@ -62,7 +62,7 @@ export const createType = ({
     for (const propertyId of properties) {
       assertValid(propertyId, '`propertyId` in `createType`');
       // Set Properties on the Type
-      (ops as GrcOp[]).push(
+      (ops as Op[]).push(
         grcCreateRelation({
           id: toGrcId(generate()),
           entity: toGrcId(generate()),