Send transactions

Documentation Index

Fetch the complete documentation index at: https://docs.startale.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Send native value

import { useSendTransaction } from 'wagmi'
import { parseEther } from 'viem'

const { sendTransactionAsync } = useSendTransaction()

const hash = await sendTransactionAsync({
  to: '0x000000000000000000000000000000000000dEaD',
  value: parseEther('0.001'),
})

​

Call a contract

import { useWriteContract } from 'wagmi'
import { erc20Abi } from 'viem'

const { writeContractAsync } = useWriteContract()

const hash = await writeContractAsync({
  address: USDSC_ADDRESS,
  abi: erc20Abi,
  functionName: 'transfer',
  args: [recipient, amount],
})

​

With the raw provider

const hash = await provider.request({
  method: 'eth_sendTransaction',
  params: [
    {
      to: '0x000000000000000000000000000000000000dEaD',
      value: '0x38d7ea4c68000', // 0.001 ETH in wei
    },
  ],
})

​

How gas works in Mini Apps

1. Context detection. The App SDK detects it is running inside the Startale App iframe and automatically routes requests through the host wallet instead of opening a standalone popup.
2. Conversion to a UserOperation. The SDK converts the eth_sendTransaction call into an ERC-4337 UserOperation using the AA SDK. This is what allows the transaction to carry a paymaster signature.
3. Paymaster capability injection. Before the request reaches the wallet, the SDK automatically injects an EIP-5792 paymasterService capability into the wallet_sendCalls payload:
   capabilities: {
     paymasterService: {
       url: "<SCS_PAYMASTER_URL>",
       id: "<HOST_PAYMASTER_ID>",
     }
   }
   
   This happens in the SDK’s request interceptor — your code does not need to pass any paymaster configuration.
4. AA SDK builds and signs the UserOperation. The Startale App’s backend uses createSCSPaymasterClient from the AA SDK to fetch a paymaster signature for the UserOperation. The paymaster co-signs the UserOp, committing to cover the gas cost.
5. Bundler submission. The signed UserOperation is submitted to the SCS Bundler, which packages it and calls handleOps on the EntryPoint contract. Gas is paid by the Startale paymaster, not the user.

​

Errors