@totemsdk/edge 0.1.0 → 0.1.1

package/src/ports.ts

@@ -1,75 +0,0 @@
-/**
- * Port interfaces for @totemsdk/edge.
- *
- * All ports are interfaces only. Callers inject implementations at runtime.
- * @totemsdk/edge ships no proof creation/verification implementations.
- */
-
-import type { EdgeOperationResult } from './types.js';
-
-export interface EdgePaymentPort {
-  pay(params: {
-    recipient: string;
-    amount: string;
-    tokenId?: string;
-    memo?: string;
-  }): Promise<EdgeOperationResult<{ txpowId?: string }>>;
-}
-
-export interface EdgeLiquidityPort {
-  getBalance(address: string): Promise<EdgeOperationResult<{ balance: string; tokenId: string }>>;
-  getUtxos(address: string): Promise<EdgeOperationResult<{ utxos: unknown[] }>>;
-}
-
-export interface EdgeProofPort {
-  createProof(params: {
-    subject: string;
-    claims: unknown[];
-    context?: Record<string, unknown>;
-  }): Promise<EdgeOperationResult<{ proofId: string; proof: unknown }>>;
-
-  verifyProof(params: {
-    proof: unknown;
-    subject?: string;
-  }): Promise<EdgeOperationResult<{ valid: boolean; reason?: string }>>;
-}
-
-export interface EdgeLookupPort {
-  lookup(params: {
-    query: string;
-    kind?: string;
-  }): Promise<EdgeOperationResult<{ results: unknown[] }>>;
-
-  watch(params: {
-    address: string;
-    onUpdate: (data: unknown) => void;
-  }): Promise<EdgeOperationResult<{ unsubscribe: () => void }>>;
-}
-
-export interface EdgePolicyPort {
-  check(params: {
-    action: string;
-    subject: string;
-    context?: Record<string, unknown>;
-  }): Promise<EdgeOperationResult<{ allowed: boolean; reason?: string }>>;
-}
-
-export interface EdgeIdentityPort {
-  resolve(identityId: string): Promise<EdgeOperationResult<{ identity: unknown }>>;
-  verify(proof: unknown): Promise<EdgeOperationResult<{ valid: boolean; address?: string }>>;
-}
-
-export interface EdgeManifestPort {
-  sign(manifest: unknown, seed: Uint8Array, keyIndex: number): Promise<EdgeOperationResult<{ signed: unknown }>>;
-  verify(signed: unknown): Promise<EdgeOperationResult<{ valid: boolean; reason?: string }>>;
-}
-
-export interface EdgeRuntimePorts {
-  payment?: EdgePaymentPort;
-  liquidity?: EdgeLiquidityPort;
-  proof?: EdgeProofPort;
-  lookup?: EdgeLookupPort;
-  policy?: EdgePolicyPort;
-  identity?: EdgeIdentityPort;
-  manifest?: EdgeManifestPort;
-}

package/src/provider.ts

@@ -1,77 +0,0 @@
-/**
- * Provider helper functions for @totemsdk/edge.
- *
- * These functions return data structures only — they do not submit to any registry.
- * Registry, trust-index, watchlist, and lease-coordinator logic remain in
- * @totemsdk/lookup-node and future @totemsdk/proofgraph.
- */
-
-import { sha3_256 } from '@noble/hashes/sha3.js';
-import { toHex } from './canonical.js';
-import { signManifest, computeManifestId } from '@totemsdk/manifest';
-import type { EdgeServiceManifest, SignedManifest } from '@totemsdk/manifest';
-import { bindManifestToIdentity } from '@totemsdk/identity';
-import type { IdentityGraph, ManifestIdentityBinding, IdentityProofVerifier } from '@totemsdk/identity';
-import type { EdgeProviderProfile, EdgeServiceRegistration } from './types.js';
-
-export function createEdgeProviderProfile(opts: {
-  operatorAddress: string;
-  name: string;
-  description?: string;
-  tags?: string[];
-}): EdgeProviderProfile {
-  const { operatorAddress, name, description, tags } = opts;
-  const ts = Date.now();
-  const raw = `edge-provider\0${operatorAddress}\0${name}\0${ts}`;
-  const hash = sha3_256(new TextEncoder().encode(raw));
-  const profileId = `edge:provider:${toHex(hash)}`;
-  return {
-    profileId,
-    operatorAddress,
-    name,
-    ...(description !== undefined ? { description } : {}),
-    tags: tags ?? [],
-    createdAt: ts,
-  };
-}
-
-export function createEdgeServiceRegistration(opts: {
-  profileId: string;
-  serviceId: string;
-  operatorAddress: string;
-  expiresAt?: number;
-  metadata?: Record<string, unknown>;
-}): EdgeServiceRegistration {
-  const { profileId, serviceId, operatorAddress, expiresAt, metadata } = opts;
-  const ts = Date.now();
-  const raw = `edge-svc-reg\0${profileId}\0${serviceId}\0${operatorAddress}\0${ts}`;
-  const hash = sha3_256(new TextEncoder().encode(raw));
-  const registrationId = `edge:registration:${toHex(hash)}`;
-  return {
-    registrationId,
-    profileId,
-    serviceId,
-    operatorAddress,
-    registeredAt: ts,
-    ...(expiresAt !== undefined ? { expiresAt } : {}),
-    ...(metadata !== undefined ? { metadata } : {}),
-  };
-}
-
-export async function createEdgeServiceManifest(
-  manifest: EdgeServiceManifest,
-  seed: Uint8Array,
-  keyIndex: number,
-): Promise<SignedManifest<EdgeServiceManifest>> {
-  return signManifest(manifest, seed, keyIndex);
-}
-
-export async function bindEdgeServiceIdentity(
-  signedManifest: SignedManifest<EdgeServiceManifest>,
-  identityGraph: IdentityGraph,
-  options?: {
-    proofVerifiers?: Record<string, IdentityProofVerifier>;
-  },
-): Promise<ManifestIdentityBinding> {
-  return bindManifestToIdentity(signedManifest, identityGraph, options);
-}

package/src/receipts.ts

@@ -1,60 +0,0 @@
-/**
- * Edge receipt creation and verification.
- *
- * EdgeReceipt is an app/runtime-level receipt. It may reference existing
- * receipt IDs from other layers via relatedManifestId, relatedIdentityId,
- * and payload fields. It does NOT represent chain-level settlement finality.
- *
- * verifyEdgeReceipt always returns a structured EdgeOperationResult, never a bare boolean.
- */
-
-import { sha3_256 } from '@noble/hashes/sha3.js';
-import { canonicalJson, toHex } from './canonical.js';
-import type { EdgeReceipt, EdgeOperationResult } from './types.js';
-
-export function createEdgeReceipt(opts: {
-  kind: string;
-  payload: Record<string, unknown>;
-  relatedManifestId?: string;
-  relatedIdentityId?: string;
-  issuedAt?: number;
-}): EdgeReceipt {
-  const { kind, payload, relatedManifestId, relatedIdentityId } = opts;
-  const issuedAt = opts.issuedAt ?? Date.now();
-
-  const canonical = canonicalJson({ kind, payload, relatedManifestId, relatedIdentityId, issuedAt });
-  const hash = sha3_256(new TextEncoder().encode(canonical));
-  const receiptId = `edge:receipt:${toHex(hash)}`;
-
-  return {
-    receiptId,
-    kind,
-    issuedAt,
-    ...(relatedManifestId !== undefined ? { relatedManifestId } : {}),
-    ...(relatedIdentityId !== undefined ? { relatedIdentityId } : {}),
-    payload,
-  };
-}
-
-export function verifyEdgeReceipt(receipt: unknown): EdgeOperationResult<{ receipt: EdgeReceipt }> {
-  if (!receipt || typeof receipt !== 'object') {
-    return { ok: false, error: 'receipt is not an object', errorCode: 'INVALID_RECEIPT' };
-  }
-
-  const r = receipt as Record<string, unknown>;
-
-  if (typeof r.receiptId !== 'string') {
-    return { ok: false, error: 'receipt.receiptId must be a string', errorCode: 'INVALID_RECEIPT' };
-  }
-  if (typeof r.kind !== 'string') {
-    return { ok: false, error: 'receipt.kind must be a string', errorCode: 'INVALID_RECEIPT' };
-  }
-  if (typeof r.issuedAt !== 'number') {
-    return { ok: false, error: 'receipt.issuedAt must be a number', errorCode: 'INVALID_RECEIPT' };
-  }
-  if (!r.payload || typeof r.payload !== 'object') {
-    return { ok: false, error: 'receipt.payload must be an object', errorCode: 'INVALID_RECEIPT' };
-  }
-
-  return { ok: true, data: { receipt: receipt as EdgeReceipt } };
-}

package/src/runtime.ts

@@ -1,33 +0,0 @@
-/**
- * Edge runtime factory.
- */
-
-import { EDGE_VERSION } from './constants.js';
-import {
-  EdgeCapabilitySet,
-  EdgeCapability,
-  hasCapability,
-  assertCapability,
-} from './capabilities.js';
-import type { EdgeRuntimePorts } from './ports.js';
-import type { EdgeRuntime } from './types.js';
-
-export function createEdgeRuntime(opts: {
-  deviceId: string;
-  capabilities: EdgeCapabilitySet;
-  ports: EdgeRuntimePorts;
-}): EdgeRuntime {
-  const { deviceId, capabilities, ports } = opts;
-  return {
-    version: EDGE_VERSION,
-    deviceId,
-    capabilities,
-    ports,
-    hasCapability(cap: EdgeCapability): boolean {
-      return hasCapability(capabilities, cap);
-    },
-    assertCapability(cap: EdgeCapability): void {
-      assertCapability(capabilities, cap);
-    },
-  };
-}

package/src/types.ts

@@ -1,73 +0,0 @@
-/**
- * @totemsdk/edge — Type definitions
- *
- * Covers devices, apps, agents, sensors, robots, gateways, and services.
- * Adapter-neutral — no ROS2, no MQTT, no Python bindings.
- */
-
-import type { ManifestIdentityBinding } from '@totemsdk/identity';
-import type { SignedManifest, EdgeServiceManifest } from '@totemsdk/manifest';
-
-export type EdgeDeviceKind =
-  | 'device'
-  | 'app'
-  | 'agent'
-  | 'sensor'
-  | 'robot'
-  | 'gateway'
-  | 'service';
-
-export interface EdgeOperationResult<T = unknown> {
-  ok: boolean;
-  data?: T;
-  error?: string;
-  errorCode?: string;
-}
-
-export interface EdgeDevice {
-  deviceId: string;
-  kind: EdgeDeviceKind;
-  identityId?: string;
-  address?: string;
-  metadata?: Record<string, unknown>;
-  createdAt: number;
-}
-
-export interface EdgeRuntime {
-  version: number;
-  deviceId: string;
-  capabilities: import('./capabilities.js').EdgeCapabilitySet;
-  ports: import('./ports.js').EdgeRuntimePorts;
-  hasCapability(cap: import('./capabilities.js').EdgeCapability): boolean;
-  assertCapability(cap: import('./capabilities.js').EdgeCapability): void;
-}
-
-export interface EdgeProviderProfile {
-  profileId: string;
-  operatorAddress: string;
-  name: string;
-  description?: string;
-  tags: string[];
-  createdAt: number;
-}
-
-export interface EdgeServiceRegistration {
-  registrationId: string;
-  profileId: string;
-  serviceId: string;
-  operatorAddress: string;
-  registeredAt: number;
-  expiresAt?: number;
-  metadata?: Record<string, unknown>;
-}
-
-export interface EdgeReceipt {
-  receiptId: string;
-  kind: string;
-  issuedAt: number;
-  relatedManifestId?: string;
-  relatedIdentityId?: string;
-  payload: Record<string, unknown>;
-}
-
-export type { ManifestIdentityBinding, SignedManifest, EdgeServiceManifest };