WrapSwap2Protocol

Defined in: protocol-swap2-wrap/src/protocol.ts:9

Wrap / unwrap the native coin on one account (ETH ↔ WETH and friends).

Extends

SingleProviderSwap2

Constructors

Constructor

new WrapSwap2Protocol(account, config): WrapSwap2Protocol

Defined in: protocol-swap2-wrap/src/protocol.ts:13

Parameters

account

unknown

config

WrapSwap2Config

Returns

WrapSwap2Protocol

Overrides

SingleProviderSwap2.constructor

Properties

_account

protected readonly _account: IWalletAccountReadOnly | IWalletAccount

Defined in: core/dist/index-QWdcwE6y.d.ts:309

Inherited from

SingleProviderSwap2._account

_config

protected readonly _config: Swap2ProtocolConfig

Defined in: core/dist/index-QWdcwE6y.d.ts:310

Inherited from

SingleProviderSwap2._config

fromChain

protected readonly fromChain: string

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:215

Inherited from

SingleProviderSwap2.fromChain

provider

protected readonly provider: CrossChainProvider

Defined in: protocol-swap2-wrap/src/protocol.ts:10

Overrides

SingleProviderSwap2.provider

Methods

assertFeeCaps()

protected assertFeeCaps(fees, sourceAmount, sourceToken, config?): void

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:247

Parameters

fees

readonly Swap2Fee[] | undefined

sourceAmount

bigint

sourceToken

string

config?

Swap2ProtocolConfig

Returns

void

Inherited from

SingleProviderSwap2.assertFeeCaps

assertFeeConfig()

protected assertFeeConfig(config?): void

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:246

Parameters

config?

Swap2ProtocolConfig

Returns

void

Inherited from

SingleProviderSwap2.assertFeeConfig

assertQuoteFeeCaps()

protected assertQuoteFeeCaps(q, options, config?): void

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:248

Parameters

q

Quote

options

Swap2Options

config?

Swap2ProtocolConfig

Returns

void

Inherited from

SingleProviderSwap2.assertQuoteFeeCaps

bridge()

bridge(options): Promise<BridgeResult>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:302

The inherited bridge() has no floor field: quote first, then bind execution to that quote’s minimum so the inherited convenience API stays safe.

Parameters

options

BridgeOptions

Returns

Promise<BridgeResult>

Inherited from

SingleProviderSwap2.bridge

chainSupported()

protected chainSupported(caip2): boolean

Defined in: protocol-swap2-wrap/src/protocol.ts:19

Whether this protocol can route a chain at all (for support discovery).

Parameters

caip2

string

Returns

boolean

Overrides

SingleProviderSwap2.chainSupported

claimSwap2()

claimSwap2(id, account): Promise<{ chain: string; hash: string; id: string; }>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:295

Two-phase routes (CCTP-style burn-and-mint): once getSwap2Status reports “action-required”, the delivery needs a second transaction on the DESTINATION chain, signed there and paid in that chain’s gas. account is the destination-chain account (the bound source account is not reused: the chains differ). The provider builds the claim from the attestation; it is refused when not ready, when it names another chain than the account, or when it is anything but plain EVM calldata. Returns the claim hash and the status id to keep polling with.

Parameters

id

string

account

unknown

Returns

Promise<{ chain: string; hash: string; id: string; }>

Inherited from

SingleProviderSwap2.claimSwap2

close()

close(): void

Defined in: protocol-swap2-core/dist/swap2/single.d.ts:18

Returns

void

Inherited from

SingleProviderSwap2.close

describeActivity()

describeActivity(tx, ctx): ActivityItem | null

Defined in: protocol-swap2-core/dist/swap2/single.d.ts:16

Activity recognition lives on the provider (shared with the router); null when it has none.

Parameters

tx

ChainTx

ctx

DescribeActivityContext

Returns

ActivityItem | null

Inherited from

SingleProviderSwap2.describeActivity

emitPhase()

protected emitPhase(phase, detail?): void

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:228

Report an execution phase; an observer that throws is ignored.

Parameters

phase

Swap2ExecutionPhase

detail?

Swap2ExecutionPhaseDetail

Returns

void

Inherited from

SingleProviderSwap2.emitPhase

getSupportedChains()

getSupportedChains(): Promise<Swap2SupportedChain[]>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:306

Source chains this protocol can swap from.

Returns

Promise<Swap2SupportedChain[]>

Inherited from

SingleProviderSwap2.getSupportedChains

getSupportedTokens()

getSupportedTokens(options?): Promise<Swap2SupportedToken[]>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:308

Tokens of the asset catalog on the supported chains, optionally narrowed.

Parameters

options?

Swap2SupportedTokensOptions

Returns

Promise<Swap2SupportedToken[]>

Inherited from

SingleProviderSwap2.getSupportedTokens

getSwap2Status()

getSwap2Status(id, _options?): Promise<Swap2StatusResult>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:284

Status of a swap by the id swap2() returned, asked from the provider that executed it.

Parameters

id

string

_options?

Swap2StatusOptions

Returns

Promise<Swap2StatusResult>

Inherited from

SingleProviderSwap2.getSwap2Status

noRouteDetail()

protected noRouteDetail(): string

Defined in: protocol-swap2-core/dist/swap2/single.d.ts:13

Why the last resolveQuote came back empty (venue names + reasons), or “”. Rides inside the no-route error so execution failures are diagnosable from the surface that shows them.

Returns

string

Inherited from

SingleProviderSwap2.noRouteDetail

pairSupported()

protected pairSupported(fromChain, toChain): boolean

Defined in: protocol-swap2-wrap/src/protocol.ts:22

Pair-level capability used when discovery specifies both endpoints.

Parameters

fromChain

string

toChain

string

Returns

boolean

Overrides

SingleProviderSwap2.pairSupported

prepareOptions()

protected prepareOptions(options): Promise<Swap2Options>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:242

Options ready to quote: with allowUnlistedTokens, an unlisted source token gets its decimals, read from the chain through the account (cached per token) — a caller’s fromTokenDecimals that disagrees is refused. Listed tokens and every option otherwise pass through unchanged.

Parameters

options

Swap2Options

Returns

Promise<Swap2Options>

Inherited from

SingleProviderSwap2.prepareOptions

protocolEnabled()

protected protocolEnabled(): boolean

Defined in: protocol-swap2-core/dist/swap2/single.d.ts:17

Runtime availability used by the public discovery methods.

Returns

boolean

Inherited from

SingleProviderSwap2.protocolEnabled

providerFor()

protected providerFor(name): CrossChainProvider | undefined

Defined in: protocol-swap2-core/dist/swap2/single.d.ts:14

Look up a provider by name to resume/track an in-flight swap2.

Parameters

name

string

Returns

CrossChainProvider | undefined

Inherited from

SingleProviderSwap2.providerFor

quoteBridge()

quoteBridge(options): Promise<BridgeQuote>

Defined in: core/dist/index-QWdcwE6y.d.ts:609

The older quoteBridge, run through quoteSwap2.

Parameters

options

BridgeOptions

Returns

Promise<BridgeQuote>

Inherited from

SingleProviderSwap2.quoteBridge

quoteSwap()

quoteSwap(options): Promise<SwapQuote>

Defined in: core/dist/index-QWdcwE6y.d.ts:605

The older quoteSwap, run through quoteSwap2.

Parameters

options

SwapOptions

Returns

Promise<SwapQuote>

Inherited from

SingleProviderSwap2.quoteSwap

quoteSwap2()

quoteSwap2(options): Promise<Swap2Quote>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:261

Ask for a quote and check it against the request (amounts, slippage floor, fee ceilings in the protocol config). Works on a read-only account.

Parameters

options

Swap2Options

Returns

Promise<Swap2Quote>

Throws

Swap2QuoteError when no route answers, with the provider’s own reason when it gave one.

Inherited from

SingleProviderSwap2.quoteSwap2

requireSigningAccount()

protected requireSigningAccount(methodName): IWalletAccount

Defined in: core/dist/index-QWdcwE6y.d.ts:322

The account, narrowed to a signing one, or a ReadOnlyAccountError naming the caller.

Parameters

methodName

string

Returns

IWalletAccount

Inherited from

SingleProviderSwap2.requireSigningAccount

resolveQuote()

protected resolveQuote(params): Promise<Quote | null>

Defined in: protocol-swap2-core/dist/swap2/single.d.ts:12

Quote the route (single provider, or best across the router).

Parameters

params

QuoteParams

Returns

Promise<Quote | null>

Inherited from

SingleProviderSwap2.resolveQuote

routeQuote()

protected routeQuote(q, options): Swap2Quote | null

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:253

A dry route the auction already validated → the public quote, or null when the caller’s floor / fee caps refuse it.

Parameters

q

Quote

options

Swap2Options

Returns

Swap2Quote | null

Inherited from

SingleProviderSwap2.routeQuote

snapshotOf()

protected snapshotOf(options): Swap2Options

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:251

A frozen, validated copy of caller options (what every engine path works from).

Parameters

options

Swap2Options

Returns

Swap2Options

Inherited from

SingleProviderSwap2.snapshotOf

sourceAsset()

protected sourceAsset(options): CcAsset | undefined

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:235

The source asset the options name: the catalog’s, or (allowUnlistedTokens) an unlisted one with its decimals.

Parameters

options

Swap2Options

Returns

CcAsset | undefined

Inherited from

SingleProviderSwap2.sourceAsset

swap()

swap(options): Promise<SwapResult>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:304

Same protection for legacy exact-in swap() calls whose min is optional.

Parameters

options

SwapOptions

Returns

Promise<SwapResult>

Inherited from

SingleProviderSwap2.swap

swap2()

swap2(options, config?): Promise<Swap2Result>

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:271

Re-quote, check the quote, show it to reviewExecution when configured, send any approvals, then sign and broadcast the source leg. An identical call already in flight on the same account is refused.

Parameters

options

Swap2Options

config?

Swap2ProtocolConfig

Returns

Promise<Swap2Result>

Throws

Swap2ExecutionError for a read-only account, Swap2InFlightError for a double tap, Swap2MaybeSentError when the broadcast outcome is unknown (do not retry; track hash).

Inherited from

SingleProviderSwap2.swap2

toParams()

protected toParams(given, dry): QuoteParams

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:244

Swap2Options → the engine’s QuoteParams (exact-in only).

Parameters

given

Swap2Options

dry

boolean

Returns

QuoteParams

Inherited from

SingleProviderSwap2.toParams

toQuote()

protected toQuote(q, options): Swap2Quote

Defined in: protocol-swap2-core/dist/swap2/base.d.ts:249

Parameters

q

Quote

options

Swap2Options

Returns

Swap2Quote

Inherited from

SingleProviderSwap2.toQuote