0xtrails 0.13.2 → 0.15.0

package/dist/actions/hooks/useEarnProviders.d.ts

@@ -0,0 +1,18 @@
+import { getEarnProviders, GetProvidersParams } from '../utils.js';
+export type UseEarnProvidersParams = GetProvidersParams;
+export type UseEarnProvidersReturn = {
+    data: Awaited<ReturnType<typeof getEarnProviders>>["items"] | undefined;
+    total: number;
+    offset: number;
+    limit: number;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+/**
+ * React Query hook for fetching earn providers supported by the Trails API.
+ *
+ * Use provider IDs from this hook to filter `useEarnMarkets({ provider })`.
+ */
+export declare function useEarnProviders(params?: UseEarnProvidersParams): UseEarnProvidersReturn;
+//# sourceMappingURL=useEarnProviders.d.ts.map

package/dist/actions/hooks/useEarnProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEarnProviders.d.ts","sourceRoot":"","sources":["../../../src/actions/hooks/useEarnProviders.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGvE,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAA;AAEvD,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,SAAS,CAAA;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,GAAE,sBAA2B,GAClC,sBAAsB,CAiBxB"}

package/dist/actions/hooks/useResolveActions.d.ts

@@ -0,0 +1,28 @@
+import { PublicClient } from 'viem';
+import { QuoteError } from '../../hooks/useQuote.js';
+import { Call, ChainIdentifier, ActionItem } from '../types.js';
+import { TrailsClient } from '../../trailsClient.js';
+export type UseResolveActionsProps = {
+    actions: ActionItem[];
+    chainId: number | undefined;
+    destinationChain: ChainIdentifier;
+    userWalletAddress: `0x${string}` | undefined;
+    trailsClient: TrailsClient | null;
+    publicClient: PublicClient | null;
+};
+export type UseResolveActionsReturn = {
+    calls: Call[] | null;
+    isLoading: boolean;
+    error: QuoteError | null;
+};
+export type ResolveActionsToCallsParams = {
+    actions: ActionItem[];
+    destinationChain: ChainIdentifier;
+    userWalletAddress: `0x${string}`;
+    trailsClient: TrailsClient;
+    publicClient: PublicClient | null;
+    abortSignal?: AbortSignal;
+};
+export declare function resolveActionsToCalls(params: ResolveActionsToCallsParams): Promise<Call[]>;
+export declare function useResolveActions(props: UseResolveActionsProps): UseResolveActionsReturn;
+//# sourceMappingURL=useResolveActions.d.ts.map

package/dist/actions/hooks/useResolveActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolveActions.d.ts","sourceRoot":"","sources":["../../../src/actions/hooks/useResolveActions.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,MAAM,CAAA;AACb,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,KAAK,EAEV,IAAI,EACJ,eAAe,EAEf,UAAU,EAMX,MAAM,aAAa,CAAA;AASpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AA6NzD,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,gBAAgB,EAAE,eAAe,CAAA;IACjC,iBAAiB,EAAE,KAAK,MAAM,EAAE,GAAG,SAAS,CAAA;IAC5C,YAAY,EAAE,YAAY,GAAG,IAAI,CAAA;IACjC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,gBAAgB,EAAE,eAAe,CAAA;IACjC,iBAAiB,EAAE,KAAK,MAAM,EAAE,CAAA;IAChC,YAAY,EAAE,YAAY,CAAA;IAC1B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAA;IACjC,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAMD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,IAAI,EAAE,CAAC,CAoKjB;AAMD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,uBAAuB,CAyFzB"}

package/dist/actions/index.d.ts

@@ -0,0 +1,8 @@
+export { SwapType } from './actionBuilder.js';
+export type { SwapProvider } from './actionBuilder.js';
+export type { ActionAmount } from './types.js';
+export { dynamic, self } from './dynamic.js';
+export { lend, deposit, swap, assertCondition, custom, } from './actionBuilder.js';
+export { uniswapV3 } from './custom-integrations/uniswapV3/uniswapV3.js';
+export { sushiswapV3 } from './custom-integrations/sushiswapV3/sushiswapV3.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAE5C,OAAO,EACL,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,eAAe,EACf,MAAM,GACP,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,8CAA8C,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAA"}

package/dist/actions/index.js

@@ -0,0 +1,13 @@
+import { A as a, D as t, Mt as p, Nt as i, O as o, Pt as e, Wt as n, j as d, k as m, qt as r } from "../src-CQhZqidH.js";
+export {
+  p as SwapType,
+  t as assertCondition,
+  o as custom,
+  m as deposit,
+  n as dynamic,
+  a as lend,
+  r as self,
+  i as sushiswapV3,
+  d as swap,
+  e as uniswapV3
+};

package/dist/actions/resolvers.d.ts

@@ -0,0 +1,30 @@
+import { ActionAmount, Call, ChainIdentifier, TokenOrAddress, FeePercent } from './types.js';
+import { TradeType as SwapType } from '@0xtrails/api';
+import { Address } from 'ox';
+import { TrailsClient } from '../trailsClient.js';
+export { SwapType };
+export type SwapProvider = "UNISWAP_V3" | "SUSHISWAP_V3";
+export type ResolveEarnCallsParams = {
+    marketId: string;
+    amount: ActionAmount;
+    userWalletAddress: `0x${string}`;
+    args?: Record<string, unknown>;
+};
+export declare function resolveEarnCalls(params: ResolveEarnCallsParams, prefix: string, client: TrailsClient): Promise<Call[]>;
+export type ResolveSwapCallsParams = {
+    chain: ChainIdentifier;
+    tokenIn: TokenOrAddress;
+    tokenOut: TokenOrAddress;
+    fee: FeePercent;
+    recipient: Address.Address;
+    swapType?: SwapType;
+    provider?: SwapProvider;
+    amountIn?: bigint;
+    amountOutMinimum?: bigint;
+    amountOut?: bigint;
+    amountInMaximum?: bigint;
+    sqrtPriceLimitX96?: bigint;
+    deadline?: bigint;
+};
+export declare function resolveSwapCalls(params: ResolveSwapCallsParams): Call[];
+//# sourceMappingURL=resolvers.d.ts.map

package/dist/actions/resolvers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../src/actions/resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,IAAI,EACJ,eAAe,EACf,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAA;AAOrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAiEtD,OAAO,EAAE,QAAQ,EAAE,CAAA;AACnB,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,cAAc,CAAA;AA+CxD,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;IACpB,iBAAiB,EAAE,KAAK,MAAM,EAAE,CAAA;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAkID,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,EAAE,CAAC,CAsFjB;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,eAAe,CAAA;IACtB,OAAO,EAAE,cAAc,CAAA;IACvB,QAAQ,EAAE,cAAc,CAAA;IACxB,GAAG,EAAE,UAAU,CAAA;IACf,SAAS,EAAE,OAAO,CAAC,OAAO,CAAA;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AA2CD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,EAAE,CA6EvE"}

package/dist/actions/types/earn.d.ts

@@ -0,0 +1,51 @@
+import { YieldArgumentField, YieldBalance, YieldBalanceQuery, YieldBalances, YieldError, YieldMarket, YieldMechanics, YieldMechanicsArguments, YieldMetadata, YieldProvider, YieldReward, YieldRewardRate, YieldRiskEntry, YieldRiskSummary, YieldState, YieldStatistics, YieldStatus, YieldToken } from '@0xtrails/api';
+export type SortBy = "statusEnterAsc" | "statusEnterDesc" | "statusExitAsc" | "statusExitDesc" | "rewardRateAsc" | "rewardRateDesc";
+export type EarnType = "lending" | "vault";
+export declare const PROVIDER_IDS: readonly ["spark", "summer-fi", "sky", "gearbox", "yearn", "aave", "morpho", "fluid", "curve"];
+export type ProviderId = (typeof PROVIDER_IDS)[number];
+export type ProviderType = "protocol" | "validator_provider";
+export type Provider = YieldProvider;
+export type EarnActionArgs = {
+    amount?: string;
+    amounts?: string[];
+    receiverAddress?: string;
+    validatorAddress?: string;
+    validatorAddresses?: string[];
+    duration?: string;
+    tronResource?: "BANDWIDTH" | "ENERGY";
+    nfts?: {
+        collection: string;
+        tokenId: string;
+    }[];
+    inputToken?: string;
+    [key: string]: unknown;
+};
+export type EarnMarketToken = YieldToken;
+export type EarnMarketRewardRate = YieldRewardRate;
+export type EarnMarketRewardRateComponent = YieldReward;
+export type EarnMarketStatus = YieldStatus;
+export type EarnMarketMetadata = YieldMetadata;
+export type EarnMarketArgumentField = YieldArgumentField;
+export type EarnMarketArguments = YieldMechanicsArguments;
+export type EarnMarketMechanics = YieldMechanics;
+export type EarnMarketStatistics = YieldStatistics;
+export type EarnMarketState = YieldState;
+export type EarnMarketRiskEntry = YieldRiskEntry;
+export type EarnMarketRisk = YieldRiskSummary;
+export type EarnMarket = YieldMarket;
+export type EarnBalance = YieldBalance;
+export type EarnBalances = YieldBalances;
+export type EarnBalanceQuery = YieldBalanceQuery;
+export type EarnBalanceError = YieldError;
+export type UnsignedTransaction = {
+    from: string;
+    gasLimit: string;
+    to: string;
+    data: string;
+    nonce: number;
+    type: number;
+    maxFeePerGas: string;
+    maxPriorityFeePerGas: string;
+    chainId: number;
+};
+//# sourceMappingURL=earn.d.ts.map

package/dist/actions/types/earn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"earn.d.ts","sourceRoot":"","sources":["../../../src/actions/types/earn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACX,UAAU,EACX,MAAM,eAAe,CAAA;AAEtB,MAAM,MAAM,MAAM,GACd,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,gBAAgB,CAAA;AAEpB,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;AAE1C,eAAO,MAAM,YAAY,gGAUf,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACtD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,oBAAoB,CAAA;AAE5D,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAA;AAEpC,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAA;IACrC,IAAI,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAChD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAA;AACxC,MAAM,MAAM,oBAAoB,GAAG,eAAe,CAAA;AAClD,MAAM,MAAM,6BAA6B,GAAG,WAAW,CAAA;AACvD,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAA;AAC1C,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAA;AAC9C,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAA;AACxD,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,CAAA;AACzD,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAA;AAChD,MAAM,MAAM,oBAAoB,GAAG,eAAe,CAAA;AAClD,MAAM,MAAM,eAAe,GAAG,UAAU,CAAA;AACxC,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAA;AAChD,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAA;AAC7C,MAAM,MAAM,UAAU,GAAG,WAAW,CAAA;AACpC,MAAM,MAAM,WAAW,GAAG,YAAY,CAAA;AACtC,MAAM,MAAM,YAAY,GAAG,aAAa,CAAA;AACxC,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAA;AAChD,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAEzC,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA"}

package/dist/actions/types.d.ts

@@ -0,0 +1,303 @@
+import { Address } from 'ox';
+import { SupportedChainName, SupportedChainId } from './constants.js';
+import { SwapType, SwapProvider } from './resolvers.js';
+import { Abi, Call as ViemCall } from 'viem';
+export type HydrateDataType = "self" | "msg.sender" | "tx.origin" | Address.Address;
+export type HydrateTypeAddress = {
+    type: "address";
+    address: HydrateDataType;
+    calldataOffset: number;
+};
+export type HydrateTypeBalance = {
+    type: "balance";
+    address: HydrateDataType;
+    calldataOffset: number;
+};
+export type HydrateTypeERC20Balance = {
+    type: "erc20Balance";
+    token: Address.Address;
+    address: HydrateDataType;
+    calldataOffset: number;
+};
+export type HydrateTypeERC20Allowance = {
+    type: "erc20Allowance";
+    token: Address.Address;
+    address: HydrateDataType;
+    spender: HydrateDataType;
+    calldataOffset: number;
+};
+export type HydrateTypeTo = {
+    type: "to";
+    address: HydrateDataType;
+};
+export type HydrateTypeValue = {
+    type: "value";
+    address: HydrateDataType;
+};
+export type HydrateTypeData = HydrateTypeAddress | HydrateTypeBalance | HydrateTypeERC20Balance | HydrateTypeERC20Allowance | HydrateTypeTo | HydrateTypeValue;
+export type Call = ViemCall & {
+    /**
+     * When set, the hydration encoder reads this token's full ERC-20 balance at
+     * execution time and injects it into the calldata slot that contains the
+     * `dynamic()` sentinel.
+     *
+     * Use this for chained actions where the amount depends on a previous step's
+     * output (e.g. swap output fed into a lending supply), and for any custom
+     * call whose calldata carries a `dynamic()` amount.
+     *
+     * **Required** whenever `data` contains a `dynamic()` sentinel, UNLESS the
+     * call itself is an ERC-20 `approve(spender, dynamic())` — in that case
+     * `to` IS the token contract and the encoder infers it. There is no
+     * implicit fallback to the batch destination token; forgetting this field
+     * for a non-approve call makes the encoder throw.
+     */
+    dynamicAmountToken?: Address.Address;
+    /**
+     * Additional hydration entries for this call. HydrateProxy will apply these
+     * at runtime before executing the call.
+     *
+     * Use this to inject runtime-resolved values (wallet address, ETH balance,
+     * ERC-20 allowance, etc.) into specific calldata offsets.
+     *
+     * Entries are appended after any auto-detected placeholder hydrations.
+     */
+    hydrateEntries?: HydrateTypeData[];
+    /**
+     * Tokens to automatically refund to the user if they get stuck in the intent
+     * wallet.
+     *
+     * Pass the zero address (`0x0000…0000`) to also auto-refund native ETH.
+     *
+     * The SDK handles this automatically when your calldata only touches a
+     * single token, the encoder infers it from the approve target or the
+     * `dynamicAmountToken`, and no extra declaration is needed.
+     *
+     * You only need to fill `sweepTokens` when a call involves more than one
+     * token and the encoder can't see all of them from the calldata alone. The
+     * canonical example is a swap: the input token is visible (via the approve
+     * or `dynamicAmountToken`), but the output token is hidden inside the
+     * swap's calldata, so the integration must declare it here to make sure
+     * any leftover output is refunded instead of stranded.
+     */
+    sweepTokens?: Address.Address[];
+};
+export type CallWithData = Call & {
+    data: `0x${string}`;
+};
+export type { SupportedChainName, SupportedChainId };
+export type ChainName = SupportedChainName;
+export type ChainId = SupportedChainId | (number & {});
+export type ChainIdentifier = ChainName | ChainId;
+export declare const ERC20_UTIL_TOKENS: {
+    readonly ETH: "ETH";
+    readonly WETH: "WETH";
+    readonly WETHe: "WETH.e";
+    readonly USDC: "USDC";
+    readonly USDT: "USDT";
+    readonly DAI: "DAI";
+    readonly BAT: "BAT";
+    readonly ARB: "ARB";
+    readonly LINK: "LINK";
+    readonly MATIC: "MATIC";
+    readonly POL: "POL";
+    readonly XTZ: "XTZ";
+    readonly WXTZ: "WXTZ";
+    readonly BNB: "BNB";
+    readonly AVAX: "AVAX";
+    readonly SOMI: "SOMI";
+    readonly MON: "MON";
+    readonly WMON: "WMON";
+};
+export type SupportedTokenSymbol = (typeof ERC20_UTIL_TOKENS)[keyof typeof ERC20_UTIL_TOKENS];
+export type TokenOrAddress = Address.Address | SupportedTokenSymbol;
+export type AbiEncodedData = {
+    abi: Abi;
+    functionName: string;
+    args?: readonly unknown[];
+};
+export type BuildCallParams = {
+    /** Target contract address. */
+    to: Address.Address;
+    /** Raw hex calldata, or an object that will be ABI-encoded via `encodeFunctionData`. */
+    data: `0x${string}` | AbiEncodedData;
+    /** Optional native value to send with the call. */
+    value?: bigint;
+    /**
+     * Token whose runtime balance replaces the `dynamic()` sentinel in
+     * calldata. Required whenever `data` contains a `dynamic()` amount and the
+     * call is not a bare `approve(spender, dynamic())`. No implicit fallback
+     * to the batch destination token — the encoder throws otherwise.
+     */
+    dynamicAmountToken?: Address.Address;
+};
+export type BuildApproveAndCallParams = {
+    /** ERC-20 token address to approve. */
+    token: Address.Address;
+    /** A single call to prepend with an approval. Provide either `call` or `calls`. */
+    call: Call;
+    /** Custom approval amount. Defaults to `maxUint256`. */
+    amount?: bigint;
+};
+export type TokenInfo = {
+    address: Address.Address;
+    decimals: number;
+    name: string;
+    imageUrl: string;
+};
+export type TokenAccessor = {
+    /** Token address and decimals on the given chain. */
+    onChain: (chain: ChainIdentifier) => TokenInfo;
+    /** Token address on the given chain (shorthand when you only need the address). */
+    addressOn: (chain: ChainIdentifier) => Address.Address;
+    /** Token decimals on the given chain. */
+    decimalsOn: (chain: ChainIdentifier) => number;
+};
+export type Erc20Utils = {
+    /** Look up a token by symbol (programmatic access).
+     * @example
+     * ```ts
+     * const { address, decimals } = erc20Utils.token("USDC").onChain("base")
+     * ```
+     */
+    token: (symbol: SupportedTokenSymbol) => TokenAccessor;
+    /** Build an ERC-20 `transfer` call. */
+    transfer: (params: TransferParams) => CallWithData;
+    /** Build an ERC-20 `approve` call. */
+    approve: (params: ApproveParams) => CallWithData;
+    /** Build an ERC-20 `transferFrom` call. */
+    transferFrom: (params: TransferFromParams) => CallWithData;
+} & Record<keyof typeof ERC20_UTIL_TOKENS, TokenAccessor>;
+export type FeePercent = "0.01" | "0.05" | "0.3" | "1";
+export type TransferParams = {
+    tokenAddress: Address.Address;
+    to: Address.Address;
+    amount: bigint;
+};
+export type ApproveParams = {
+    tokenAddress: Address.Address;
+    spender: Address.Address;
+    amount: bigint;
+};
+export type TransferFromParams = {
+    tokenAddress: Address.Address;
+    from: Address.Address;
+    to: Address.Address;
+    amount: bigint;
+};
+/**
+ * Direction of an earn-style action.
+ *
+ * Only `"enter"` is supported — the action builders and `useQuote` are
+ * intentionally scoped to deposits / supplies. Exits (withdrawals) are not part of the Trails intent pipeline, use
+ * the protocol's own withdrawal flow directly.
+ */
+export type ActionDirection = "enter";
+/**
+ * An amount accepted by action builders.
+ *
+ * - `string` — human-readable decimal (e.g. `"0.5"`); parsed with the token's
+ *   decimals by the resolver.
+ * - `bigint` — raw wei; used as-is without scaling.
+ * - `dynamic()` sentinel — resolved to the intent wallet's runtime balance at
+ *   execution time.
+ */
+export type ActionAmount = string | bigint;
+/**
+ * Internal marker string emitted by the action factories on any amount field
+ * passed as `dynamic()`. The resolver and earn-API serializer both recognise
+ * this marker and route it back to `TRAILS_HYDRATE_PLACEHOLDER_AMOUNT`.
+ *
+ * **Internal SDK use only.** Callers should always use `dynamic()` — never
+ * the raw string — when building actions.
+ */
+export declare const DYNAMIC_AMOUNT_MARKER: "dynamic";
+export type DynamicAmountMarker = typeof DYNAMIC_AMOUNT_MARKER;
+export type LendActionItem = {
+    type: "lend";
+    marketId: string;
+    amount: ActionAmount;
+    receiverAddress?: `0x${string}`;
+    inputToken?: string;
+    inputTokenNetwork?: string;
+    direction?: ActionDirection;
+};
+export type SwapActionItem = {
+    type: "swap";
+    swapType?: SwapType;
+    provider?: SwapProvider;
+    tokenIn: TokenOrAddress;
+    tokenOut: TokenOrAddress;
+    fee: FeePercent;
+    /** EXACT_INPUT input amount. String = human-readable; bigint = raw wei. */
+    amountIn?: ActionAmount;
+    /** EXACT_INPUT minimum output. String = human-readable; bigint = raw wei. */
+    minAmountOut?: ActionAmount;
+    /** EXACT_OUTPUT output amount. String = human-readable; bigint = raw wei. */
+    amountOut?: ActionAmount;
+    /**
+     * EXACT_OUTPUT maximum input. String = human-readable; bigint = raw wei.
+     * Omit or set to `"dynamic"` / `dynamic()` to let Trails inject the available
+     * balance at runtime.
+     */
+    maxAmountIn?: ActionAmount;
+    /**
+     * Destination of the swap output. When omitted the resolver routes output
+     * to the user's wallet for the final action and to `self()` for
+     * intermediate actions so downstream steps can consume it.
+     */
+    recipient?: Address.Address;
+};
+export type DepositActionItem = {
+    type: "deposit";
+    marketId: string;
+    amount: ActionAmount;
+    receiverAddress?: `0x${string}`;
+    inputToken?: string;
+    inputTokenNetwork?: string;
+    useMaxAllowance?: boolean;
+    direction?: ActionDirection;
+};
+export type CustomActionItem = {
+    type: "custom";
+    to: Address.Address;
+    data: `0x${string}`;
+    value?: bigint;
+    dynamicAmountToken?: Address.Address;
+    /**
+     * Hydration entries attached to the resolved `Call`. Populated by
+     * `custom()` when the caller asks for runtime-resolved fields
+     * (e.g. `value: dynamic()` synthesises a `{ type: "value", address: "self" }`
+     * entry). Forwarded verbatim by `useResolveActions` into `Call.hydrateEntries`.
+     *
+     * This field is SDK-internal plumbing — callers express hydration needs via
+     * high-level sugar (`dynamic()`, `self()`) on builder params, not by populating
+     * this list directly.
+     */
+    hydrateEntries?: HydrateTypeData[];
+};
+export type AssertERC20BalanceItem = {
+    type: "assert";
+    assertType: "erc20Balance";
+    token: TokenOrAddress;
+    gte: ActionAmount;
+};
+export type AssertNativeBalanceItem = {
+    type: "assert";
+    assertType: "nativeBalance";
+    gte: ActionAmount;
+};
+export type AssertNotExpiredItem = {
+    type: "assert";
+    assertType: "notExpired";
+    deadline: number;
+};
+export type AssertERC20AllowanceItem = {
+    type: "assert";
+    assertType: "erc20Allowance";
+    token: TokenOrAddress;
+    spender: `0x${string}`;
+    gte: ActionAmount;
+};
+export type AssertActionItem = AssertERC20BalanceItem | AssertNativeBalanceItem | AssertNotExpiredItem | AssertERC20AllowanceItem;
+export type ActionItem = LendActionItem | SwapActionItem | DepositActionItem | CustomActionItem | AssertActionItem;
+//# sourceMappingURL=types.d.ts.map

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

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