abstract-global-wallet

Abstract Global Wallet

AGW is Abstract's cross-application smart contract wallet. Users sign up once (email, social, passkey) and use it across all Abstract apps. Recommended over standard wallet connections for new Abstract apps — see the decision table below for when to consider alternatives.

For AI agent wallet access (not end-user facing), see the using-agw-mcp skill instead.

Quick Start (New Project)

npx @abstract-foundation/create-abstract-app@latest my-app

This scaffolds a React app with AGW pre-configured.

Quick Start (Existing React Project)

1. Install

npm install @abstract-foundation/agw-react @abstract-foundation/agw-client wagmi [email protected] @tanstack/react-query

viem must be 2.x. Using viem 1.x causes compatibility errors.

2. Wrap with provider

import { AbstractWalletProvider } from "@abstract-foundation/agw-react";
import { abstractTestnet } from "viem/chains"; // or abstract for mainnet

export default function App() {
  return (
    <AbstractWalletProvider chain={abstractTestnet}>
      {/* Your app */}
    </AbstractWalletProvider>
  );
}

3. Add login

import { useLoginWithAbstract } from "@abstract-foundation/agw-react";

export default function LoginButton() {
  const { login, logout } = useLoginWithAbstract();
  return <button onClick={login}>Login with Abstract</button>;
}

4. Send transactions

import { useAbstractClient } from "@abstract-foundation/agw-react";

export default function SendTx() {
  const { data: abstractClient } = useAbstractClient();

  async function send() {
    if (!abstractClient) return;
    const hash = await abstractClient.sendTransaction({
      to: "0x...",
      data: "0x...",
    });
  }

  return <button onClick={send}>Send</button>;
}

5. Sponsored transactions (gas-free for users)

import { useWriteContractSponsored } from "@abstract-foundation/agw-react";
import { getGeneralPaymasterInput } from "viem/zksync";

export default function SponsoredMint() {
  const { writeContractSponsored, isPending } = useWriteContractSponsored();

  return (
    <button
      disabled={isPending}
      onClick={() =>
        writeContractSponsored({
          abi: contractAbi,
          address: "0xContractAddress",
          functionName: "mint",
          args: ["0xRecipient", BigInt(1)],
          paymaster: "0xPaymasterAddress",
          paymasterInput: getGeneralPaymasterInput({ innerInput: "0x" }),
        })
      }
    >
      Mint (Gas Free)
    </button>
  );
}