@otim/utils 0.0.2-development.0

package/dist/helpers/types.d.mts

@@ -0,0 +1,39 @@
+import type { z, ZodObject } from "zod";
+export type Nullable<T> = T | null;
+export type Nullish<T> = T | null | undefined;
+export type Optional<T> = T | undefined;
+export type Any = any;
+export type NumberOrString = number | string;
+export type OverrideProps<T, TOverridden> = Omit<T, keyof TOverridden> & TOverridden;
+export type NonEmptyArray<T> = [T, ...T[]];
+export interface DataRecord {
+    [value: string]: Nullish<DataRecord | string | number | boolean>;
+}
+export interface Input<T> {
+    input: T;
+}
+export type ZodCustom<Values extends object> = ZodObject<{
+    [P in keyof Values]: z.ZodType<Values[P]>;
+}>;
+export declare const isError: (value: unknown) => value is Error;
+export declare const isFunction: (value: unknown) => value is (...args: unknown[]) => unknown;
+export declare const isObject: (value: unknown) => value is Record<string, unknown>;
+export declare const isNumber: (value: unknown) => value is number;
+export declare const isString: (value: unknown) => value is string;
+export declare const isUndefined: (value: unknown) => value is undefined;
+export declare const isBoolean: (value: unknown) => value is boolean;
+/**
+ * Safely extracts a string from an unknown value.
+ * @param value - The value to extract from
+ * @param fallback - Optional fallback value if extraction fails
+ * @returns The extracted string or fallback/undefined
+ */
+export declare const extractString: (value: unknown, fallback?: string) => Optional<string>;
+/**
+ * Safely extracts a number from an unknown value.
+ * Handles both number and string representations.
+ * @param value - The value to extract from
+ * @returns The extracted number or undefined
+ */
+export declare const extractNumber: (value: unknown) => Optional<number>;
+//# sourceMappingURL=types.d.ts.map

package/dist/helpers/types.d.ts

@@ -0,0 +1,39 @@
+import type { z, ZodObject } from "zod";
+export type Nullable<T> = T | null;
+export type Nullish<T> = T | null | undefined;
+export type Optional<T> = T | undefined;
+export type Any = any;
+export type NumberOrString = number | string;
+export type OverrideProps<T, TOverridden> = Omit<T, keyof TOverridden> & TOverridden;
+export type NonEmptyArray<T> = [T, ...T[]];
+export interface DataRecord {
+    [value: string]: Nullish<DataRecord | string | number | boolean>;
+}
+export interface Input<T> {
+    input: T;
+}
+export type ZodCustom<Values extends object> = ZodObject<{
+    [P in keyof Values]: z.ZodType<Values[P]>;
+}>;
+export declare const isError: (value: unknown) => value is Error;
+export declare const isFunction: (value: unknown) => value is (...args: unknown[]) => unknown;
+export declare const isObject: (value: unknown) => value is Record<string, unknown>;
+export declare const isNumber: (value: unknown) => value is number;
+export declare const isString: (value: unknown) => value is string;
+export declare const isUndefined: (value: unknown) => value is undefined;
+export declare const isBoolean: (value: unknown) => value is boolean;
+/**
+ * Safely extracts a string from an unknown value.
+ * @param value - The value to extract from
+ * @param fallback - Optional fallback value if extraction fails
+ * @returns The extracted string or fallback/undefined
+ */
+export declare const extractString: (value: unknown, fallback?: string) => Optional<string>;
+/**
+ * Safely extracts a number from an unknown value.
+ * Handles both number and string representations.
+ * @param value - The value to extract from
+ * @returns The extracted number or undefined
+ */
+export declare const extractNumber: (value: unknown) => Optional<number>;
+//# sourceMappingURL=types.d.ts.map

package/dist/helpers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/helpers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAExC,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACnC,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAC9C,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;AAExC,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC;AAEtB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7C,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,WAAW,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,WAAW,CAAC,GACpE,WAAW,CAAC;AAEd,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC;CACV;AAED,MAAM,MAAM,SAAS,CAAC,MAAM,SAAS,MAAM,IAAI,SAAS,CAAC;KACtD,CAAC,IAAI,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAC1C,CAAC,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,KAC1B,CAAC;AAEzB,eAAO,MAAM,UAAU,GACrB,OAAO,OAAO,KACb,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAsC,CAAC;AAE3E,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAC5B,CAAC;AAE9C,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACxB,CAAC;AAE5B,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACxB,CAAC;AAE5B,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,SACxB,CAAC;AAE/B,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OACxB,CAAC;AAE7B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,EACd,WAAW,MAAM,KAChB,QAAQ,CAAC,MAAM,CAEjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,QAAQ,CAAC,MAAM,CAW7D,CAAC"}

package/dist/helpers/url.d.mts

@@ -0,0 +1,11 @@
+export type QueryParams = Record<string, string | number | boolean | null | undefined>;
+/**
+ * Builds a query string from a params object, skipping undefined/null values.
+ * Encodes using encodeURIComponent. Returns empty string if no params.
+ */
+export declare function buildQueryString(params: QueryParams): string;
+/**
+ * Build a URL by combining a base path with optional query params.
+ */
+export declare function buildUrl(path: string, params?: QueryParams): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/helpers/url.d.ts

@@ -0,0 +1,11 @@
+export type QueryParams = Record<string, string | number | boolean | null | undefined>;
+/**
+ * Builds a query string from a params object, skipping undefined/null values.
+ * Encodes using encodeURIComponent. Returns empty string if no params.
+ */
+export declare function buildQueryString(params: QueryParams): string;
+/**
+ * Build a URL by combining a base path with optional query params.
+ */
+export declare function buildUrl(path: string, params?: QueryParams): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/helpers/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/helpers/url.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,CAC9B,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAC7C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQ5D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAGnE"}

package/dist/helpers/window.d.mts

@@ -0,0 +1,37 @@
+import type { Nullable } from "./types";
+export declare const isClient: () => boolean;
+/**
+ * Configuration for emergent window
+ */
+export interface EmergentWindowConfig {
+    width?: number;
+    height?: number;
+    name?: string;
+}
+/**
+ * Opens an emergent window centered on the screen.
+ * Used for authentication flows and external integrations.
+ *
+ * @param url - The URL to open in the emergent window
+ * @param config - Optional configuration for the window
+ * @returns The opened window or null if it failed
+ */
+export declare function openCenteredEmergentWindow(url: string, config?: EmergentWindowConfig): Nullable<Window>;
+/**
+ * Closes an emergent window safely
+ *
+ * @param emergentWindow - The emergent window to close
+ */
+export declare function closeEmergentWindow(emergentWindow: Nullable<Window>): void;
+/**
+ * Returns focus to the main window
+ */
+export declare function focusMainWindow(): void;
+/**
+ * Performs a client-side redirect to the specified path
+ *
+ * @param path - The path to redirect to
+ * @param fallbackPath - Optional fallback path if the main path is empty
+ */
+export declare function performRedirect(path: string, fallbackPath?: string): void;
+//# sourceMappingURL=window.d.ts.map

package/dist/helpers/window.d.ts

@@ -0,0 +1,37 @@
+import type { Nullable } from "./types";
+export declare const isClient: () => boolean;
+/**
+ * Configuration for emergent window
+ */
+export interface EmergentWindowConfig {
+    width?: number;
+    height?: number;
+    name?: string;
+}
+/**
+ * Opens an emergent window centered on the screen.
+ * Used for authentication flows and external integrations.
+ *
+ * @param url - The URL to open in the emergent window
+ * @param config - Optional configuration for the window
+ * @returns The opened window or null if it failed
+ */
+export declare function openCenteredEmergentWindow(url: string, config?: EmergentWindowConfig): Nullable<Window>;
+/**
+ * Closes an emergent window safely
+ *
+ * @param emergentWindow - The emergent window to close
+ */
+export declare function closeEmergentWindow(emergentWindow: Nullable<Window>): void;
+/**
+ * Returns focus to the main window
+ */
+export declare function focusMainWindow(): void;
+/**
+ * Performs a client-side redirect to the specified path
+ *
+ * @param path - The path to redirect to
+ * @param fallbackPath - Optional fallback path if the main path is empty
+ */
+export declare function performRedirect(path: string, fallbackPath?: string): void;
+//# sourceMappingURL=window.d.ts.map

package/dist/helpers/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../src/helpers/window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,eAAO,MAAM,QAAQ,QAAO,OACiC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAWD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,oBAAyB,GAChC,QAAQ,CAAC,MAAM,CAAC,CAgDlB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAU1E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAWtC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,MAAY,GACzB,IAAI,CAKN"}

package/dist/helpers/zod.d.mts

@@ -0,0 +1,30 @@
+import type { ZodObject, ZodTypeAny } from "zod";
+import { z } from "zod";
+export type Validator<T> = (data: T, ctx: z.RefinementCtx) => void;
+export declare const composeValidators: <T>(validators: Validator<T>[]) => (data: T, ctx: z.RefinementCtx) => void;
+/**
+ * creates a time unit validator for fields stored as JSON strings.
+ * validates both the JSON format and the minimum seconds requirement.
+ *
+ * @param fieldName – the name of the field for error messages
+ * @param options – configuration options
+ * @param options.minSeconds – minimum seconds required (default: 60)
+ * @param options.allowZero – whether to allow 0 seconds for "None" option (default: false)
+ * @param options.useHumanReadable – whether to use human-readable time in error messages (default: true)
+ */
+export declare const createTimeUnitValidator: (fieldName: string, options?: {
+    minSeconds?: number;
+    allowZero?: boolean;
+    useHumanReadable?: boolean;
+}) => z.ZodOptional<z.ZodString>;
+/**
+ * Parse the input values using the provided schema. If the input values are
+ * invalid, throw a ResolverError.
+ * @param values - The input values to parse.
+ * @param schema - The schema to use to parse the input values.
+ * @param error - The error code to use if the input values are invalid.
+ * @returns The parsed input values.
+ * @throws ResolverError if the input values are invalid.
+ */
+export declare const parseSchema: <Values, Schema extends ZodTypeAny = ZodObject<{ [P in keyof Values]: z.ZodType<Values[P]>; }>>(values: Values, schema: Schema) => z.infer<Schema>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/helpers/zod.d.ts

@@ -0,0 +1,30 @@
+import type { ZodObject, ZodTypeAny } from "zod";
+import { z } from "zod";
+export type Validator<T> = (data: T, ctx: z.RefinementCtx) => void;
+export declare const composeValidators: <T>(validators: Validator<T>[]) => (data: T, ctx: z.RefinementCtx) => void;
+/**
+ * creates a time unit validator for fields stored as JSON strings.
+ * validates both the JSON format and the minimum seconds requirement.
+ *
+ * @param fieldName – the name of the field for error messages
+ * @param options – configuration options
+ * @param options.minSeconds – minimum seconds required (default: 60)
+ * @param options.allowZero – whether to allow 0 seconds for "None" option (default: false)
+ * @param options.useHumanReadable – whether to use human-readable time in error messages (default: true)
+ */
+export declare const createTimeUnitValidator: (fieldName: string, options?: {
+    minSeconds?: number;
+    allowZero?: boolean;
+    useHumanReadable?: boolean;
+}) => z.ZodOptional<z.ZodString>;
+/**
+ * Parse the input values using the provided schema. If the input values are
+ * invalid, throw a ResolverError.
+ * @param values - The input values to parse.
+ * @param schema - The schema to use to parse the input values.
+ * @param error - The error code to use if the input values are invalid.
+ * @returns The parsed input values.
+ * @throws ResolverError if the input values are invalid.
+ */
+export declare const parseSchema: <Values, Schema extends ZodTypeAny = ZodObject<{ [P in keyof Values]: z.ZodType<Values[P]>; }>>(values: Values, schema: Schema) => z.infer<Schema>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/helpers/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/helpers/zod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC;AAEnE,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,YAAY,SAAS,CAAC,CAAC,CAAC,EAAE,MACrD,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,aAAa,SAKtC,CAAC;AAiBF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,EACjB,UAAS;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACvB,+BA6BP,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,EACN,MAAM,SAAS,UAAU,GAAG,SAAS,CAAC,GACnC,CAAC,IAAI,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAC1C,CAAC,EAEF,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,CAAC,CAAC,KAAK,CAAC,MAAM,CAShB,CAAC"}

package/dist/index.d.mts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1 @@
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/index.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/instructions/actions/index.d.mts

@@ -0,0 +1,5 @@
+export * from "./refuel";
+export * from "./sweep";
+export * from "./swap";
+export * from "./transfer";
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./refuel";
+export * from "./sweep";
+export * from "./swap";
+export * from "./transfer";
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/instructions/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

package/dist/instructions/actions/refuel/index.d.mts

@@ -0,0 +1,15 @@
+import type { GasLimitConfigurablePayload, ScheduledInstructionBuildPayload, TokenInstructionPayload } from "../../types";
+import type { InstructionBuildRequest } from "@otim/utils/api";
+import type { Address } from "@otim/utils/schemas";
+/**
+ * Payload for building a refuel instruction.
+ * Automatically refuels a target address when balance drops below threshold.
+ * Supports both native currency and ERC20 token refueling.
+ */
+export interface RefuelBuildPayload extends ScheduledInstructionBuildPayload, TokenInstructionPayload, GasLimitConfigurablePayload {
+    target: Address;
+    threshold: string;
+    endBalance: string;
+}
+export declare function createRefuelBuildPayload(payload: RefuelBuildPayload): InstructionBuildRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/refuel/index.d.ts

@@ -0,0 +1,15 @@
+import type { GasLimitConfigurablePayload, ScheduledInstructionBuildPayload, TokenInstructionPayload } from "../../types";
+import type { InstructionBuildRequest } from "@otim/utils/api";
+import type { Address } from "@otim/utils/schemas";
+/**
+ * Payload for building a refuel instruction.
+ * Automatically refuels a target address when balance drops below threshold.
+ * Supports both native currency and ERC20 token refueling.
+ */
+export interface RefuelBuildPayload extends ScheduledInstructionBuildPayload, TokenInstructionPayload, GasLimitConfigurablePayload {
+    target: Address;
+    threshold: string;
+    endBalance: string;
+}
+export declare function createRefuelBuildPayload(payload: RefuelBuildPayload): InstructionBuildRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/refuel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/instructions/actions/refuel/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,gCAAgC,EAChC,uBAAuB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAmB,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;;GAIG;AACH,MAAM,WAAW,kBACf,SAAQ,gCAAgC,EACtC,uBAAuB,EACvB,2BAA2B;IAE7B,MAAM,EAAE,OAAO,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAElB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,GAC1B,uBAAuB,CA+BzB"}

package/dist/instructions/actions/swap/index.d.mts

@@ -0,0 +1,19 @@
+import type { ScheduledInstructionBuildPayload } from "../../types";
+import type { InstructionBuildRequest } from "@otim/utils/api";
+import type { Address } from "@otim/utils/schemas";
+/**
+ * Payload for building a Uniswap V3 exact input swap instruction.
+ * Swaps a specific input amount for a minimum output amount using Uniswap V3.
+ */
+export interface UniswapV3ExactInputBuildPayload extends ScheduledInstructionBuildPayload {
+    tokenIn: Address;
+    tokenOut: Address;
+    feeTier: string;
+    amountIn: string;
+    floorAmountOut: string;
+    recipient: Address;
+    meanPriceLookBack?: number;
+    maxPriceDeviationBps?: number;
+}
+export declare function createUniswapV3ExactInputBuildPayload(payload: UniswapV3ExactInputBuildPayload): InstructionBuildRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/swap/index.d.ts

@@ -0,0 +1,19 @@
+import type { ScheduledInstructionBuildPayload } from "../../types";
+import type { InstructionBuildRequest } from "@otim/utils/api";
+import type { Address } from "@otim/utils/schemas";
+/**
+ * Payload for building a Uniswap V3 exact input swap instruction.
+ * Swaps a specific input amount for a minimum output amount using Uniswap V3.
+ */
+export interface UniswapV3ExactInputBuildPayload extends ScheduledInstructionBuildPayload {
+    tokenIn: Address;
+    tokenOut: Address;
+    feeTier: string;
+    amountIn: string;
+    floorAmountOut: string;
+    recipient: Address;
+    meanPriceLookBack?: number;
+    maxPriceDeviationBps?: number;
+}
+export declare function createUniswapV3ExactInputBuildPayload(payload: UniswapV3ExactInputBuildPayload): InstructionBuildRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/swap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/instructions/actions/swap/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAAmB,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;GAGG;AACH,MAAM,WAAW,+BACf,SAAQ,gCAAgC;IAExC,OAAO,EAAE,OAAO,CAAC;IAEjB,QAAQ,EAAE,OAAO,CAAC;IAElB,OAAO,EAAE,MAAM,CAAC;IAEhB,QAAQ,EAAE,MAAM,CAAC;IAEjB,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,OAAO,CAAC;IAEnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,+BAA+B,GACvC,uBAAuB,CA0BzB"}

package/dist/instructions/actions/sweep/index.d.mts

@@ -0,0 +1,16 @@
+import type { BaseInstructionBuildPayload, TokenInstructionPayload } from "../../types";
+import type { InstructionBuildRequest } from "@otim/utils/api";
+import type { Address } from "@otim/utils/schemas";
+/**
+ * Payload for building a sweep deposit account instruction.
+ * Automatically sweeps funds from a deposit account when balance exceeds threshold.
+ * Supports both native currency and ERC20 token sweeping.
+ * Note: This action does NOT support scheduling or gas limit configuration.
+ */
+export interface SweepDepositAccountBuildPayload extends BaseInstructionBuildPayload, TokenInstructionPayload {
+    recipient: Address;
+    threshold: string;
+    depositor: Address;
+}
+export declare function createSweepDepositAccountBuildPayload(payload: SweepDepositAccountBuildPayload): InstructionBuildRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/sweep/index.d.ts

@@ -0,0 +1,16 @@
+import type { BaseInstructionBuildPayload, TokenInstructionPayload } from "../../types";
+import type { InstructionBuildRequest } from "@otim/utils/api";
+import type { Address } from "@otim/utils/schemas";
+/**
+ * Payload for building a sweep deposit account instruction.
+ * Automatically sweeps funds from a deposit account when balance exceeds threshold.
+ * Supports both native currency and ERC20 token sweeping.
+ * Note: This action does NOT support scheduling or gas limit configuration.
+ */
+export interface SweepDepositAccountBuildPayload extends BaseInstructionBuildPayload, TokenInstructionPayload {
+    recipient: Address;
+    threshold: string;
+    depositor: Address;
+}
+export declare function createSweepDepositAccountBuildPayload(payload: SweepDepositAccountBuildPayload): InstructionBuildRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/sweep/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/instructions/actions/sweep/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAmB,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;;;GAKG;AACH,MAAM,WAAW,+BACf,SAAQ,2BAA2B,EACjC,uBAAuB;IAEzB,SAAS,EAAE,OAAO,CAAC;IAEnB,SAAS,EAAE,MAAM,CAAC;IAElB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,+BAA+B,GACvC,uBAAuB,CA0BzB"}

package/dist/instructions/actions/transfer/index.d.mts

@@ -0,0 +1,13 @@
+import type { GasLimitConfigurablePayload, ScheduledInstructionBuildPayload, TokenInstructionPayload } from "../../types";
+import type { InstructionBuildRequest } from "@otim/utils/api";
+import type { Address } from "@otim/utils/schemas";
+/**
+ * Payload for building a transfer instruction.
+ * Supports both native currency and ERC20 token transfers.
+ */
+export interface TransferBuildPayload extends ScheduledInstructionBuildPayload, TokenInstructionPayload, GasLimitConfigurablePayload {
+    target: Address;
+    value: string;
+}
+export declare function createTransferBuildPayload(payload: TransferBuildPayload): InstructionBuildRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/transfer/index.d.ts

@@ -0,0 +1,13 @@
+import type { GasLimitConfigurablePayload, ScheduledInstructionBuildPayload, TokenInstructionPayload } from "../../types";
+import type { InstructionBuildRequest } from "@otim/utils/api";
+import type { Address } from "@otim/utils/schemas";
+/**
+ * Payload for building a transfer instruction.
+ * Supports both native currency and ERC20 token transfers.
+ */
+export interface TransferBuildPayload extends ScheduledInstructionBuildPayload, TokenInstructionPayload, GasLimitConfigurablePayload {
+    target: Address;
+    value: string;
+}
+export declare function createTransferBuildPayload(payload: TransferBuildPayload): InstructionBuildRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/actions/transfer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/instructions/actions/transfer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,gCAAgC,EAChC,uBAAuB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAmB,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;GAGG;AACH,MAAM,WAAW,oBACf,SAAQ,gCAAgC,EACtC,uBAAuB,EACvB,2BAA2B;IAE7B,MAAM,EAAE,OAAO,CAAC;IAEhB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,GAC5B,uBAAuB,CA8BzB"}

package/dist/instructions/activate.d.mts

@@ -0,0 +1,84 @@
+import type { InstructionActivateRequest } from "@otim/utils/api";
+import type { Address, HexString, InstructionAction } from "@otim/utils/schemas";
+import type { TypedDataDomain } from "viem";
+/**
+ * EIP-712 typed data for instruction activation signatures.
+ */
+export interface InstructionEIP712TypedData {
+    domain: TypedDataDomain;
+    primaryType: "Instruction";
+    types: Record<string, Array<{
+        name: string;
+        type: string;
+    }>>;
+    message: {
+        [key: string]: unknown;
+        salt: bigint;
+        maxExecutions: bigint;
+        action: HexString;
+    };
+}
+/**
+ * Payload for activating an instruction with all required parameters.
+ */
+export interface InstructionActivatePayload {
+    nickname?: string;
+    address: Address;
+    chainId: number;
+    salt: HexString;
+    maxExecutions: HexString;
+    action: HexString;
+    actionName: InstructionAction;
+    arguments: HexString;
+    signature: string;
+}
+/**
+ * Configuration for creating instruction signatures.
+ */
+export interface InstructionSignatureConfig {
+    delegateAddress: Address;
+    chainId: number;
+}
+/**
+ * Creates the EIP-712 domain for instruction signatures.
+ * Defines the domain separator used in typed data signing.
+ *
+ * @param config - Configuration containing delegate address and chain ID
+ * @returns TypedDataDomain object for EIP-712 signing
+ */
+export declare function createInstructionDomain(config: InstructionSignatureConfig): TypedDataDomain;
+/**
+ * Decodes hex-encoded instruction parameters for EIP-712 signatures.
+ * Uses action-specific ABI definitions to properly decode arguments.
+ *
+ * @param salt - Hex-encoded salt value for instruction uniqueness
+ * @param maxExecutions - Hex-encoded maximum execution count
+ * @param argumentsHex - Hex-encoded action-specific arguments
+ * @param actionName - Name of the instruction action
+ * @returns Decoded parameters as TypeScript primitives
+ * @throws Error if action has no EIP-712 types or ABI definition
+ */
+export declare function decodeInstructionParameters(salt: HexString, maxExecutions: HexString, argumentsHex: HexString, actionName: InstructionAction): {
+    decodedSalt: bigint;
+    decodedMaxExecutions: bigint;
+    decodedArguments: Record<string, unknown>;
+};
+/**
+ * Creates EIP-712 typed data for instruction activation.
+ * Automatically handles ABI decoding based on action type.
+ *
+ * @param payload - Instruction activation payload (without signature)
+ * @param config - Signature configuration for domain creation
+ * @returns Complete EIP-712 typed data structure ready for signing
+ * @throws Error if action has no EIP-712 type definitions
+ */
+export declare function createInstructionTypedData(payload: Omit<InstructionActivatePayload, "signature" | "nickname">, config: InstructionSignatureConfig): InstructionEIP712TypedData;
+/**
+ * Creates an activation payload with EIP-2098 signature format.
+ * Converts a standard signature to the compact EIP-2098 format used by the protocol.
+ *
+ * @param payload - The instruction activation payload including signature
+ * @returns Formatted activation request ready for API submission
+ */
+export declare function createActivationPayload(payload: InstructionActivatePayload): InstructionActivateRequest;
+//# sourceMappingURL=activate.d.ts.map

package/dist/instructions/activate.d.ts

@@ -0,0 +1,84 @@
+import type { InstructionActivateRequest } from "@otim/utils/api";
+import type { Address, HexString, InstructionAction } from "@otim/utils/schemas";
+import type { TypedDataDomain } from "viem";
+/**
+ * EIP-712 typed data for instruction activation signatures.
+ */
+export interface InstructionEIP712TypedData {
+    domain: TypedDataDomain;
+    primaryType: "Instruction";
+    types: Record<string, Array<{
+        name: string;
+        type: string;
+    }>>;
+    message: {
+        [key: string]: unknown;
+        salt: bigint;
+        maxExecutions: bigint;
+        action: HexString;
+    };
+}
+/**
+ * Payload for activating an instruction with all required parameters.
+ */
+export interface InstructionActivatePayload {
+    nickname?: string;
+    address: Address;
+    chainId: number;
+    salt: HexString;
+    maxExecutions: HexString;
+    action: HexString;
+    actionName: InstructionAction;
+    arguments: HexString;
+    signature: string;
+}
+/**
+ * Configuration for creating instruction signatures.
+ */
+export interface InstructionSignatureConfig {
+    delegateAddress: Address;
+    chainId: number;
+}
+/**
+ * Creates the EIP-712 domain for instruction signatures.
+ * Defines the domain separator used in typed data signing.
+ *
+ * @param config - Configuration containing delegate address and chain ID
+ * @returns TypedDataDomain object for EIP-712 signing
+ */
+export declare function createInstructionDomain(config: InstructionSignatureConfig): TypedDataDomain;
+/**
+ * Decodes hex-encoded instruction parameters for EIP-712 signatures.
+ * Uses action-specific ABI definitions to properly decode arguments.
+ *
+ * @param salt - Hex-encoded salt value for instruction uniqueness
+ * @param maxExecutions - Hex-encoded maximum execution count
+ * @param argumentsHex - Hex-encoded action-specific arguments
+ * @param actionName - Name of the instruction action
+ * @returns Decoded parameters as TypeScript primitives
+ * @throws Error if action has no EIP-712 types or ABI definition
+ */
+export declare function decodeInstructionParameters(salt: HexString, maxExecutions: HexString, argumentsHex: HexString, actionName: InstructionAction): {
+    decodedSalt: bigint;
+    decodedMaxExecutions: bigint;
+    decodedArguments: Record<string, unknown>;
+};
+/**
+ * Creates EIP-712 typed data for instruction activation.
+ * Automatically handles ABI decoding based on action type.
+ *
+ * @param payload - Instruction activation payload (without signature)
+ * @param config - Signature configuration for domain creation
+ * @returns Complete EIP-712 typed data structure ready for signing
+ * @throws Error if action has no EIP-712 type definitions
+ */
+export declare function createInstructionTypedData(payload: Omit<InstructionActivatePayload, "signature" | "nickname">, config: InstructionSignatureConfig): InstructionEIP712TypedData;
+/**
+ * Creates an activation payload with EIP-2098 signature format.
+ * Converts a standard signature to the compact EIP-2098 format used by the protocol.
+ *
+ * @param payload - The instruction activation payload including signature
+ * @returns Formatted activation request ready for API submission
+ */
+export declare function createActivationPayload(payload: InstructionActivatePayload): InstructionActivateRequest;
+//# sourceMappingURL=activate.d.ts.map