useTransfer()

Transfers tokens from the user’s wallet to another address. Uses Avnu’s paymaster to cover gas fees.

Parameters

  • encryptKey (string): PIN used to decrypt the private key
  • wallet (WalletData): Object with publicKey and encryptedPrivateKey
  • contractAddress (string): Token contract address
  • recipient (string): Destination wallet address
  • amount (string | number): Transfer amount
  • decimals (number): Token decimals (default: 18)

Example Implementation

'use client'

import { useTransfer } from "@chipi-pay/chipi-sdk";
import { useState } from "react";

// Sample wallet data - replace with your wallet in production
const sampleWallet = {
  publicKey: "0x123...yourPublicKeyHere",
  privateKey: "encrypted:key:data" // This would be encrypted data in production
};

export function TransferForm() {
  const { transferAsync, transferData, isLoading, error } = useTransfer();
  const [form, setForm] = useState({
    pin: '',
    recipient: '',
    amount: ''
  });

  // BROTHER Token Details
  const BROTHER_TOKEN = {
    address: '0x03b405a98c9e795d427fe82cdeeeed803f221b52471e3a757574a2b4180793ee',
    name: 'STARKNET BROTHER',
    symbol: 'BROTHER',
    decimals: 18
  };

  const handleSubmit = async (e: React.FormEvent) => {
    e.preventDefault();

    try {
      await transferAsync({
        encryptKey: form.pin,
        wallet: {
          publicKey: sampleWallet.publicKey,
          encryptedPrivateKey: sampleWallet.privateKey
        },
        contractAddress: BROTHER_TOKEN.address,
        recipient: form.recipient,
        amount: form.amount,
        decimals: BROTHER_TOKEN.decimals
      });
    } catch (err) {
      console.error('Transfer failed:', err);
    }
  };

  return (
    <div className="bg-white rounded-xl shadow-lg p-6">
      <h2 className="text-2xl font-bold mb-4">Transfer {BROTHER_TOKEN.symbol}</h2>
      
      <form onSubmit={handleSubmit} className="space-y-4">
        <div>
          <label className="block text-sm font-medium mb-1">Security PIN</label>
          <input
            type="password"
            value={form.pin}
            onChange={(e) => setForm({...form, pin: e.target.value})}
            className="w-full p-2 border rounded-md"
            required
          />
        </div>

        <div>
          <label className="block text-sm font-medium mb-1">Recipient Address</label>
          <input
            type="text"
            value={form.recipient}
            onChange={(e) => setForm({...form, recipient: e.target.value})}
            className="w-full p-2 border rounded-md"
            required
          />
        </div>

        <div>
          <label className="block text-sm font-medium mb-1">Amount ({BROTHER_TOKEN.symbol})</label>
          <input
            type="number"
            step={`0.${'0'.repeat(BROTHER_TOKEN.decimals-1)}1`}
            value={form.amount}
            onChange={(e) => setForm({...form, amount: e.target.value})}
            className="w-full p-2 border rounded-md"
            required
          />
        </div>

        <button 
          type="submit" 
          disabled={isLoading}
          className="w-full bg-green-600 text-white py-2 px-4 rounded-md hover:bg-green-700 disabled:bg-gray-400"
        >
          {isLoading ? 'Processing...' : 'Transfer'}
        </button>
      </form>

      {transferData && (
        <div className="mt-4 p-3 bg-gray-50 rounded-md">
          <p className="text-sm font-mono break-all">
            TX Hash: {transferData}
          </p>
        </div>
      )}

      {error && (
        <div className="mt-4 p-3 bg-red-50 text-red-700 rounded-md">
          Error: {error.message}
        </div>
      )}
    </div>
  );
}

:::danger Always verify recipient addresses. Transfers on StarkNet are irreversible. :::