Create Universal Signer

Overview

Wrap any EVM or non-EVM signer (ethers, viem, Solana, etc.) into a UniversalSigner so you can send cross-chain transactions on Push Chain without touching your on-chain code.

Prerequisite
Remember to install and import required libraries. See Quickstart for install steps.

Create Universal Signer

PushChain.utils.signer.toUniversal(signer): Promise<UniversalSigner>

The most common way to create a Universal Signer is by converting an existing signer from supported libraries (Ethers, Viem, Solana).

Ethers (v6)

// Derive Ethers Signer
const provider = new ethers.providers.JsonRpcProvider('<RPC_URL>');
const ethersSigner = new ethers.Wallet('<PRIVATE_KEY>', provider);

// Convert to Universal Signer
const universalSigner = await PushChain.utils.signer.toUniversal(ethersSigner);

Provider determines the chain of the account

• RPC URL picks the chain – Sepolia RPC → Ethereum Sepolia, Donut RPC → Push Chain Testnet

Viem

// Derive Wallet Client
const account = privateKeyToAccount('<PRIVATE_KEY>');
const viemClient = createWalletClient({
  transport: http('<RPC_URL>'), // or your preferred RPC URL
  account,
});

// Convert to Universal Signer
const universalSigner = await PushChain.utils.signer.toUniversal(viemClient);

Provider determines the chain of the account

• RPC URL picks the chain – Sepolia RPC → Ethereum Sepolia, Donut RPC → Push Chain Testnet

Solana (Web3 JS)

// Derive Solana Keypair
const solKeypair = Keypair.generate();

// Convert Keypair to Universal Signer
const universalSigner = await PushChain.utils.signer.toUniversalFromKeypair(
  solKeypair,
  {
    chain: PushChain.CONSTANTS.CHAIN.SOLANA_DEVNET,
    library: PushChain.CONSTANTS.LIBRARY.SOLANA_WEB3JS,
  }
);

TheseArgumentsare mandatory

Arguments	Type	Description
signer	viem.WalletClient | ethers.Wallet | UniversalSignerSkeleton	The signer to convert to Universal Signer format.

Returns `UniversalSigner` <object>

// UniversalSigner object
{
  account: {
    address: '0x32DE7d63C654d18F1382f5a30Ef69CB86b399ac7',
    chain: 'eip155:11155111'
  },
  signMessage: [Function: signMessage],
  signAndSendTransaction: [Function: signAndSendTransaction],
  signTypedData: [Function: signTypedData]
}

Ready to dive in? Try the code in live playground 👇.

Ethers (v6)

VIRTUAL NODE IDE

Copy playground link

Copy code

Viem

VIRTUAL NODE IDE

Copy playground link

Copy code

Solana (Web3 JS)

VIRTUAL NODE IDE

Copy playground link

Copy code

UI Kit (Frontend / Abstracted)

REACT PLAYGROUND

Copy playground link

Copy code

// Import necessary components from @pushchain/ui-kit
import {
  PushUniversalWalletProvider,
  PushUniversalAccountButton,
  usePushWalletContext,
  usePushChainClient,
  PushUI,
} from '@pushchain/ui-kit';

function App() {
  // Define Wallet Config
  const walletConfig = {
    network: PushUI.CONSTANTS.PUSH_NETWORK.TESTNET,
  };

  function Component() {
    const { connectionStatus } = usePushWalletContext();
    const { pushChainClient } = usePushChainClient();

    return (
      <div>
        <PushUniversalAccountButton />

        {connectionStatus == PushUI.CONSTANTS.CONNECTION.STATUS.CONNECTED &&
          <p>Push Chain Client Initialized with Universal Signer: ${JSON.stringify(pushChainClient)}</p>
        }
      </div>
    );
  }

  return (
    <PushUniversalWalletProvider config={walletConfig}>
      <Component />
    </PushUniversalWalletProvider>
  );
}

LIVE APP PREVIEW

Next Steps

• Initialize Push Chain Client with the Universal Signer
• Abstract away creation of the Universal Signer using UI Kit
• Learn how to create Universal Signer from public / private keypair
• Create custom implementation of universal signer (Advanced)