npm package: @stratospherex-dev/awgmi
Description: ## Install
Latest version: 1.2.0

# @stratospherex-dev/awgmi

## Install

```bash
pnpm i @stratospherex-dev/awgmi @tanstack/react-query
```

Connect to Aptos with similar [wagmi](https://github.com/wagmi-dev/wagmi) React hooks.

Support Aptos Wallet Connectors:

- Petra
- Martian
- Pontem
- Fewcha
- SafePal
- Trust Wallet
- Msafe

```jsx
import { createClient, AwgmiConfig, useConnect, getDefaultProviders, defaultChains } from '@stratospherex-dev/awgmi'
import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
import { PetraConnector } from '@stratospherex-dev/awgmi/connectors/petra'
import { MartianConnector } from '@stratospherex-dev/awgmi/connectors/martain'
import { SafePalConnector } from '@stratospherex-dev/awgmi/connectors/safePal'
import { BloctoConnector } from '@stratospherex-dev/awgmi/connectors/blocto'
import { FewchaConnector } from '@stratospherex-dev/awgmi/connectors/fewcha'

// import { mainnet, testnet } from '@stratospherex-dev/awgmi/core'
const chains = defaultChains // mainnet, testnet, devnet

const queryClient = new QueryClient({
  defaultOptions: {
    queries: {
      gcTime: 1_000 * 60 * 60 * 24, // 24 hours
      networkMode: 'offlineFirst',
      refetchOnWindowFocus: false,
      retry: 0,
    },
    mutations: {
      networkMode: 'offlineFirst',
    },
  },
})

export const client = createClient({
  connectors: [
    new PetraConnector({ chains }),
    new MartianConnector({ chains }),
    new PetraConnector({ chains, options: { name: 'Trust Wallet', id: 'trustWallet' } }),
    new SafePalConnector({ chains }),
    new BloctoConnector({ chains, options: { appId: BLOCTO_APP_ID } }),
    new FewchaConnector({ chains }),
  ],
  provider: getDefaultProviders,
  autoConnect: true,
})

function App() {
  return (
    <AwgmiConfig client={client}>
      <QueryClientProvider client={queryClient}>
        <YourApp />
      </QueryClientProvider>
    </AwgmiConfig>
  )
}
```

## Connector

```jsx
import { useConnect, useDisconnect } from '@stratospherex-dev/awgmi'

function ConnectButton() {
  const { connect, connectors } = useConnect()

  return (
    <div>
      {connectors.map((connector) => (
        <button type="button" key={connector.id} onClick={() => connect({ connector, networkName: 'mainnet' })}>
          {connector.name}
        </button>
      ))}
    </div>
  )
}
```

## Hooks

```jsx
import {
  useAccountBalance,
  useAccountBalances,
  useAccountResource,
  useAccountResources,
  useCoin,
  useCoins,
  useNetwork,
  useSendTransaction,
  useSimulateTransaction,
  useTableItem,
} from '@stratospherex-dev/awgmi'
```

### Balance

```js
const { data } = useAccountBalance({
  address: Address,
  coin: '0x1::aptos_coin::AptosCoin',
  watch: true,
})
```

### Send Transaction

```js
import { UserRejectedRequestError } from '@stratospherex-dev/awgmi'

const { sendTransactionAsync } = useSendTransaction()

sendTransactionAsync({
  payload: {
    type: 'entry_function_payload',
    function: '<address>::message::set_message',
    arguments: ['are we gonna make it?'],
    type_arguments: [],
  },
}).catch((err) => {
  if (err instanceof UserRejectedRequestError) {
    // handle user reject
  }
  // handle transaction error
})
```