@otim/sdk-core 0.0.1

package/dist/utils-DziAHBiz.mjs

@@ -0,0 +1,81 @@
+import { toHex, toRlp } from "viem";
+
+//#region src/utils/rlp.ts
+const ensureHexPrefix = (value) => value.startsWith("0x") ? value : `0x${value}`;
+const normalizeYParityValue = (value) => {
+	if (value === void 0 || value === null) return 0;
+	let numericValue;
+	if (typeof value === "number") numericValue = value;
+	else if (typeof value === "bigint") numericValue = Number(value);
+	else if (typeof value === "string") {
+		const trimmed = value.trim();
+		const parsed = trimmed.startsWith("0x") ? parseInt(trimmed, 16) : parseInt(trimmed, 10);
+		if (Number.isNaN(parsed)) throw new Error("invalid yParity value");
+		numericValue = parsed;
+	} else throw new Error("invalid yParity type");
+	return Math.abs(numericValue) % 2 === 0 ? 0 : 1;
+};
+function createRlpEncodedAuthorization(authorizationOrChainId, delegateAddress, nonce, yParity, r, s) {
+	if (typeof authorizationOrChainId === "object") {
+		const authorization = authorizationOrChainId;
+		const normalizedYParity = normalizeYParityValue(authorization.yParity);
+		return toRlp([
+			toHex(authorization.chainId),
+			ensureHexPrefix(authorization.address),
+			authorization.nonce === 0 ? "0x" : toHex(authorization.nonce),
+			normalizedYParity === 0 ? "0x" : toHex(normalizedYParity),
+			authorization.r,
+			authorization.s
+		]);
+	} else {
+		const chainId = authorizationOrChainId;
+		const normalizedYParity = normalizeYParityValue(yParity);
+		return toRlp([
+			toHex(chainId),
+			ensureHexPrefix(delegateAddress),
+			nonce === 0 ? "0x" : toHex(nonce),
+			normalizedYParity === 0 ? "0x" : toHex(normalizedYParity),
+			r,
+			s
+		]);
+	}
+}
+
+//#endregion
+//#region src/utils/vrs.ts
+const isValidV = (v) => {
+	return v === 0 || v === 1 || v === 27 || v === 28 || v >= 35;
+};
+const normalizeV = (v) => {
+	if (!isValidV(v)) return 0;
+	const cmp = v <= 1 ? 1 : 0;
+	const result = v % 2 === cmp;
+	return Number(result) % 2;
+};
+const createEIP2098Signature = (vrs) => {
+	const v = vrs.v;
+	const r = vrs.r;
+	const s = vrs.s;
+	return {
+		yParity: normalizeV(v),
+		r,
+		s
+	};
+};
+const parseSignatureToVRS = (signature) => {
+	if (typeof signature !== "string") throw new Error("Signature must be a string");
+	if (!signature.startsWith("0x")) throw new Error("Signature must start with \"0x\"");
+	if (signature.length !== 132) throw new Error("Signature must be 65 bytes (130 hex chars) plus \"0x\" = 132 total length");
+	const r = signature.slice(2, 66);
+	const s = signature.slice(66, 130);
+	const vHex = signature.slice(130, 132);
+	return {
+		v: parseInt(vHex, 16),
+		r: `0x${r}`,
+		s: `0x${s}`
+	};
+};
+
+//#endregion
+export { normalizeYParityValue as i, parseSignatureToVRS as n, createRlpEncodedAuthorization as r, createEIP2098Signature as t };
+//# sourceMappingURL=utils-DziAHBiz.mjs.map

package/dist/utils-DziAHBiz.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-DziAHBiz.mjs","names":["numericValue: number"],"sources":["../src/utils/rlp.ts","../src/utils/vrs.ts"],"sourcesContent":["import type { Authorization } from \"viem\";\n\nimport { toHex, toRlp } from \"viem\";\n\n/*\n * RLP (recursive length prefix) encoding utilities for EIP-7702 auth tuples.\n * RLP is a serialization format used in Ethereum to encode structured data.\n *\n * EIP-7702 authorizations are encoded as:\n * [chainId, address, nonce, yParity, r, s]\n */\n\n// Ensures the value has a \"0x\" prefix for proper hex encoding.\nconst ensureHexPrefix = (value: string): `0x${string}` =>\n  value.startsWith(\"0x\") ? (value as `0x${string}`) : `0x${value}`;\n\n/*\n * Normalizes yParity to 0 or 1 for EIP-2098 compact signatures.\n * yParity indicate which of two possible points on the elliptic curve was used.\n * Handles various input formats: number, bigint, hex string, or decimal string.\n * - Even values (0, 2, 4, 27, etc.) normalize to 0\n * - Odd values (1, 3, 5, 28, etc.) normalize to 1\n */\nexport const normalizeYParityValue = (\n  value: number | bigint | string | undefined | null,\n): 0 | 1 => {\n  if (value === undefined || value === null) return 0;\n\n  let numericValue: number;\n  if (typeof value === \"number\") {\n    numericValue = value;\n  } else if (typeof value === \"bigint\") {\n    numericValue = Number(value);\n  } else if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    const parsed = trimmed.startsWith(\"0x\")\n      ? parseInt(trimmed, 16)\n      : parseInt(trimmed, 10);\n    if (Number.isNaN(parsed)) throw new Error(\"invalid yParity value\");\n    numericValue = parsed;\n  } else {\n    throw new Error(\"invalid yParity type\");\n  }\n\n  return (Math.abs(numericValue) % 2 === 0 ? 0 : 1) as 0 | 1;\n};\n\n/*\n * Creates an RLP-encoded authorization tuple for EIP-7702 delegations.\n * This encoded value is submitted to the Otim API for processing on-chain.\n *\n * Accepts either:\n * 1. A complete authorization object (from viem)\n * 2. Individual parameters (chainId, address, nonce, signature components)\n *\n * Returns hex-encoded RLP bytes ready for submission.\n */\nexport function createRlpEncodedAuthorization(\n  authorization: Authorization,\n): `0x${string}`;\nexport function createRlpEncodedAuthorization(\n  chainId: number,\n  delegateAddress: string,\n  nonce: number,\n  yParity: number | bigint,\n  r: `0x${string}`,\n  s: `0x${string}`,\n): `0x${string}`;\nexport function createRlpEncodedAuthorization(\n  authorizationOrChainId: Authorization | number,\n  delegateAddress?: string,\n  nonce?: number,\n  yParity?: number | bigint,\n  r?: `0x${string}`,\n  s?: `0x${string}`,\n) {\n  if (typeof authorizationOrChainId === \"object\") {\n    // Authorization object provided - extract fields.\n    const authorization = authorizationOrChainId;\n    const normalizedYParity = normalizeYParityValue(\n      authorization.yParity as unknown as number | bigint | string | undefined,\n    );\n    /**\n     * RLP encoding requires specific format for zero values:\n     * - \"0x\" instead of \"0x00\".\n     */\n    const rlpInput = [\n      toHex(authorization.chainId),\n      ensureHexPrefix(authorization.address),\n      authorization.nonce === 0 ? \"0x\" : toHex(authorization.nonce),\n      normalizedYParity === 0 ? \"0x\" : toHex(normalizedYParity),\n      authorization.r!,\n      authorization.s!,\n    ] as const;\n\n    return toRlp(rlpInput);\n  } else {\n    // Individual parameters provided - construct tuple.\n    const chainId = authorizationOrChainId;\n    const normalizedYParity = normalizeYParityValue(yParity);\n    const rlpInput = [\n      toHex(chainId),\n      ensureHexPrefix(delegateAddress!),\n      nonce === 0 ? \"0x\" : toHex(nonce!),\n      normalizedYParity === 0 ? \"0x\" : toHex(normalizedYParity),\n      r!,\n      s!,\n    ] as const;\n\n    return toRlp(rlpInput);\n  }\n}\n","import type { EIP2098Signature, VRS } from \"@otim/utils/schemas\";\n\n/*\n * Signature utilities for handling ECDSA signature components.\n * VRS = {v, r, s} where:\n * - v: Recovery id (indicates which point on elliptic curve)\n * - r: First 32 bytes of signature\n * - s: Last 32 bytes of signature\n */\n\n/*\n * Checks if the v value is valid according to Ethereum signature standards.\n * - 0/1: EIP-2098 compact format (yParity)\n * - 27/28: Legacy Ethereum format\n * - 35+: EIP-155 format (includes chain id)\n */\nconst isValidV = (v: number): boolean => {\n  return v === 0 || v === 1 || v === 27 || v === 28 || v >= 35;\n};\n\n/*\n * Normalizes v to yParity (0 or 1) for EIP-2098 compact signatures.\n * Handles all v formats: 0/1 (yParity), 27/28 (legacy), 35+ (EIP-155).\n * Returns 0 or 1 based on parity.\n */\nconst normalizeV = (v: number) => {\n  if (!isValidV(v)) return 0;\n\n  const cmp = v <= 1 ? 1 : 0;\n  const result = v % 2 === cmp;\n\n  return Number(result) % 2;\n};\n\n/*\n * Converts a standard VRS signature to EIP-2098 compact format.\n * EIP-2098 uses yParity (0/1) instead of v (27/28 or higher).\n * This saves 1 byte in the signature encoding.\n */\nexport const createEIP2098Signature = (vrs: VRS): EIP2098Signature => {\n  const v = vrs.v;\n  const r = vrs.r as `0x${string}`;\n  const s = vrs.s as `0x${string}`;\n\n  return { yParity: normalizeV(v), r, s };\n};\n\n/*\n * Parses a hex-encoded signature string into VRS components.\n\n * Expects standard Ethereum signature format:\n * 0x + 64 chars (r) + 64 chars (s) + 2 chars (v).\n *\n * Total length: 132 characters (0x + 130 hex chars = 65 bytes).\n *\n * Example: \"0x\" + r (32 bytes) + s (32 bytes) + v (1 byte).\n */\nexport const parseSignatureToVRS = (signature: string): VRS => {\n  if (typeof signature !== \"string\") {\n    throw new Error(\"Signature must be a string\");\n  }\n\n  if (!signature.startsWith(\"0x\")) {\n    throw new Error('Signature must start with \"0x\"');\n  }\n\n  if (signature.length !== 132) {\n    throw new Error(\n      'Signature must be 65 bytes (130 hex chars) plus \"0x\" = 132 total length',\n    );\n  }\n\n  /* Extract components: r (bytes 0-32), s (bytes 32-64), v (byte 64). */\n  const r = signature.slice(2, 66);\n  const s = signature.slice(66, 130);\n  const vHex = signature.slice(130, 132);\n  const v = parseInt(vHex, 16);\n  return { v, r: `0x${r}`, s: `0x${s}` };\n};\n"],"mappings":";;;AAaA,MAAM,mBAAmB,UACvB,MAAM,WAAW,KAAK,GAAI,QAA0B,KAAK;AAS3D,MAAa,yBACX,UACU;AACV,KAAI,UAAU,UAAa,UAAU,KAAM,QAAO;CAElD,IAAIA;AACJ,KAAI,OAAO,UAAU,SACnB,gBAAe;UACN,OAAO,UAAU,SAC1B,gBAAe,OAAO,MAAM;UACnB,OAAO,UAAU,UAAU;EACpC,MAAM,UAAU,MAAM,MAAM;EAC5B,MAAM,SAAS,QAAQ,WAAW,KAAK,GACnC,SAAS,SAAS,GAAG,GACrB,SAAS,SAAS,GAAG;AACzB,MAAI,OAAO,MAAM,OAAO,CAAE,OAAM,IAAI,MAAM,wBAAwB;AAClE,iBAAe;OAEf,OAAM,IAAI,MAAM,uBAAuB;AAGzC,QAAQ,KAAK,IAAI,aAAa,GAAG,MAAM,IAAI,IAAI;;AAwBjD,SAAgB,8BACd,wBACA,iBACA,OACA,SACA,GACA,GACA;AACA,KAAI,OAAO,2BAA2B,UAAU;EAE9C,MAAM,gBAAgB;EACtB,MAAM,oBAAoB,sBACxB,cAAc,QACf;AAcD,SAAO,MATU;GACf,MAAM,cAAc,QAAQ;GAC5B,gBAAgB,cAAc,QAAQ;GACtC,cAAc,UAAU,IAAI,OAAO,MAAM,cAAc,MAAM;GAC7D,sBAAsB,IAAI,OAAO,MAAM,kBAAkB;GACzD,cAAc;GACd,cAAc;GACf,CAEqB;QACjB;EAEL,MAAM,UAAU;EAChB,MAAM,oBAAoB,sBAAsB,QAAQ;AAUxD,SAAO,MATU;GACf,MAAM,QAAQ;GACd,gBAAgB,gBAAiB;GACjC,UAAU,IAAI,OAAO,MAAM,MAAO;GAClC,sBAAsB,IAAI,OAAO,MAAM,kBAAkB;GACzD;GACA;GACD,CAEqB;;;;;;AC7F1B,MAAM,YAAY,MAAuB;AACvC,QAAO,MAAM,KAAK,MAAM,KAAK,MAAM,MAAM,MAAM,MAAM,KAAK;;AAQ5D,MAAM,cAAc,MAAc;AAChC,KAAI,CAAC,SAAS,EAAE,CAAE,QAAO;CAEzB,MAAM,MAAM,KAAK,IAAI,IAAI;CACzB,MAAM,SAAS,IAAI,MAAM;AAEzB,QAAO,OAAO,OAAO,GAAG;;AAQ1B,MAAa,0BAA0B,QAA+B;CACpE,MAAM,IAAI,IAAI;CACd,MAAM,IAAI,IAAI;CACd,MAAM,IAAI,IAAI;AAEd,QAAO;EAAE,SAAS,WAAW,EAAE;EAAE;EAAG;EAAG;;AAazC,MAAa,uBAAuB,cAA2B;AAC7D,KAAI,OAAO,cAAc,SACvB,OAAM,IAAI,MAAM,6BAA6B;AAG/C,KAAI,CAAC,UAAU,WAAW,KAAK,CAC7B,OAAM,IAAI,MAAM,mCAAiC;AAGnD,KAAI,UAAU,WAAW,IACvB,OAAM,IAAI,MACR,4EACD;CAIH,MAAM,IAAI,UAAU,MAAM,GAAG,GAAG;CAChC,MAAM,IAAI,UAAU,MAAM,IAAI,IAAI;CAClC,MAAM,OAAO,UAAU,MAAM,KAAK,IAAI;AAEtC,QAAO;EAAE,GADC,SAAS,MAAM,GAAG;EAChB,GAAG,KAAK;EAAK,GAAG,KAAK;EAAK"}

package/package.json

@@ -0,0 +1,162 @@
+{
+  "name": "@otim/sdk-core",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./account": {
+      "import": {
+        "types": "./dist/account/index.d.mts",
+        "default": "./dist/account/index.mjs"
+      },
+      "require": {
+        "types": "./dist/account/index.d.cts",
+        "default": "./dist/account/index.cjs"
+      }
+    },
+    "./clients": {
+      "import": {
+        "types": "./dist/clients/index.d.mts",
+        "default": "./dist/clients/index.mjs"
+      },
+      "require": {
+        "types": "./dist/clients/index.d.cts",
+        "default": "./dist/clients/index.cjs"
+      }
+    },
+    "./config": {
+      "import": {
+        "types": "./dist/config/index.d.mts",
+        "default": "./dist/config/index.mjs"
+      },
+      "require": {
+        "types": "./dist/config/index.d.cts",
+        "default": "./dist/config/index.cjs"
+      }
+    },
+    "./context": {
+      "import": {
+        "types": "./dist/context/index.d.mts",
+        "default": "./dist/context/index.mjs"
+      },
+      "require": {
+        "types": "./dist/context/index.d.cts",
+        "default": "./dist/context/index.cjs"
+      }
+    },
+    "./utils": {
+      "import": {
+        "types": "./dist/utils/index.d.mts",
+        "default": "./dist/utils/index.mjs"
+      },
+      "require": {
+        "types": "./dist/utils/index.d.cts",
+        "default": "./dist/utils/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "otim",
+    "sdk",
+    "ethereum",
+    "blockchain",
+    "defi",
+    "smart-contracts",
+    "typescript"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/otimlabs/otim-ts-sdk.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/otimlabs/otim-ts-sdk/issues"
+  },
+  "homepage": "https://github.com/otimlabs/otim-ts-sdk#readme",
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@otim/turnkey": "0.0.2-development.0",
+    "@otim/utils": "0.0.2-development.0",
+    "@playwright/test": "^1.56.1",
+    "@types/adm-zip": "^0.5.7",
+    "@types/node": "^24.10.1",
+    "@types/node-fetch": "^2.6.13",
+    "adm-zip": "^0.5.16",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.39.1",
+    "msw": "^2.12.2",
+    "node-fetch": "^3.3.2",
+    "tsdown": "^0.16.5",
+    "typescript-eslint": "^8.47.0",
+    "vitest": "^4.0.10",
+    "@otim/eslint-config": "0.0.1",
+    "@otim/typescript-config": "0.0.0"
+  },
+  "dependencies": {
+    "@t3-oss/env-core": "^0.13.8",
+    "@testing-library/user-event": "^14.6.1",
+    "@turnkey/api-key-stamper": "^0.5.0",
+    "@turnkey/core": "^1.7.0",
+    "@turnkey/sdk-server": "^4.12.0",
+    "@turnkey/viem": "^0.14.13",
+    "@wagmi/connectors": "^7.0.0",
+    "@wagmi/core": "^3.0.0",
+    "abitype": "^1.1.2",
+    "axios": "^1.13.2",
+    "viem": "^2.39.3",
+    "zod": "^4.1.12"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.4",
+    "viem": "2.x"
+  },
+  "peerDependenciesMeta": {
+    "viem": {
+      "optional": false
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "dev:clear": "tsc --watch --pretty --preserveWatchOutput",
+    "lint": "eslint .",
+    "lint:check": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "check-types": "tsc --noEmit",
+    "check-exports": "attw --pack . --format=table --ignore-rules=no-resolution untyped-resolution fallback-condition || true",
+    "clean": "rm -rf dist",
+    "ci": "pnpm run lint:check && pnpm run check-types && pnpm run build && pnpm run check-exports",
+    "test": "vitest run",
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "playwright test",
+    "e2e": "playwright test",
+    "e2e:ui": "playwright test --ui"
+  }
+}