Skip to main content

Transaction Events

Transaction Events are logged when a transaction is submitted by a user.

These must be manually tracked when using the NPM package.

Basic Usage​

To manually track transaction submitted events, use the .transaction() method on the SDK instance.

Parameters​

  • attributes (object)
    • chainId (number | string) - the chain ID where the transaction took place.
    • transactionHash (string) - the transaction hash of the transaction.
    • metadata (object) - an optional collection of transaction metadata that you wish to capture.

React Example​

import { useArcxAnalytics } from '@0xarc-io/analytics'
import { useWeb3React } from '@web3-react/core'

const TransactionButton = () => {
  const { account, chainId } = useWeb3React()
  const sdk = useArcxAnalytics()

  const handleClick = async () => {
    // Example: Simulating a transaction call
    // In a real scenario, you would replace this with your transaction logic,
    // for example, using ethers.js or web3.js to interact with a smart contract

    const transactionHash = '0x023c0e7...' // Placeholder for the actual transaction hash

    // Assuming the transaction was successful and you have the hash
    // Now, track the transaction using the analytics SDK
    sdk.transaction({
      transactionHash,
      account, // Optional: if not passed, the SDK will use the account from the last wallet() call
      chainId, // Optional: if not passed, the SDK will use the chainId from the last chain or wallet call
      metadata: {
        // Example metadata
        action: 'User Initiated Transaction',
      },
    })

    console.log('Transaction tracked!')
  }

  return <button onClick={handleClick}>Send Event</button>
}

Note: the useWeb3React hook is not required to track wallet connections. You can use any library you want to get the account and chainId values. This library is for demonstration purposes, from the Uniswap web3-react library.

JS Example​

import { ArcxAnalyticsSdk } from '@0xarc-io/analytics'

const sdk = await ArcxAnalyticsSdk.init('YOUR_API_KEY', { trackChainChanges: false })

const transactionHash = '0x023c0e7...' // Placeholder for the actual transaction hash

// Assuming the transaction was successful and you have the hash
// Now, track the transaction using the analytics SDK
await sdk.transaction({
  transactionHash,
  account, // Optional: if not passed, the SDK will use the account from the last wallet() call
  chainId, // Optional: if not passed, the SDK will use the chainId from the last chain or wallet call
  metadata: {
    // Example metadata
    action: 'User Initiated Transaction',
  },
})