@swapdk/wdk-protocol-swidge-swapdk 1.0.0-alpha.0

package/dist/adapters/solana.js

@@ -0,0 +1,96 @@
+// ---------------------------------------------------------------------------
+// Swidge adapter: Solana source.
+//
+// Builds a Solana `transactionMessage` combining two instructions:
+//   1. SystemProgram transfer of `lamports` from source → THORChain inbound vault
+//   2. Memo Program instruction carrying the THORChain swap memo
+//
+// Both come from the /quote response — swap-engine returns
+// `route.inboundAddress` (the rotating THORChain SOL vault) and
+// `route.memo` (the encoded swap intent). No /swap round-trip needed;
+// Solana source is a pure /quote-driven build like Bitcoin's
+// THORChain path.
+//
+// Native SOL only in this MVP. SPL sources are not yet supported —
+// they need a different instruction (SPL Token transfer) and an
+// associated token account lookup, which is a separate design pass.
+//
+// The paired wallet is `@tetherto/wdk-wallet-solana` — its
+// `sendTransaction` fills in blockhash + fee payer, signs, and
+// broadcasts.
+// ---------------------------------------------------------------------------
+import { SwapDKUserError } from "@swapdk/swap-engine-client";
+import { address } from "@solana/addresses";
+import { createNoopSigner } from "@solana/signers";
+import { appendTransactionMessageInstruction, createTransactionMessage, } from "@solana/transaction-messages";
+import { getTransferSolInstruction } from "@solana-program/system";
+import { getAddMemoInstruction } from "@solana-program/memo";
+import { fromHumanAmount } from "../asset-encode.js";
+// SOL native decimals — 1 SOL = 1e9 lamports.
+const SOL_DECIMALS = 9;
+export const solanaAdapter = {
+    family: "solana",
+    // Solana source builds its tx from /quote alone (inboundAddress +
+    // memo + sellAmount) — same pattern as Bitcoin's THORChain path.
+    needsSwapResponse: false,
+    async execute(account, ctx) {
+        const { route, sourceAddress, fromChain, options } = ctx;
+        if (isSplToken(options.fromToken)) {
+            throw new SwapDKUserError("SwapDKSwidge (solana): SPL-token sources are not yet supported — " +
+                "pass `fromToken: \"SOL\"` for native SOL. SPL support requires a " +
+                "separate SPL Token instruction path.");
+        }
+        if (!route.inboundAddress) {
+            throw new SwapDKUserError("SwapDKSwidge (solana): swap-engine quote returned no inboundAddress. " +
+                `Providers: ${route.providers.join(", ")}`);
+        }
+        if (!route.memo) {
+            throw new SwapDKUserError("SwapDKSwidge (solana): swap-engine quote returned no memo. Without a " +
+                "memo the THORChain observer cannot route the deposit and funds " +
+                `would be lost. Providers: ${route.providers.join(", ")}`);
+        }
+        const lamports = fromHumanAmount(route.sellAmount, SOL_DECIMALS);
+        const transactionMessage = buildNativeTransferWithMemo({
+            source: sourceAddress,
+            destination: route.inboundAddress,
+            lamports,
+            memo: route.memo,
+        });
+        const result = await account.sendTransaction(transactionMessage);
+        if (account.waitForTransaction) {
+            await account.waitForTransaction(result.hash);
+        }
+        const transactions = [
+            { hash: result.hash, chain: fromChain, type: "source" },
+        ];
+        return { hash: result.hash, transactions };
+    },
+};
+// -- helpers -------------------------------------------------------------
+/**
+ * Best-effort SPL detection: a swidge `fromToken` that isn't "SOL"
+ * (case-insensitive) is treated as an SPL mint address. Discovery
+ * endpoints return SPL mints in their raw base58 form; native SOL
+ * comes back as the uppercase ticker.
+ */
+function isSplToken(fromToken) {
+    if (!fromToken)
+        return false;
+    return fromToken.trim().toUpperCase() !== "SOL";
+}
+export function buildNativeTransferWithMemo(args) {
+    const sourceAddr = address(args.source);
+    const destAddr = address(args.destination);
+    // A NoopSigner is a placeholder with the right shape carrying only
+    // the address. The WDK Solana wallet later attaches the real
+    // fee-payer signer, which covers the whole tx.
+    const sourceSigner = createNoopSigner(sourceAddr);
+    const transferIx = getTransferSolInstruction({
+        source: sourceSigner,
+        destination: destAddr,
+        amount: args.lamports,
+    });
+    const memoIx = getAddMemoInstruction({ memo: args.memo });
+    return appendTransactionMessageInstruction(memoIx, appendTransactionMessageInstruction(transferIx, createTransactionMessage({ version: 0 })));
+}
+//# sourceMappingURL=solana.js.map

package/dist/adapters/solana.js.map

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

package/dist/adapters/tron.d.ts

@@ -0,0 +1,18 @@
+import type { TronPrebuiltTransaction } from "../types.js";
+import type { SwidgeAdapter } from "./types.js";
+/**
+ * Structural subset of `@tetherto/wdk-wallet-tron@^1.0.0-beta.8`'s
+ * `WalletAccountTron`. Adapter never touches key material — only
+ * `getAddress()` (base58) and `sendTransaction(prebuiltTx)`.
+ */
+export interface SwidgeTronAccount {
+    getAddress(): string | Promise<string>;
+    sendTransaction(tx: TronPrebuiltTransaction): Promise<{
+        hash: string;
+        fee: bigint;
+        activationFee?: bigint;
+    }>;
+    waitForTransaction?(hash: string, timeoutMs?: number): Promise<void>;
+}
+export declare const tronAdapter: SwidgeAdapter;
+//# sourceMappingURL=tron.d.ts.map

package/dist/adapters/tron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tron.d.ts","sourceRoot":"","sources":["../../src/adapters/tron.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,uBAAuB,EAAe,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,eAAe,CAAC,EAAE,EAAE,uBAAuB,GAAG,OAAO,CAAC;QACpD,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,eAAO,MAAM,WAAW,EAAE,aAqFzB,CAAC"}

package/dist/adapters/tron.js

@@ -0,0 +1,119 @@
+// ---------------------------------------------------------------------------
+// Swidge adapter: TRON source.
+//
+// Two tx shapes swap-engine may emit for TRON, picked from the /swap
+// response:
+//
+//   - Router path (default): `tx.data` carries `depositWithExpiry`
+//     calldata, `tx.to` is the router contract, `tx.memo` is empty.
+//     Adapter builds a `TriggerSmartContract` with raw calldata via
+//     `tronWeb.transactionBuilder.triggerSmartContract(to, "", { input }, [], ownerHex)`.
+//
+//   - Direct-vault path: `tx.data` is empty, `tx.memo` carries the
+//     routing memo. Used when THORChain has the TRON pool unhalted for
+//     trading but the router contract isn't deployed (transitional
+//     state observed mid-2026). Adapter builds a `TransferContract` via
+//     `sendTrx()` + attaches the memo through `addUpdateData()` — the
+//     latter recomputes `txID` because the memo is part of the tx hash
+//     preimage.
+//
+// For TRC-20 sources, swap-engine emits an `approvalTx` alongside the
+// main tx; adapter dispatches it first, waits for confirmation, then
+// sends the router call. Same pattern as `SwapDKBridgeTron`.
+//
+// Requires a `tronWeb` instance on `SwapDKSwidgeConfig.tronWeb`. Pass
+// the same tronweb instance the paired `WalletManagerTron` was built
+// with — the adapter only reads from it (address encoding, feeLimit
+// fallback, transactionBuilder), no key material is exchanged.
+// ---------------------------------------------------------------------------
+import { SwapDKUserError } from "@swapdk/swap-engine-client";
+export const tronAdapter = {
+    family: "tron",
+    needsSwapResponse: true,
+    async execute(account, ctx) {
+        const { swapRes, config, sourceAddress, fromChain } = ctx;
+        if (!swapRes) {
+            throw new SwapDKUserError("SwapDKSwidge (tron): missing /swap response — this is a bug in the swidge module (adapter should have signalled needsSwapResponse=true).");
+        }
+        const tronWeb = config.tronWeb;
+        if (!tronWeb) {
+            throw new SwapDKUserError("SwapDKSwidge (tron): config.tronWeb is required. Pass the tronweb instance the paired WalletManagerTron was constructed with.");
+        }
+        const sourceAddressHex = tronWeb.address.toHex(sourceAddress);
+        const transactions = [];
+        // 1. TRC-20 approval leg, when present.
+        if (swapRes.approvalTx) {
+            const approvePrebuilt = await buildContractCallTx(tronWeb, {
+                to: swapRes.approvalTx.to,
+                data: swapRes.approvalTx.data,
+                value: swapRes.approvalTx.value,
+                feeLimit: swapRes.approvalTx.feeLimit,
+                ownerHex: sourceAddressHex,
+            });
+            const approveResult = await account.sendTransaction(approvePrebuilt);
+            transactions.push({
+                hash: approveResult.hash,
+                chain: fromChain,
+                type: "approval",
+            });
+            if (account.waitForTransaction) {
+                await account.waitForTransaction(approveResult.hash);
+            }
+        }
+        // 2. Main leg — dispatch on tx.data (router) vs tx.memo (direct vault).
+        const tx = swapRes.tx;
+        if (!tx) {
+            throw new SwapDKUserError("SwapDKSwidge (tron): swap-engine returned no transaction data. " +
+                `Providers: ${swapRes.providers.join(", ")}`);
+        }
+        let prebuilt;
+        if (tx.data && tx.data !== "") {
+            prebuilt = await buildContractCallTx(tronWeb, {
+                to: tx.to,
+                data: tx.data,
+                value: tx.value,
+                feeLimit: tx.feeLimit,
+                ownerHex: sourceAddressHex,
+            });
+        }
+        else if (tx.memo && tx.memo !== "") {
+            prebuilt = await buildTransferWithMemoTx(tronWeb, {
+                to: tx.to,
+                value: tx.value,
+                memo: tx.memo,
+                ownerAddress: sourceAddress,
+            });
+        }
+        else {
+            throw new SwapDKUserError("SwapDKSwidge (tron): swap-engine returned a SwapTx with neither `data` nor `memo` — cannot dispatch. " +
+                `Providers: ${swapRes.providers.join(", ")}`);
+        }
+        const sendResult = await account.sendTransaction(prebuilt);
+        transactions.push({
+            hash: sendResult.hash,
+            chain: fromChain,
+            type: "source",
+        });
+        return { hash: sendResult.hash, transactions };
+    },
+};
+// -- prebuilt-tx builders (shared with the legacy SwapDKBridgeTron) ------
+async function buildContractCallTx(tronWeb, args) {
+    if (!args.data) {
+        throw new SwapDKUserError("SwapDKSwidge (tron): buildContractCallTx requires `data` (ABI calldata)");
+    }
+    const inputHex = String(args.data).replace(/^0x/, "");
+    const callValue = args.value !== undefined && args.value !== "" ? Number(args.value) : 0;
+    const energyCap = args.feeLimit !== undefined && args.feeLimit !== ""
+        ? Number(args.feeLimit)
+        : tronWeb.feeLimit;
+    const { transaction } = await tronWeb.transactionBuilder.triggerSmartContract(args.to, "", // functionSelector empty → options.input carries the raw calldata
+    { feeLimit: energyCap, callValue, input: inputHex }, [], args.ownerHex);
+    return transaction;
+}
+async function buildTransferWithMemoTx(tronWeb, args) {
+    const sun = args.value !== undefined && args.value !== "" ? Number(args.value) : 0;
+    const transferTx = await tronWeb.transactionBuilder.sendTrx(args.to, sun, args.ownerAddress);
+    return await tronWeb.transactionBuilder.addUpdateData(transferTx, args.memo, "utf8");
+}
+//# sourceMappingURL=tron.js.map

package/dist/adapters/tron.js.map

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

package/dist/adapters/types.d.ts

@@ -0,0 +1,69 @@
+import type { QuoteRoute, SwapDKClient, SwapResponse } from "@swapdk/swap-engine-client";
+import type { SwidgeTransaction } from "../SwapDKSwidge.js";
+import type { SwapDKSwidgeConfig, SwapDKSwidgeOptions } from "../types.js";
+/**
+ * Context threaded from SwapDKSwidge into the adapter.
+ *
+ * `route` is the best route selected from /quote — every adapter has
+ * this. `swapRes` is the finalized /swap response with calldata; it's
+ * populated only when SwapDKSwidge determined the family needs it (EVM,
+ * Cosmos-MsgSend, TRON — all need calldata from /swap). Bitcoin's
+ * THORChain path constructs its tx directly from `route.inboundAddress`
+ * + `route.memo` so `swapRes` is omitted for that adapter.
+ *
+ * `client` gives the adapter access to additional endpoints — currently
+ * only `openBrokerChannel` (Chainflip); most adapters won't touch it.
+ *
+ * `sourceAddress` is pre-resolved from `account.getAddress()` — some
+ * adapters need it for /swap parameters or refund addresses; pre-
+ * resolving avoids duplicate calls.
+ */
+export interface SwidgeAdapterContext {
+    route: QuoteRoute;
+    swapRes?: SwapResponse;
+    client: SwapDKClient;
+    options: SwapDKSwidgeOptions;
+    config: SwapDKSwidgeConfig;
+    fromChain: string;
+    sourceAddress: string;
+}
+/**
+ * Result an adapter produces. `hash` is the primary source-chain
+ * transaction hash — surfaced on `SwidgeResult.hash` for the caller.
+ * `transactions` is the full per-tx list including any approval /
+ * auxiliary steps; SwapDKSwidge writes it verbatim into
+ * `SwidgeResult.transactions`.
+ */
+export interface SwidgeAdapterResult {
+    hash: string;
+    transactions: SwidgeTransaction[];
+}
+/**
+ * Common interface every source-chain adapter implements. Adapters are
+ * chain-family-specific — one per {btc, cosmos, evm, solana, tron}.
+ */
+export interface SwidgeAdapter {
+    /**
+     * Chain family this adapter handles. Matches the `family` return
+     * value from `chainFamilyFor()` in chain-map.ts.
+     */
+    readonly family: "bitcoin" | "cosmos" | "evm" | "solana" | "tron";
+    /**
+     * Whether SwapDKSwidge should fetch the /swap response before
+     * dispatching. Adapters that build their tx from /quote data alone
+     * (Bitcoin's THORChain path) return `false`; adapters that need
+     * finalized calldata (EVM, Cosmos-MsgSend, TRON) return `true`.
+     *
+     * Default (undefined) is treated as `true` to preserve backwards
+     * compatibility with the initial EVM-only shape.
+     */
+    readonly needsSwapResponse?: boolean;
+    /**
+     * Dispatch the outbound transaction(s). Adapters are expected to
+     * throw a `SwapDKUserError` on caller-fixable problems (missing
+     * calldata, unsupported route shape) and a `SwapDKError` subclass
+     * on transport failures.
+     */
+    execute(account: any, ctx: SwidgeAdapterContext): Promise<SwidgeAdapterResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACb,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAElE;;;;;;;;OAQG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAErC;;;;;OAKG;IACH,OAAO,CAEL,OAAO,EAAE,GAAG,EACZ,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC"}

package/dist/adapters/types.js

@@ -0,0 +1,16 @@
+// ---------------------------------------------------------------------------
+// Shared shape for source-chain adapters.
+//
+// Each adapter takes the /swap response from swap-engine and the source
+// wallet account, dispatches the outbound transaction(s), and returns the
+// data SwapDKSwidge needs to build its `SwidgeResult` (primary tx hash,
+// per-tx list, and any auxiliary results the source chain produces —
+// approval tx for ERC-20, activation fee for TRON, etc.).
+//
+// Adapters are intentionally isolated from the swap-engine HTTP layer:
+// SwapDKSwidge fetches the /swap response and hands the parsed tx to the
+// adapter's `execute()`. This keeps the adapter's dependency surface small
+// (only the paired wallet account interface + a few internal helpers).
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0CAA0C;AAC1C,EAAE;AACF,wEAAwE;AACxE,0EAA0E;AAC1E,wEAAwE;AACxE,qEAAqE;AACrE,0DAA0D;AAC1D,EAAE;AACF,uEAAuE;AACvE,yEAAyE;AACzE,2EAA2E;AAC3E,uEAAuE;AACvE,8EAA8E"}

package/dist/asset-encode.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Encodes a swidge {chain, token} pair into the SwapKit asset string the
+ * swap-engine `/quote` / `/swap` endpoints consume.
+ *
+ * Rules:
+ *   - Native token (matches the chain's nativeSymbol): `"CHAIN.TICKER"`.
+ *   - Address-based token: `"CHAIN.<TICKER-placeholder>-<address>"`. The
+ *     swap-engine parser strips everything before the '-' when resolving
+ *     the actual asset, so the placeholder is unused — we pass "T" as a
+ *     non-empty stub.
+ *
+ * Throws `Error` when the chain is not in the swidge catalogue.
+ */
+export declare function encodeSwapKitAsset(swidgeChain: string, token: string): string;
+/**
+ * Converts a base-unit amount (bigint or number) to the human-decimal
+ * string the swap-engine expects on the wire.
+ *
+ * Example: `toHumanAmount(100_000_000n, 8)` → `"1"` (1 BTC).
+ * Example: `toHumanAmount(500_000n, 6)` → `"0.5"` (0.5 USDC).
+ *
+ * Rejects negative and fractional numeric inputs — the swap-engine
+ * expects integer base units on the way in, and JS `number` cannot
+ * safely represent large integers (> 2^53), so callers should prefer
+ * `bigint`.
+ */
+export declare function toHumanAmount(baseUnits: bigint | number, decimals: number): string;
+/**
+ * Inverse of `toHumanAmount`: parses a human-decimal string returned
+ * by the swap-engine and rounds to base units. Truncates rather than
+ * rounds to avoid over-quoting.
+ */
+export declare function fromHumanAmount(human: string, decimals: number): bigint;
+//# sourceMappingURL=asset-encode.d.ts.map

package/dist/asset-encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-encode.d.ts","sourceRoot":"","sources":["../src/asset-encode.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAoB7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CA+BR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOvE"}

package/dist/asset-encode.js

@@ -0,0 +1,95 @@
+// ---------------------------------------------------------------------------
+// Translation between the swidge public API and the SwapKit-shaped HTTP
+// surface of the swap-engine.
+//
+// Downstream code speaks swidge — { fromToken, fromChain, toToken, toChain }
+// with `token` = ticker (native) or address (fungible). The swap-engine
+// still speaks SwapKit — a single `"CHAIN.TICKER-0xAddress"` string per
+// asset. This module encodes / decodes those two conventions.
+// ---------------------------------------------------------------------------
+import { swapkitChainFor, nativeMetaFor } from "./chain-map.js";
+/**
+ * Encodes a swidge {chain, token} pair into the SwapKit asset string the
+ * swap-engine `/quote` / `/swap` endpoints consume.
+ *
+ * Rules:
+ *   - Native token (matches the chain's nativeSymbol): `"CHAIN.TICKER"`.
+ *   - Address-based token: `"CHAIN.<TICKER-placeholder>-<address>"`. The
+ *     swap-engine parser strips everything before the '-' when resolving
+ *     the actual asset, so the placeholder is unused — we pass "T" as a
+ *     non-empty stub.
+ *
+ * Throws `Error` when the chain is not in the swidge catalogue.
+ */
+export function encodeSwapKitAsset(swidgeChain, token) {
+    const chainCode = swapkitChainFor(swidgeChain);
+    if (chainCode === "") {
+        throw new Error(`SwapDKSwidge: unknown chain "${swidgeChain}" — must be one of the swidge chain ids from getSupportedChains()`);
+    }
+    const native = nativeMetaFor(swidgeChain);
+    const upper = token.trim().toUpperCase();
+    if (native && upper === native.symbol.toUpperCase()) {
+        return `${chainCode}.${native.symbol.toUpperCase()}`;
+    }
+    // Fungible: prefix with a placeholder ticker so the SwapKit parser
+    // sees a well-formed identifier. The swap-engine's parser drops the
+    // ticker part and keeps only the trailing address, so the stub is
+    // never surfaced downstream.
+    const trimmed = token.trim();
+    return `${chainCode}.T-${trimmed}`;
+}
+/**
+ * Converts a base-unit amount (bigint or number) to the human-decimal
+ * string the swap-engine expects on the wire.
+ *
+ * Example: `toHumanAmount(100_000_000n, 8)` → `"1"` (1 BTC).
+ * Example: `toHumanAmount(500_000n, 6)` → `"0.5"` (0.5 USDC).
+ *
+ * Rejects negative and fractional numeric inputs — the swap-engine
+ * expects integer base units on the way in, and JS `number` cannot
+ * safely represent large integers (> 2^53), so callers should prefer
+ * `bigint`.
+ */
+export function toHumanAmount(baseUnits, decimals) {
+    if (typeof baseUnits === "number") {
+        if (!Number.isFinite(baseUnits) || baseUnits < 0) {
+            throw new Error(`toHumanAmount: bad amount ${baseUnits}`);
+        }
+        if (!Number.isInteger(baseUnits)) {
+            throw new Error(`toHumanAmount: fractional number ${baseUnits}; pass a bigint for large integer base-unit values`);
+        }
+        baseUnits = BigInt(baseUnits);
+    }
+    if (baseUnits < 0n)
+        throw new Error(`toHumanAmount: negative amount ${baseUnits}`);
+    if (decimals < 0 || !Number.isInteger(decimals)) {
+        throw new Error(`toHumanAmount: bad decimals ${decimals}`);
+    }
+    const raw = baseUnits.toString();
+    if (decimals === 0)
+        return raw;
+    if (raw.length <= decimals) {
+        const padded = raw.padStart(decimals + 1, "0");
+        const intPart = padded.slice(0, padded.length - decimals);
+        const fracPart = padded.slice(padded.length - decimals).replace(/0+$/, "");
+        return fracPart === "" ? intPart : `${intPart}.${fracPart}`;
+    }
+    const intPart = raw.slice(0, raw.length - decimals);
+    const fracPart = raw.slice(raw.length - decimals).replace(/0+$/, "");
+    return fracPart === "" ? intPart : `${intPart}.${fracPart}`;
+}
+/**
+ * Inverse of `toHumanAmount`: parses a human-decimal string returned
+ * by the swap-engine and rounds to base units. Truncates rather than
+ * rounds to avoid over-quoting.
+ */
+export function fromHumanAmount(human, decimals) {
+    const trimmed = human.trim();
+    if (trimmed === "")
+        return 0n;
+    const [intPart, fracPartRaw = ""] = trimmed.split(".");
+    const fracPart = fracPartRaw.slice(0, decimals).padEnd(decimals, "0");
+    const combined = `${intPart}${fracPart}`.replace(/^0+/, "") || "0";
+    return BigInt(combined);
+}
+//# sourceMappingURL=asset-encode.js.map

package/dist/asset-encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-encode.js","sourceRoot":"","sources":["../src/asset-encode.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wEAAwE;AACxE,8BAA8B;AAC9B,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,wEAAwE;AACxE,8DAA8D;AAC9D,8EAA8E;AAE9E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,KAAa;IACnE,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,gCAAgC,WAAW,mEAAmE,CAC/G,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEzC,IAAI,MAAM,IAAI,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QACpD,OAAO,GAAG,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,mEAAmE;IACnE,oEAAoE;IACpE,kEAAkE;IAClE,6BAA6B;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,GAAG,SAAS,MAAM,OAAO,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,SAA0B,EAC1B,QAAgB;IAEhB,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,oCAAoC,SAAS,oDAAoD,CAClG,CAAC;QACJ,CAAC;QACD,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,SAAS,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,SAAS,EAAE,CAAC,CAAC;IACnF,IAAI,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAE/B,IAAI,GAAG,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3E,OAAO,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,QAAgB;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,GAAG,OAAO,GAAG,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IACnE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC"}

package/dist/chain-map.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resolves a swidge chain id to the SwapKit chain code used by the
+ * `/quote` and `/swap` HTTP surface. Case-insensitive. Returns `""`
+ * when the swidge id is unknown — callers must check and surface a
+ * user-facing error.
+ */
+export declare function swapkitChainFor(swidgeChain: string): string;
+/** Reverse lookup: SwapKit code → swidge id. Returns `""` when unknown. */
+export declare function swidgeChainFor(swapkitChain: string): string;
+/** Chain family (used by the source-dispatch layer to pick an adapter). */
+export declare function chainFamilyFor(swidgeChain: string): "bitcoin" | "evm" | "cosmos" | "tron" | "solana" | "";
+/**
+ * Metadata for a chain's native gas coin — ticker + decimals. Used by
+ * the option translator to convert between base-unit `fromTokenAmount`
+ * and the human-decimal string the swap-engine expects on /quote.
+ */
+export declare function nativeMetaFor(swidgeChain: string): {
+    symbol: string;
+    decimals: number;
+} | null;
+/** All swidge chain ids the module knows about — used by tests. */
+export declare function allSwidgeChains(): string[];
+//# sourceMappingURL=chain-map.d.ts.map

package/dist/chain-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-map.d.ts","sourceRoot":"","sources":["../src/chain-map.ts"],"names":[],"mappings":"AA0CA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,GAClB,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,EAAE,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,GAClB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQ7C;AAED,mEAAmE;AACnE,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}

package/dist/chain-map.js

@@ -0,0 +1,85 @@
+// ---------------------------------------------------------------------------
+// Swidge chain identifier ↔ SwapKit-style chain code translation.
+//
+// The swap-engine `/quote` and `/swap` HTTP surface still speaks SwapKit
+// notation (`"ETH.USDC-0x…"`, `"BTC.BTC"`, `"THOR.RUNE"`). The swidge protocol
+// speaks lower-case swidge chain ids (`"ethereum"`, `"bitcoin"`, `"thorchain"`).
+// This file is the single translation table.
+//
+// Order matters: the map is the source of truth for supported source chains.
+// Adding a new chain here + wiring an adapter is enough to make the
+// swidge module route it — the /chains discovery endpoint on swap-engine
+// carries the same list on the backend.
+// ---------------------------------------------------------------------------
+/**
+ * Ordered list of every swidge chain the module recognises. Kept as an
+ * array of tuples so the same source of truth serves both lookup
+ * directions.
+ */
+const CHAIN_TABLE = [
+    { swidge: "bitcoin", swapkit: "BTC", family: "bitcoin", nativeSymbol: "BTC", nativeDecimals: 8 },
+    { swidge: "ethereum", swapkit: "ETH", family: "evm", nativeSymbol: "ETH", nativeDecimals: 18 },
+    { swidge: "arbitrum", swapkit: "ARB", family: "evm", nativeSymbol: "ETH", nativeDecimals: 18 },
+    { swidge: "base", swapkit: "BASE", family: "evm", nativeSymbol: "ETH", nativeDecimals: 18 },
+    { swidge: "bsc", swapkit: "BSC", family: "evm", nativeSymbol: "BNB", nativeDecimals: 18 },
+    { swidge: "avalanche", swapkit: "AVAX", family: "evm", nativeSymbol: "AVAX", nativeDecimals: 18 },
+    { swidge: "tron", swapkit: "TRON", family: "tron", nativeSymbol: "TRX", nativeDecimals: 6 },
+    { swidge: "solana", swapkit: "SOL", family: "solana", nativeSymbol: "SOL", nativeDecimals: 9 },
+    { swidge: "thorchain", swapkit: "THOR", family: "cosmos", nativeSymbol: "RUNE", nativeDecimals: 8 },
+    { swidge: "mayachain", swapkit: "MAYA", family: "cosmos", nativeSymbol: "CACAO", nativeDecimals: 10 },
+    { swidge: "cosmoshub", swapkit: "GAIA", family: "cosmos", nativeSymbol: "ATOM", nativeDecimals: 6 },
+    { swidge: "dogecoin", swapkit: "DOGE", family: "bitcoin", nativeSymbol: "DOGE", nativeDecimals: 8 },
+    { swidge: "bitcoincash", swapkit: "BCH", family: "bitcoin", nativeSymbol: "BCH", nativeDecimals: 8 },
+    { swidge: "litecoin", swapkit: "LTC", family: "bitcoin", nativeSymbol: "LTC", nativeDecimals: 8 },
+];
+/**
+ * Resolves a swidge chain id to the SwapKit chain code used by the
+ * `/quote` and `/swap` HTTP surface. Case-insensitive. Returns `""`
+ * when the swidge id is unknown — callers must check and surface a
+ * user-facing error.
+ */
+export function swapkitChainFor(swidgeChain) {
+    const target = swidgeChain.trim().toLowerCase();
+    for (const row of CHAIN_TABLE) {
+        if (row.swidge === target)
+            return row.swapkit;
+    }
+    return "";
+}
+/** Reverse lookup: SwapKit code → swidge id. Returns `""` when unknown. */
+export function swidgeChainFor(swapkitChain) {
+    const target = swapkitChain.trim().toUpperCase();
+    for (const row of CHAIN_TABLE) {
+        if (row.swapkit === target)
+            return row.swidge;
+    }
+    return "";
+}
+/** Chain family (used by the source-dispatch layer to pick an adapter). */
+export function chainFamilyFor(swidgeChain) {
+    const target = swidgeChain.trim().toLowerCase();
+    for (const row of CHAIN_TABLE) {
+        if (row.swidge === target)
+            return row.family;
+    }
+    return "";
+}
+/**
+ * Metadata for a chain's native gas coin — ticker + decimals. Used by
+ * the option translator to convert between base-unit `fromTokenAmount`
+ * and the human-decimal string the swap-engine expects on /quote.
+ */
+export function nativeMetaFor(swidgeChain) {
+    const target = swidgeChain.trim().toLowerCase();
+    for (const row of CHAIN_TABLE) {
+        if (row.swidge === target) {
+            return { symbol: row.nativeSymbol, decimals: row.nativeDecimals };
+        }
+    }
+    return null;
+}
+/** All swidge chain ids the module knows about — used by tests. */
+export function allSwidgeChains() {
+    return CHAIN_TABLE.map((r) => r.swidge);
+}
+//# sourceMappingURL=chain-map.js.map

package/dist/chain-map.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { SwapDKSwidge } from "./SwapDKSwidge.js";
+export type { SwidgeStatus, SwidgeFeeType, SwidgeFee, SwidgeTransaction, SwidgeQuote, SwidgeResult, SwidgeStatusOptions, SwidgeStatusResult, } from "./SwapDKSwidge.js";
+export type { SwapDKSwidgeConfig, SwapDKSwidgeOptions, SwidgeWalletAccount, TronPrebuiltTransaction, TronWebLike, } from "./types.js";
+export type { SwidgeBtcAccount, SwidgeCosmosAccount, SwidgeEvmAccount, SwidgeSolanaAccount, SwidgeTronAccount, } from "./adapters/index.js";
+export { swapkitChainFor, swidgeChainFor, chainFamilyFor, nativeMetaFor, allSwidgeChains, } from "./chain-map.js";
+export { encodeSwapKitAsset, toHumanAmount, fromHumanAmount, } from "./asset-encode.js";
+export { SwapDKError, SwapDKNetworkError, SwapDKApiError, SwapDKProviderError, SwapDKUserError, } from "@swapdk/swap-engine-client";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,GACZ,MAAM,YAAY,CAAC;AAMpB,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,eAAe,GAChB,MAAM,4BAA4B,CAAC"}