swag-mi

swag-mi is an ESM-only collection of advanced React hooks built on top of wagmi for production dapp flows.

Repository: ukorvl/swag-mi

Current Hooks

• useSmartWriteContract combines simulation, wallet signature, transaction submission, confirmation tracking, replacement handling, and decoded revert errors into one write lifecycle.

Install

pnpm add swag-mi wagmi viem @tanstack/react-query react

swag-mi expects wagmi, viem, React, and TanStack Query to already be part of your app.

ESM Only

swag-mi ships ESM only. Use it in modern bundlers and runtimes that support ESM package entrypoints.

Example

import { useSmartWriteContract } from "swag-mi";

const useDeposit = () =>
  useSmartWriteContract({
    abi: vaultAbi,
    address: vaultAddress,
    functionName: "deposit",
    args: [amount],
    confirmations: 2,
    onReceipt: receipt => {
      console.log("confirmed", receipt.transactionHash);
    },
    onDecodedError: decodedError => {
      console.error(decodedError.reason ?? decodedError.shortMessage);
    },
  });

The hook exposes a single lifecycle with statuses such as validating, awaiting-signature, submitted, confirming, success, reverted, replaced, cancelled, and user-rejected.

Development

pnpm install
pnpm run lint
pnpm run typecheck
pnpm run test
pnpm run verify:package

License

MIT