@fide.work/fcp 0.0.1

package/README.md

@@ -0,0 +1,19 @@
+# `@fide-work/fcp` (v0)
+
+Minimal FCP SDK focused on deterministic Fide ID derivation.
+
+## Exported API
+
+- `calculateFideID(entityType, sourceEntityType, rawIdentifier)`
+
+## Notes
+
+- Hash algorithm is SHA-256.
+- `rawIdentifier` is UTF-8 encoded inside `calculateFideID`.
+- Output format is `did:fide:0x{type}{source}{fingerprint}`.
+- Fingerprint rule is the last 38 hex chars of the SHA-256 digest.
+- `calculateFideID` is async.
+
+## Golden Vectors
+
+Reference vectors are in `vectors/calculateFideID.v0.json`.

package/dist/calculateFideID.d.ts

@@ -0,0 +1,15 @@
+export declare const TYPE_MAP: {
+    readonly Statement: "0";
+    readonly Attestation: "a";
+    readonly EvaluationMethod: "e";
+    readonly Person: "1";
+    readonly Organization: "2";
+    readonly Place: "3";
+    readonly Event: "4";
+    readonly Product: "5";
+    readonly CreativeWork: "6";
+    readonly AutonomousAgent: "7";
+    readonly CryptographicAccount: "8";
+};
+export type FideEntityType = keyof typeof TYPE_MAP;
+export declare function calculateFideID(entityType: FideEntityType, sourceEntityType: FideEntityType, rawIdentifier: string): Promise<`did:fide:0x${string}`>;

package/dist/calculateFideID.js

@@ -0,0 +1,43 @@
+export const TYPE_MAP = {
+    Statement: "0",
+    Attestation: "a",
+    EvaluationMethod: "e",
+    Person: "1",
+    Organization: "2",
+    Place: "3",
+    Event: "4",
+    Product: "5",
+    CreativeWork: "6",
+    AutonomousAgent: "7",
+    CryptographicAccount: "8"
+};
+async function getSubtleCrypto() {
+    if (globalThis.crypto?.subtle) {
+        return globalThis.crypto.subtle;
+    }
+    const { webcrypto } = await import("node:crypto");
+    return webcrypto.subtle;
+}
+function isStatementFideID(value) {
+    return /^did:fide:0x00[0-9a-f]{38}$/i.test(value) || /^0x00[0-9a-f]{38}$/i.test(value);
+}
+export async function calculateFideID(entityType, sourceEntityType, rawIdentifier) {
+    if (typeof rawIdentifier !== "string") {
+        throw new TypeError(`Invalid rawIdentifier: expected string, got ${typeof rawIdentifier}`);
+    }
+    if ((entityType === "Statement" && sourceEntityType !== "Statement") ||
+        (entityType === "Attestation" && sourceEntityType !== "Attestation")) {
+        throw new Error(`Protocol entity ${entityType} must be self-sourced. Expected source type: ${entityType}, got: ${sourceEntityType}`);
+    }
+    if (sourceEntityType === "Statement" && entityType !== "Statement" && !isStatementFideID(rawIdentifier)) {
+        throw new Error(`Invalid Statement source for ${entityType}: rawIdentifier must be a Statement Fide ID (did:fide:0x00... or 0x00...).`);
+    }
+    const subtle = await getSubtleCrypto();
+    const bytes = new TextEncoder().encode(rawIdentifier);
+    const digest = await subtle.digest("SHA-256", bytes);
+    const hashHex = Array.from(new Uint8Array(digest))
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+    const fingerprint = hashHex.slice(-38);
+    return `did:fide:0x${TYPE_MAP[entityType]}${TYPE_MAP[sourceEntityType]}${fingerprint}`;
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { TYPE_MAP, calculateFideID, type FideEntityType } from "./calculateFideID.js";

package/dist/index.js

@@ -0,0 +1 @@
+export { TYPE_MAP, calculateFideID } from "./calculateFideID.js";

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@fide.work/fcp",
+  "version": "0.0.1",
+  "description": "Fide Context Protocol SDK (v0)",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fide-work/fcp.git"
+  },
+  "homepage": "https://github.com/fide-work/fcp",
+  "keywords": [
+    "fide",
+    "fcp",
+    "did",
+    "identity",
+    "sha256"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "vectors"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "pnpm run build && node scripts/check-vectors.mjs"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.9.3"
+  }
+}

package/vectors/calculateFideID.v0.json

@@ -0,0 +1,28 @@
+{
+  "version": "v0",
+  "algorithm": "SHA-256",
+  "fingerprintRule": "last-38-hex-chars",
+  "cases": [
+    {
+      "name": "person-product-url",
+      "entityType": "Person",
+      "sourceEntityType": "Product",
+      "rawIdentifier": "https://x.com/alice",
+      "expectedFideID": "did:fide:0x152f02f1d1c1e62b2e569e11818420c1968be3d9"
+    },
+    {
+      "name": "person-product-unicode",
+      "entityType": "Person",
+      "sourceEntityType": "Product",
+      "rawIdentifier": "Alice 🚀",
+      "expectedFideID": "did:fide:0x1515bbb7d07cd07283b643b8bc179fc841ceff36"
+    },
+    {
+      "name": "statement-statement-empty",
+      "entityType": "Statement",
+      "sourceEntityType": "Statement",
+      "rawIdentifier": "",
+      "expectedFideID": "did:fide:0x006fb92427ae41e4649b934ca495991b7852b855"
+    }
+  ]
+}