Skip to content
docs

@anywalletkit/protocol-swap2-thorchain

@anywalletkit/protocol-swap2-thorchain

Section titled “@anywalletkit/protocol-swap2-thorchain”

npm

THORChain native cross-chain swaps as a swap2 module: EVM sources (Ethereum, Base, BSC, Avalanche) deposit into the THORChain router with depositWithExpiry(vault, asset, amount, memo, expiry); Tron executes as a native send to the inbound vault with a memo. Standalone through ThorchainSwap2Protocol, or as one provider of the router.

Install

Section titled “Install”
Terminal window
npm install @anywalletkit/protocol-swap2-thorchain @anywalletkit/core
# or: pnpm add @anywalletkit/protocol-swap2-thorchain @anywalletkit/core  ·  yarn add @anywalletkit/protocol-swap2-thorchain @anywalletkit/core

On npm: @anywalletkit/protocol-swap2-thorchain, published from the release workflow with provenance.

Where the funds go

Section titled “Where the funds go”

The router an EVM-source swap calls and approves must be one of THORCHAIN_ROUTERS (Ethereum, BSC, Avalanche, Base; trustedRouters adds one, e.g. during a router migration), and the inbound vault the router pays must be reported by a second THORNode (any node other than the one that quoted) both when the quote is taken and right before broadcast. A disagreeing node, or no second node answering, refuses the swap. The defaults are two public nodes of different operators (Liquify’s gateway and the IBS team’s node, both checked on 2026-10-28); with one nodeUrl of your own, the defaults confirm it unless confirmNodeUrl names another node (pick one of another operator; a local mock needs a second mock there). Node URLs must be https: (allowInsecureNodeUrl for local development).

Behind remoteProvider, the app checks the backend’s build itself: remoteProvider({name: "thorchain", baseUrl, ...thorchainPins()}) pins the routers and runs verifyBuild on the client — the vault in the router call confirmed by two nodes, the source asset and exact input, and the memo’s destination, refund and limit against the app’s own request (pass the backend’s affiliate / affiliateBps). The pins open the stub to the Tron deposit route (depositAddressRoutes): its vault is the one verifyBuild confirms.

Activity

Section titled “Activity”

Routers and Asgard vaults rotate, so describeActivity(tx, ctx) matches no address — only the router’s unique ABI, on the EVM chains this module serves:

Selector Meaning Kind Title
depositWithExpiry(address,address,uint256,string,uint256) 0x44bc937b, sent by the owner our source leg bridge (swap when the output also landed here) “Bridged USDC”
transferOut(address,address,uint256,string) 0x574da717 / transferOutAndCall 0xec341444, with something arriving at the owner THORChain paying a destination leg bridge “Received USDC via THORChain”

Subtitle “THORChain”, counterparty = the router called. Not recognizable offline: the Tron / BTC vault deposits (plain sends with a memo, vault addresses rotate) and the destination leg on non-EVM chains.

Fixtures (fixtures/activity/, test wallet on Ethereum, 2026-10-10): two depositWithExpiry USDC deposits and one router transferOut that paid the wallet; negatives: a LI.FI swap, a Uniswap multicall.

Classes

Section titled “Classes”

Interfaces

Section titled “Interfaces”

Variables

Section titled “Variables”

Functions

Section titled “Functions”

References

Section titled “References”

default

Section titled “default”

Renames and re-exports ThorchainSwap2Protocol