@lombard.finance/sdk 3.7.4 → 4.1.0

package/src/contract-functions/claimUnstakeRedeem/claimUnstakeRedeem.ts

@@ -1,95 +0,0 @@
-import { DEFAULT_ENV } from '@lombard.finance/sdk-common';
-import { Hash, parseGwei, zeroAddress } from 'viem';
-
-import { makePublicClient } from '../../clients/public-client';
-import { makeWalletClient } from '../../clients/wallet-client';
-import { CHAIN_ID_TO_VIEM_CHAIN_MAP, isKatanaChain } from '../../common/chains';
-import { CommonWriteParameters } from '../../common/parameters';
-import ASSET_ROUTER_ABI from '../../tokens/abi/ASSET_ROUTER_ABI';
-import { AddressKind, Token } from '../../tokens/token-addresses';
-import { getTokenContractInfo } from '../../tokens/tokens';
-import { estimateGasFees } from '../../utils/gas';
-import { ensureHex } from '../../utils/hex';
-
-/**
- * Parameters for claiming BTC.b from unstake redemptions
- */
-export interface IClaimUnstakeRedeemParams extends CommonWriteParameters {
-  /** Raw payload from the unstake redemption (`Unstake.rawPayload`) */
-  data: string;
-
-  /** Signature/proof from the unstake redemption (`Unstake.proof`) */
-  proofSignature: string;
-}
-
-/**
- * Claims BTC.b tokens from an unstake redemption (LBTC → BTC.b)
- *
- * This function is specifically for claiming native chain redemptions after the 7-day unstaking period.
- * Unlike deposits which use `adapter.mintV1`, unstake redemptions use `assetRouter.mint`.
- *
- * Business Rules:
- * - Only works for native chain redemptions (LBTC → BTC.b)
- * - Requires notarization status = SESSION_APPROVED
- * - Requires session state = COMPLETED
- * - Must be called after 7 days from unstake
- *
- * @param params - Parameters for claiming
- * @returns Transaction hash of the claim operation
- *
- * @throws Error if claiming fails or if action selector doesn't match
- */
-export async function claimUnstakeRedeem({
-  data,
-  proofSignature,
-  account,
-  chainId,
-  provider,
-  rpcUrl,
-  env = DEFAULT_ENV,
-}: IClaimUnstakeRedeemParams): Promise<Hash> {
-  const publicClient = makePublicClient({ chainId, rpcUrl, env });
-  const walletClient = makeWalletClient({ chainId, provider });
-
-  // Get AssetRouter address from BTCb token adapter
-  const btcbTokenContract = await getTokenContractInfo(
-    Token.BTCb,
-    chainId,
-    env,
-    AddressKind.Adapter,
-  );
-
-  // Read AssetRouter address from token adapter
-  const assetRouterAddress = await publicClient.readContract({
-    address: btcbTokenContract.address,
-    abi: btcbTokenContract.abi,
-    functionName: 'getAssetRouter',
-  });
-
-  if (!assetRouterAddress || assetRouterAddress === zeroAddress) {
-    throw new Error('AssetRouter address not found in token adapter');
-  }
-
-  // Call AssetRouter.mint function
-  const callData = {
-    address: assetRouterAddress,
-    account,
-    chain: CHAIN_ID_TO_VIEM_CHAIN_MAP[chainId],
-    abi: ASSET_ROUTER_ABI,
-    functionName: 'mint',
-    args: [ensureHex(data), ensureHex(proofSignature)],
-  } as const;
-
-  const gasEstimationData = isKatanaChain(chainId)
-    ? await estimateGasFees(publicClient, callData, parseGwei('1'))
-    : {};
-
-  const { request } = await publicClient.simulateContract({
-    ...callData,
-    ...gasEstimationData,
-  });
-
-  const txHash = await walletClient.writeContract(request);
-
-  return txHash;
-}

package/src/contract-functions/claimUnstakeRedeem/index.ts

@@ -1 +0,0 @@
-export * from './claimUnstakeRedeem';

package/src/contract-functions/deposit/depositToken.stories.tsx

@@ -1,82 +0,0 @@
-import { DEFAULT_ENV } from '@lombard.finance/sdk-common';
-import type { Meta, StoryObj } from '@storybook/react';
-import { makeTokenSelector } from '../../stories/arg-types';
-import { Button } from '../../stories/components/Button';
-import { CodeBlock } from '../../stories/components/CodeBlock';
-import { ConnectButton } from '../../stories/components/ConnectButton';
-import {
-  functionType,
-  wagmiDecorator,
-} from '../../stories/components/decorators';
-import {
-  canPerformAction,
-  useConnection,
-} from '../../stories/hooks/useConnection';
-import useQuery from '../../stories/hooks/useQuery';
-import { Token } from '../../tokens/token-addresses';
-import { depositToken } from './depositToken';
-
-const meta = {
-  title: 'write/depositToken',
-  component: StoryView,
-  tags: ['autodocs'],
-  decorators: [wagmiDecorator, functionType('write')],
-  argTypes: {
-    ...makeTokenSelector([Token.BTCK, Token.BTCb], 'tokenIn'),
-    ...makeTokenSelector([Token.LBTC], 'tokenOut'),
-  },
-} satisfies Meta<typeof StoryView>;
-
-export default meta;
-
-type Story = StoryObj<typeof meta>;
-
-export const WithParams: Story = {
-  args: {
-    env: DEFAULT_ENV,
-    amount: 0,
-    tokenIn: Token.BTCb,
-    tokenOut: Token.LBTC,
-  },
-};
-
-type StoryProps = Omit<
-  Parameters<typeof depositToken>[0],
-  'account' | 'chainId' | 'provider'
->;
-
-export function StoryView(props: StoryProps) {
-  const connection = useConnection();
-
-  const request = async () => {
-    if (!canPerformAction(connection)) {
-      return;
-    }
-
-    return depositToken({
-      ...props,
-      account: connection.account.address,
-      chainId: connection.account.chainId,
-      provider: connection.provider,
-    });
-  };
-
-  const { data, error, isLoading, refetch } = useQuery(request, [], false);
-
-  return (
-    <>
-      <div className="mb-4">
-        <ConnectButton />
-      </div>
-
-      <Button
-        onClick={refetch}
-        disabled={isLoading || !connection.account.address}
-        isLoading={isLoading}
-        actionName={depositToken.name}
-      />
-
-      <CodeBlock text={error || data} />
-    </>
-  );
-}

package/src/contract-functions/deposit/depositToken.ts

@@ -1,214 +0,0 @@
-/**
- * Asset Router deposit functionality for token swaps
- */
-import BigNumber from 'bignumber.js';
-import { Address } from 'viem';
-
-import { makePublicClient } from '../../clients/public-client';
-import { makeWalletClient } from '../../clients/wallet-client';
-import { CHAIN_ID_TO_VIEM_CHAIN_MAP } from '../../common/chains';
-import { CommonWriteParameters, IEnvParam } from '../../common/parameters';
-import ASSET_ROUTER_ABI from '../../tokens/abi/ASSET_ROUTER_ABI';
-import { AddressKind, Token } from '../../tokens/token-addresses';
-import {
-  fromBaseDenomination,
-  getTokenContractInfo,
-  retrieveTokenProperties,
-  toBaseDenomination,
-} from '../../tokens/tokens';
-import { UnsupportedTokenFlow } from '../../utils/err';
-import toBigInt from '../../utils/numbers';
-
-const AVAILABLE_FLOWS: Array<{
-  tokenIn: Token;
-  tokenOut: Token;
-}> = [
-  {
-    tokenIn: Token.BTCb,
-    tokenOut: Token.LBTC,
-  },
-];
-
-/* -------------------------------------------------------------------------- */
-/*                                   Types                                    */
-/* -------------------------------------------------------------------------- */
-
-/**
- * Parameters for depositing tokens into a supported token contract.
- *
- * Extends {@link CommonWriteParameters} and {@link IEnvParam}.
- */
-type DepositTokenParameters = {
-  /**
-   * The amount of tokens to deposit in human-readable format
-   * (e.g., `1.23` for 1.23 XBTC).
-   */
-  amount: BigNumber.Value;
-  /**
-   * The input token that will be deposited.
-   * Defaults to {@link Token.BTCb}.
-   */
-  tokenIn: Token;
-  /**
-   * The output token to be minted after deposit.
-   * Defaults to {@link Token.LBTC}.
-   */
-  tokenOut: Token;
-} & CommonWriteParameters &
-  IEnvParam;
-
-/* -------------------------------------------------------------------------- */
-/*                               Public API                                   */
-/* -------------------------------------------------------------------------- */
-
-/**
- * Gets the AssetRouter address for a given token.
- *
- * This is useful for approving tokens before calling the deposit function.
- *
- * @param tokenIn - The input token (e.g., Token.BTCb)
- * @param chainId - The chain ID
- * @param env - The environment
- * @param rpcUrl - Optional RPC URL
- * @returns The AssetRouter address
- */
-export async function getAssetRouterAddress({
-  tokenIn,
-  chainId,
-  env,
-  rpcUrl,
-}: {
-  tokenIn: Token;
-  chainId: CommonWriteParameters['chainId'];
-  env?: IEnvParam['env'];
-  rpcUrl?: string;
-}): Promise<Address> {
-  const publicClient = makePublicClient({ chainId, rpcUrl, env });
-
-  const adapterContractInfo = await getTokenContractInfo(
-    tokenIn,
-    chainId,
-    env,
-    AddressKind.Adapter,
-  );
-
-  const assetRouterAddress = (await publicClient.readContract({
-    address: adapterContractInfo.address,
-    abi: adapterContractInfo.abi,
-    functionName: 'getAssetRouter',
-  })) as Address;
-
-  return assetRouterAddress;
-}
-
-/**
- * Deposits tokens using the Asset Router contract to mint the corresponding output token.
- *
- * This function validates the deposit flow (input → output token), retrieves token and adapter contract
- * information, obtains the AssetRouter address, and submits a `deposit` transaction to the AssetRouter contract.
- *
- * **Note:** This function does NOT handle token approval. You must approve tokens for the AssetRouter
- * before calling this function. Use {@link getAssetRouterAddress} to get the spender address for approval.
- *
- * ---
- * **Supported flows:**
- * - BTC.b → LBTC
- *
- * ---
- * **Errors thrown:**
- * - `UnsupportedTokenDepositFlow` if the (tokenIn, tokenOut) pair is not supported
- * - `Error` if token contract properties cannot be retrieved
- * - `Error` if the deposit amount exceeds the account balance
- * - `Error` if insufficient allowance (tokens not approved)
- */
-export async function depositToken({
-  account: accountAddress,
-  amount: amountRaw,
-  chainId,
-  env,
-  provider,
-  rpcUrl,
-  tokenIn = Token.BTCb,
-  tokenOut = Token.LBTC,
-}: DepositTokenParameters) {
-  const flow = AVAILABLE_FLOWS.find(
-    af => af.tokenIn === tokenIn && af.tokenOut === tokenOut,
-  );
-  if (!flow) {
-    throw new UnsupportedTokenFlow(tokenIn, tokenOut, chainId, env);
-  }
-
-  const publicClient = makePublicClient({ chainId, rpcUrl, env });
-  const walletClient = makeWalletClient({ provider, chainId });
-
-  // Get adapter contract for tokenIn (BTC.b)
-  const adapterContractInfo = await getTokenContractInfo(
-    tokenIn,
-    chainId,
-    env,
-    AddressKind.Adapter,
-  );
-
-  // Get token contract for tokenIn to check balance and approve
-  const tokenInContractInfo = await getTokenContractInfo(
-    tokenIn,
-    chainId,
-    env,
-    AddressKind.Token,
-  );
-
-  // Get token contract for tokenOut to pass to AssetRouter
-  const tokenOutContractInfo = await getTokenContractInfo(
-    tokenOut,
-    chainId,
-    env,
-    AddressKind.Token,
-  );
-
-  const IN = await retrieveTokenProperties(publicClient, tokenInContractInfo);
-  if (!IN) {
-    throw new Error(
-      `Could not retrieve the properties of ${tokenIn} on ${chainId}`,
-    );
-  }
-
-  // Get AssetRouter address from adapter contract
-  const assetRouterAddress = (await publicClient.readContract({
-    address: adapterContractInfo.address,
-    abi: adapterContractInfo.abi,
-    functionName: 'getAssetRouter',
-  })) as Address;
-
-  const amount = BigNumber(amountRaw);
-  const amountBigInt = toBigInt(toBaseDenomination(amount, IN.decimals));
-
-  // Check token balance
-  const tokenInBalanceRaw = await publicClient.readContract({
-    address: IN.address,
-    abi: IN.abi,
-    functionName: 'balanceOf',
-    args: [accountAddress],
-  });
-  const tokenInBalance = fromBaseDenomination(tokenInBalanceRaw, IN.decimals);
-
-  if (amount.isGreaterThan(tokenInBalance)) {
-    throw new Error(
-      `Unable to deposit ${amount.toString()} ${IN.symbol} because the amount exceeds the account's balance of ${tokenInBalance.toString()} ${IN.symbol}`,
-    );
-  }
-
-  // const isAvalanche =
-  //   chainId === ChainId.avalanche || chainId === ChainId.avalancheFuji;
-
-  // Call deposit on AssetRouter
-  const hash = await walletClient.writeContract({
-    address: assetRouterAddress,
-    abi: ASSET_ROUTER_ABI,
-    chain: CHAIN_ID_TO_VIEM_CHAIN_MAP[chainId],
-    functionName: 'deposit',
-    args: [accountAddress, tokenOutContractInfo.address, amountBigInt],
-    account: accountAddress,
-  });
-
-  return hash;
-}

package/src/contract-functions/deposit/index.ts

@@ -1 +0,0 @@
-export * from './depositToken';

package/src/contract-functions/getBasculeDepositStatus/decodeBasculeDepositStatus.ts

@@ -1,170 +0,0 @@
-import { decodeFunctionData, encodeAbiParameters, keccak256 } from 'viem';
-
-const GMP_V1_SELECTOR = '0xe288fb4a';
-const MINT_SELECTOR = '0x155b6b13';
-
-// ABI for the outer payload (matches your Solidity encodePayload/MessageV1)
-const gmpPayloadAbi = {
-  type: 'function',
-  name: 'MessageV1',
-  inputs: [
-    { name: 'msgPath', type: 'bytes32' },
-    { name: 'msgNonce', type: 'uint256' },
-    { name: 'msgSender', type: 'bytes32' },
-    { name: 'msgRecipient', type: 'bytes32' },
-    { name: 'msgDestinationCaller', type: 'bytes32' },
-    { name: 'msgBody', type: 'bytes' },
-  ],
-} as const;
-
-// ABI for the inner body (mint)
-const mintAbi = {
-  type: 'function',
-  name: 'mint',
-  inputs: [
-    { name: 'toToken', type: 'bytes32' },
-    { name: 'recipient', type: 'bytes32' },
-    { name: 'amount', type: 'uint256' },
-  ],
-} as const;
-
-export interface DecodedMintBody {
-  selector: string;
-  toToken: string;
-  recipient: string;
-  amount: bigint;
-}
-
-export interface DecodedGmpPayload {
-  selector: string; // outer selector (GMP_V1_SELECTOR)
-  msgPath: string;
-  msgNonce: bigint;
-  msgSender: string;
-  msgRecipient: string;
-  msgDestinationCaller: string;
-  rawBody: string; // full hex of msgBody
-  mint: DecodedMintBody; // decoded body
-}
-
-/**
- * Example usage (for testing/debugging):
- *
- * async function testDecoding() {
- *   const res = decodeGmpMintPayload(
- *     '0xe288fb4a022d9999f6a62cd3401ba6e03ae710a1b3fcd8a77325b435371108676e600a5f...',
- *   );
- *   console.log(res);
- *   const mintID = calcMintIDFromDecoded(res, 747474); // Katana chainId
- *   console.log(mintID);
- * }
- */
-
-/**
- * Decode ABI-encoded GMP Payload hex where msgBody is an ABI-encoded `mint` call.
- */
-export function decodeGmpMintPayload(hexData: string): DecodedGmpPayload {
-  if (!hexData.startsWith('0x')) {
-    throw new Error('Payload must be 0x-prefixed hex');
-  }
-
-  // 1) Check outer selector
-  const selector = hexData.slice(0, 10); // 4 bytes = 8 hex chars + '0x'
-  if (selector.toLowerCase() !== GMP_V1_SELECTOR.toLowerCase()) {
-    throw new Error(
-      `Invalid GMP selector: expected ${GMP_V1_SELECTOR}, got ${selector}`,
-    );
-  }
-
-  // 2) Decode outer payload using viem
-  const decoded = decodeFunctionData({
-    abi: [gmpPayloadAbi],
-    data: hexData as `0x${string}`,
-  });
-
-  if (!decoded.args) {
-    throw new Error('Failed to decode GMP payload: args is undefined');
-  }
-
-  const msgPath = decoded.args[0] as string;
-  const msgNonce = decoded.args[1] as bigint;
-  const msgSender = decoded.args[2] as string;
-  const msgRecipient = decoded.args[3] as string;
-  const msgDestinationCaller = decoded.args[4] as string;
-  const msgBody = decoded.args[5] as string; // bytes => 0x…
-
-  if (typeof msgBody !== 'string' || !msgBody.startsWith('0x')) {
-    throw new Error('msgBody is not valid hex');
-  }
-
-  // 3) Check inner selector (mint)
-  const bodySelector = msgBody.slice(0, 10);
-  if (bodySelector.toLowerCase() !== MINT_SELECTOR.toLowerCase()) {
-    throw new Error(
-      `Invalid mint selector in body: expected ${MINT_SELECTOR}, got ${bodySelector}`,
-    );
-  }
-
-  // 4) Decode mint body using viem
-  const mintDecoded = decodeFunctionData({
-    abi: [mintAbi],
-    data: msgBody as `0x${string}`,
-  });
-
-  if (!mintDecoded.args) {
-    throw new Error('Failed to decode mint body: args is undefined');
-  }
-
-  const toToken = mintDecoded.args[0] as string;
-  const recipient = mintDecoded.args[1] as string;
-  const amount = mintDecoded.args[2] as bigint;
-
-  return {
-    selector,
-    msgPath,
-    msgNonce,
-    msgSender,
-    msgRecipient,
-    msgDestinationCaller,
-    rawBody: msgBody,
-    mint: {
-      selector: bodySelector,
-      toToken,
-      recipient,
-      amount,
-    },
-  };
-}
-
-/**
- * Calculate mintID off-chain, equivalent to Solidity _mintID(Message).
- *
- * @param decoded - result of decodeGmpMintPayload(...)
- * @param chainId - destination EVM chain id (same as block.chainid on that chain)
- */
-export function calcMintIDFromDecoded(
-  decoded: DecodedGmpPayload,
-  chainId: bigint | number | string,
-): string {
-  const { msgNonce, mint } = decoded;
-
-  // Solidity: abi.encode(uint256 nonce, uint256 chainId, address recipient, address toToken, uint256 amount)
-  const encoded = encodeAbiParameters(
-    [
-      { name: 'nonce', type: 'uint256' },
-      { name: 'chainId', type: 'uint256' },
-      { name: 'recipient', type: 'bytes32' },
-      { name: 'toToken', type: 'bytes32' },
-      { name: 'amount', type: 'uint256' },
-    ],
-    [
-      BigInt(msgNonce), // self.nonce
-      BigInt(chainId), // block.chainid
-      mint.recipient as `0x${string}`, // self.recipient
-      mint.toToken as `0x${string}`, // self.toToken
-      BigInt(mint.amount), // self.amount
-    ],
-  );
-
-  // bytes32 mintID = keccak256(encoded)
-  return keccak256(encoded);
-}

package/src/contract-functions/getBasculeDepositStatus/getBasculeDepositStatus.stories.tsx

@@ -1,61 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { ChainId } from '../../common/chains';
-import {
-  chainSelector,
-  envSelector,
-  makeTokenSelector,
-} from '../../stories/arg-types';
-import { Button } from '../../stories/components/Button';
-import { CodeBlock } from '../../stories/components/CodeBlock';
-import { functionType } from '../../stories/components/decorators';
-import useQuery from '../../stories/hooks/useQuery';
-import { Token } from '../../tokens/token-addresses';
-import {
-  IGetBasculeDepositStatusParameters,
-  getBasculeDepositStatus,
-} from './getBasculeDepositStatus';
-
-const meta = {
-  title: 'read/getBasculeDepositStatus',
-  component: StoryView,
-  tags: ['autodocs'],
-  decorators: [functionType('read')],
-  argTypes: {
-    ...chainSelector,
-    ...envSelector,
-    ...makeTokenSelector([Token.LBTC, Token.BTCb, Token.BTCK]),
-  },
-} satisfies Meta<typeof StoryView>;
-
-export default meta;
-
-type Story = StoryObj<typeof meta>;
-
-export const WithParams: Story = {
-  args: {
-    rawPayload:
-      'e288fb4a022d9999f6a62cd3401ba6e03ae710a1b3fcd8a77325b435371108676e600a5f000000000000000000000000000000000000000000000000000000000000002200000000000000000000000089e3e4e7a699d6f131d893aeef7ee143706ac23a0000000000000000000000009ece5fb1ab62d9075c4ec814b321e24d8ea021ac000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000064155b6b13000000000000000000000000ecac9c5f704e954931349da37f60e39f515c11c1000000000000000000000000659579f1460c38c3ce3288b47b074646cef855fc0000000000000000000000000000000000000000000000000000000000004df800000000000000000000000000000000000000000000000000000000',
-    chainId: ChainId.katana,
-  },
-};
-
-export function StoryView(props: IGetBasculeDepositStatusParameters) {
-  const request = async () => {
-    return getBasculeDepositStatus(props);
-  };
-
-  const { data, error, isLoading, refetch } = useQuery(request, [], false);
-
-  return (
-    <>
-      <Button
-        onClick={refetch}
-        disabled={isLoading}
-        isLoading={isLoading}
-        actionName={getBasculeDepositStatus.name}
-      />
-
-      <CodeBlock text={error || data} />
-    </>
-  );
-}