@geoprotocol/geo-sdk 0.1.1

package/dist/src/codec/convert.js

@@ -0,0 +1,188 @@
+/**
+ * Conversion layer between grc-20-ts ops and @geoprotocol/grc-20 ops.
+ *
+ * This module bridges the high-level grc-20-ts operation types to the
+ * low-level @geoprotocol/grc-20 types used for binary encoding.
+ */
+import { createId, } from '@geoprotocol/grc-20';
+import { toBytes } from '../id-utils.js';
+/**
+ * Converts a grc-20-ts Id (string) to @geoprotocol/grc-20 Id (Uint8Array).
+ */
+function convertId(id) {
+    const bytes = toBytes(id);
+    return createId(bytes);
+}
+/**
+ * Converts a grc-20-ts TypedValue to @geoprotocol/grc-20 Value.
+ */
+function convertTypedValue(v) {
+    switch (v.type) {
+        case 'bool':
+            return { type: 'bool', value: v.value };
+        case 'float64':
+            return {
+                type: 'float64',
+                value: v.value,
+                unit: v.unit ? convertId(v.unit) : undefined,
+            };
+        case 'text':
+            return {
+                type: 'text',
+                value: v.value,
+                language: v.language ? convertId(v.language) : undefined,
+            };
+        case 'point':
+            return {
+                type: 'point',
+                lon: v.lon,
+                lat: v.lat,
+                alt: v.alt,
+            };
+        case 'date':
+            return { type: 'date', value: v.value };
+        case 'time':
+            return { type: 'time', value: v.value };
+        case 'datetime':
+            return { type: 'datetime', value: v.value };
+        case 'schedule':
+            return { type: 'schedule', value: v.value };
+        default:
+            throw new Error(`Unsupported value type: ${v.type}`);
+    }
+}
+/**
+ * Converts a grc-20-ts Value to @geoprotocol/grc-20 PropertyValue.
+ */
+function convertPropertyValue(v) {
+    // Extract property and build TypedValue from remaining fields
+    const { property, ...typedValue } = v;
+    return {
+        property: convertId(property),
+        value: convertTypedValue(typedValue),
+    };
+}
+/**
+ * Converts a single grc-20-ts Op to @geoprotocol/grc-20 Op.
+ */
+function convertOp(op) {
+    switch (op.type) {
+        case 'UPDATE_ENTITY': {
+            // In grc-20-ts, UPDATE_ENTITY is used for both create and update
+            // In @geoprotocol/grc-20, we use createEntity for new entities
+            // Since we can't know if it's a new entity, we use createEntity
+            // which acts as an upsert in the spec
+            const createEntity = {
+                type: 'createEntity',
+                id: convertId(op.entity.id),
+                values: op.entity.values.map(convertPropertyValue),
+            };
+            return createEntity;
+        }
+        case 'CREATE_RELATION': {
+            const createRelation = {
+                type: 'createRelation',
+                id: convertId(op.relation.id),
+                relationType: convertId(op.relation.type),
+                from: convertId(op.relation.fromEntity),
+                to: convertId(op.relation.toEntity),
+                entity: op.relation.entity ? convertId(op.relation.entity) : undefined,
+                position: op.relation.position,
+                fromSpace: op.relation.fromSpace ? convertId(op.relation.fromSpace) : undefined,
+                fromVersion: op.relation.fromVersion ? convertId(op.relation.fromVersion) : undefined,
+                toSpace: op.relation.toSpace ? convertId(op.relation.toSpace) : undefined,
+                toVersion: op.relation.toVersion ? convertId(op.relation.toVersion) : undefined,
+            };
+            return createRelation;
+        }
+        case 'DELETE_RELATION': {
+            const deleteRelation = {
+                type: 'deleteRelation',
+                id: convertId(op.id),
+            };
+            return deleteRelation;
+        }
+        case 'UPDATE_RELATION': {
+            // Build unset array from boolean flags
+            const unset = [];
+            // Note: grc-20-ts doesn't have unset flags in UPDATE_RELATION,
+            // those are in UNSET_RELATION_FIELDS. So we pass empty unset array.
+            const updateRelation = {
+                type: 'updateRelation',
+                id: convertId(op.relation.id),
+                position: op.relation.position,
+                fromSpace: op.relation.fromSpace ? convertId(op.relation.fromSpace) : undefined,
+                fromVersion: op.relation.fromVersion ? convertId(op.relation.fromVersion) : undefined,
+                toSpace: op.relation.toSpace ? convertId(op.relation.toSpace) : undefined,
+                toVersion: op.relation.toVersion ? convertId(op.relation.toVersion) : undefined,
+                unset,
+            };
+            return updateRelation;
+        }
+        case 'UNSET_ENTITY_VALUES': {
+            // Convert to UpdateEntity with unset values
+            const unsetValues = op.unsetEntityValues.properties.map(propertyId => ({
+                property: convertId(propertyId),
+                language: { type: 'all' },
+            }));
+            const updateEntity = {
+                type: 'updateEntity',
+                id: convertId(op.unsetEntityValues.id),
+                set: [],
+                unset: unsetValues,
+            };
+            return updateEntity;
+        }
+        case 'UNSET_RELATION_FIELDS': {
+            const unset = [];
+            if (op.unsetRelationFields.fromSpace)
+                unset.push('fromSpace');
+            if (op.unsetRelationFields.fromVersion)
+                unset.push('fromVersion');
+            if (op.unsetRelationFields.toSpace)
+                unset.push('toSpace');
+            if (op.unsetRelationFields.toVersion)
+                unset.push('toVersion');
+            if (op.unsetRelationFields.position)
+                unset.push('position');
+            const updateRelation = {
+                type: 'updateRelation',
+                id: convertId(op.unsetRelationFields.id),
+                unset,
+            };
+            return updateRelation;
+        }
+        case 'CREATE_PROPERTY': {
+            // CREATE_PROPERTY is not directly supported in GRC-20 v2 as an op type
+            // Properties are implicitly created when used. We skip this op.
+            // For now, throw an error to make it explicit.
+            throw new Error('CREATE_PROPERTY is not supported in GRC-20 v2 binary format. Properties are created implicitly.');
+        }
+        default:
+            throw new Error(`Unknown op type: ${op.type}`);
+    }
+}
+/**
+ * Converts an array of grc-20-ts Ops to @geoprotocol/grc-20 Ops.
+ */
+export function convertOps(ops) {
+    return ops.filter(op => op.type !== 'CREATE_PROPERTY').map(convertOp);
+}
+/**
+ * Converts a hex address string to a GrcId (Uint8Array).
+ * Used for converting author addresses.
+ */
+export function hexToGrcId(hex) {
+    let hexString = hex;
+    if (hexString.startsWith('0x')) {
+        hexString = hexString.slice(2);
+    }
+    // Pad to 32 hex chars (16 bytes) if shorter
+    const paddedHex = hexString.padStart(32, '0');
+    const bytes = new Uint8Array(16);
+    for (let i = 0; i < 16; i++) {
+        bytes[i] = Number.parseInt(paddedHex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return createId(bytes);
+}
+//# sourceMappingURL=convert.js.map

package/dist/src/codec/convert.js.map

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

package/dist/src/core/account.d.ts

@@ -0,0 +1,28 @@
+/**
+ * This module provides utility functions for working with knowledge graph
+ * images in TypeScript.
+ *
+ * @since 0.0.6
+ */
+import type { Op } from '@geoprotocol/grc-20';
+type MakeAccountReturnType = {
+    accountId: string;
+    ops: Op[];
+};
+/**
+ * Returns the ops to create an entity representing an Account.
+ *
+ * @example
+ * ```ts
+ * const { accountId, ops } = Account.make('0x1234');
+ * console.log(accountId); // 'gw9uTVTnJdhtczyuzBkL3X'
+ * console.log(ops); // [...]
+ * ```
+ *
+ * @param address – Ethereum address
+ * @returns accountId – base58 encoded v4 uuid representing the account entity: {@link MakeAccountReturnType}
+ * @returns ops – The ops for the Account entity: {@link MakeAccountReturnType}
+ */
+export declare function make(address: string): MakeAccountReturnType;
+export {};
+//# sourceMappingURL=account.d.ts.map

package/dist/src/core/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/core/account.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAQ9C,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,EAAE,EAAE,CAAC;CACX,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CA4C3D"}

package/dist/src/core/account.js

@@ -0,0 +1,67 @@
+/**
+ * This module provides utility functions for working with knowledge graph
+ * images in TypeScript.
+ *
+ * @since 0.0.6
+ */
+import { createEntity } from '../graph/create-entity.js';
+import { createRelation } from '../graph/create-relation.js';
+import { generate } from '../id-utils.js';
+import { getChecksumAddress } from './get-checksum-address.js';
+import { ETHEREUM } from './ids/network.js';
+import { ACCOUNT_TYPE, ADDRESS_PROPERTY, NAME_PROPERTY, NETWORK_PROPERTY, TYPES_PROPERTY } from './ids/system.js';
+/**
+ * Returns the ops to create an entity representing an Account.
+ *
+ * @example
+ * ```ts
+ * const { accountId, ops } = Account.make('0x1234');
+ * console.log(accountId); // 'gw9uTVTnJdhtczyuzBkL3X'
+ * console.log(ops); // [...]
+ * ```
+ *
+ * @param address – Ethereum address
+ * @returns accountId – base58 encoded v4 uuid representing the account entity: {@link MakeAccountReturnType}
+ * @returns ops – The ops for the Account entity: {@link MakeAccountReturnType}
+ */
+export function make(address) {
+    const accountId = generate();
+    const checkedAddress = getChecksumAddress(address);
+    const ops = [];
+    const { ops: entityOps } = createEntity({
+        id: accountId,
+        values: [
+            {
+                property: ADDRESS_PROPERTY,
+                type: 'text',
+                value: checkedAddress,
+            },
+            {
+                property: NAME_PROPERTY,
+                type: 'text',
+                value: checkedAddress,
+            },
+        ],
+    });
+    ops.push(...entityOps);
+    // Types -> Account
+    const { ops: accountOps } = createRelation({
+        fromEntity: accountId,
+        type: TYPES_PROPERTY,
+        toEntity: ACCOUNT_TYPE,
+    });
+    ops.push(...accountOps);
+    // Network -> Ethereum
+    // Signals that the account is for the Ethereum family of chains
+    const { ops: networkOps } = createRelation({
+        fromEntity: accountId,
+        type: NETWORK_PROPERTY,
+        toEntity: ETHEREUM,
+    });
+    ops.push(...networkOps);
+    return {
+        accountId,
+        ops,
+    };
+}
+//# sourceMappingURL=account.js.map

package/dist/src/core/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/core/account.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAOlH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAW,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE3D,MAAM,GAAG,GAAS,EAAE,CAAC;IAErB,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC;QACtC,EAAE,EAAE,SAAS;QACb,MAAM,EAAE;YACN;gBACE,QAAQ,EAAE,gBAAgB;gBAC1B,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,cAAc;aACtB;YACD;gBACE,QAAQ,EAAE,aAAa;gBACvB,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,cAAc;aACtB;SACF;KACF,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAEvB,mBAAmB;IACnB,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC;QACzC,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAExB,sBAAsB;IACtB,gEAAgE;IAChE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC;QACzC,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,QAAQ;KACnB,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAExB,OAAO;QACL,SAAS;QACT,GAAG;KACJ,CAAC;AACJ,CAAC"}

package/dist/src/core/account.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=account.test.d.ts.map

package/dist/src/core/account.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.test.d.ts","sourceRoot":"","sources":["../../../src/core/account.test.ts"],"names":[],"mappings":""}

package/dist/src/core/account.test.js

@@ -0,0 +1,80 @@
+import { expect, it } from 'vitest';
+import { toGrcId } from '../id-utils.js';
+import { make } from './account.js';
+import { ETHEREUM } from './ids/network.js';
+import { ACCOUNT_TYPE, ADDRESS_PROPERTY, NAME_PROPERTY, NETWORK_PROPERTY, TYPES_PROPERTY } from './ids/system.js';
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+it('should generate ops for an account entity', () => {
+    const { accountId, ops } = make(ZERO_ADDRESS);
+    const [entityOp, accountTypeOp, networkOp] = ops;
+    // Verify we have the expected number of ops
+    expect(ops.length).toBe(3);
+    // Check createEntity op for the account
+    expect(entityOp?.type).toBe('createEntity');
+    const createEntityOp = entityOp;
+    expect(createEntityOp.id).toEqual(toGrcId(accountId));
+    // Verify ADDRESS_PROPERTY value
+    const addressValue = createEntityOp.values.find(v => {
+        const propBytes = v.property;
+        return propBytes.every((b, i) => b === toGrcId(ADDRESS_PROPERTY)[i]);
+    });
+    expect(addressValue).toBeDefined();
+    expect(addressValue?.value.type).toBe('text');
+    if (addressValue?.value.type === 'text') {
+        expect(addressValue.value.value).toBe(ZERO_ADDRESS);
+    }
+    // Verify NAME_PROPERTY value
+    const nameValue = createEntityOp.values.find(v => {
+        const propBytes = v.property;
+        return propBytes.every((b, i) => b === toGrcId(NAME_PROPERTY)[i]);
+    });
+    expect(nameValue).toBeDefined();
+    expect(nameValue?.value.type).toBe('text');
+    if (nameValue?.value.type === 'text') {
+        expect(nameValue.value.value).toBe(ZERO_ADDRESS);
+    }
+    // Check types relation to ACCOUNT_TYPE
+    expect(accountTypeOp?.type).toBe('createRelation');
+    const accountTypeRelOp = accountTypeOp;
+    expect(accountTypeRelOp.from).toEqual(toGrcId(accountId));
+    expect(accountTypeRelOp.to).toEqual(toGrcId(ACCOUNT_TYPE));
+    expect(accountTypeRelOp.relationType).toEqual(toGrcId(TYPES_PROPERTY));
+    // Check network relation to ETHEREUM
+    expect(networkOp?.type).toBe('createRelation');
+    const networkRelOp = networkOp;
+    expect(networkRelOp.from).toEqual(toGrcId(accountId));
+    expect(networkRelOp.to).toEqual(toGrcId(ETHEREUM));
+    expect(networkRelOp.relationType).toEqual(toGrcId(NETWORK_PROPERTY));
+});
+it('should use checksum address format', () => {
+    // Lowercase address should be converted to checksum format
+    const lowercaseAddress = '0xabcd1234567890abcdef1234567890abcdef1234';
+    const { ops } = make(lowercaseAddress);
+    const entityOp = ops[0];
+    const addressValue = entityOp.values.find(v => {
+        const propBytes = v.property;
+        return propBytes.every((b, i) => b === toGrcId(ADDRESS_PROPERTY)[i]);
+    });
+    expect(addressValue).toBeDefined();
+    expect(addressValue?.value.type).toBe('text');
+    if (addressValue?.value.type === 'text') {
+        // Should be checksum formatted (mixed case)
+        expect(addressValue.value.value).not.toBe(lowercaseAddress);
+        expect(addressValue.value.value.toLowerCase()).toBe(lowercaseAddress.toLowerCase());
+    }
+});
+it('should generate unique account IDs for different calls', () => {
+    const { accountId: id1 } = make(ZERO_ADDRESS);
+    const { accountId: id2 } = make(ZERO_ADDRESS);
+    expect(id1).not.toBe(id2);
+});
+it('should generate correct number of ops for account creation', () => {
+    const { ops } = make(ZERO_ADDRESS);
+    // 1 createEntity + 1 createRelation (type) + 1 createRelation (network)
+    expect(ops.length).toBe(3);
+    // Verify op types in correct order
+    expect(ops[0]?.type).toBe('createEntity');
+    expect(ops[1]?.type).toBe('createRelation');
+    expect(ops[2]?.type).toBe('createRelation');
+});
+//# sourceMappingURL=account.test.js.map

package/dist/src/core/account.test.js.map

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

package/dist/src/core/base58.d.ts

@@ -0,0 +1,43 @@
+/**
+ * This module provides utility functions for working with base58 ids
+ * in TypeScript.
+ *
+ * @since 0.0.6
+ */
+export declare const BASE58_ALLOWED_CHARS = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+export type Base58 = string;
+/**
+ * Base58 encodes the given string value.
+ *
+ * @example
+ * ```ts
+ * import { v4 as uuidv4 } from "uuid";
+ *
+ * const uuid = uuidv4(); // 92539817-7989-4083-ab80-e9c2b2b66669
+ * const dashesRemoved = uuid.replaceAll(/-/g, ""); // 9253981779894083ab80e9c2b2b66669
+ * const encoded = encodeBase58(dashesRemoved)
+ * console.log(encoded) // K51CbDqxW35osbjPo5ZF77
+ * ```
+ *
+ * @param val string to encode as base58
+ * @returns the base58 encoded string
+ */
+export declare function encodeBase58(val: string): Base58;
+export type UUID = string;
+/**
+ * Expand the base58 encoded UUID back to its original UUID format
+ *
+ * @example
+ * ```ts
+ * const uuid = 92539817-7989-4083-ab80-e9c2b2b66669;
+ * const encoded = encodeBase58(dashesRemoved); // K51CbDqxW35osbjPo5ZF77
+ * const decoded = decodeBase58ToUUID(encoded); // 92539817-7989-4083-ab80-e9c2b2b66669
+ *
+ * expect(decoded).toEqual(uuid);
+ * ```
+ *
+ * @param encoded base58 encoded UUID
+ * @returns the expanded UUID from the base58 encoded value
+ */
+export declare function decodeBase58ToUUID(encoded: string): UUID;
+//# sourceMappingURL=base58.d.ts.map

package/dist/src/core/base58.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.d.ts","sourceRoot":"","sources":["../../../src/core/base58.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,oBAAoB,+DAA+D,CAAC;AAEjG,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBhD;AAED,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAE1B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAkBxD"}

package/dist/src/core/base58.js

@@ -0,0 +1,68 @@
+/**
+ * This module provides utility functions for working with base58 ids
+ * in TypeScript.
+ *
+ * @since 0.0.6
+ */
+export const BASE58_ALLOWED_CHARS = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+/**
+ * Base58 encodes the given string value.
+ *
+ * @example
+ * ```ts
+ * import { v4 as uuidv4 } from "uuid";
+ *
+ * const uuid = uuidv4(); // 92539817-7989-4083-ab80-e9c2b2b66669
+ * const dashesRemoved = uuid.replaceAll(/-/g, ""); // 9253981779894083ab80e9c2b2b66669
+ * const encoded = encodeBase58(dashesRemoved)
+ * console.log(encoded) // K51CbDqxW35osbjPo5ZF77
+ * ```
+ *
+ * @param val string to encode as base58
+ * @returns the base58 encoded string
+ */
+export function encodeBase58(val) {
+    const hex = BigInt(`0x${val}`);
+    let remainder = hex;
+    const result = []; // Use an array to store encoded characters
+    while (remainder > 0n) {
+        const mod = remainder % 58n;
+        const base58CharAtMod = BASE58_ALLOWED_CHARS[Number(mod)];
+        if (base58CharAtMod) {
+            result.push(base58CharAtMod);
+        }
+        remainder = remainder / 58n;
+    }
+    // Reverse and join the array to get the final Base58 encoded string
+    return result.reverse().join('');
+}
+/**
+ * Expand the base58 encoded UUID back to its original UUID format
+ *
+ * @example
+ * ```ts
+ * const uuid = 92539817-7989-4083-ab80-e9c2b2b66669;
+ * const encoded = encodeBase58(dashesRemoved); // K51CbDqxW35osbjPo5ZF77
+ * const decoded = decodeBase58ToUUID(encoded); // 92539817-7989-4083-ab80-e9c2b2b66669
+ *
+ * expect(decoded).toEqual(uuid);
+ * ```
+ *
+ * @param encoded base58 encoded UUID
+ * @returns the expanded UUID from the base58 encoded value
+ */
+export function decodeBase58ToUUID(encoded) {
+    let decoded = 0n;
+    for (const char of encoded) {
+        const index = BASE58_ALLOWED_CHARS.indexOf(char);
+        if (index === -1) {
+            throw new Error('Invalid Base58 character');
+        }
+        decoded = decoded * 58n + BigInt(index);
+    }
+    // Convert the bigint to a hex string, padded to 32 characters
+    let hexStr = decoded.toString(16);
+    hexStr = hexStr.padStart(32, '0'); // Ensure it is 32 characters
+    return [hexStr.slice(0, 8), hexStr.slice(8, 12), hexStr.slice(12, 16), hexStr.slice(16, 20), hexStr.slice(20)].join('-');
+}
+//# sourceMappingURL=base58.js.map

package/dist/src/core/base58.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.js","sourceRoot":"","sources":["../../../src/core/base58.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,4DAA4D,CAAC;AAIjG;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAC/B,IAAI,SAAS,GAAG,GAAG,CAAC;IACpB,MAAM,MAAM,GAAa,EAAE,CAAC,CAAC,2CAA2C;IAExE,OAAO,SAAS,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,SAAS,GAAG,GAAG,CAAC;QAC5B,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,CAAC;QACD,SAAS,GAAG,SAAS,GAAG,GAAG,CAAC;IAC9B,CAAC;IAED,oEAAoE;IACpE,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC;AAID;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,GAAG,OAAO,GAAG,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,8DAA8D;IAC9D,IAAI,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,6BAA6B;IAEhE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CACjH,GAAG,CACJ,CAAC;AACJ,CAAC"}

package/dist/src/core/base58.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base58.test.d.ts.map

package/dist/src/core/base58.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.test.d.ts","sourceRoot":"","sources":["../../../src/core/base58.test.ts"],"names":[],"mappings":""}

package/dist/src/core/base58.test.js

@@ -0,0 +1,17 @@
+import { v4 } from 'uuid';
+import { describe, expect, it } from 'vitest';
+import { decodeBase58ToUUID, encodeBase58 } from './base58.js';
+describe('base58', () => {
+    it('should be able to encoded a UUID to base58 and then decode it back to its original UUID', () => {
+        const expected = v4();
+        const given = expected.replaceAll(/-/g, '');
+        const encoded = encodeBase58(given);
+        // We check the length should be 22 in the ID.generate() function and
+        // re-run encodeBase58 if not.
+        expect(encoded.length === 22 || encoded.length === 21).toBe(true);
+        const decoded = decodeBase58ToUUID(encoded);
+        expect(decoded).toHaveLength(expected.length);
+        expect(decoded).toEqual(expected);
+    });
+});
+//# sourceMappingURL=base58.test.js.map

package/dist/src/core/base58.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.test.js","sourceRoot":"","sources":["../../../src/core/base58.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,yFAAyF,EAAE,GAAG,EAAE;QACjG,MAAM,QAAQ,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpC,qEAAqE;QACrE,8BAA8B;QAC9B,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,EAAE,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElE,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/core/blocks/data.d.ts

@@ -0,0 +1,34 @@
+/**
+ * This module provides utility functions for working with data blocks
+ * in TypeScript.
+ *
+ * @since 0.0.6
+ */
+import type { Op } from '@geoprotocol/grc-20';
+type DataBlockSourceType = 'QUERY' | 'COLLECTION' | 'GEO';
+type DataBlockParams = {
+    fromId: string;
+    sourceType: DataBlockSourceType;
+    position?: string;
+    name?: string;
+};
+/**
+ * Returns the ops to create an entity representing a Data Block.
+ *
+ * @example
+ * ```ts
+ * const ops = DataBlock.make({
+ *   fromId: 'from-id',
+ *   sourceType: 'COLLECTION',
+ *   // optional
+ *   position: 'position-string',
+ *   name: 'name',
+ * });
+ * ```
+ *
+ * @param param args {@link TextBlockParams}
+ * @returns ops – The ops for the Data Block entity: {@link Op}[]
+ */
+export declare function make({ fromId, sourceType, position, name }: DataBlockParams): Op[];
+export {};
+//# sourceMappingURL=data.d.ts.map

package/dist/src/core/blocks/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../../src/core/blocks/data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAQ9C,KAAK,mBAAmB,GAAG,OAAO,GAAG,YAAY,GAAG,KAAK,CAAC;AAa1D,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,mBAAmB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,eAAe,GAAG,EAAE,EAAE,CAyClF"}