heimdall-tide 0.1.0

package/dist/esm/wrapper.js

@@ -0,0 +1,225 @@
+export const version = "1";
+export function wrapper(arr) {
+    // If array is only Uint8Arrays - create a TideMemory out of it 
+    // If there is any entry in an array that is another array
+    //     -> Go inside that array and repeat the process
+    if (arr.every(a => a instanceof Uint8Array))
+        return TideMemory.CreateFromArray(arr);
+    else {
+        // Go through each entry
+        arr.forEach((a) => {
+            // If the entry is an array, apply the wappa on it
+            if (Array.isArray(a)) {
+                // Reassign the value of the entry -> to the serialized wrapper
+                a = wrapper(a);
+            }
+            else if (a["value"]) {
+                // Let's check if is a number, boolean or Uint8Array. If none of those, it'll be null
+                const res = encode(a["value"]);
+                if (res) {
+                    // serialized correctly
+                    a = res;
+                }
+                else {
+                    if (typeof a["value"] == "string") {
+                        // Serialize it into Uint8Array
+                        if (!a["encoding"]) {
+                            // No encoding provided
+                            // Let's default to UTF-8
+                            a = encodeStr(a["value"], "UTF-8");
+                        }
+                        else {
+                            a = encodeStr(a["value"], a["encoding"]);
+                        }
+                    }
+                    else
+                        throw 'Unsupported type';
+                }
+            }
+            else
+                throw 'Unexpected format';
+        });
+        if (arr.every(a => a instanceof Uint8Array))
+            return TideMemory.CreateFromArray(arr); // Check to make sure everything was serialized correctly from the wappa
+        else
+            throw 'There was an error encoding all your values';
+    }
+}
+export function encodeStr(str, enc) {
+    switch (enc) {
+        case "UTF-8":
+            return new TextEncoder().encode(str);
+        case "HEX":
+            // 1) Strip 0x prefix
+            let normalized = str.replace(/^0x/i, "");
+            // treat empty as invalid
+            if (normalized.length === 0) {
+                throw new Error("Empty hex string");
+            }
+            // 2) Pad odd length
+            if (normalized.length % 2 !== 0) {
+                normalized = "0" + normalized;
+            }
+            // 3) Validate
+            if (!/^[0-9A-Fa-f]+$/.test(normalized)) {
+                throw new Error("Invalid hex string");
+            }
+            // 4) Parse into bytes
+            const byteCount = normalized.length / 2;
+            const out = new Uint8Array(byteCount);
+            for (let i = 0; i < byteCount; i++) {
+                out[i] = Number.parseInt(normalized.slice(i * 2, i * 2 + 2), 16);
+            }
+            return out;
+        case "B64":
+            const binaryString = atob(str);
+            const len = binaryString.length;
+            const bytes = new Uint8Array(len);
+            for (let i = 0; i < len; i++) {
+                bytes[i] = binaryString.charCodeAt(i);
+            }
+            return bytes;
+        case "B64URL":
+            // 1) Replace URL-safe chars with standard Base64 chars
+            let base64 = str.replace(/-/g, '+').replace(/_/g, '/');
+            // 2) Pad with '=' so length is a multiple of 4
+            const pad = base64.length % 4;
+            if (pad === 2) {
+                base64 += '==';
+            }
+            else if (pad === 3) {
+                base64 += '=';
+            }
+            else if (pad === 1) {
+                // This shouldn’t happen for valid Base64-URL, but just in case…
+                base64 += '===';
+            }
+            // 3) Decode to binary string
+            const binary = atob(base64);
+            // 4) Convert to Uint8Array
+            const ulen = binary.length;
+            const ubytes = new Uint8Array(ulen);
+            for (let i = 0; i < ulen; i++) {
+                ubytes[i] = binary.charCodeAt(i);
+            }
+            return ubytes;
+        default:
+            // catches anything else (should never happen)
+            throw new TypeError(`Unsupported encoding: ${enc}`);
+    }
+}
+export function encode(data) {
+    switch (typeof data) {
+        case 'number':
+            const buffer = new ArrayBuffer(4);
+            const view = new DataView(buffer);
+            view.setUint32(0, data, true);
+            return new Uint8Array(buffer);
+        case 'boolean':
+            return new Uint8Array([data ? 1 : 0]);
+        case 'object':
+            // since a Uint8Array is an object at runtime, we need to check it here
+            if (data instanceof Uint8Array) {
+                return new Uint8Array(data.slice(0));
+            }
+            // if we fall through, it wasn't one of our allowed types
+            throw new TypeError(`Unsupported object type: ${data}`);
+        default:
+            // catches anything else (should never happen)
+            return undefined;
+    }
+}
+// Tide Memory Object helper functions from tide-js
+export class TideMemory extends Uint8Array {
+    static CreateFromArray(datas) {
+        const length = datas.reduce((sum, next) => sum + next.length, 0);
+        const mem = this.Create(datas[0], length);
+        for (let i = 1; i < datas.length; i++) {
+            mem.WriteValue(i, datas[i]);
+        }
+        return mem;
+    }
+    static Create(initialValue, totalLength, version = 1) {
+        if (totalLength < initialValue.length + 4) {
+            throw new Error("Not enough space to allocate requested data. Make sure to request more space in totalLength than length of InitialValue plus 4 bytes for length.");
+        }
+        // Total buffer length is 4 (version) + totalLength
+        const bufferLength = 4 + totalLength;
+        const buffer = new TideMemory(bufferLength);
+        const dataView = new DataView(buffer.buffer);
+        // Write version at position 0 (4 bytes)
+        dataView.setInt32(0, version, true); // true for little-endian
+        let dataLocationIndex = 4;
+        // Write data length of initialValue at position 4 (4 bytes)
+        dataView.setInt32(dataLocationIndex, initialValue.length, true);
+        dataLocationIndex += 4;
+        // Write initialValue starting from position 8
+        buffer.set(initialValue, dataLocationIndex);
+        return buffer;
+    }
+    WriteValue(index, value) {
+        if (index < 0)
+            throw new Error("Index cannot be less than 0");
+        if (index === 0)
+            throw new Error("Use CreateTideMemory to set value at index 0");
+        if (this.length < 4 + value.length)
+            throw new Error("Could not write to memory. Memory too small for this value");
+        const dataView = new DataView(this.buffer);
+        let dataLocationIndex = 4; // Start after the version number
+        // Navigate through existing data segments
+        for (let i = 0; i < index; i++) {
+            if (dataLocationIndex + 4 > this.length) {
+                throw new RangeError("Index out of range.");
+            }
+            // Read data length at current position
+            const nextDataLength = dataView.getInt32(dataLocationIndex, true);
+            dataLocationIndex += 4;
+            dataLocationIndex += nextDataLength;
+        }
+        // Check if there's enough space to write the value
+        if (dataLocationIndex + 4 + value.length > this.length) {
+            throw new RangeError("Not enough space to write value");
+        }
+        // Check if data has already been written to this index
+        const existingLength = dataView.getInt32(dataLocationIndex, true);
+        if (existingLength !== 0) {
+            throw new Error("Data has already been written to this index");
+        }
+        // Write data length of value at current position
+        dataView.setInt32(dataLocationIndex, value.length, true);
+        dataLocationIndex += 4;
+        // Write value starting from current position
+        this.set(value, dataLocationIndex);
+    }
+    GetValue(index) {
+        // 'a' should be an ArrayBuffer or Uint8Array
+        if (this.length < 4) {
+            throw new Error("Insufficient data to read.");
+        }
+        // Create a DataView for reading integers in little-endian format
+        const dataView = new DataView(this.buffer, this.byteOffset, this.byteLength);
+        // Optional: Read the version if needed
+        // const version = dataView.getInt32(0, true);
+        let dataLocationIndex = 4;
+        for (let i = 0; i < index; i++) {
+            // Check if there's enough data to read the length of the next segment
+            if (dataLocationIndex + 4 > this.length) {
+                throw new RangeError("Index out of range.");
+            }
+            const nextDataLength = dataView.getInt32(dataLocationIndex, true);
+            dataLocationIndex += 4 + nextDataLength;
+        }
+        // Check if there's enough data to read the length of the final segment
+        if (dataLocationIndex + 4 > this.length) {
+            throw new RangeError("Index out of range.");
+        }
+        const finalDataLength = dataView.getInt32(dataLocationIndex, true);
+        dataLocationIndex += 4;
+        // Check if the final data segment is within bounds
+        if (dataLocationIndex + finalDataLength > this.length) {
+            throw new RangeError("Index out of range.");
+        }
+        return this.subarray(dataLocationIndex, dataLocationIndex + finalDataLength);
+    }
+}
+//# sourceMappingURL=wrapper.js.map

package/dist/esm/wrapper.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "heimdall-tide",
+  "version": "0.1.0",
+  "description": "SDK for communicating with a Tide Enclave",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "typings": "dist/esm/index.d.ts",     
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./enclaves/ApprovalEnclave": {
+      "import": "./dist/esm/enclaves/ApprovalEnclave.js",
+      "require": "./dist/cjs/enclaves/ApprovalEnclave.js"
+    },
+    "./enclaves/RequestEnclave": {
+      "import": "./dist/esm/enclaves/RequestEnclave.js",
+      "require": "./dist/cjs/enclaves/RequestEnclave.js"
+    }
+  },
+  "scripts": {
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build": "npm run build:cjs && npm run build:esm"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tide-foundation/heimdall.git"
+  },
+  "keywords": [
+    "tide"
+  ],
+  "author": "Tide",
+  "license": "ISC",
+  "types": "./heimdall.d.ts",
+  "bugs": {
+    "url": "https://github.com/tide-foundation/heimdall/issues"
+  },
+  "homepage": "https://github.com/tide-foundation/heimdall#readme",
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  }
+}

package/src/enclaves/ApprovalEnclave.ts

@@ -0,0 +1,63 @@
+import {Heimdall, windowType} from "../heimdall";
+
+export class ApprovalEnclave extends Heimdall<ApprovalEnclave>{
+    name: string = "approval";
+    _windowType: windowType = windowType.Popup;
+    private acceptedAdminIds: string[];
+    enclaveUrl: URL;
+    private initDone: Promise<any>;
+
+    init(data: string[], enclaveUrl: string): ApprovalEnclave {
+        this.acceptedAdminIds = data;
+        this.enclaveUrl = new URL(enclaveUrl);
+        this.initDone = this.open();
+        return this;
+    }
+
+    async getAuthorizerAuthentication() {
+        await this.initDone;
+        // ready to accept reply
+        const pre_response = this.recieve("authentication");
+
+        // send to enclave
+        this.send({
+            type: "authentication",
+            message: "pretty please"
+        });
+
+        // wait for response - this does not mean that enclave it closed, just that the admin has responded to the approval request from the enclave
+        return await pre_response;
+    }
+
+    
+    async getAuthorizerApproval(draftToApprove, modelId, expiry, encoding = "bytes", authflow = "") {
+        await this.initDone;
+        // ready to accept reply
+        const pre_response = this.recieve("approval");
+
+        // send to enclave
+        this.send({
+            type: "approval",
+            message: {
+                draftToAuthorize: {
+                    data: draftToApprove,
+                    encoding: encoding
+                },
+                modelId: modelId,
+                expiry: expiry,
+                authflow: authflow
+            }
+        });
+
+        // wait for response - this does not mean that enclave it closed, just that the admin has responded to the approval request from the enclave
+        return await pre_response;
+    }
+
+    getOrkUrl() { 
+        // how to create approval ork url for openinging enclave?
+        this.enclaveUrl.searchParams.set("type", "approval");
+        this.enclaveUrl.searchParams.set("acceptedIds", JSON.stringify(this.acceptedAdminIds));
+        return this.enclaveUrl;
+    }
+    
+}

package/src/enclaves/RequestEnclave.ts

@@ -0,0 +1,237 @@
+import { Heimdall, windowType } from "../heimdall";
+import { TideMemory } from "../wrapper";
+
+interface HiddenInit{
+    doken: string;
+    /**
+     * @returns A refresh doken for Heimdall
+     */
+    dokenRefreshCallback: () => Promise<string> | undefined;
+    /**
+     * @returns A function that re authenticates the current user from the client. (Used to update their session key on Identity System). Returns a new doken too.
+     */
+    requireReloginCallback: () => Promise<string>;
+}
+
+export class RequestEnclave extends Heimdall<RequestEnclave>{
+    private doken: string;
+    private dokenRefreshCallback: () => Promise<string> | undefined;
+    private requireReloginCallback: () => Promise<string>;
+
+    _windowType: windowType = windowType.Hidden;
+
+    private initDone: Promise<any> = this.recieve("init done");
+
+    init(data: HiddenInit): RequestEnclave {
+        if(!data.doken) throw 'Doken not provided';
+
+        this.doken = data.doken;
+        this.dokenRefreshCallback = data.dokenRefreshCallback;
+        this.requireReloginCallback = data.requireReloginCallback;
+
+        this.recieve("hidden enclave").then((data) => this.handleHiddenEnclaveResponse(data));
+
+        this.open().then((success: boolean) => {
+            if(success){
+                this.send({
+                    type: "init",
+                    message: {
+                        doken: this.doken
+                    }
+                });
+            }else throw 'Error opening enclave';
+        });
+
+        return this;
+    }
+
+    async handleHiddenEnclaveResponse(msg: any){
+        // Below is the session key mismatch flow that was implemented but then it was decided a basic relogin was more elegent
+        // Keeping it though because it is nearly identical to the flow where a tide user delegates a token to another tide user
+        // This would require the second tide user to sign a new delegated token with their current session key 
+        // This would be gold in a cvk scenario
+        // if(msg == "session key mismatch" && this._windowType == windowType.Hidden){
+        //     this.initDone = this.recieve("init done"); // await the REOPENED HIDDEN ENCLAVE INIT DONE SIGNAL
+        //     // looks like the hidden iframe has not allowed data to be stored on the browser OR the session key is mismatched with whats on the enclave vs doken
+        //     // either way we gotta get a doken with the appropriate session key
+
+        //     // Close the hidden enclave
+        //     this.close();
+
+        //     // We're now going to open the request enclave as a popup with the mismatched doken
+        //     // The page should recognise the doken is mismatched, generate a new one, then close
+        //     this._windowType = windowType.Popup;
+
+        //     // open popup
+        //     await this.open();
+        //     // send doken to refresh
+        //     this.send({
+        //         type: "init",
+        //         message:{
+        //             doken: this.doken
+        //         }
+        //     });
+        //     // wait for new doken
+        //     const resp = await this.recieve("refreshed doken"); 
+        //     this.doken = resp.doken;
+        //     if(this.requireReloginCallback) this.requireReloginCallback();
+
+        //     // close pop up enclave
+        //     this.close();
+
+        //     // reset page to hidden iframe
+        //     this._windowType = windowType.Hidden;
+        //     // open hidden iframe
+        //     this.open().then((success: boolean) => {
+        //         if(success){
+        //             this.send({
+        //                 type: "init",
+        //                 message: {
+        //                     doken: this.doken
+        //                 }
+        //             });
+        //         }else throw 'Error opening enclave';
+        //     });
+
+        // }
+        if(msg == "session key mismatch"){
+            this.requireReloginCallback(); // should initiate a full client page reload, killing this
+        }
+
+        this.recieve("hidden enclave").then((data) => this.handleHiddenEnclaveResponse(data));
+    }
+
+    getOrkUrl(): URL {
+        // construct ork url
+        const url = new URL(this.enclaveOrigin);
+
+        // Set hidden status
+        url.searchParams.set("hidden", this._windowType == windowType.Hidden ? "true" : "false");
+
+        // Set vendor public
+        url.searchParams.set("vendorId", this.vendorId);
+
+        // Set client origin
+        url.searchParams.set("origin", encodeURIComponent(window.location.origin));
+
+        // Set client origin signature (by vendor)
+        url.searchParams.set("originsig", encodeURIComponent(this.signed_client_origin));
+
+        // Set voucher url
+        url.searchParams.set("voucherURL", encodeURIComponent(this.voucherURL));
+
+        // Set requestsed enclave
+        url.searchParams.set("type", "request");
+
+        return url;
+    }
+    checkEnclaveOpen(){
+        if(this.enclaveClosed()){
+            // Enclave was closed!
+            // We need to reopen the enclave and await the init again
+            this.initDone = this.recieve("init done");
+            this.open().then((success: boolean) => {
+                if(success){
+                    this.send({
+                        type: "init",
+                        message:{
+                            doken: this.doken
+                        }
+                    });
+                }else throw 'Error opening enclave';
+            });
+        }
+    }
+
+    async execute(data: TideMemory): Promise<Uint8Array[]>{
+        this.checkEnclaveOpen();
+        await this.initDone;
+        const pre_resp = this.recieve("sign request completed");
+        this.send({
+            type: "request",
+            message:{
+                flow: "sign",
+                request: data,
+            }
+        })
+        const resp = await pre_resp;
+        if(!Array.isArray(resp)) throw 'Expecting request completed data to be an array, not' + resp;
+        if(!resp.every((d: any) => d instanceof Uint8Array)) throw 'Expecting all entries in response to be Uint8Arrays';
+        return resp;
+    }
+    async decrypt(data: decryptRequest): Promise<Uint8Array[]>{
+        this.checkEnclaveOpen();
+        await this.initDone;
+        const pre_resp = this.recieve("decrypt request completed");
+        this.send({
+            type: "request",
+            message:{
+                flow: "decrypt",
+                request: data
+            }
+        })
+        const resp = await pre_resp;
+        if(!Array.isArray(resp)) throw 'Expecting request completed data to be an array, not' + resp;
+        if(!resp.every((d: any) => d instanceof Uint8Array)) throw 'Expecting all entries in response to be Uint8Arrays';
+        return resp;
+    }
+    async encrypt(data: encryptRequest): Promise<Uint8Array[]>{
+        this.checkEnclaveOpen();
+        await this.initDone;
+        const pre_resp = this.recieve("encrypt request completed");
+        this.send({
+            type: "request",
+            message: {
+                flow: "encrypt",
+                request: data
+            }
+        })
+        const resp = await pre_resp;
+        if(!Array.isArray(resp)) throw 'Expecting request completed data to be an array, not' + resp;
+        if(!resp.every((d: any) => d instanceof Uint8Array)) throw 'Expecting all entries in response to be Uint8Arrays';
+        return resp;
+    }
+
+    async updateDoken(doken: string){
+        this.doken = doken;
+        this.send({
+            type: "doken refresh",
+            message:{
+                doken: this.doken
+            }
+        });
+    }
+
+    async onerror(data: any) {
+        if(typeof data.message === "string"){
+            switch(data.message){
+                case "expired":
+                    if(!this.dokenRefreshCallback){
+                        console.error("[HEIMDALL] Doken on enclave has expired but there is no Doken Refresh Callback registered");
+                        return;
+                    }
+                    console.log("[HEIMDALL] Refreshing doken");
+                    this.doken = await this.dokenRefreshCallback();
+                    this.send({
+                        type: "doken refresh",
+                        message:{
+                            doken: this.doken
+                        }
+                    });
+                    break;
+                default:
+                    this.close();
+                    throw new Error("[HEIMDALL] Recieved enclave error: " + data.message);
+            }
+        }
+    }
+}
+
+interface decryptRequest{
+    encrypted: Uint8Array;
+    tags: string[]
+}
+interface encryptRequest{
+    data: Uint8Array;
+    tags: string[]
+}