router state

cloneStringInt64Map

cloneStringInt64Map returns a copy so callers cannot reach the stored map.

ExactInSwapRoute

ExactInSwapRoute executes a multi-hop swap for an exact input amount. Parameters: - cur: current realm context; callers use cross(cur) when crossing into this realm - inputToken: input token path - outputToken: output token path - amountIn: exact input amount - routeArr: encoded route - quoteArr: encoded quotes - amountOutMin: minimum output amount - deadline: transaction deadline - referrer: referral address Returns: - amountIn: input amount consumed - amountOut: net output amount delivered after the router fee Halt check: reverts while the Router halt scope is active.

ExactInSingleSwapRoute

ExactInSingleSwapRoute executes a single-hop swap for an exact input amount. Parameters: - cur: current realm context; callers use cross(cur) when crossing into this realm - inputToken: input token path - outputToken: output token path - amountIn: exact input amount - routeArr: encoded route - amountOutMin: minimum output amount - sqrtPriceLimitX96: Q64.96 price limit - deadline: transaction deadline - referrer: referral address Returns: - amountIn: input amount consumed (a nonzero price limit may stop early) - amountOut: net output amount delivered after the router fee Halt check: reverts while the Router halt scope is active.

ExactOutSwapRoute

ExactOutSwapRoute executes a multi-hop swap for a requested post-fee output target. Parameters: - cur: current realm context; callers use cross(cur) when crossing into this realm - inputToken: input token path - outputToken: output token path - amountOut: requested net output target - routeArr: encoded route - quoteArr: encoded quotes - amountInMax: maximum input amount - deadline: transaction deadline - referrer: referral address Returns: - amountIn: input amount consumed - amountOut: net output delivered after the router fee Halt check: reverts while the Router halt scope is active.

ExactOutSingleSwapRoute

ExactOutSingleSwapRoute executes a single-hop swap for a requested post-fee output target. Parameters: - cur: current realm context; callers use cross(cur) when crossing into this realm - inputToken: input token path - outputToken: output token path - amountOut: requested net output target - routeArr: encoded route - amountInMax: maximum input amount - sqrtPriceLimitX96: Q64.96 price limit - deadline: transaction deadline - referrer: referral address Returns: - amountIn: input amount consumed (a nonzero price limit may stop early) - amountOut: net output delivered after the router fee; it may be below the requested target when the limit is reached Halt check: reverts while the Router halt scope is active.

DrySwapRoute

DrySwapRoute simulates a swap route without changing state. Parameters: - inputToken: input token path - outputToken: output token path - specifiedAmount: exact input or output amount - swapTypeStr: \`EXACT\_IN\` or \`EXACT\_OUT\` - strRouteArr: encoded route - quoteArr: encoded quotes - tokenAmountLimit: minimum output or maximum input amount Returns: - amountIn: estimated input amount - amountOut: estimated output amount - err: non-nil when route validation or simulation fails

SwapCallback

SwapCallback transfers amounts owed by a pool during a swap. Parameters: - cur: current realm context; callers use cross(cur) when crossing into this realm - token0Path: token0 path - token1Path: token1 path - amount0Delta: token0 amount owed to or by the pool - amount1Delta: token1 amount owed to or by the pool - payer: address that supplies positive deltas Returns: - err: non-nil when payment validation or transfer fails Halt check: reverts while the Router halt scope is active.

GetSwapFee

GetSwapFee retrieves the current swap fee from persistent storage. Returns: - fee: configured router fee in basis points; panics if the key is missing or has the wrong type

SetSwapFee

SetSwapFee stores the router fee in persistent storage. Parameters: - \_: leading call discriminator; callers pass 0 - rlm: current realm context; must be the current crossing frame - fee: router fee rate in basis points Returns: - err: nil when storage succeeds; an error when rlm is not current or KVStore rejects the write

GetPendingProtocolFees

GetPendingProtocolFees retrieves the token-path keyed pending protocol-fees map. Returns: - fees: stored token-path to pending amount map; panics if storage is missing or has the wrong type

Render

Render delegates web rendering to the active implementation.

domainPath

currentAddress

kvStore

versionManager

implementation

init.16

initializeDomainStore

getImplementation

updateImplementation

errSpoofedRealm

StoreKey

StoreKeySwapFee

// Swap fee in basis points

StoreKeyPendingProtocolFees

// tokenPath -> amount held locally for protocol\_fee

routerStore

NewRouterStore

NewRouterStore creates a router store backed by the provided KV store. Parameters: - kvStore: persistent key-value store used for router fee and pending-fee data Returns: - routerStore: router storage implementation using kvStore

IRouter

IRouterStore

RegisterInitializer

RegisterInitializer registers a new router implementation version. Each implementation package calls it during initialization before it can be selected. Parameters: - cur: current realm context; callers use cross(cur) when crossing into this realm - initializer: callback that receives the propagated realm context and router store, then constructs the IRouter implementation

UpgradeImpl

UpgradeImpl switches the active router implementation to a different registered version. Parameters: - cur: current realm context; callers use cross(cur) when crossing into this realm - packagePath: package path of the previously registered implementation to activate

GetImplementationPackagePath

GetImplementationPackagePath returns the package path of the currently active implementation. Returns: - packagePath: package path of the active implementation