Rhino.fi Swidge Configuration

Community modules are developed and maintained independently by third-party contributors.

Tether and the WDK Team do not endorse or assume responsibility for their code, security, or maintenance. Use your own judgment and proceed at your own risk.

RhinofiProtocol requires a Rhino.fi API key. The SDK authenticates every call, including quote and discovery calls. Create and manage API keys in the Rhino.fi Console.

import RhinofiProtocol from '@rhino.fi/wdk-protocol-swidge-rhinofi'

const rhinofi = new RhinofiProtocol(account, {
  apiKey: process.env.RHINO_API_KEY,
  maxNetworkFeeBps: 50,
  maxProtocolFeeBps: 30
})

Constructor

new RhinofiProtocol(account?, config)

Parameter	Description
`account`	Optional WDK EVM account. Writable accounts can execute. Read-only accounts can quote and discover support.
`config`	Required `RhinofiProtocolConfig`. Must include `apiKey`.

Configuration Options

Option	Type	Description
`apiKey`	`string`	Rhino.fi API key. Required for every call.
`apiBaseUrl`	`string`	Optional Rhino.fi API base URL override. Use `https://`.
`maxNetworkFeeBps`	`number \| bigint`	Rejects execution when network fees exceed this many basis points of the input amount.
`maxProtocolFeeBps`	`number \| bigint`	Rejects execution when protocol fees exceed this many basis points of the input amount.
`configTtlMs`	`number`	Milliseconds to cache Rhino.fi config and swap-token lists. Defaults to `60000`; set `0` to always fetch fresh.

Per-Call Overrides

Pass config to swidge(options, config) to override fee caps for a single execution.

await rhinofi.swidge(options, {
  maxNetworkFeeBps: 40,
  maxProtocolFeeBps: 25
})

API Base URL

Use https:// API URLs. http:// URLs can redirect and break authenticated SDK requests.

const rhinofi = new RhinofiProtocol(account, {
  apiKey: process.env.RHINO_API_KEY,
  apiBaseUrl: 'https://api.rhino.fi'
})

Config Caching

The module caches Rhino.fi chain config and swap-token lists for configTtlMs.

const rhinofi = new RhinofiProtocol(account, {
  apiKey: process.env.RHINO_API_KEY,
  configTtlMs: 60000
})

Set configTtlMs: 0 when you need every call to fetch fresh provider configuration.

Security Notes

Store apiKey in server-side or secret-managed configuration.
Use trusted RPC providers for WDK EVM accounts.
Set fee caps for user-facing flows.
Ask for user confirmation before calling swidge().

Usage

Quote, execute, and track Rhino.fi swidge routes.

API Reference

Detailed method, type, status, fee, and error reference.