@1shotapi/ows-clear-signing 0.0.0-stage → 0.2.0

package/dist/ClearSigningValue.js

@@ -0,0 +1,231 @@
+import { bytesToHex, getAddress, hexToBytes, isHex, numberToBytes, stringToBytes, } from "viem";
+import { ClearSigningCanonicalString, EVMAccountAddress } from "@1shotapi/ows-types";
+import { ClearSigningError } from "./ClearSigningError.js";
+export var EClearSigningValueKind;
+(function (EClearSigningValueKind) {
+    /** Decoded primitive: bigint (int/uint), string (address/bytes/string), boolean. */
+    EClearSigningValueKind["Leaf"] = "leaf";
+    EClearSigningValueKind["Array"] = "array";
+    EClearSigningValueKind["Struct"] = "struct";
+    /** Literal from the descriptor (`value`, `$.` references, constant params). */
+    EClearSigningValueKind["Constant"] = "constant";
+})(EClearSigningValueKind || (EClearSigningValueKind = {}));
+const ARRAY_SUFFIX = /\[(\d*)\]$/;
+/**
+ * Decoded structured data with its Solidity / EIP-712 type kept alongside, so path slices
+ * and formatters know how to interpret each value (e.g. a slice of a `uint256` vs `bytes`).
+ */
+export class ClearSigningValue {
+    kind;
+    type;
+    value;
+    constructor(kind, 
+    /** Solidity type for leaves (`uint256`, `address`, `bytes`, …); struct/array type otherwise. */
+    type, value) {
+        this.kind = kind;
+        this.type = type;
+        this.value = value;
+    }
+    static constant(value) {
+        return new ClearSigningValue(EClearSigningValueKind.Constant, "", value);
+    }
+    static leaf(type, value) {
+        return new ClearSigningValue(EClearSigningValueKind.Leaf, type, ClearSigningValue.normalizeLeaf(type, value));
+    }
+    static struct(type, members) {
+        return new ClearSigningValue(EClearSigningValueKind.Struct, type, members);
+    }
+    /** Build the `#` root from viem `decodeFunctionData` args and the function inputs. */
+    static fromAbiArguments(inputs, args) {
+        const members = {};
+        inputs.forEach((input, i) => {
+            members[input.name || String(i)] = ClearSigningValue.fromAbi(input, args[i]);
+        });
+        return ClearSigningValue.struct("", members);
+    }
+    /** Build the `#` root from an EIP-712 message. */
+    static fromTypedData(types, primaryType, message) {
+        return ClearSigningValue.fromEip712(types, primaryType, message);
+    }
+    static fromAbi(param, raw) {
+        const arrayMatch = ARRAY_SUFFIX.exec(param.type);
+        if (arrayMatch) {
+            if (!Array.isArray(raw)) {
+                throw new ClearSigningError(`Expected array for ${param.type}`);
+            }
+            const element = {
+                ...param,
+                type: param.type.slice(0, arrayMatch.index),
+            };
+            return new ClearSigningValue(EClearSigningValueKind.Array, param.type, raw.map((item) => ClearSigningValue.fromAbi(element, item)));
+        }
+        if (param.type === "tuple") {
+            const components = "components" in param ? param.components : [];
+            const source = raw;
+            const members = {};
+            components.forEach((component, i) => {
+                const name = component.name || String(i);
+                const item = component.name && source[component.name] !== undefined
+                    ? source[component.name]
+                    : source[i];
+                members[name] = ClearSigningValue.fromAbi(component, item);
+            });
+            return ClearSigningValue.struct("tuple", members);
+        }
+        return ClearSigningValue.leaf(param.type, raw);
+    }
+    static fromEip712(types, type, raw) {
+        const arrayMatch = ARRAY_SUFFIX.exec(type);
+        if (arrayMatch) {
+            if (!Array.isArray(raw)) {
+                throw new ClearSigningError(`Expected array for ${type}`);
+            }
+            const elementType = type.slice(0, arrayMatch.index);
+            return new ClearSigningValue(EClearSigningValueKind.Array, type, raw.map((item) => ClearSigningValue.fromEip712(types, elementType, item)));
+        }
+        const structFields = types[type];
+        if (structFields) {
+            if (raw === null || typeof raw !== "object") {
+                throw new ClearSigningError(`Expected struct for ${type}`);
+            }
+            const source = raw;
+            const members = {};
+            for (const field of structFields) {
+                members[field.name] = ClearSigningValue.fromEip712(types, field.type, source[field.name]);
+            }
+            return ClearSigningValue.struct(type, members);
+        }
+        return ClearSigningValue.leaf(type, raw);
+    }
+    static normalizeLeaf(type, value) {
+        if (/^u?int\d*$/.test(type)) {
+            if (typeof value === "bigint" ||
+                typeof value === "number" ||
+                (typeof value === "string" && value.trim() !== "")) {
+                try {
+                    return BigInt(value);
+                }
+                catch {
+                    // fall through
+                }
+            }
+            throw new ClearSigningError(`Invalid ${type} value`);
+        }
+        if (type === "address") {
+            if (typeof value !== "string" || !/^0x[0-9a-fA-F]{40}$/.test(value)) {
+                throw new ClearSigningError("Invalid address value");
+            }
+            return getAddress(value);
+        }
+        if (type === "bool")
+            return Boolean(value);
+        if (type === "string")
+            return String(value ?? "");
+        if (type.startsWith("bytes")) {
+            if (typeof value !== "string" || !isHex(value)) {
+                throw new ClearSigningError(`Invalid ${type} value`);
+            }
+            return value.toLowerCase();
+        }
+        return value;
+    }
+    get isInteger() {
+        return this.kind === EClearSigningValueKind.Leaf && typeof this.value === "bigint";
+    }
+    /** Bytes view of a leaf, used by path slices. */
+    toBytes() {
+        if (this.kind === EClearSigningValueKind.Leaf) {
+            if (typeof this.value === "bigint") {
+                const v = this.value < 0n ? (1n << 256n) + this.value : this.value;
+                return numberToBytes(v, { size: 32 });
+            }
+            if (typeof this.value === "boolean")
+                return new Uint8Array([this.value ? 1 : 0]);
+            if (this.type === "string")
+                return stringToBytes(this.value);
+            if (typeof this.value === "string" && isHex(this.value)) {
+                return hexToBytes(this.value);
+            }
+        }
+        if (this.kind === EClearSigningValueKind.Constant && typeof this.value === "string") {
+            if (isHex(this.value))
+                return hexToBytes(this.value);
+            return stringToBytes(this.value);
+        }
+        throw new ClearSigningError("Value cannot be sliced");
+    }
+    /** Byte slice of a leaf → `bytes` leaf (spec: slices on primitives select bytes). */
+    sliceBytes(start, end) {
+        const bytes = this.toBytes();
+        const sliced = bytes.slice(ClearSigningValue.sliceIndex(start, bytes.length, 0), ClearSigningValue.sliceIndex(end, bytes.length, bytes.length));
+        return ClearSigningValue.leaf("bytes", bytesToHex(sliced));
+    }
+    static sliceIndex(index, length, fallback) {
+        if (index === undefined)
+            return fallback;
+        const resolved = index < 0 ? length + index : index;
+        return Math.max(0, Math.min(length, resolved));
+    }
+    /** Interpret as an unsigned/signed integer (ints, byte strings, numeric constants). */
+    asBigInt() {
+        const v = this.value;
+        if (typeof v === "bigint")
+            return v;
+        if (typeof v === "number" && Number.isInteger(v))
+            return BigInt(v);
+        if (typeof v === "string") {
+            if (v === "0x" || v === "")
+                return 0n;
+            if (isHex(v) || /^-?[0-9]+$/.test(v))
+                return BigInt(v);
+        }
+        if (typeof v === "boolean")
+            return v ? 1n : 0n;
+        throw new ClearSigningError("Value is not numeric");
+    }
+    /** Interpret as an address (address leaves, ≥20-byte slices → last 20 bytes, uint → low 160 bits). */
+    asAddress() {
+        const v = this.value;
+        if (typeof v === "string" && /^0x[0-9a-fA-F]{40}$/.test(v)) {
+            return EVMAccountAddress(getAddress(v));
+        }
+        if (typeof v === "bigint") {
+            const low = v & ((1n << 160n) - 1n);
+            return EVMAccountAddress(getAddress(`0x${low.toString(16).padStart(40, "0")}`));
+        }
+        if (typeof v === "string" && isHex(v)) {
+            const bytes = hexToBytes(v);
+            if (bytes.length >= 20) {
+                return EVMAccountAddress(getAddress(bytesToHex(bytes.slice(bytes.length - 20))));
+            }
+        }
+        throw new ClearSigningError("Value is not an address");
+    }
+    /** Canonical rendering of a primitive (decimal ints, `true`/`false`, strings as-is, JSON otherwise). */
+    static canonical(v) {
+        if (typeof v === "bigint")
+            return ClearSigningCanonicalString(v.toString());
+        if (typeof v === "boolean")
+            return ClearSigningCanonicalString(v ? "true" : "false");
+        if (typeof v === "string")
+            return ClearSigningCanonicalString(v);
+        if (v === null || v === undefined)
+            return ClearSigningCanonicalString("");
+        return ClearSigningCanonicalString(JSON.stringify(v));
+    }
+    /** Canonical raw rendering (decimal ints, checksummed addresses, hex bytes, utf-8 strings). */
+    toRawString() {
+        switch (this.kind) {
+            case EClearSigningValueKind.Leaf:
+            case EClearSigningValueKind.Constant:
+                return ClearSigningValue.canonical(this.value);
+            case EClearSigningValueKind.Array:
+                return ClearSigningCanonicalString(`[${this.value.map((v) => v.toRawString()).join(", ")}]`);
+            case EClearSigningValueKind.Struct:
+                return ClearSigningCanonicalString(`{${Object.entries(this.value)
+                    .map(([k, v]) => `${k}: ${v.toRawString()}`)
+                    .join(", ")}}`);
+        }
+    }
+}
+//# sourceMappingURL=ClearSigningValue.js.map

package/dist/ClearSigningValue.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { ClearSigningFormatter } from "./ClearSigningFormatter.js";
+export { ClearSigningUtils } from "./ClearSigningUtils.js";
+export { ClearSigningError } from "./ClearSigningError.js";
+export { EClearSigningDisplayKind, type IClearSigningDisplay, type IClearSigningDisplayField, type IClearSigningEnvironment, type IClearSigningIntentDetail, type IClearSigningTokenMetadata, type IClearSigningTransaction, type IClearSigningTypedData, type IClearSigningTypedDataField, } from "./interfaces.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,GACjC,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { ClearSigningFormatter } from "./ClearSigningFormatter.js";
+export { ClearSigningUtils } from "./ClearSigningUtils.js";
+export { ClearSigningError } from "./ClearSigningError.js";
+export { EClearSigningDisplayKind, } from "./interfaces.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,wBAAwB,GASzB,MAAM,iBAAiB,CAAC"}

package/dist/interfaces.d.ts

@@ -0,0 +1,83 @@
+import type { ClearSigningCanonicalString, EVMAccountAddress, EVMChainId, EVMContractAddress, HexString } from "@1shotapi/ows-types";
+/** Kind of rendered value, so the UI can pick an affordance (copy button, token icon, …). */
+export declare enum EClearSigningDisplayKind {
+    Text = "text",
+    Address = "address",
+    TokenAmount = "tokenAmount",
+    NativeAmount = "nativeAmount",
+    Date = "date",
+    Nft = "nft",
+    Calldata = "calldata"
+}
+/** Transaction being clear-signed (the ERC-7730 EVM transaction container). */
+export interface IClearSigningTransaction {
+    chainId: EVMChainId;
+    from: EVMAccountAddress;
+    to: EVMContractAddress;
+    data: HexString;
+    /** Native value in wei, `0x` hex (as on `eth_sendTransaction`). */
+    value: HexString;
+}
+/** EIP-712 field definition. */
+export interface IClearSigningTypedDataField {
+    name: string;
+    type: string;
+}
+/** EIP-712 payload (structurally compatible with `eth_signTypedData_v4` input). */
+export interface IClearSigningTypedData {
+    types: Record<string, ReadonlyArray<IClearSigningTypedDataField>>;
+    primaryType: string;
+    domain: Record<string, unknown>;
+    message: Record<string, unknown>;
+}
+/** Token symbol + decimals used by `amount` / `tokenAmount` / `tokenTicker`. */
+export interface IClearSigningTokenMetadata {
+    symbol: string;
+    decimals: number;
+}
+/**
+ * Wallet-supplied lookups. The formatter never does network I/O itself; implementations may
+ * read local registries, on-chain ERC-20 metadata, address books, etc. Return `null` when
+ * unknown; the formatter falls back to raw values with a warning.
+ */
+export interface IClearSigningEnvironment {
+    getTokenMetadata(chainId: EVMChainId, address: EVMContractAddress): Promise<IClearSigningTokenMetadata | null>;
+    getNativeCurrency(chainId: EVMChainId): IClearSigningTokenMetadata;
+    getChainName(chainId: EVMChainId): string | null;
+    getAddressName(chainId: EVMChainId, address: EVMAccountAddress): Promise<string | null>;
+}
+/** One rendered row. */
+export interface IClearSigningDisplayField {
+    label: string;
+    /** Formatted value for display. */
+    value: string;
+    /** Unformatted value (decimal integers, checksummed addresses, hex bytes) for a raw view. */
+    rawValue: ClearSigningCanonicalString;
+    kind: EClearSigningDisplayKind;
+    /** Set for address-like values (addressName, raw address, calldata callee, nft collection). */
+    address: EVMAccountAddress | null;
+    /** Set for token-denominated values. */
+    tokenAddress: EVMContractAddress | null;
+    /** Non-fatal caveat to surface next to the value (e.g. "Unknown token"). */
+    warning: string | null;
+    /** `visible: "optional"` — UI may collapse it. */
+    optional: boolean;
+}
+/** Label/value pair from an object-form `intent`. */
+export interface IClearSigningIntentDetail {
+    label: string;
+    value: string;
+}
+/** Fully rendered clear-signing screen model. */
+export interface IClearSigningDisplay {
+    /** Plain intent; for object intents, the values joined with " · ". */
+    intent: string;
+    intentDetails: IClearSigningIntentDetail[];
+    /** `interpolatedIntent` rendered, or `null` if absent or any interpolation failed. */
+    interpolatedIntent: string | null;
+    contractName: string | null;
+    owner: string | null;
+    url: string | null;
+    fields: IClearSigningDisplayField[];
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAE7B,6FAA6F;AAC7F,oBAAY,wBAAwB;IAClC,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,QAAQ,aAAa;CACtB;AAED,+EAA+E;AAC/E,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,iBAAiB,CAAC;IACxB,EAAE,EAAE,kBAAkB,CAAC;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,mEAAmE;IACnE,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,gCAAgC;AAChC,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,gFAAgF;AAChF,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,CACd,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;IAC9C,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,0BAA0B,CAAC;IACnE,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;IACjD,cAAc,CACZ,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAwB;AACxB,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,QAAQ,EAAE,2BAA2B,CAAC;IACtC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,+FAA+F;IAC/F,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,wCAAwC;IACxC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,yBAAyB,EAAE,CAAC;IAC3C,sFAAsF;IACtF,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACrC"}

package/dist/interfaces.js

@@ -0,0 +1,12 @@
+/** Kind of rendered value, so the UI can pick an affordance (copy button, token icon, …). */
+export var EClearSigningDisplayKind;
+(function (EClearSigningDisplayKind) {
+    EClearSigningDisplayKind["Text"] = "text";
+    EClearSigningDisplayKind["Address"] = "address";
+    EClearSigningDisplayKind["TokenAmount"] = "tokenAmount";
+    EClearSigningDisplayKind["NativeAmount"] = "nativeAmount";
+    EClearSigningDisplayKind["Date"] = "date";
+    EClearSigningDisplayKind["Nft"] = "nft";
+    EClearSigningDisplayKind["Calldata"] = "calldata";
+})(EClearSigningDisplayKind || (EClearSigningDisplayKind = {}));
+//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAQA,6FAA6F;AAC7F,MAAM,CAAN,IAAY,wBAQX;AARD,WAAY,wBAAwB;IAClC,yCAAa,CAAA;IACb,+CAAmB,CAAA;IACnB,uDAA2B,CAAA;IAC3B,yDAA6B,CAAA;IAC7B,yCAAa,CAAA;IACb,uCAAW,CAAA;IACX,iDAAqB,CAAA;AACvB,CAAC,EARW,wBAAwB,KAAxB,wBAAwB,QAQnC"}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@1shotapi/ows-clear-signing",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "ERC-7730 clear signing for OWS Branding Layers — lookup keys, descriptor verification, calldata / EIP-712 decoding and field formatting",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "test": "node --import tsx --test test/*.test.ts",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@1shotapi/ows-types": "*"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.0",
+    "viem": "^2.52.0"
+  },
+  "keywords": [
+    "ows",
+    "open-wallet-standard",
+    "erc-7730",
+    "clear-signing",
+    "evm",
+    "eip-712"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/1Shot-API/open-wallet.git",
+    "directory": "packages/ows-clear-signing"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}