@towns-protocol/utils 0.0.368 → 0.0.369

package/dist/delegate.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Delegate wallet authentication utilities
+ *
+ * These functions support delegate wallet signatures where a primary wallet
+ * authorizes a device/delegate wallet to sign on its behalf with an expiry time.
+ */
+/**
+ * Creates the hash source for delegate authorization signature
+ *
+ * @param devicePublicKey - Uncompressed public key (64 or 65 bytes)
+ * @param expiryEpochMs - Expiry timestamp in milliseconds (0 = no expiry)
+ * @returns Hash source to be signed by primary wallet
+ */
+export declare function riverDelegateHashSrc(devicePublicKey: Uint8Array, expiryEpochMs: bigint): Uint8Array;
+/**
+ * Converts uncompressed public key from string to Uint8Array
+ *
+ * @param publicKey - Public key string starting with '0x04' (132 chars total)
+ * @returns Public key as Uint8Array
+ */
+export declare function publicKeyToUint8Array(publicKey: string): Uint8Array;
+/**
+ * Derives Ethereum address from public key
+ *
+ * @param publicKey - Uncompressed public key (64 or 65 bytes)
+ * @returns 20-byte Ethereum address
+ */
+export declare function publicKeyToAddress(publicKey: Uint8Array): Uint8Array;
+/**
+ * Recovers the primary wallet address from a delegate signature
+ *
+ * This verifies that a delegate wallet was authorized by a primary wallet
+ * by recovering the primary wallet's address from the delegate authorization signature.
+ *
+ * @param params.delegatePubKey - Delegate wallet's public key (string or Uint8Array)
+ * @param params.delegateSig - Signature from primary wallet authorizing the delegate
+ * @param params.expiryEpochMs - Expiry timestamp that was signed
+ * @returns Primary wallet address (20 bytes)
+ */
+export declare function recoverPublicKeyFromDelegateSig(params: {
+    delegatePubKey: Uint8Array | string;
+    delegateSig: Uint8Array;
+    expiryEpochMs: bigint;
+}): Uint8Array;
+//# sourceMappingURL=delegate.d.ts.map

package/dist/delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../src/delegate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAChC,eAAe,EAAE,UAAU,EAC3B,aAAa,EAAE,MAAM,GACtB,UAAU,CAYZ;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAOnE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU,CAMpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACpD,cAAc,EAAE,UAAU,GAAG,MAAM,CAAA;IACnC,WAAW,EAAE,UAAU,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;CACxB,GAAG,UAAU,CAYb"}

package/dist/delegate.js

@@ -0,0 +1,85 @@
+/**
+ * Delegate wallet authentication utilities
+ *
+ * These functions support delegate wallet signatures where a primary wallet
+ * authorizes a device/delegate wallet to sign on its behalf with an expiry time.
+ */
+import { ecrecover, fromRPCSig, hashPersonalMessage } from '@ethereumjs/util';
+import { bin_fromHexString, bin_toHexString } from './binary';
+import { check } from './check';
+import { keccak256 } from 'ethereum-cryptography/keccak';
+import { abytes } from '@noble/hashes/utils';
+// Header for delegate signature 'RIVERSIG'
+const RIVER_SIG_HEADER = new Uint8Array([82, 73, 86, 69, 82, 83, 73, 71]);
+function bigintToUint8Array64(num, endianMode) {
+    const buffer = new ArrayBuffer(8);
+    const view = new DataView(buffer);
+    view.setBigInt64(0, num, endianMode === 'littleEndian'); // true for little endian
+    return new Uint8Array(buffer);
+}
+/**
+ * Creates the hash source for delegate authorization signature
+ *
+ * @param devicePublicKey - Uncompressed public key (64 or 65 bytes)
+ * @param expiryEpochMs - Expiry timestamp in milliseconds (0 = no expiry)
+ * @returns Hash source to be signed by primary wallet
+ */
+export function riverDelegateHashSrc(devicePublicKey, expiryEpochMs) {
+    abytes(devicePublicKey);
+    check(expiryEpochMs >= 0, 'Expiry should be positive');
+    check(devicePublicKey.length === 64 || devicePublicKey.length === 65, 'Bad public key');
+    const expiryBytes = bigintToUint8Array64(expiryEpochMs, 'littleEndian');
+    const retVal = new Uint8Array(RIVER_SIG_HEADER.length + devicePublicKey.length + expiryBytes.length);
+    retVal.set(RIVER_SIG_HEADER);
+    retVal.set(devicePublicKey, RIVER_SIG_HEADER.length);
+    retVal.set(expiryBytes, RIVER_SIG_HEADER.length + devicePublicKey.length);
+    return retVal;
+}
+/**
+ * Converts uncompressed public key from string to Uint8Array
+ *
+ * @param publicKey - Public key string starting with '0x04' (132 chars total)
+ * @returns Public key as Uint8Array
+ */
+export function publicKeyToUint8Array(publicKey) {
+    // Uncompressed public key in string form should start with '0x04'.
+    check(typeof publicKey === 'string' && publicKey.startsWith('0x04') && publicKey.length === 132, 'Bad public key');
+    return bin_fromHexString(publicKey);
+}
+/**
+ * Derives Ethereum address from public key
+ *
+ * @param publicKey - Uncompressed public key (64 or 65 bytes)
+ * @returns 20-byte Ethereum address
+ */
+export function publicKeyToAddress(publicKey) {
+    abytes(publicKey, 64, 65);
+    if (publicKey.length === 65) {
+        publicKey = publicKey.slice(1);
+    }
+    return keccak256(publicKey).slice(-20);
+}
+/**
+ * Recovers the primary wallet address from a delegate signature
+ *
+ * This verifies that a delegate wallet was authorized by a primary wallet
+ * by recovering the primary wallet's address from the delegate authorization signature.
+ *
+ * @param params.delegatePubKey - Delegate wallet's public key (string or Uint8Array)
+ * @param params.delegateSig - Signature from primary wallet authorizing the delegate
+ * @param params.expiryEpochMs - Expiry timestamp that was signed
+ * @returns Primary wallet address (20 bytes)
+ */
+export function recoverPublicKeyFromDelegateSig(params) {
+    const { delegateSig, expiryEpochMs } = params;
+    const delegatePubKey = typeof params.delegatePubKey === 'string'
+        ? publicKeyToUint8Array(params.delegatePubKey)
+        : params.delegatePubKey;
+    const hashSource = riverDelegateHashSrc(delegatePubKey, expiryEpochMs);
+    const hash = hashPersonalMessage(hashSource);
+    const { v, r, s } = fromRPCSig(('0x' + bin_toHexString(delegateSig)));
+    const recoveredCreatorPubKey = ecrecover(hash, v, r, s);
+    const recoveredCreatorAddress = Uint8Array.from(publicKeyToAddress(recoveredCreatorPubKey));
+    return recoveredCreatorAddress;
+}
+//# sourceMappingURL=delegate.js.map

package/dist/delegate.js.map

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

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  **************************************************************************/
 export * from './binary';
 export * from './check';
+export * from './delegate';
 export * from './dlog';
 export * from './envUtils';
 export * from './utils';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;4EAE4E;AAC5E,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;4EAE4E;AAC5E,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -3,6 +3,7 @@
  **************************************************************************/
 export * from './binary';
 export * from './check';
+export * from './delegate';
 export * from './dlog';
 export * from './envUtils';
 export * from './utils';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;4EAE4E;AAC5E,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;4EAE4E;AAC5E,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@towns-protocol/utils",
-    "version": "0.0.368",
+    "version": "0.0.369",
     "packageManager": "yarn@3.8.0",
     "type": "module",
     "main": "dist/index.js",
@@ -19,7 +19,9 @@
     },
     "dependencies": {
         "@bufbuild/protobuf": "^2.9.0",
-        "@towns-protocol/proto": "^0.0.368",
+        "@ethereumjs/util": "^10.0.0",
+        "@noble/hashes": "^1.8.0",
+        "@towns-protocol/proto": "^0.0.369",
         "debug": "^4.3.4",
         "ethereum-cryptography": "^3.2.0"
     },
@@ -40,5 +42,5 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "bb014c92cd91d742be6ea53ac56027ec90e4d345"
+    "gitHead": "5a4adeead17c71980426b92b98c23952536e08fa"
 }