Skip to main content
Once a user has signed in with an embedded wallet, your app can read balances, sign messages, and submit transactions, all without the user leaving your product. The examples below use the @0xsequence/waas headless SDK, which gives direct access to the wallet without a UI layer. For React apps using wagmi, standard wagmi hooks (useSendTransaction, useSignMessage, etc.) work directly.

​
Get wallet address

import { SequenceWaaS } from "@0xsequence/waas";

const sequence = new SequenceWaaS({
  projectAccessKey: process.env.PROJECT_ACCESS_KEY,
  waasConfigKey: process.env.WAAS_CONFIG_KEY,
  network: "polygon",
});

await sequence.signIn({ idToken }, "user-session");

const address = await sequence.getAddress();
// 0x1234...abcd

​
Send a stablecoin payment (USDC)

const tx = await sequence.sendERC20({
  chainId: 137, // Polygon mainnet
  token: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", // Native USDC
  to: "0xRecipientAddress",
  value: "10000000", // 10 USDC (6 decimals)
});

if (isSentTransactionResponse(tx)) {
  console.log("Transaction hash:", tx.data.txHash);
}

​
Send a raw transaction

const tx = await sequence.sendTransaction({
  chainId: 137,
  transactions: [
    {
      to: "0xContractAddress",
      value: "0",
      data: "0x...", // encoded calldata
    },
  ],
});

​
Call a contract by ABI

const tx = await sequence.callContract({
  to: "0xContractAddress",
  abi: "transfer(address to, uint256 amount)",
  func: "transfer",
  args: {
    to: "0xRecipientAddress",
    amount: "10000000",
  },
  value: 0,
  chainId: 137,
});

​
Sign a message

Used for authentication, consent flows, or off-chain verifications: 
const signature = await sequence.signMessage({
  chainId: 137,
  message: "I authorize this payment of 10 USDC",
});

​
Send ERC-20, ERC-721, ERC-1155

The SDK has helpers for all standard token types: 
// ERC-721 (NFT transfer)
await sequence.sendERC721({
  chainId: 137,
  token: "0xNFTContractAddress",
  to: "0xRecipientAddress",
  id: "42",
});

// ERC-1155 (multi-token)
await sequence.sendERC1155({
  chainId: 137,
  token: "0xTokenContractAddress",
  to: "0xRecipientAddress",
  values: [{ id: "1", amount: "100" }],
});

​
Gas sponsorship

By default, users pay their own gas in MATIC. To avoid prompting users for gas, sponsor it via the Sequence Gas Tank in Builder. Sponsored transactions submit without prompting the user for gas. See fee options on the Sequence docs for configuration.

​
Transaction receipts

import { isSentTransactionResponse } from "@0xsequence/waas";

const result = await sequence.sendERC20({ ... });

if (isSentTransactionResponse(result)) {
  const { txHash, metaTxHash } = result.data;
  // txHash: onchain hash
  // metaTxHash: Sequence relayer hash (useful for tracking sponsored txs)
}