@ledgerhq/context-module 0.0.0-signer-eth-20250122093657 → 0.0.0-transaction-unfunded-20250917151052

package/lib/types/src/uniswap/domain/UniswapContextLoader.d.ts

@@ -0,0 +1,105 @@
+import { ContextLoader } from "../../shared/domain/ContextLoader";
+import { ClearSignContext } from "../../shared/model/ClearSignContext";
+import { TransactionContext } from "../../shared/model/TransactionContext";
+import { type TokenDataSource } from "../../token/data/TokenDataSource";
+import { type CommandDecoderDataSource } from "../../uniswap/data/CommandDecoderDataSource";
+export declare class UniswapContextLoader implements ContextLoader {
+    private commandDecoderDataSource;
+    private tokenDataSource;
+    constructor(commandDecoderDataSource: CommandDecoderDataSource, tokenDataSource: TokenDataSource);
+    load(ctx: TransactionContext): Promise<ClearSignContext[]>;
+    /**
+     * Constructs the external plugin context for Uniswap external plugin command.
+     *
+     * @private
+     * @returns {ClearSignContext} - The generated external plugin context.
+     */
+    private _buildUniswapPluginCommandData;
+    /**
+     * Extracts and decodes the clear sign contexts from a Uniswap calldata transaction.
+     *
+     * This function:
+     * - Parses the calldata using the Uniswap `execute` function signature.
+     * - Extracts and validates the `commands` and `inputs`.
+     * - Decodes the commands and ensures they match the number of inputs.
+     * - Extracts addresses used in the transaction and verifies if chaining swaps are supported.
+     * - Fetches token information for unique addresses.
+     * - Returns an array of `ClearSignContext` objects representing either token data or errors.
+     *
+     * @private
+     * @param {HexaString} calldata - The raw calldata of the Uniswap transaction.
+     * @param {number} chainId - The blockchain chain ID where the transaction is being executed.
+     * @returns {Promise<ClearSignContext[]>} - A promise resolving to an array of clear sign contexts.
+     */
+    private _extractClearSignContexts;
+    /**
+     * Extracts Uniswap-supported commands from a hexadecimal string.
+     * Each command is represented by one byte (2 hex characters), and this function:
+     * - Maps each command to a known Uniswap command.
+     * - Returns `Nothing` if any extracted command is unsupported.
+     *
+     * @private
+     * @param {HexaString} hex - A hexadecimal string representing commands.
+     * @returns {Maybe<UniswapSupportedCommand[]>} - A `Maybe` containing an array of recognized commands, or `Nothing` if any command is unsupported.
+     *
+     * @example
+     * // Valid command extraction
+     * _extractCommands('0x0008');
+     * // Returns: Just(['0x00', '0x08'])
+     *
+     * @example
+     * // Contains an unsupported command (0x05 is not supported)
+     * _extractCommands('0x0005');
+     * // Returns: Nothing
+     *
+     * @example
+     * // Empty or invalid input
+     * _extractCommands('0x');
+     * // Returns: Nothing
+     */
+    private _extractCommands;
+    /**
+     * Checks if the provided swap commands can be chained together.
+     * A valid chain requires that:
+     * - The output asset of the previous swap matches the input asset of the next swap.
+     * - The pool version remains consistent across swaps.
+     *
+     * @private
+     * @param {Array<[UniswapSupportedCommand, HexaString[]]>} data - An array of tuples containing a swap command and associated addresses.
+     * @returns {boolean} - Returns `true` if the swap commands form a valid chain, otherwise `false`.
+     *
+     * @example
+     * // Valid chaining: same output/input asset and pool version
+     * _isChainingSwapSupported([
+     *   ['0x08', ['0xABC', '0xDEF']],
+     *   ['0x08', ['0xDEF', '0x123']]
+     * ]);
+     * // Returns: true
+     *
+     * @example
+     * // Invalid chaining: different pool versions
+     * _isChainingSwapSupported([
+     *   ['0x08', ['0xABC', '0xDEF']],
+     *   ['0x01', ['0xDEF', '0x123']]
+     * ]);
+     * // Returns: false
+     *
+     * @example
+     * // Invalid chaining: output does not match next input
+     * _isChainingSwapSupported([
+     *   ['0x01A1', ['0xABC', '0xDEF']],
+     *   ['0x01B2', ['0xXYZ', '0x123']]
+     * ]);
+     * // Returns: false
+     */
+    private _isChainingSwapSupported;
+    /**
+     * Checks if a given value is an array of hexadecimal strings.
+     *
+     * @private
+     * @param {unknown} array - The value to check.
+     * @returns {array is HexaString[]} - `true` if the value is an array of hexadecimal strings, otherwise `false`.
+     */
+    private _isHexaStringArray;
+}
+//# sourceMappingURL=UniswapContextLoader.d.ts.map

package/lib/types/src/uniswap/domain/UniswapContextLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniswapContextLoader.d.ts","sourceRoot":"","sources":["../../../../../src/uniswap/domain/UniswapContextLoader.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAEjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAcpE,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAGxF,qBACa,oBAAqB,YAAW,aAAa;IAGtD,OAAO,CAAC,wBAAwB;IAEhC,OAAO,CAAC,eAAe;gBAFf,wBAAwB,EAAE,wBAAwB,EAElD,eAAe,EAAE,eAAe;IAGpC,IAAI,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAmBhE;;;;;OAKG;IACH,OAAO,CAAC,8BAA8B;IAetC;;;;;;;;;;;;;;;OAeG;YACW,yBAAyB;IA8DvC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,OAAO,CAAC,wBAAwB;IA2BhC;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;CAM3B"}

package/lib/types/src/uniswap/domain/UniswapContextLoader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=UniswapContextLoader.test.d.ts.map

package/lib/types/src/uniswap/domain/UniswapContextLoader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniswapContextLoader.test.d.ts","sourceRoot":"","sources":["../../../../../src/uniswap/domain/UniswapContextLoader.test.ts"],"names":[],"mappings":""}

package/lib/types/src/web3-check/data/HttpWeb3CheckDataSource.d.ts

@@ -0,0 +1,14 @@
+import { Either } from "purify-ts";
+import type { ContextModuleConfig } from "../../config/model/ContextModuleConfig";
+import { type PkiCertificateLoader } from "../../pki/domain/PkiCertificateLoader";
+import { type Web3CheckContext, type Web3Checks } from "../../web3-check/domain/web3CheckTypes";
+import { Web3CheckDataSource } from "./Web3CheckDataSource";
+export declare class HttpWeb3CheckDataSource implements Web3CheckDataSource {
+    private readonly config;
+    private readonly _certificateLoader;
+    constructor(config: ContextModuleConfig, _certificateLoader: PkiCertificateLoader);
+    getWeb3Checks(context: Web3CheckContext): Promise<Either<Error, Web3Checks>>;
+    private isTypedDataContext;
+    private isWeb3CheckDto;
+}
+//# sourceMappingURL=HttpWeb3CheckDataSource.d.ts.map

package/lib/types/src/web3-check/data/HttpWeb3CheckDataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpWeb3CheckDataSource.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/data/HttpWeb3CheckDataSource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAe,MAAM,WAAW,CAAC;AAGhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAM9E,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEhB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,qBACa,uBAAwB,YAAW,mBAAmB;IAEnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEnD,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAFU,MAAM,EAAE,mBAAmB,EAEvD,kBAAkB,EAAE,oBAAoB;IAOrD,aAAa,CACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAkErC,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,cAAc;CAYvB"}

package/lib/types/src/web3-check/data/HttpWeb3CheckDataSource.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=HttpWeb3CheckDataSource.test.d.ts.map

package/lib/types/src/web3-check/data/HttpWeb3CheckDataSource.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpWeb3CheckDataSource.test.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/data/HttpWeb3CheckDataSource.test.ts"],"names":[],"mappings":""}

package/lib/types/src/web3-check/data/Web3CheckDataSource.d.ts

@@ -0,0 +1,6 @@
+import { type Either } from "purify-ts";
+import type { Web3CheckContext, Web3Checks } from "../../web3-check/domain/web3CheckTypes";
+export interface Web3CheckDataSource {
+    getWeb3Checks(params: Web3CheckContext): Promise<Either<Error, Web3Checks>>;
+}
+//# sourceMappingURL=Web3CheckDataSource.d.ts.map

package/lib/types/src/web3-check/data/Web3CheckDataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Web3CheckDataSource.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/data/Web3CheckDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACX,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;CAC7E"}

package/lib/types/src/web3-check/data/Web3CheckDto.d.ts

@@ -0,0 +1,20 @@
+import type { Web3CheckTypedData } from "../../web3-check/domain/web3CheckTypes";
+export type GetWeb3ChecksTypedDataRequestDto = {
+    msg: {
+        from: string;
+        data: Web3CheckTypedData;
+    };
+};
+export type GetWeb3ChecksRawTxRequestDto = {
+    tx: {
+        from: string;
+        raw: string;
+    };
+    chain: number;
+};
+export type GetWeb3ChecksRequestDto = GetWeb3ChecksTypedDataRequestDto | GetWeb3ChecksRawTxRequestDto;
+export type Web3CheckDto = {
+    public_key_id: string;
+    descriptor: string;
+};
+//# sourceMappingURL=Web3CheckDto.d.ts.map

package/lib/types/src/web3-check/data/Web3CheckDto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Web3CheckDto.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/data/Web3CheckDto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,MAAM,MAAM,gCAAgC,GAAG;IAC7C,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,kBAAkB,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B,gCAAgC,GAChC,4BAA4B,CAAC;AAEjC,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/lib/types/src/web3-check/di/web3CheckModuleFactory.d.ts

@@ -0,0 +1,3 @@
+import { ContainerModule } from "inversify";
+export declare const web3CheckModuleFactory: () => ContainerModule;
+//# sourceMappingURL=web3CheckModuleFactory.d.ts.map

package/lib/types/src/web3-check/di/web3CheckModuleFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3CheckModuleFactory.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/di/web3CheckModuleFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAO5C,eAAO,MAAM,sBAAsB,uBAM/B,CAAC"}

package/lib/types/src/web3-check/di/web3CheckTypes.d.ts

@@ -0,0 +1,5 @@
+export declare const web3CheckTypes: {
+    Web3CheckDataSource: symbol;
+    Web3CheckContextLoader: symbol;
+};
+//# sourceMappingURL=web3CheckTypes.d.ts.map

package/lib/types/src/web3-check/di/web3CheckTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3CheckTypes.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/di/web3CheckTypes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;CAG1B,CAAC"}

package/lib/types/src/web3-check/domain/DefaultWeb3CheckLoader.d.ts

@@ -0,0 +1,10 @@
+import { Either } from "purify-ts";
+import { type Web3CheckDataSource } from "../../web3-check/data/Web3CheckDataSource";
+import { Web3CheckContextLoader } from "./Web3CheckContextLoader";
+import { Web3CheckContext, Web3Checks } from "./web3CheckTypes";
+export declare class DefaultWeb3CheckContextLoader implements Web3CheckContextLoader {
+    private _dataSource;
+    constructor(dataSource: Web3CheckDataSource);
+    load(web3CheckContext: Web3CheckContext): Promise<Either<Error, Web3Checks>>;
+}
+//# sourceMappingURL=DefaultWeb3CheckLoader.d.ts.map

package/lib/types/src/web3-check/domain/DefaultWeb3CheckLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultWeb3CheckLoader.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/domain/DefaultWeb3CheckLoader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAGjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhE,qBACa,6BAA8B,YAAW,sBAAsB;IAC1E,OAAO,CAAC,WAAW,CAAsB;gBAIvC,UAAU,EAAE,mBAAmB;IAK3B,IAAI,CACR,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;CAGtC"}

package/lib/types/src/web3-check/domain/DefaultWeb3CheckLoader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultWeb3CheckLoader.test.d.ts.map

package/lib/types/src/web3-check/domain/DefaultWeb3CheckLoader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultWeb3CheckLoader.test.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/domain/DefaultWeb3CheckLoader.test.ts"],"names":[],"mappings":""}

package/lib/types/src/web3-check/domain/Web3CheckContextLoader.d.ts

@@ -0,0 +1,6 @@
+import { type Either } from "purify-ts";
+import { type Web3CheckContext, type Web3Checks } from "./web3CheckTypes";
+export interface Web3CheckContextLoader {
+    load(web3CheckContext: Web3CheckContext): Promise<Either<Error, Web3Checks>>;
+}
+//# sourceMappingURL=Web3CheckContextLoader.d.ts.map

package/lib/types/src/web3-check/domain/Web3CheckContextLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Web3CheckContextLoader.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/domain/Web3CheckContextLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;CAC9E"}

package/lib/types/src/web3-check/domain/web3CheckTypes.d.ts

@@ -0,0 +1,35 @@
+import { type DeviceModelId } from "@ledgerhq/device-management-kit";
+import { type PkiCertificate } from "../../pki/model/PkiCertificate";
+export type Web3CheckTypedData = {
+    domain: {
+        name?: string;
+        version?: string;
+        chainId?: number;
+        verifyingContract?: string;
+        salt?: string;
+    };
+    types: Record<string, Array<{
+        name: string;
+        type: string;
+    }>>;
+    primaryType: string;
+    message: Record<string, unknown>;
+};
+export type Web3CheckTypedDataContext = {
+    from: string;
+    deviceModelId: DeviceModelId;
+    data: Web3CheckTypedData;
+};
+export type Web3CheckRawTxContext = {
+    from: string;
+    deviceModelId: DeviceModelId;
+    rawTx: string;
+    chainId: number;
+};
+export type Web3CheckContext = Web3CheckTypedDataContext | Web3CheckRawTxContext;
+export type Web3Checks = {
+    publicKeyId: string;
+    descriptor: string;
+    certificate?: PkiCertificate;
+};
+//# sourceMappingURL=web3CheckTypes.d.ts.map

package/lib/types/src/web3-check/domain/web3CheckTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3CheckTypes.d.ts","sourceRoot":"","sources":["../../../../../src/web3-check/domain/web3CheckTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,kBAAkB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,yBAAyB,GACzB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,UAAU,GAAG;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B,CAAC"}